Illusive Networks

このドキュメントでは、Illusive Networks を Google SecOps と統合する方法について説明します。

プロダクトのユースケース

  1. アクティブなアクションを実行する - フォレンジック スキャンの実行、エンティティの拡充、デセプション ユーザー/サーバーの追加/削除など。
  2. インシデントを Simplify に取り込む。

Google Security Operations で Illusive Networks の統合を構成する

Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 タイプ デフォルト値 必須 Description
API ルート 文字列 http://x.x.x.x ○ Illusive Networks インスタンスの API ルート。
API キー パスワード なし ○

Illusive Networks の API キー。
注: 文字列「Basic」は値の一部にしないでください。

CA 証明書ファイル 文字列 False Base64 でエンコードされた CA 証明書ファイル。
SSL を確認 チェックボックス オン ○ 有効になっている場合は、Illusive Networks サーバーへの接続用の SSL 証明書が有効であることを確認します。

API キーの生成方法

  1. Illusive Networks コンソールの [Settings] セクションに移動します。
  2. [General] セクションで、[API キー] 部分まで下にスクロールします。
  3. [キーを追加] ボタンを押します。
  4. API キーにすべての権限を追加することをおすすめします。
  5. 指定された文字列から、「Basic」文字列を除くすべてをコピーする必要があります。
  6. その値を Google SecOps 統合の「API キー」パラメータに入力します。

レート制限を更新する方法

Illusive Networks の特定のエンドポイントにはレート制限があります。コネクタの場合、すべてのインシデントが取り込まれるように、上限を十分に高くすることが重要です。レート制限を更新するには、管理サーバーにログインして C:\Program Files\illusive-Management-Server-3.1.XXX.XXXX\conf\general.properties.txt に移動する必要があります。

このファイルで、次のプロパティを探します。

  • api.incident.rate.limit.maximum.num.requests
  • api.rate.limit.windows.duration.minutes

次のように設定することをおすすめします。

  • api.incident.rate.limit.maximum.num.requests=100
  • api.rate.limit.windows.duration.minutes=1
  • api.monitoring.rate.limit.maximum.num.requests = 100
  • api.forensics.rate.limit.maximum.num.requests = 100

操作

Ping

説明

Google SecOps Content Hub ページの統合構成ページで提供されるパラメータを使用して、Illusive Networks への接続性をテストします。

パラメータ

なし

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

成功した場合:「指定された接続パラメータで Illusive Networks サーバーに正常に接続しました。」

失敗した場合(fail) - Illusive Networks サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)

一般

エンティティの拡充

説明

Illusive Networks の情報を使用してエンティティを拡充します。サポートされるエンティティ: ホスト名。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
なし

実行

このアクションはホスト エンティティに対して実行されます。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "machineId": "00428a29-0343-4e13-aa97-3b624739c509",
    "machineName": "HELLO",
    "isHealthy": false,
    "lastDeploymentMethodType": "WMI",
    "distinguishedName": "CN=HELLO,CN=Computers,dc=iln,dc=local",
    "groupName": null,
    "sourceDiscoveryName": "iln.local",
    "collectData": true,
    "policyName": null,
    "assignmentStatus": "ANALYSIS",
    "operatingSystemType": "Windows",
    "operatingSystemName": "Windows Server 2016 Standard Evaluation",
    "operatingSystemVersion": "10.0 (14393)",
    "agentVersion": null,
    "bitness": null,
    "loggedInUserName": null,
    "lastLogonTime": 1613078764501,
    "succeededDeceptionFamilies": 0,
    "shouldBeUninstalledDeceptionFamilies": 0,
    "desiredDeceptionFamilies": 0,
    "deceptionFamiliesPercentages": null,
    "lastExecutionType": "AGENT",
    "machineLastExecutionPhaseType": "CONNECTION",
    "machineLastExecutionPhaseStatus": "FAILURE",
    "machineLastExecutionPhaseErrorMessage": "Unreachable - no ping",
    "mitigationStatusType": null,
    "machineExecutionUnifiedStatus": "FAILURE_CONNECTION",
    "machineLastExecutionPhaseFinishDate": "2021-02-12T10:17:30.623Z",
    "endpointTrapHealthCheckHostStatus": "NotTested",
    "endpointTrapHealthCheckHostStatusLastUpdated": null,
    "failedDeceptionFamilies": 0,
    "inProgressDeceptionFamilies": 0,
    "notDeployedDeceptionFamilies": 0,
    "policyId": null,
    "ghost": false
}
エンティティ拡充
拡充フィールド名 ロジック - 適用するタイミング
ILLNET_machineName JSON で利用可能な場合(ホスト情報)
ILLNET_isHealthy JSON で利用可能な場合(ホスト情報)
ILLNET_host JSON で利用可能な場合(ホスト情報)
ILLNET_distinguishedName JSON で利用可能な場合(ホスト情報)
ILLNET_sourceDiscoveryName JSON で利用可能な場合(ホスト情報)
ILLNET_policyName JSON で利用可能な場合(ホスト情報)
ILLNET_operatingSystemName JSON で利用可能な場合(ホスト情報)
ILLNET_agentVersion JSON で利用可能な場合(ホスト情報)
ILLNET_loggedInUserName JSON で利用可能な場合(ホスト情報)
ILLNET_machineExecutionUnifiedStatus JSON で利用可能な場合(ホスト情報)
ILLNET_bitness JSON で利用可能な場合(ホスト情報)
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
少なくとも 1 つのデータが利用可能である場合(is_success = true):「Illusive Networks を使用して、次のエンティティを正常に拡充しました: \n {entity.identifier}。」

少なくとも 1 つのデータがない場合(is_success = true): 「アクションは、Illusive Networks を使用して次のエンティティを拡充できませんでした: \n {entity.identifier}」

すべてのデータが利用できない場合(is_success = false): 「エンティティが拡充されませんでした」。

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が誤っているなどの致命的なエラーで、サーバーへの接続がない場合、その他: 「"エンティティの拡充" アクションの実行中にエラーが発生しました。Reason: {0}''.format(error.Stacktrace)

429 ステータス コードの場合:「アクション「エンティティの拡充」の実行エラー。理由: レート制限エラー。レート制限を引き上げる方法については、ドキュメントをご覧ください。」

全般
Case Wall テーブル

名前: {entity.identifier}

列は 2 つのみです。Key と Value。

エンティティ

フォレンジック スキャンの実行

説明

Illusive Networks のエンドポイントでフォレンジック スキャンを実行します。IP エンティティとホスト名エンティティで動作します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
システム情報を含める チェックボックス オン ○ 有効にすると、アクションでシステム情報が返されます。
プリフェッチ ファイル情報を含める チェックボックス オン ○ 有効にすると、アクションによってプリフェッチ ファイルに関する情報が返されます。
プログラムの追加と削除に関する情報を含める チェックボックス オン ○ 有効にすると、アクションによってプログラムの追加と削除に関する情報が返されます。
スタートアップ プロセス情報を含める チェックボックス オン ○ 有効にすると、アクションによって起動プロセスに関する情報が返されます。
実行中のプロセスに関する情報を含める チェックボックス オン ○ 有効にすると、アクションによって実行中のプロセスに関する情報が返されます。
ユーザー支援プログラムに関する情報を含める チェックボックス オン ○ 有効にすると、アクションでユーザー アシスト プログラムに関する情報が返されます。
PowerShell 履歴情報を含める チェックボックス オン ○ 有効にすると、アクションによって PowerShell の履歴に関する情報が返されます。

返されるアイテムの最大数

Integer 50 いいえ 返されるアイテムの数を指定します。何も指定しないと、アクションですべてが返されます。

実行

このアクションは次のエンティティに対して実行されます。

  • IP アドレス
  • ホスト

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "Entity.identifier": {
        "host_info": "{Host_info part}",
        "prefetch_info": "{prefetch_info}",
        "installed_programs_info": "{installed_programs_info}",
        "startup_processes": "{startup_processes}",
        "running_processes": "{running_processes}",
        "user_assist_info": "{user_assist_info}",
        "powershell_history": "{powershell history}"
    }
}
エンティティ拡充
拡充フィールド名 ロジック - 適用するタイミング
ILLNET_osName JSON で利用可能な場合(ホスト情報)
ILLNET_machineType JSON で利用可能な場合(ホスト情報)
ILLNET_host JSON で利用可能な場合(ホスト情報)
ILLNET_loggedInUser JSON で利用可能な場合(ホスト情報)
ILLNET_userProfiles JSON で利用可能な場合(ホスト情報)
ILLNET_operatingSystemType JSON で利用可能な場合(ホスト情報)
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
少なくとも 1 つが正常に実行された場合(is_success = true): 「Illusive Networks の次のエンドポイントでフォレンジック スキャンが正常に実行されました: {entity.identifier}」

少なくとも 1 つで成功しなかった場合: 「アクションは、次のエンドポイントのフォレンジック スキャンから情報を取得できませんでした: {entity.identifier}」

すべてで成功しなかった場合:「指定されたエンドポイントでフォレンジック情報が見つかりませんでした。」

非同期メッセージ: 「次のエンドポイントでフォレンジック スキャンを開始しました: {entity identifier}。\n

次のエンドポイントでフォレンジック スキャンが完了しました。

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が誤っているなどの致命的なエラーで、サーバーへの接続がない場合、その他: 「"フォレンジック スキャンの実行" アクションの実行中にエラーが発生しました。Reason: {0}''.format(error.Stacktrace)

「include ...」パラメータが有効になっていない場合:「アクション「フォレンジック スキャンの実行」の実行エラー。理由: 「含める ...」パラメータを少なくとも 1 つ有効にする必要があります。

全般
ケースウォール テーブルのホスト情報

名前: {entity.identifier}

列は 2 つのみです。Key と Value。

エンティティ
ケースウォール テーブルの Prefetch_Info

名前: 「{entity.identifier}: プリフェッチ ファイル情報」

列:

ファイル名

最終実行時間

ファイルの変更日時

プリフェッチ ファイル名

全般

Case Wall テーブル

INSTALLED_PROGRAMS_INFO

名前: 「{entity.identifier}: プログラムの追加と削除に関する情報」

列:

表示名

ファイル名

全般

Case Wall テーブル

STARTUP_PROCESSES

名前: 「{entity.identifier}: スタートアップ プロセス」

列:

Name

コマンド

場所

ユーザー

全般

Case Wall テーブル

RUNNING_PROCESSES

名前: 「{entity.identifier}: 実行中のプロセス」

列:

ユーザー

管理者権限

コマンド

プロセス ID

プロセス名

開始時間

全般

Case Wall テーブル

USER_ASSIST_INFO

名前: 「{entity.identifier}: ユーザー補助プログラムの情報」

列:

ファイル名

ユーザー名

最終使用日

****

Case Wall テーブル

POWER_SHELL_HISTORY

名前: 「{entity.identifier}: Powershell 履歴」

列:

ユーザー名

コマンド

不正なアイテムを一覧表示する

説明

Illusive Networks で利用可能な欺瞞的なアイテムを一覧表示します。

パラメータ

パラメータの表示名 タイプ デフォルト値 必須 説明
虚偽のタイプ DDL

すべて

有効な値:

すべて

ユーザーのみ

サーバーのみ

○ 返される欺瞞的なアイテムの種類を指定します。
欺瞞的な状態 DDL

すべて

有効な値:

すべて

[Only Approved](承認済みのみ)、[Only Suggested](提案のみ)

○ 状態に基づいて返される、不適切なアイテムの種類を指定します。
返されるアイテムの最大数 Integer 50 いいえ 返されるアイテムの数を指定します。デフォルト: 50。 何も指定しないと、アクションはすべてのアイテムを返します。

実行

このアクションはエンティティに対しては実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
JSON の結果
{
    "users": [
        {
            "username": "backupad",
            "password": "5437niwY",
            "domainName": "intw-lab.local",
            "policyNames": [
                "Full Protection"
            ],
            "adUser": false,
            "activeUser": false,
            "deceptiveState": "APPROVED"
        },
        {
            "username": "jvillar",
            "password": "ritA1102",
            "domainName": "intw-lab.local",
            "policyNames": [],
            "adUser": true,
            "activeUser": false,
            "deceptiveState": "SUGGESTED"
        },
        {
            "username": "gaccess.user",
            "password": "psUiS01",
            "domainName": "intw-lab.local",
            "policyNames": [],
            "adUser": true,
            "activeUser": false,
            "deceptiveState": "SUGGESTED"
        },
        {
            "username": "service.user",
            "password": "mAkaYe4",
            "domainName": "intw-lab.local",
            "policyNames": [],
            "adUser": true,
            "activeUser": false,
            "deceptiveState": "SUGGESTED"
        }
    ],
    "servers": [
        {
            "host": "10.0.0.2",
            "serviceTypes": [
                "DB"
            ],
            "policyNames": [
                "Full Protection"
            ],
            "adHost": false,
            "deceptiveState": "APPROVED"
        },
        {
            "host": "10.0.0.1",
            "serviceTypes": [
                "DB"
            ],
            "policyNames": [
                "Full Protection"
            ],
            "adHost": false,
            "deceptiveState": "APPROVED"
        }
    ]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
200 でデータが利用可能な場合(is_success = true):「Illusive Networks から利用可能な欺瞞的なアイテムが正常に返されました。」

200 で、利用可能なデータがない場合(is_success=false)「Illusive Networks で指定された条件に基づく、不正なアイテムに関するデータが見つかりませんでした。」

アクションが失敗し、ハンドブックの実行が停止します:
認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:「アクション「不正なアイテムの一覧表示」の実行エラー。理由: {0}」.format(error.Stacktrace)

一般
Case Wall テーブル

名前: 「Deceptive Users」

列:

ユーザー名

パスワード

ドメイン

ポリシー

AD ユーザー

アクティブ

都道府県

全般
Case Wall テーブル

名前: 「Deceptive Servers」

列:

ホスト

サービス

ポリシー

広告サーバー

都道府県

全般

不正なユーザーを追加する

説明

Illusive Networks に欺瞞的なユーザーを追加します。

パラメータ

Name デフォルト値 必須 説明
ユーザー名 なし ○ 新しい不正なユーザーのユーザー名を指定します。
パスワード なし ○ 新しいおとりユーザーのパスワードを指定します。
DNS ドメイン なし いいえ 新しいおとりユーザーのドメイン名を指定します。
ポリシー名 なし いいえ 新しい不正なユーザーに適用する必要があるポリシーのカンマ区切りのリストを指定します。何も指定しない場合、アクションはデフォルトですべてのポリシーを使用します。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

成功(is_success=true) → Illusive ネットワークにデセプティブ ユーザーが正常に追加されました。

ケース 1. ユーザーがすでに存在する(失敗) - アクション「{アクション名}」の実行中にエラーが発生しました。理由: 虚偽のユーザー「{username}」がすでに存在します。

ケース 2. 400 ステータス コード(失敗) - アクション「{action name}」の実行エラー。理由: {エラー メッセージ}。

ケース 3. 一般的なエラー(失敗) - アクション「{action name}」の実行中にエラーが発生しました。理由: {error traceback}。

全般

虚偽のユーザーを削除する

説明

Illusive Networks から欺瞞的なユーザーを削除します。

パラメータ

Name デフォルト値 必須 説明
ユーザー名 なし ○ 削除する必要がある不正なユーザーのユーザー名を指定します。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

成功 → Illusive ネットワークで、おとりユーザーを削除しました。

ケース 1. ユーザーが存在しない(is_success=false)- アクションは、不正なユーザー「{username}」を削除できませんでした。理由: 虚偽のユーザー「{username}」は存在しません。

ケース 2. 一般的なエラー(失敗)- アクション「{action name}」の実行中にエラーが発生しました。理由: {error traceback}。

全般

デセプション サーバーを追加

説明

Illusive Networks にデセプション サーバーを追加します。

パラメータ

Name デフォルト値 必須 説明
サーバー名 なし ○ 新しいデセプション サーバーの名前を指定します。
Service のタイプ DB ○ 新しいデセプション サーバーのサービスタイプのカンマ区切りのリストを指定します。
ポリシー名 いいえ 新しいおとりサーバーに適用する必要があるポリシーのカンマ区切りのリストを指定します。何も指定しない場合、アクションはデフォルトですべてのポリシーを使用します。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

成功(is_success=true) → Illusive ネットワークにデセプション サーバーが正常に追加されました。

ケース 1. サーバーがすでに存在します(失敗)- アクション「{action name}」の実行中にエラーが発生しました。理由: おとりサーバー「{server name}」はすでに存在します。

ケース 2. 400 ステータス(失敗)- アクション「{action name}」の実行中にエラーが発生しました。理由: {エラー メッセージ}。

ケース 3. 一般的なエラー - アクション「{action name}」の実行中にエラーが発生しました。理由: {error traceback}。

全般

おとりサーバーを削除する

説明

Illusive Networks から不正なサーバーを削除します。

パラメータ

Name デフォルト値 必須 説明
サーバー名 なし ○ 削除する必要があるデセプション サーバーの名前を指定します。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション
is_success is_success=False
is_success is_success=True
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ *

成功 → Illusive ネットワーク内の欺瞞サーバーを正常に削除しました。

ケース 1. サーバーが存在しない(is_success=false)- アクションは、不正なサーバー「{server name}」を削除できませんでした。理由: おとりサーバー「{サーバー名}」が存在しません。

ケース 2. 一般的なエラー - アクション「{action name}」の実行中にエラーが発生しました。理由: {error traceback}。

全般

コネクタ

Illusive Networks - インシデント コネクタ

説明

Illusive Networks から、関連するフォレンジック タイムラインを含むインシデントを取得します。

Google SecOps で Illusive Networks - Incidents コネクタを構成する

Google SecOps でコネクタを構成する方法の詳細については、コネクタの構成をご覧ください。

コネクタ パラメータ

次のパラメータを使用してコネクタを構成します。

パラメータの表示名 Type> デフォルト値 必須 説明
プロダクト フィールド名 文字列 プロダクト名 ○ ソース フィールド名を入力してプロダクト フィールド名を取得します。
イベント フィールド名 文字列 details_serviceType ○ ソース フィールド名を入力してイベント フィールド名を取得します。
環境フィールド名 文字列 "" いいえ

環境名が保存されるフィールドの名前を記述します。

環境フィールドがない場合、その環境がデフォルトの環境です。

環境の正規表現パターン 文字列 .* いいえ

[環境フィールド名] フィールドで見つかった値に対して実行する正規表現パターン。

デフォルトは、すべてキャッチして値を変更せずに返す .* です。

ユーザーが正規表現ロジックで環境フィールドを操作できるようにするために使用されます。

正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。

スクリプトのタイムアウト(秒) 整数 180 はい 現在のスクリプトを実行している Python プロセスのタイムアウト上限。
API ルート 文字列 http://x.x.x.x ○ Illusive Networks インスタンスの API ルート。
API キー 文字列 なし ○ Illusive Networks の API キー。注: 文字列「Basic」は値の一部にしないでください。
アラートの重大度 文字列 中 ○

Illusive Networks のインシデントに基づいて作成される Google SecOps アラートの重大度。

値は次のいずれかです。

情報

低

中

高

重大

最大遡及時間 整数 1 いいえ インシデントを取得した時点からの経過時間数。
取得する最大インシデント数 Integer 10 いいえ 1 回のコネクタのイテレーションで処理するインシデントの数。最大値は 1,000 です。
許可リストを拒否リストとして使用 チェックボックス オン ○ 有効にすると、許可リストが拒否リストとして使用されます。
SSL を確認 チェックボックス オフ ○ 有効になっている場合は、Illusive Networks サーバーへの接続用の SSL 証明書が有効であることを確認します。
CA 証明書ファイル 文字列 なし いいえ Base64 でエンコードされた CA 証明書ファイル。
プロキシ サーバーのアドレス 文字列 なし いいえ 使用するプロキシ サーバーのアドレス。
プロキシのユーザー名 文字列 なし いいえ 認証に使用するプロキシのユーザー名。
プロキシ パスワード パスワード なし いいえ 認証に使用するプロキシ パスワード。

コネクタ ルール

プロキシのサポート

コネクタでプロキシがサポートされます。

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。