Microsoft Sentinel

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

この統合では、1 つ以上のオープンソース コンポーネントを使用します。この統合の完全なソースコードのコピーを Cloud Storage バケットからダウンロードできます。

ユースケース

  1. オンプレミス ホストと、Microsoft 365 や Microsoft 365 Cloud App Security などのクラウドベースの Microsoft サービスの両方から流れるイベントに基づいて、Sentinel で作成されたアラートをモニタリングして検査します。
  2. 特定のインシデントを調査しながら、Sentinel で収集され、相関付けられたデータを拡充に使用します。アナリストは、Sentinel で収集して保存したデータを調査に使用できます。たとえば、特定の情報に「ドリルダウン」する(アラートデータを検査する、Syslog ログを検査するなど)、特定の期間のアクティビティや特定のホストからのアクティビティをクエリするなどです。

前提条件

Microsoft Security Insights API に対してリクエストを実行するには、まず Microsoft Entra ID で認可を構成する必要があります。権限を構成する必要があります。

  • Microsoft Entra アプリを作成します。
  • クライアント シークレットを作成します。
  • 登録済みの Microsoft Entra アプリに Microsoft Sentinel ワークスペースへのアクセス権を付与します。
  • Microsoft Entra アプリケーションを使用してアクセス トークンを取得します。

Microsoft Entra アプリを作成する

  1. ユーザー管理者またはパスワード管理者として Azure ポータルにログインします。

  2. [Microsoft Entra ID] を選択します。

  3. [App registrations] > [New registration] に移動します。

  4. アプリの名前を入力します。

  5. 該当するサポートされているアカウントの種類を選択します。

  6. [Register] をクリックします。

  7. 後で統合パラメータを構成するときに使用するために、アプリケーション(クライアント)ID とディレクトリ(テナント)ID の値を保存します。

クライアント シークレットを作成する

  1. [証明書とシークレット] > [新しいクライアント シークレット] に移動します。

  2. クライアント シークレットの説明を入力し、有効期限を設定します。

  3. [追加] をクリックします。

  4. クライアント シークレットの値(シークレット ID ではない)を保存して、統合を構成するときに Client Secret パラメータ値として使用します。クライアント シークレットの値は 1 回だけ表示されます。

登録済みの Microsoft Entra に Microsoft Sentinel ワークスペースへのアクセス権を付与する

  1. Microsoft Sentinel の [概要] ページに移動します。

  2. [設定] をクリックします。

  3. [アクセス制御(IAM)] をクリックします。

  4. [ロールの割り当てを追加] セクションで、[追加] をクリックします。

  5. 次のパラメータを構成します。

    • ロール = Azure Sentinel Contributor。

    • アクセス権の割り当て先 = default, Microsoft Entra ID user group, or service principal。

  6. [選択] セクションで、アプリを検索する検索条件を指定し、アプリのロール割り当てを追加します。

  7. Microsoft Sentinel のワークスペース ページに移動します。次のパラメータを見つけて構成します。

    • Azure Resource Group
    • Azure Sentinel Workspace Name

Microsoft Sentinel を Google SecOps SOAR と統合する

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

統合のパラメータ

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

パラメータの表示名 種類 デフォルト値 必須 説明
インスタンス名 文字列 なし いいえ 統合を構成するインスタンスの名前。
説明 文字列 なし いいえ インスタンスの説明。
Azure サブスクリプション ID 文字列 なし ○ Microsoft Azure サブスクリプション ID。Azure ポータル > [サブスクリプション] > [<サブスクリプション>] > [サブスクリプション ID] で確認できます。
Azure Active Directory ID 文字列 なし ○ Microsoft Entra テナント ID。Microsoft Entra > [アプリの登録] > [統合用に構成したアプリケーション] > [ディレクトリ(テナント)ID] で確認できます。
API ルート 文字列 https://management.azure.com ○ 統合で使用する management.azure.com API のルート URL。
Azure リソース グループ 文字列 なし ○ Microsoft Sentinel が配置されている Azure リソース グループの名前。
Azure Sentinel ワークスペース名 文字列 なし ○ 操作する Microsoft Sentinel ワークスペースの名前。Azure ポータル > [Microsoft Sentinel] > [Microsoft Sentinel ワークスペース] で確認できます。
クライアント ID 文字列 なし ○ この統合のために Microsoft Entra でアプリ登録用に追加されたクライアント(アプリケーション)ID。
クライアント シークレット パスワード なし ○ Azure Sentinel アプリの登録時に入力したシークレット。
リモートで実行 チェックボックス オフ いいえ 構成した統合をリモートで実行するには、フィールドのチェックボックスをオンにします。オンにすると、リモート ユーザー(エージェント)を選択するオプションが表示されます。

アクション

Ping

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

ユースケース

このアクションは、Google SecOps Content Hub ページの統合構成ページで接続性をテストするために使用されます。手動アクションとして実行でき、ハンドブックでは使用されません。

実行

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

アクションの結果

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

成功した場合: 「指定された接続パラメータを使用して Microsoft Sentinel ワークスペースに正常に接続されました!」と出力されます。

成功しなかった場合: 次の内容が出力されます。「Microsoft Sentinel ワークスペースへの接続に失敗しました。Error is {0}".format(exception.stacktrace) を出力します。

全般

インシデントを一覧表示する

指定された検索条件に基づいて Microsoft Sentinel インシデントを一覧表示します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
期間 Integer 3 いいえ インシデントを取得する期間を時間で指定します。
ステータス 文字列 新規、アクティブ、クローズ いいえ 検索するインシデントのステータスを指定します。パラメータは、カンマ区切りの文字列として複数の値を受け入れます。
重大度 文字列 情報、低、中、高 いいえ 検索するインシデントの重大度を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
取得するインシデントの数 Integer 200 いいえ 取得するインシデントの数。デフォルトでは、最新の 200 件のインシデントが返されます。

ユースケース

このアクションを使用すると、Google SecOps のハンドブックから Microsoft Sentinel のインシデントを一覧表示できます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "value": [
        {
            "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/323032be-5b0d-4661-944f-ff9557597e50",
            "name": "323032be-5b0d-4661-944f-ff9557597e50",
            "etag": "\"2100e65a-0000-0d00-0000-5de3b1bf0000\"",
            "type": "Microsoft.SecurityInsights/Cases",
            "properties": {
                "title": "Suspicious process injection observed",
                "description": "A process abnormally injected code into another process, As a result, unexpected code may be running in the target process memory. Injection is often used to hide malicious code execution within a trusted process. \nAs a result, the target process may exhibit abnormal behaviors such as opening a listening port or connecting to a command and control server.",
                "severity": "Medium",
                "status": "New",
                "labels": ["add_tag"],
                "endTimeUtc": "2019-11-29T03:42:05Z",
                "startTimeUtc": "2019-11-29T03:42:05Z",
                "owner": {
                    "objectId": null
                },
                "lastUpdatedTimeUtc": "2019-12-01T12:27:43Z",
                "createdTimeUtc": "2019-11-29T07:13:32.0266519Z",
                "relatedAlertIds": ["2462474c-b6d9-6937-17ee-c2a62671c2f8"],
                "relatedAlertProductNames": ["Microsoft Defender Advanced Threat Protection"],
                "caseNumber": 2276,
                "totalComments": 0,
                "metrics": {
                    "SecurityAlert": 1
                },
                "firstAlertTimeGenerated": "2019-11-29T07:13:31.961602Z",
                "lastAlertTimeGenerated": "2019-11-29T07:13:31.961602Z"
            }
        },{
            "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/c7939be8-32fb-415c-9f7c-c13325d6c48b",
            "name": "c7939be8-32fb-415c-9f7c-c13325d6c48b",
            "etag": "\"1900f5e2-0000-0d00-0000-5de0c5110000\"",
            "type": "Microsoft.SecurityInsights/Cases",
            "properties": {
                "title": "Suspicious Power Shell command line",
                "description": "A suspicious PowerShell activity was observed on the machine. \nThis behavior may indicate that PowerShell was used during installation, exploration, or in some cases in lateral movement activities which are used by attackers to invoke modules, download external payloads, or get more information about the system. Attackers usually use PowerShell to bypass security protection mechanisms by executing their payload in memory without touching the disk and leaving any trace.\r\nOur algorithms found the behaviors of this process to be suspicious due to the following factors:\nSuspicious memory activity\nExecutes suspicious PowerShell commands",
                "severity": "Medium",
                "status": "New",
                "labels": [],
                "endTimeUtc": "2019-11-29T03:42:04.9552017Z",
                "startTimeUtc": "2019-11-29T03:42:04.9552017Z",
                "owner": {
                    "objectId": null
                },
                "lastUpdatedTimeUtc": "2019-11-29T07:13:21Z",
                "createdTimeUtc": "2019-11-29T07:13:21.6858164Z",
                "relatedAlertIds": [
                    "d053f17e-6153-d171-9f4d-82389442aa35"
                ],
                "relatedAlertProductNames": [
                    "Microsoft Defender Advanced Threat Protection"
                ],
                "caseNumber": 2275,
                "totalComments": 0,
                "metrics": {
                    "SecurityAlert": 1
                },
                "firstAlertTimeGenerated": "2019-11-29T07:13:21.5885314Z",
                "lastAlertTimeGenerated": "2019-11-29T07:13:21.5885314Z"
            }
        }
    ],
    "nextLink": "https://management.azure.com:443/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases?api-version=2019-01-01-preview&$skipToken=H4sIAAAAAAAEAE1VTVMiSxD8MR45LIstukbsIbvnqxmGcRgR2xsiFqA44soiHt5vf1nzfOwaQUg31fWRlVnVGfvo8p-Jf5jhavBejW1_jQvon5OfP0_G15ffT67H7rLX7fIQXQ4P64vB583efZqXUSo7zGaRvS4-inWzK9Z-V3ze3RSfxfko8ufFdfy7jIpu8Snd8vkXTnx9c9k78XF52T87O-2fJFdXlxCZfMUDItN-zflJ2m9o-EmRx13Efi52cvw9Fnf2LBmvkW0-aBJwK8kUSYPp0R88pm_m9s-5gg2uKx9y9PMMu1yuOqgNaklrOGPfBDtMAu4FfawNZpJ2EDXWChZYGCwl2iBt7EpQovKARD1k3pb6u_Vqt4ELdqy_nw7mhSQ7pN5e6RnGbQQ9PDUYSNpHEnAjaQzUtiM2x71HLoMNoXCVoMZMz4wHg6FkueaXCrZYBHiJWYG3tEuRVke8Dog69ccs9uJ2wNxaJJ55OsASmmDvBB3F7VaQoarQ0XzjyiKOe4gDluo0laO_HN752wa_5a6-Ow3x_R88BYU_yOt7b1B6PPyN-_Ps6fHv8_ez7vLv876R1fFs2fftaLqsFjgPUV9GNevPzqRc4D1EvyXvYGPYN2yHfv9_XnYBt7A77ddgh-fgSin6tM_mEh3sqcFaHrb4HqI7sStrGvcm-RafjTMy7GHl7d262WDR2B-Sl9g27pcMD3gI2TfGsYx_LqMF3kJUSdnjO2QyP-DdR5EMd1gaPB3zT0E_5Uz9PjXsc1TiNtieDDroBdr73AafXMg0tXUTL-Wxr_cdGfUYN5qITzEPvXu51fjOyjDFKkSPks6Ytw1S9e0oJE4ea4xDZsgje9bikdqdd-eS7zA49p_0Sxb-1KdP4nd4CW4pfoVNg0TmM-JD-0GNZXAHGXbw4l0jWY1n40T9rIx7krRXLrwbiZ_ixdAuW9A-Wio-pyZKJT_gYNyH5n0d0ldJOuxnJFLMGMd2xYWjvgbChG5XSWPcWP3Q316GW5SGOEe5fQxJLVXqbkzcl3pnfcjexP3R5w9KvfkgPw3GcLHyc6p-Jh5d1ZElXwUrXDX4IW6hI8SL7ek82JIHuDKq4xWyVrf6X_WZwXueaVc2eBe3Jf8hjufU41yiVOPYPa9UD3oeNvgU6sex7-JKeMN41OWQI-br_lTiKUaN6qqGb_W9UOndq95co_lu4APIx43ml4lVnmMjrsbIMB5lmhvOA94XBhOxrBfVs7gp-45X9RMFjj47o36t0zmVCGXrVVH4T5AxgmAILdDZVOfUTmTl8yM_CNLryj4aFzSfNGgczolf0FkQZ4orpcU4HIZWtVqJc_qSw3elcWDhUATOI-LP_DPBTOvjHDogC4j2joOWqei7rFGdMNv2HVxpiBftaB8RX1bIy2SF2qOnOHLOpWKd4hjEliyWzxolAeMRp0x5gIHmfa15JgbcC6nyICiuxOmpzXdOXPh-oPOSc5D2Y62F9U2UF8OAR84FjRfpPGU_K-0reVBVbqV822nfuU_4Tir2s5R4q3lM27447gX6rwxG4gqlJhQh8uWXuI32nfypHPMrxXW03y-ijPb8nXhfeRjtq9V-sq_s00RxoX2u8xzKD3fQep-Ur2xFrf1ivE_pLLJXk1SSpyga9bsD56KNW9nJN9UBeeR4pa2qFNdE9wd5ETOBmPyhXu7b-i-YpDYV1VL3j2_76cA7r3WQ13eKD_F0MXk58Lj6wtdXxD1S3nP_MQ-397E2vmr3o2e-xIlbhfEP2s_f4mbah1jrJL573a_EdSRc2eTDWnXoW35wL7X17rT-i5YXc8ut1Oqzrzrm3nRfOA0Vp6TlH3kvvrUbNHhWnCOv_c25l6lL8iXlnod6t1i1um9QtHwMzIP99OrHFvTrFBTV1rnyKt4zb8VJ9cX6klYPFR2pJJzydy12q3ik6geqa-ojbeeItbTnHnfUVfXzX2qVoX91CQAA"
}
ケースウォール
結果のタイプ 値/ 説明 種類
出力メッセージ*

成功してデータを取得した場合: 「Successfully returned Microsoft Sentinel incidents」を出力します。

何も見つからなかった場合: 「アクションでインシデントが見つかりませんでした」と出力します。

エラーの場合: 「Microsoft Sentinel インシデントを一覧表示できませんでした!Error is {0}".format(exception.stacktrace) を出力します。

一般
テーブル

表のタイトル: 検出された Microsoft Sentinel インシデント:

列: インシデント番号、インシデント ID、タイトル、説明、重大度、ステータス、ラベル、担当者、アラート商品名、作成時間、最終更新時間

全般
添付ファイル List_Incidents.json - には、returned by the action の技術的な JSON データが含まれます。 全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

インシデントの詳細を更新する

Microsoft Sentinel インシデントを更新します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
インシデント ケース番号 Integer なし ○ 更新する Azure Sentinel インシデント番号を指定します。
タイトル 文字列 なし いいえ Azure Sentinel インシデントの新しいタイトルを指定します。
重大度 DDL

未更新(有効な値: 未更新、情報、低、中、高)

いいえ Azure Sentinel インシデントの新しい重大度を指定します。
説明 文字列 なし いいえ Azure Sentinel インシデントの新しい説明を指定します。
割り当て先 文字列 なし いいえ インシデントを割り当てるユーザーを指定します。
ステータス DDL 未更新(指定可能な値: 未更新、新規、アクティブ、クローズ) いいえ Azure Sentinel インシデントの新しいステータスを指定します。
クローズの理由 DDL

未更新(有効な値:
未更新、真陽性 - 不審なアクティビティ、良性陽性 - 不審だが想定内、
偽陽性 - 誤ったアラート ロジック、偽陽性 - 不正確なデータ、未確定)

いいえ インシデントのステータスが [Closed] に設定されている場合は、インシデントの [Closed Reason] を指定します。
結びのコメント 文字列 なし いいえ クローズされた Azure Sentinel インシデントに提供するオプションのクローズ コメント。
再試行の回数 Integer 1 ○ インシデントの更新が失敗した場合にアクションが再試行する回数を指定します。
再試行間隔 Integer 20 ○ インシデント更新の再試行の間にアクションが待機する期間を指定します。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから Microsoft Sentinel インシデントを更新できます。これは、Microsoft Sentinel インシデントの分析を含むワークフローの結果アクションとして使用できます。インシデントが Google SecOps で処理されると、インシデントを更新してインシデントの分析の進行状況を示すことができます(assignedTo の設定、ステータスを inProgress に設定するなど)。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果

リクエスト 2 の JSON 結果が返されます。これには、更新されたインシデントの詳細が含まれます。

{
  "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/9e5c0afc-b7a6-4eac-8164-9242ad710a66",
  "name": "9e5c0afc-b7a6-4eac-8164-9242ad710a66",
  "etag": "\"12002b5c-0000-0d00-0000-5dde83730000\"",
  "type": "Microsoft.SecurityInsights/Cases",
  "properties": {
      "title": "Activity from a Tor IP address",
      "description": "A failed sign in was detected from a Tor IP addressThe Tor IP address 203.0.113.200 was used by Example User - Test User Spec (user@example.com).",
      "severity": "Informational",
      "status": "InProgress",
      "assignedTo": "test@example.com",
      "labels": [],
      "closeReason": "Resolved",
      "endTimeUtc": "2019-11-27T01:56:03.4651258Z",
      "startTimeUtc": "2019-11-27T01:56:03.4651258Z",
      "owner": {
          "objectId": null,
          "email": "test@example.com"
      },
      "lastUpdatedTimeUtc": "2019-11-27T14:08:51Z",
      "createdTimeUtc": "2019-11-27T05:01:11.1139394Z",
      "relatedAlertIds": [
          "2a96343c-e551-4529-96f1-18d6f734470d"
      ],
      "relatedAlertProductNames": [
          "Azure Sentinel"
      ],
      "caseNumber": 2274,
      "totalComments": 0,
      "metrics": {
          "SecurityAlert": 1
      },
      "firstAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z",
      "lastAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z"
  }
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: 「Microsoft Sentinel インシデント {0} が正常に更新されました」と出力されます。format(IncidentID).

指定されたインシデント ケース番号でインシデントが見つからない場合: 「ケース番号 {0} の Microsoft Sentinel インシデントが見つかりませんでした」と出力されます。format(incident_case_number).

エラーの場合: 「Microsoft Sentinel インシデントを更新できませんでした。Error is {0}".format(exception.stacktrace) を出力します。

全般

インシデント ラベルを更新する

特定の Microsoft Sentinel インシデントのラベルを更新します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
インシデント ケース番号 Integer 2273 ○ 新しいラベルで更新する Azure Sentinel インシデント番号を指定します。
ラベル 文字列 malware ○ インシデントに追加する新しいラベルを指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
再試行の回数 Integer 1 ○ インシデントの更新が失敗した場合にアクションが再試行する回数を指定します。
再試行間隔 Integer 20 ○ インシデント更新の再試行の間にアクションが待機する期間を指定します。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから Microsoft Sentinel インシデント ラベルを更新できます。ユーザーは、このアクションを使用して、必要に応じて特定のインシデントに特定のタグ(ラベル)を割り当てることができます。たとえば、特定のホストがこのインシデントの一部である場合は、特定のラベルが必要です。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果

リクエスト 2 の JSON の結果が返され、更新されたインシデントの詳細が含まれます。

{
  "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Cases/9e5c0afc-b7a6-4eac-8164-9242ad710a66",
  "name": "9e5c0afc-b7a6-4eac-8164-9242ad710a66",
  "etag": "\"12002b5c-0000-0d00-0000-5dde83730000\"",
  "type": "Microsoft.SecurityInsights/Cases",
  "properties": {
      "title": "Activity from a Tor IP address",
      "severity": "Informational",
      "status": "InProgress",
      "labels": [
 "malware",
 "trojan"
   ],
      "endTimeUtc": "2019-11-27T01:56:03.4651258Z",
      "startTimeUtc": "2019-11-27T01:56:03.4651258Z",
      "owner": {
          "objectId": null,
      },
      "lastUpdatedTimeUtc": "2019-11-27T14:08:51Z",
      "createdTimeUtc": "2019-11-27T05:01:11.1139394Z",
      "relatedAlertIds": [
          "2a96343c-e551-4529-96f1-18d6f734470d"
      ],
      "relatedAlertProductNames": [
          "Azure Sentinel"
      ],
      "caseNumber": 2274,
      "totalComments": 0,
      "metrics": {
          "SecurityAlert": 1
      },
      "firstAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z",
      "lastAlertTimeGenerated": "2019-11-27T05:01:10.2574659Z"
  }
}
ケースウォール
結果のタイプ 値/ 説明 種類
出力メッセージ*

成功した場合: 「Microsoft Sentinel インシデント {0} を次のラベルで正常に更新しました: {1}」.format(IncidentID, [labels_list]).

指定されたインシデント ケース番号でインシデントが見つからない場合: "Microsoft Sentinel incident with case number {0} was not found!".format(incident_case_number).

ユーザーがインシデントにすでに存在するラベルを指定した場合(isSuccess=False): 「次のラベルはすでに存在するため、インシデント {0} の Microsoft Sentinel ラベルに追加されませんでした: {1}」.format(IncidentID, [labels_list])

エラーの場合: 「Microsoft Sentinel インシデント ラベルを更新できませんでした。Error is {0}".format(exception.stacktrace) を出力します。

全般

インシデントの統計情報を取得する

Azure Sentinel インシデントの統計情報を取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
期間 Integer 3 いいえ 統計情報を表示する期間を指定します。

ユースケース

このアクションは、Microsoft Sentinel イベントの Google SecOps Playbook レポートを表示するために使用できます。このアクションは、ユーザーが Microsoft Sentinel のアラームを操作するハンドブックの一部を形成します。たとえば、警告が処理されて削除されたときに作成されたアラームを操作する場合、このアクションを実装して、[lessons learned] ページで Microsoft Sentinel インシデントの結果を表示できます。

逆に、Windows Sentinel アプリを使用する代わりに、Google SecOps に留まるユーザーのインターフェース メソッドにすることもできます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Aggregations/Cases",
    "name": "Cases",
    "type": "Microsoft.SecurityInsights/Aggregations",
    "kind": "CasesAggregation",
    "properties": {
        "aggregationBySeverity": {
            "totalCriticalSeverity": 1,
            "totalHighSeverity": 2,
            "totalMediumSeverity": 554,
            "totalLowSeverity": 1714,
            "totalInformationalSeverity": 1
        },
        "aggregationByStatus": {
            "totalNewStatus": 2268,
            "totalInProgressStatus": 4,
            "totalResolvedStatus": 1,
            "totalDismissedStatus": 0,
            "totalTruePositiveStatus": 2,
            "totalFalsePositiveStatus": 1
        }
    }
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功してデータを取得した場合: 「Microsoft Sentinel インシデント統計情報を正常に返しました」と出力されます。

エラーの場合: 「Microsoft Sentinel インシデントの統計情報を取得できませんでした。Error is {0}".format(exception.stacktrace) を出力します。

全般
表 1

テーブルのタイトル: Microsoft Sentinel インシデントの統計情報(重大度別):

列: 重大(totalCriticalSeverity にマッピング)、高(totalHighSeverity にマッピング)、中(totalMediumSeverity にマッピング)、低(totalLowSeverity にマッピング)、情報(totalInformationalSeverity にマッピング)

全般
表 2

テーブルのタイトル: ステータス別の Microsoft Sentinel インシデントの統計情報:

列: New(totalNewStatus にマッピング)、InProgress(totalInProgressStatus にマッピング)、Resolved(totalResolvedStatus にマッピング)、Dismissed(totalDismissedStatus にマッピング)、TruePositive(totalTruePositiveStatus にマッピング)、

FalsePositive(totaFalsePositiveStatus にマッピング)

全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

アラートルールを一覧表示する

Azure Sentinel のスケジュール設定されたルールの一覧を取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
アラートルールの重大度 文字列 情報、低、中、高、重大 いいえ 検索するアラートルールの重大度を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。
特定のアラートルール タイプを取得する 文字列 なし いいえ

アクションが返すアラートタイプを指定します。パラメータは、カンマ区切りの文字列として複数の値を受け入れます。

値が指定されていない場合は、考えられるすべてのアラートタイプを返します。

特定のアラートルールの戦術を取得する 文字列 なし いいえ

アラートルールの戦術アクションが返す内容を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

値が指定されていない場合は、考えられるすべてのアラートタイプを返します。

有効なアラートルールのみを取得しますか? チェックボックス オフ いいえ アクションで有効なアラートルールのみを返すかどうかを指定します。
返されるルールの最大数 Integer なし いいえ アクションが返すスケジュールされたアラートルールの数(例: 50)。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから Microsoft Sentinel アラートルールを一覧表示できます。アラートルールを一覧表示して、環境内で疑わしい脅威と異常の種類ごとにアラートルールが用意されていることを確認できます。一部の状況が適切に処理されていないことがわかった場合は、既存のアラートルールをすぐに更新するか、新しいアラートルールを作成できます。Microsoft Sentinel のアラートルールにより、脅威のトリアージ、調査、修復をすぐに行えるように、通知がすぐに届きます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "value": [
        {
            "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/alertRules/4bdce24d-7837-4f02-9f7a-10824f376517",
            "name": "4bdce24d-7837-4f02-9f7a-10824f376517",
            "etag": "\"00002f05-0000-0d00-0000-5d9db9970000\"",
            "type": "Microsoft.SecurityInsights/alertRules",
            "kind": "MicrosoftSecurityIncidentCreation",
            "properties": {
                "productFilter": "Azure Active Directory Identity Protection",
                "severitiesFilter": null,
                "displayNamesFilter": null,
                "displayName": "Create incidents based on Azure Active Directory Identity Protection alerts",
                "enabled": true,
                "description": "Create incidents based on all alerts generated in Azure Active Directory Identity Protection",
                "tactics": null,
                "alertRuleTemplateName": "532c1811-79ee-4d9f-8d4d-6304c840daa1",
                "lastModifiedUtc": "2019-10-09T10:42:31.5264376Z"
            }
        },
        {
            "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/alertRules/540f68c9-9397-49c7-8953-8efce08d6e62",
            "name": "540f68c9-9397-49c7-8953-8efce08d6e62",
            "etag": "\"00003105-0000-0d00-0000-5d9db9ad0000\"",
            "type": "Microsoft.SecurityInsights/alertRules",
            "kind": "MicrosoftSecurityIncidentCreation",
            "properties": {
                "productFilter": "Azure Security Center",
                "severitiesFilter": null,
                "displayNamesFilter": null,
                "displayName": "Create incidents based on Azure Security Center alerts",
                "enabled": true,
                "description": "Create incidents based on all alerts generated in Azure Security Center",
                "tactics": null,
                "alertRuleTemplateName": "90586451-7ba8-4c1e-9904-7d1b7c3cc4d6",
                "lastModifiedUtc": "2019-10-09T10:42:53.9014288Z"
            }
        }
    ]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: 「構成された Microsoft Sentinel アラートルールが正常に一覧表示されました」と出力されます。

エラーの場合: 「Microsoft Sentinel アラートルールを一覧表示できませんでした。Error is {0}".format(exception.stacktrace) を出力します。

全般
テーブル

テーブルのタイトル: 検出された Microsoft Sentinel アラートルール:

列: AlertID(name にマッピング)、Name(displayName にマッピング)、Enabled、Description、Tactics、Last Modification Time(lastModificationUtc にマッピング)

全般
添付ファイル List_AlertRules.json - には、returned by the action の技術的な JSON データが含まれます。 全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

アラートルールの詳細を取得する

Azure Sentinel のスケジュールされたアラートルールの詳細を取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
AlertRuleID 文字列 なし ○ アラートルールの ID を指定します。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから Microsoft Sentinel アラートルールの詳細を取得できます。たとえば、一部のアラートの頻度が高くなり、そのほとんどが誤検知である場合や、1 つのアラートルールで処理する状況が多すぎるため、脅威を特定しやすくするためにそれらを分離する場合は、このアクションを使用してアラートルールの構成を適切に把握できます。アラートルールの結果に基づいて、更新、削除、変更なしのいずれかを選択できます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/alertRules/8dce4dbd-0ba6-4c93-943a-8da49f7d0aa4",
    "name": "8dce4dbd-0ba6-4c93-943a-8da49f7d0aa4",
    "etag": "\"0200c767-0000-0d00-0000-5ddf3b160000\"",
    "type": "Microsoft.SecurityInsights/alertRules",
    "kind": "Scheduled",
    "properties": {
        "severity": "High",
        "query": "SecurityEvent\r\n| where Activity startswith \"4625\"\r\n| summarize count() by IpAddress, Computer\r\n| where count_ >3\r\n| extend HostCustomEntity = Computer\r\n| extend IPCustomEntity = IpAddress",
        "queryFrequency": "PT1H",
        "queryPeriod": "P5D",
        "triggerOperator": "GreaterThan",
        "triggerThreshold": 0,
        "suppressionDuration": "PT5H",
        "suppressionEnabled": false,
        "displayName": "Multiple failed login attempts from the same IP",
        "enabled": false,
        "description": "",
        "tactics": [
            "InitialAccess"
        ],
        "alertRuleTemplateName": null,
        "lastModifiedUtc": "2019-11-28T03:12:21.9276927Z"
    }
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功してデータを取得した場合: print "Successfully returned Microsoft Sentinel アラートルール {0} details".format(AlertRuleID).

指定された AlertID でアラートルールが見つからない場合: 「Microsoft Sentinel alert rule with ID "{0}" was not found!」と出力します。format(AlertRuleID).

エラーの場合: 「Microsoft Sentinel アラートルールの詳細を取得できませんでした。Error is {0}".format(exception.stacktrace) を出力します。

一般
テーブル

テーブルのタイトル: Microsoft Sentinel アラートルールの詳細:

列: AlertID(name にマッピング)、Name(displayName にマッピング)、Enabled、Description、Query、Frequency(queryFrequency にマッピング)、Period of Lookup data(queryPeriod にマッピング)、Trigger(triggerOperator と triggerThreshold の組み合わせとしてマッピング)、Tactics、Enable Suppression(suppressionEnabled としてマッピング)、Suppression Duration(suppressionDuration としてマッピング)、Last Modification Time(lastModificationUtc にマッピング)

全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

アラートルールを作成

Azure Sentinel のスケジュール設定されたアラートルールを作成します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
アラートルールを有効にする DDL なし ○ このアラートルールを無効にするか有効にするかを指定します。
名前 文字列 なし ○ アラートルールの表示名を指定します。
重大度 DDL なし ○ このアラートルールの重大度を指定します。
クエリ 文字列 なし ○

このアラートルールのクエリを指定します。

頻度 文字列 なし ○

クエリを実行する頻度を、PT + 数値 +(M、H、D)の形式で指定します。

ここで、M は分、H は時間、D は日です。

最小値は 5 分、最大値は 14 日です。

ルックアップ データの期間 文字列 なし ○

最後のルックアップ データの時刻を指定します。形式は P + 数値 +(M、H、D)です。

ここで、M は分、H は時間、D は日です。最小値は 5 分、最大値は 14 日です。

トリガー オペレーター DDL なし ○ このアラートルールのトリガー演算子を指定します。
トリガーしきい値 Integer なし ○ このアラートルールのトリガーしきい値を指定します。
抑制を有効にする DDL なし ○ アラートの生成後にクエリの実行を停止するかどうかを指定します。
抑制期間 文字列 なし ○

アラートが生成された後にクエリの実行を停止する期間を指定します。次の形式を使用します。PT + 数値 +(M、H、D)

ここで、M は分、H は時間、D は日です。

例:

P1M - 1 分

P10H - 10 時間

P2D - 2 日。

最小値は 5 分、最大値は 14 日です。

説明 文字列 なし いいえ このアラートルールの説明を指定します。
戦術 文字列 なし いいえ

このアラートルールの戦術を指定します。

パラメータには、カンマ区切り値の複数の値を指定できます。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから Microsoft Sentinel アラートルールを作成できます。カスタム アラートルールを作成すると、環境内で疑わしい脅威や異常の種類を検索できます。Microsoft Sentinel のアラートルールにより、脅威のトリアージ、調査、修正をすぐに行えるように、通知がすぐに送信されます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False

ケースウォール

結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: 「Microsoft Sentinel アラートルールが正常に作成されました」と出力されます。

エラーの場合: 「Microsoft Sentinel アラートルールの作成に失敗しました!Error is {0}".format(exception.stacktrace) を出力します。

全般

アラートルールを更新

Azure Sentinel のスケジュールされたアラートルールを更新します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
AlertRuleID 文字列 なし ○ アラートルールの AlertRuleID を指定します。
名前 文字列 なし いいえ アラートルールの表示名を指定します。
アラートルールを有効にする DDL なし いいえ このアラートルールを無効にするか有効にするかを指定します。
重大度 DDL なし いいえ このアラートルールの重大度を指定します。
クエリ 文字列 なし いいえ このアラートルールのクエリを指定します。
頻度 文字列 なし いいえ

クエリを実行する頻度を、PT + 数値 +(M、H、D)の形式で指定します。

ここで、M は分、H は時間、D は日です。例:

PT1M - 1 分ごとにクエリを実行

PT10H - 10 時間ごとにクエリを実行

PT2D - 2 日ごとにクエリを実行します。

最小値は 5 分、最大値は 14 日です。

ルックアップ データの期間 文字列 なし いいえ

最後のルックアップ データの時刻を指定します。形式は P + 数値 +(M、H、D)です。

ここで、M は分、H は時間、D は日です。.

例:

P1M - 1 分

P10H - 10 時間

P2D - 2 日。

最小値は 5 分、最大値は 14 日です。

トリガー オペレーター DDL なし いいえ このアラートルールのトリガー演算子を指定します。
トリガーしきい値 Integer なし いいえ このアラートルールのトリガーしきい値を指定します。
抑制を有効にする DDL なし いいえ アラートの生成後にクエリの実行を停止するかどうかを指定します。
抑制期間 文字列 なし いいえ

アラートが生成された後にクエリの実行を停止する期間を指定します。次の形式を使用します。PT + 数値 +(M、H、D)

ここで、M は分、H は時間、D は日です。

例:

P1M - 1 分

P10H - 10 時間

P2D - 2 日。

最小値は 5 分、最大値は 14 日です。

説明 文字列 なし いいえ このアラートルールの説明を指定します。
戦術 文字列 なし いいえ

このアラートルールの戦術を指定します。

パラメータには、カンマ区切り値の複数の値を指定できます。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから Microsoft Sentinel アラートルールを更新できます。たとえば、一部のアラートの頻度が高くなり、そのほとんどが誤検出である場合は、このアクションを使用して、ニーズと要望に合わせてアラートルールの構成を更新できます。Microsoft Sentinel のアラートルールにより、脅威のトリアージ、調査、修正をすぐに行えるように、通知がすぐに送信されます。

実行

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

アクションの結果

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

成功した場合: 「Successfully updated Microsoft Sentinel アラートルール with ID {0}」を出力します。format(AlertRuleID).

指定された AlertID でアラートルールが見つからない場合: 「Microsoft Sentinel alert rule with ID "{0}" was not found!」を出力します。format(AlertRuleID).

エラーの場合: 「Microsoft Sentinel アラートルールの更新に失敗しました!エラー: {0}」.format(exception.stacktrace)

全般

アラートルールを削除

Azure Sentinel のスケジュールされたアラートルールを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
AlertRuleID 文字列 なし ○ 削除するアラートルールの ID を指定します。

ユースケース

このアクションを使用すると、Google SecOps から Microsoft Sentinel アラートルールを削除できます。アラートルールが非常に古く、目的を果たしていない場合や、ルールで誤検出のみが作成される場合は、このアクションで削除できます。

実行

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

アクションの結果

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

成功した場合: 「Successfully deleted Microsoft Sentinel アラートルール {0}」を出力します。format(AlertRuleID).

指定された AlertID でアラートルールが見つからない場合: 「Microsoft Sentinel alert rule with ID "{0}" was not found!」と出力します。format(AlertRuleID).

エラーの場合: 「Microsoft Sentinel アラートルールの削除に失敗しました!エラー: {0}」.format(exception.stacktrace)

全般

カスタム ハンティング ルールを一覧表示する

Azure Sentinel のカスタム ハンティング ルールのリストを取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
返されるハンティング ルール名 文字列 なし いいえ

アクションが返すハンティング ルールの名前を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

値が指定されていない場合は、考えられるすべてのアラートタイプを返します。

特定のハンティング ルールの戦術を取得する 文字列 なし いいえ

ハンティング ルールの戦術アクションが返す内容を指定します。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

値が指定されていない場合は、考えられるすべてのアラートタイプを返します。

返されるルールの最大数 Integer なし いいえ アクションが返すスケジュールされたアラートルールの数(例: 50)。

ユースケース

このアクションを使用すると、Microsoft Sentinel 用の Google SecOps ハンドブックのカスタム ハンティング ルールとお気に入りのハンティング ルールを一覧表示できます。ネットワーク上で動作する、最もまれではあるものの非常に重要なプロセスに関するデータに対して、すべてのハンティング ルールを確立していることを確認するには、カスタム ハンティング ルールと優先ハンティング ルールについて言及する必要があります。一部の状況が正しく処理されていないことが判明した場合は、既存のハンティング ルールをすぐに更新して作成できます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "__metadata": {},
    "value": [
        {
            "id": "subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/savedSearches/0c5bd7e1-0e13-4e7d-9e32-88baf9589192",
            "etag": "W/\"datetime'2019-12-02T10%3A14%3A10.5299491Z'\"",
            "properties": {
                "Category": "Hunting Queries",
                "DisplayName": "Hunting Query 1",
                "Query": "\r\nlet timeframe = 7d;\r\nAWSCloudTrail\r\n| where TimeGenerated >= ago(timeframe)\r\n| where  EventName in~ (\"AttachGroupPolicy\", \"AttachRolePolicy\", \"AttachUserPolicy\", \"CreatePolicy\",\r\n\"DeleteGroupPolicy\", \"DeletePolicy\", \"DeleteRolePolicy\", \"DeleteUserPolicy\", \"DetachGroupPolicy\",\r\n\"PutUserPolicy\", \"PutGroupPolicy\", \"CreatePolicyVersion\", \"DeletePolicyVersion\", \"DetachRolePolicy\", \"CreatePolicy\")\r\n| project TimeGenerated, EventName, EventTypeName, UserIdentityAccountId, UserIdentityPrincipalid, UserAgent, \r\nUserIdentityUserName, SessionMfaAuthenticated, SourceIpAddress, AWSRegion, EventSource, AdditionalEventData, ResponseElements\r\n| extend timestamp = TimeGenerated, IPCustomEntity = SourceIpAddress, AccountCustomEntity = UserIdentityAccountId\r\n",
                "Tags": [
                    {
                        "Name": "description",
                        "Value": "1234"
                    },
                    {
                        "Name": "tactics",
                        "Value": "DefenseEvasion"
                    },
                    {
                        "Name": "createdTimeUtc",
                        "Value": "12/02/2019 09:21:18"
                    }
                ],
                "Version": 2
            },
            "name": "0c5bd7e1-0e13-4e7d-9e32-88baf9589192"
        },
        {
            "id": "subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/savedSearches/30a94796-a573-4e6e-9385-fb96d0aa5ea2",
            "etag": "W/\"datetime'2019-12-02T10%3A10%3A18.4761379Z'\"",
            "properties": {
                "Category": "Hunting Queries",
                "DisplayName": "Hunting Query 1",
                "Query": "\r\nlet timeframe = 7d;\r\nAWSCloudTrail\r\n| where TimeGenerated >= ago(timeframe)\r\n| where  EventName in~ (\"AttachGroupPolicy\", \"AttachRolePolicy\", \"AttachUserPolicy\", \"CreatePolicy\",\r\n\"DeleteGroupPolicy\", \"DeletePolicy\", \"DeleteRolePolicy\", \"DeleteUserPolicy\", \"DetachGroupPolicy\",\r\n\"PutUserPolicy\", \"PutGroupPolicy\", \"CreatePolicyVersion\", \"DeletePolicyVersion\", \"DetachRolePolicy\", \"CreatePolicy\")\r\n| project TimeGenerated, EventName, EventTypeName, UserIdentityAccountId, UserIdentityPrincipalid, UserAgent, \r\nUserIdentityUserName, SessionMfaAuthenticated, SourceIpAddress, AWSRegion, EventSource, AdditionalEventData, ResponseElements\r\n| extend timestamp = TimeGenerated, IPCustomEntity = SourceIpAddress, AccountCustomEntity = UserIdentityAccountId\r\n",
                "Tags": [
                    {
                        "Name": "description",
                        "Value": "1234"
                    },
                    {
                        "Name": "tactics",
                        "Value": "DefenseEvasion"
                    },
                    {
                        "Name": "createdTimeUtc",
                        "Value": "12/02/2019 09:21:18"
                    }
                ],
                "Version": 2
            },
            "name": "30a94796-a573-4e6e-9385-fb96d0aa5ea2"
        }
    ]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: 「Successfully returned Microsoft Sentinel hunting rules」を出力します。

エラーの場合: 「Microsoft Sentinel のハンティング ルールを一覧表示できませんでした。Error is {0}".format(exception.stacktrace) を出力します。

全般
テーブル

テーブルのタイトル: 見つかった Microsoft Sentinel ハンティング ルール:

列: HuntingRuleID(name にマッピング)、title(displayName にマッピング)、category、description(tags dict の description パラメータにマッピング)、tactics(tags dict の tactics パラメータにマッピング)、query、creation time(tags dict の CreatedTimeUtc パラメータにマッピング)

全般
添付ファイル List_HuntingRules.json - には、returned by the action の技術的な JSON データが含まれます。 全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

カスタム ハンティング ルールの詳細を取得する

Azure Sentinel のカスタム ハンティング ルールの詳細を取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
HuntingRuleID 文字列 なし ○ ハンティング ルールの ID を指定します。

ユースケース

Microsoft Sentinel の標準または推奨のハンティング ルールに関する情報には、Google SecOps ハンドブックを使用してアクセスできます。たとえば、分析に適していないハンティング ルールから受信した詳細が表示された場合や、ハンティング ルールが正しく構成されているかどうかを確認する場合に、このツールを使用します。結果に基づいて、編集、削除、または変更しないかどうかを評価します。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
   "id": "subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/savedSearches/30a94796-a573-4e6e-9385-fb96d0aa5ea2",
    "etag": "W/\"datetime'2019-12-02T10%3A14%3A10.5299491Z'\"",
    "properties": {
        "Category": "Log Management",
        "DisplayName": "Multiple Password Reset by user",
        "Query": "\nlet timeframe = 7d;\nAWSCloudTrail\n| where TimeGenerated >= ago(timeframe)\n| where  EventName in~ (\"AttachGroupPolicy\", \"AttachRolePolicy\", \"AttachUserPolicy\", \"CreatePolicy\",\n\"DeleteGroupPolicy\", \"DeletePolicy\", \"DeleteRolePolicy\", \"DeleteUserPolicy\", \"DetachGroupPolicy\",\n\"PutUserPolicy\", \"PutGroupPolicy\", \"CreatePolicyVersion\", \"DeletePolicyVersion\", \"DetachRolePolicy\", \"CreatePolicy\")\n| project TimeGenerated, EventName, EventTypeName, UserIdentityAccountId, UserIdentityPrincipalid, UserAgent, \nUserIdentityUserName, SessionMfaAuthenticated, SourceIpAddress, AWSRegion, EventSource, AdditionalEventData, ResponseElements\n| extend timestamp = TimeGenerated, IPCustomEntity = SourceIpAddress, AccountCustomEntity = UserIdentityAccountId\n",
        "Tags": [
            {
                "Name": "description",
                "Value": "Identity and Access Management (IAM) securely manages access to AWS services and resources."
            },
            {
                "Name": "tactics",
                "Value": "DefenseEvasion"
            },
            {
                "Name": "createdTimeUtc",
                "Value": "12/02/2019 09:21:18"
            }
        ],
        "Version": 2
    }
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: print "Successfully returned Microsoft Sentinel hunting rule {0} details".format(HuntingRuleID).

指定された AlertID でアラートルールが見つからない場合: 「ID "{0}" の Microsoft Sentinel ハンティング ルールが見つかりませんでした」を出力します。format(HuntingRuleID)。

エラーの場合: 「Microsoft Sentinel のハンティング ルールの詳細を取得できませんでした!Error is {0}".format(exception.stacktrace) を出力します。

一般
テーブル

テーブルのタイトル: Microsoft Sentinel ハンティング ルールの詳細:

列: HuntingRuleID(name にマッピング)、Name(displayName にマッピング)、Description、Query、Tactic、Creation TIme

全般
添付ファイル List_HuntingRules.json - には、returned by the action の技術的な JSON データが含まれます。 全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

カスタム ハンティング ルールの作成

Azure Sentinel のカスタム ハンティング ルールを作成します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
クエリ 文字列 なし ○ このハンティング ルールで実行するクエリを指定します。
表示名 文字列 なし ○ ハンティング ルールの表示名を指定します。
説明 文字列 なし いいえ ハンティング ルールの説明を指定します。
戦術 文字列 なし いいえ このハンティング ルールの戦術を指定します。このパラメータは、カンマ区切り値の複数の値を受け入れます。

ユースケース

このアクションを使用すると、Google SecOps ハンドブックから新しい Microsoft Sentinel ハンティング ルールを作成できます。たとえば、ハンティング ルールにはクエリが含まれています。このクエリは、インフラストラクチャで実行されている最も一般的でないプロセスに関するデータを提供できます。実行されるたびにアラートを受け取る必要はありません。完全に無害な場合もありますが、クエリを時々確認して、異常がないかどうかを確認することをおすすめします。つまり、ネットワーク環境からより多くの情報を収集するために使用できます。

実行

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

アクションの結果

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

成功した場合: 「Microsoft Sentinel ハンティング ルールが正常に作成されました」と出力されます。

エラーの場合: 「Microsoft Sentinel ハンティング ルールの作成に失敗しました!Error is {0}".format(exception.stacktrace) を出力します。

全般

カスタム ハンティング ルールを更新する

Azure Sentinel のカスタム ハンティング ルールを更新します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
HuntingRuleID 文字列 なし ○ ハンティング ルールの ID を指定します。
表示名 文字列 なし いいえ ハンティング ルールの表示名を指定します。
クエリ 文字列 なし いいえ このハンティング ルールで実行するクエリを指定します。
説明 文字列 なし いいえ 説明を指定します。
戦術 文字列 なし いいえ

このハンティング ルールの戦術を指定します。

このパラメータには、カンマ区切り値の複数の値を指定できます。

ユースケース

このアクションを使用すると、Google SecOps のハンドブックからカスタムの Microsoft Sentinel ハンティング ルールを更新できます。たとえば、ハンティング ルールが非常に古く、クエリや説明などの複数のパラメータを更新する場合は、このアクションを使用します。インシデントの調査では情報が重要であるため、関連する情報を表示するようにすべてのハンティング ルールを更新する必要があります。

実行

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

アクションの結果

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

成功した場合: print "Successfully updated Microsoft Sentinel hunting rule with ID {0}".format(HuntingRuleID).

指定された HuntingRuleID でハンティング ルールが見つからない場合: 「Microsoft Sentinel hunting rule with ID "{0}" was not found!」を出力します。format(HuntingRuleID).

エラーの場合: 「Microsoft Sentinel のハンティング ルールの更新に失敗しました!Error is {0}".format(exception.stacktrace) を出力します。

全般

カスタム ハンティング ルールを削除する

Azure Sentinel のカスタム ハンティング ルールを削除します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
HuntingRuleID 文字列 なし ○ 削除するハンティング ルールの ID を指定します。

ユースケース

このアクションを使用すると、Google SecOps からカスタム Microsoft Sentinel ハンティング ルールを削除できます。たとえば、ハンティング ルールが非常に古く、調査プロセスに必要ないと判断した場合は、削除することをおすすめします。

実行

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

アクションの結果

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

成功した場合: 「Successfully deleted Microsoft Sentinel hunting rule with ID {0}」を出力します。format(HuntingRuleID).

指定された HuntingRuleID でハンティング ルールが見つからない場合: 「Microsoft Sentinel hunting rule with ID "{0}" was not found!」を出力します。format(HuntingRuleID).

エラーの場合: 「Microsoft Sentinel のハンティング ルールを削除できませんでした!Error is {0}".format(exception.stacktrace) を出力します。

全般

カスタム ハンティング ルールを実行する

カスタムまたはお気に入りの Microsoft Sentinel ハンティング ルールを実行します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
HuntingRuleID 文字列 なし ○ ハンティング ルールの ID を指定します。
タイムアウト Integer なし いいえ Azure Sentinel ハンティング ルール API 呼び出しのタイムアウト値を指定するために使用されるパラメータ。

ユースケース

このアクションは、Google SecOps ハンドブックから Microsoft Sentinel ハンティング ルールを実行するために使用できます。ハンティング ルールクエリを実行すると、インフラストラクチャで実行されている最も一般的でないプロセスに関するデータが提供されます。実行されるたびにアラートを受け取る必要はありません。完全に無害な場合もありますが、クエリを時々確認して、異常がないかどうかを確認することをおすすめします。つまり、ネットワーク環境からより多くの情報を収集するために使用できます。これにより、調査担当者はインシデントに関するすべてのニュアンスを把握し、さらなる意思決定を行うことができます。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "tables": [
        {
            "name": "PrimaryResult",
            "columns": [
                {
                    "name": "timerange",
                    "type": "datetime"
                },
                {
                    "name": "AppDisplayName",
                    "type": "string"
                },
                {
                    "name": "UserPrincipalName",
                    "type": "string"
                },
                {
                    "name": "threeDayWindowLocationCount",
                    "type": "long"
                },
                {
                    "name": "locationList",
                    "type": "dynamic"
                },
                {
                    "name": "timestamp",
                    "type": "datetime"
                },
                {
                    "name": "AccountCustomEntity",
                    "type": "string"
                }
            ],
            "rows": [
                [
                    "2019-11-29T00:00:00Z",
                    "WindowsDefenderATP Portal",
                    "user@example.com",
                    2,
                    "[\"US/Florida/Miami;\",\"AM/Kotayk'/Abovyan;\"]",
                    "2019-11-29T00:00:00Z",
                    "user@example.com"
                ],
                [
                    "2019-12-02T00:00:00Z",
                    "WindowsDefenderATP Portal",
                    "user@example.com",
                    1,
                    "[\"US/Florida/Miami;\"]",
                    "2019-12-02T00:00:00Z",
                    "user@example.com"
                ],
                [
                    "2019-11-29T00:00:00Z",
                    "Azure Portal",
                    "example@example.com",
                    1,
                    "[\"UA/Kyiv Misto/Kyiv;\"]",
                    "2019-11-29T00:00:00Z",
                    "example@example.com"
                ],
                [
                    "2019-12-02T00:00:00Z",
                    "Azure Portal",
                    "example@example.com",
                    2,
                    "[\"UA/Kyiv Misto/Kyiv;\",\"UA/Kyivs'ka Oblast'/Boryspil';\"]",
                    "2019-12-02T00:00:00Z",
                    "example@example.com"
                ],
                [
                    "2019-11-29T00:00:00Z",
                    "Azure Portal",
                    "user@example.com",
                    1,
                    "[\"RU/Sverdlovskaya Oblast'/Yekaterinburg;\"]",
                    "2019-11-29T00:00:00Z",
                    "user@example.com"
                ],
                [
                    "2019-12-02T00:00:00Z",
                    "Azure Portal",
                    "user@example.com",
                    1,
                    "[\"RU/Sverdlovskaya Oblast'/Yekaterinburg;\"]",
                    "2019-12-02T00:00:00Z",
                    "user@example.com"
                ]
            ]
        }
    ]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: 「ハンティング ルールが正常に実行されました」と出力されます。

指定された HuntingRuleID でハンティング ルールが見つからない場合: 「Microsoft Sentinel hunting rule with ID "{0}" was not found!」を出力します。format(HuntingRuleID)

何も見つからなかった場合: 「ハンティング ルールは正常に実行されましたが、結果は返されませんでした」と出力します。

エラーの場合: 「次のエラーによりハンティング ルールが完了しませんでした: {0}」format(exception.stacktrace) を出力します。

タイムアウトの場合: 「タイムアウトによりハンティング ルールが完了しませんでした: {0}」format(exception.stacktrace) を出力します。

クエリ結果が切り捨てられた場合: 「Hunting rule results exceeded limits and were truncated, please rewrite your query!」を出力します。

全般
テーブル

テーブルのタイトル: Microsoft Sentinel ハンティング ルールの結果

列: クエリ結果に基づいて列を動的に生成します

全般
添付ファイル Run_Hunting_rule_{HuntingRuleID}_response.json - には、returned by the action の技術的な JSON データが含まれます。 全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

KQL クエリを実行する

指定されたアクション入力パラメータに基づいて Azure Sentinel KQL クエリを実行します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
KQL クエリ 文字列 なし ○ Azure Sentinel で実行する KQL クエリ。たとえば、Sentinel で利用可能なセキュリティ通知を取得するには、クエリは「SecurityAlert」になります。他のアクション入力パラメータ(期間、上限)を使用して、クエリ結果をフィルタします。KQL クエリの例については、Sentinel の「ログ」ウェブページをご覧ください。
期間 文字列 なし いいえ

検索する期間を指定します。時刻値は ISO 8601 に準拠している必要があります。たとえば、過去 10 時間の検索や、検索する時間間隔を指定するために使用できます。PT + 数値 +(M、H、D)の形式を使用します。

ここで、M は分、H は時間、D は日です。

クエリのタイムアウト Integer 180 いいえ Azure Sentinel ハンティング ルール API 呼び出しのタイムアウト値。このパラメータに応じて、Google SecOps アクションの Python プロセスのタイムアウトを調整する必要があります。これにより、Python プロセスのタイムアウトが原因で、指定された値よりも早くアクションがタイムアウトしないようにします。
レコードの上限 Integer 100 いいえ 取得するレコードの数。オプションのパラメータ。設定すると、kql クエリに「| limit x」が追加されます。ここで、x はレコード上限に設定された値です。kql クエリで「limit」がすでに設定されている場合や、不要な場合は削除できます。

ユースケース

ケースの調査中に高度なクエリを実行する。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "tables": [
        {
            "name": "PrimaryResult",
            "columns": [
                {
                    "name": "Reason",
                    "type": "string"
                },
                {
                    "name": "StartTimeUtc",
                    "type": "datetime"
                },
                {
                    "name": "EndTimeUtc",
                    "type": "datetime"
                },
                {
                    "name": "count_",
                    "type": "long"
                },
                {
                    "name": "timestamp",
                    "type": "datetime"
                }
            ],
            "rows": [
                [
                    "Incorrect password",
                    "2019-10-22T06:38:30.837Z",
                    "2019-10-22T11:57:00.003Z",
                    28,
                    "2019-10-22T06:38:30.837Z"
                ],
                [
                    "Account name does not exist",
                    "2019-10-21T15:19:33.727Z",
                    "2019-10-22T06:40:13.51Z",
                    3,
                    "2019-10-21T15:19:33.727Z"
                ]
            ]
        }
    ]
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

成功した場合: 「クエリが正常に実行されました」と出力されます。

何も見つからなかった場合: 「クエリは正常に実行されましたが、結果は返されませんでした」と出力します。

エラーの場合: 「次のエラーによりクエリが失敗しました: {0}」format(exception.stacktrace) を出力します。

タイムアウトの場合: 「Query didn't completed due to timeout: {0}」format(exception.stacktrace) を出力します。

クエリ結果が切り捨てられた場合: 「Query results exceeded limits and were truncated, please rewrite your query!」を出力します。

テーブル

テーブルのタイトル: KQL クエリ結果

列: クエリ結果に基づいて列を動的に生成します

全般
添付ファイル Run_KQL_query_response.json - には、returned by the action の技術的な JSON データが含まれます。 全般

JSON ビューア
(テーブルがオプションでない場合のみ)

クエリ結果の JSON ビューアを表示します。 全般

インシデントにコメントを追加する

Azure Sentinel インシデントにコメントを追加します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
インシデント番号 Integer なし ○ コメントを追加するインシデント番号を指定します。
追加するコメント 文字列 なし ○ インシデントに追加するコメントを指定します。

実行

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

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
    "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Incidents/00cfebdc-c677-463f-8355-cb7f23472c06/Comments/f0f31d1a-d32b-4774-a21d-3279240c7c33",
    "name": "f0f31d1a-d32b-4774-a21d-3279240c7c33",
    "etag": "\"7e000812-0000-0c00-0000-606fc83f0000\"",
    "type": "Microsoft.SecurityInsights/Incidents/Comments",
    "properties": {
        "message": "Some message",
        "createdTimeUtc": "2021-04-09T03:21:35.0894288Z",
        "lastModifiedTimeUtc": "2021-04-09T03:21:35.0894288Z",
        "author": {
            "objectId": "f6ce2f43-6f77-4b30-9a4a-de1a069b2560",
            "email": null,
            "name": "Comment created from external application - log_analytics_rest_api_for_sentinel",
            "userPrincipalName": null
        }
    }
}
ケースウォール
結果のタイプ 値 / 説明 種類
出力メッセージ*

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

  • 成功した場合: 「Microsoft Sentinel インシデント {0} にコメントが正常に追加されました」.format(Incident number)。

  • 指定されたインシデント ケース番号でインシデントが見つからない場合: "Microsoft Sentinel incident {0} was not found!".format(incident_case_number).

アクションが失敗し、ハンドブックの実行が停止します。

  • 認証情報の誤りなどの致命的なエラーの場合: 「Failed to add a comment to Microsoft Sentinel incident! Error is {0}".format(exception.stacktrace) を出力します。
全般

コネクタ

Google SecOps でコネクタを構成する方法については、データを取り込む(コネクタ)をご覧ください。

Microsoft Azure Sentinel Incidents コネクタ - 非推奨

Google SecOps SOAR では、Microsoft Azure Sentinel Incidents コネクタが、Azure Security Insights API を使用して、特定の Microsoft Sentinel ワークスペースからインシデントをアラートとして取り込みます。

このコネクタは、インシデントの一覧表示アクションとインシデントの詳細を取得するアクションと同様の機能を使用し、Azure Security Insights エンドポイントに接続して、指定された期間に生成されたインシデントのリストを pull します。

コネクタのユースケース

コネクタを使用して、Microsoft Sentinel ワークスペースで新しいインシデントをモニタリングし、Google SecOps SOAR サーバーに取り込みます。

特定のイベントタイプのフローを確保するには、Microsoft Sentinel にデータコネクタを追加します。たとえば、Windows ホストのセキュリティ イベントをデータコネクタの 1 つとして追加するには、Windows ホストに Microsoft Sentinel エージェントをインストールし、取り込むイベントの種類(セキュリティ イベント、ファイアウォール イベント、DNS イベントなど)を構成します。

特定の条件に基づいてアラートを生成するには、ルールクエリを使用してアラートルールを定義します。アラートルールによって警告が作成されると、Microsoft Sentinel がトリガーされ、イベントの生成、データ インシデントの保存、ポータルのインシデント ページへのインシデントの表示が行われます。

インシデント データをプログラムで読み書きするには、Security Insights REST API を使用します。

コネクタ パラメータ

コネクタを構成するには、次のパラメータを使用します。

パラメータ
Product Field Name 必須

商品名が保存されるフィールドの名前。

デフォルト値は ProductName です。

Event Field Name 必須

イベント名が保存されるフィールドの名前。

デフォルト値は AlertName です。

Environment Field Name 省略可

環境名が保存されるフィールドの名前。

環境フィールドがない場合、デフォルトの環境が使用されます。

デフォルト値は "" です。

Environment Regex Pattern 省略可

Environment Field Name フィールドで見つかった値に対して実行する正規表現パターン。

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

このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。

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

Azure Subscription ID 必須

Azure サブスクリプション ID。

Azure Active Directory ID 必須

Microsoft Entra テナント ID。

Api Root 必須

統合で使用する management.azure.com API のルート URL。

デフォルト値は https://management.azure.com です。

Azure Resource Group 必須

Microsoft Sentinel が配置されている Azure リソース グループの名前。

Azure Sentinel Workspace Name 必須

操作する Microsoft Sentinel ワークスペースの名前。

Client ID 必須

この統合に使用される Microsoft Entra アプリケーション(クライアント)ID。

Client Secret 必須

Microsoft Entra クライアント シークレットの値。

Script Timeout (Seconds) 必須

現在のスクリプトを実行している Python プロセスのタイムアウト上限。

デフォルト値は 180 秒です。

Offset Time In Hours 必須

インシデントを取得する現在からの時間数。

デフォルト値は 24 時間です。

Incident Statuses to Fetch 必須

取得するインシデントのステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は Active, New, Closed です。

Incident Severities to Fetch 必須

取得するインシデントの重大度。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は Informational, Low, Medium, High です。

Max Incidents per Cycle 必須

1 回のコネクタ実行中に処理するインシデントの数。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は 10 です。

Proxy Server Address 省略可

使用するプロキシ サーバーのアドレス。

Proxy Server Username 省略可

認証に使用するプロキシのユーザー名。

Proxy Server Password 省略可

認証に使用するプロキシ パスワード。

コネクタルール

  • コネクタは、ブロックリストと動的リストをサポートしていません。

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

Microsoft Azure Sentinel Incident Connector v2

Microsoft Azure Sentinel Incidents Connector v2 は、Microsoft Sentinel を使用する場合に推奨されるコネクタです。主な変更点としては、Microsoft Sentinel API の新しいインシデント エンドポイントへの移行、コネクタ エンティティの処理と解析ロジックの導入などがあります。特定の Microsoft Sentinel インシデントをフィルタし、インシデント名に基づいて取得するには、動的リストを使用します。

Microsoft Sentinel UI にインシデント エンティティが表示されても、API がそれらを返さない(エンティティ リストが空である)場合があります。その結果、コネクタがこのようなインシデントを取り込むのに時間がかかり、次のコネクタ実行のためにバックログでクエリを実行します。エンティティ情報が API レスポンスで利用可能になると、コネクタはインシデントを取り込みます。

スケジュールされた Sentinel アラートとスケジュールされていない Sentinel アラートの処理

Microsoft Azure Sentinel Incidents Connector で、Azure Sentinel のスケジュール設定されたアラート以外のすべてのアラートのエンティティが誤って表示される問題を解決するため、Microsoft Azure Sentinel Incidents Connector v2 では、エンティティごとに追加のイベントが追加されます。

つまり、コネクタが Google SecOps イベントで IP、アカウント、ホスト名 エンティティを受信すると、検出されたエンティティごとに Google SecOps イベントが追加されます。新しく作成されたイベントは、Google SecOps SOAR でエンティティを作成し、エンティティ プロパティをマッピングするために使用できます。最初の予定はそのまま残ります。新しいイベントは Google SecOps アラートにのみ追加されます。他のエンティティ タイプはこのロジックの影響を受けず、最初のイベントに残ります。追加のイベントは作成されません。

追加のイベントを作成できるように、コネクタは entity Sentinel API エンドポイントを使用してデータを取得します。スケジュール設定されたアラートと NRT アラートは、デフォルトで、ログ分析 KQL クエリを使用して取り込まれ、アラートとイベントデータを取得します。選択すると、コネクタ構成の [Use the same approach with event creation for all alert types?] パラメータは、スケジュール設定されたアラートとスケジュール設定されていないアラートを含むすべてのアラートに同じエンティティベースのアプローチを使用します。このオプションは慎重に使用することをおすすめします。

コネクタ パラメータ

コネクタを構成するには、次のパラメータを使用します。

パラメータ
Product Field Name 必須

商品名が保存されるフィールドの名前。

デフォルト値は product_type です。

Event Field Name 必須

イベント名が保存されるフィールドの名前。

デフォルト値は event_type です。

Environment Field Name 省略可

環境名が保存されるフィールドの名前。

環境フィールドがない場合、デフォルトの環境が使用されます。

デフォルト値は "" です。

Environment Regex Pattern 省略可

Environment Field Name フィールドで見つかった値に対して実行する正規表現パターン。

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

このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。

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

Azure Subscription ID 必須

Azure サブスクリプション ID。

Azure Active Directory ID 必須

Microsoft Entra テナント ID。

Api Root 必須

統合で使用する API ルート URL。

デフォルト値は https://management.azure.com です。

OAUTH2 Login Endpoint Url 必須

OAuth 2.0 認証に使用するエンドポイント URL。

Azure Resource Group 必須

Microsoft Sentinel が配置されている Azure リソース グループの名前。

Azure Sentinel Workspace Name 必須

操作する Microsoft Sentinel ワークスペースの名前。

Client ID 必須

この統合に使用される Microsoft Entra アプリケーション(クライアント)ID。

Client Secret 必須

Microsoft Entra クライアント シークレットの値。

Script Timeout (Seconds) 必須

現在のスクリプトを実行している Python プロセスのタイムアウト上限。

デフォルト値は 180 秒です。

Offset Time In Hours 必須

インシデントを取得する現在からの時間数。

デフォルト値は 24 時間です。

Incident Statuses to Fetch 必須

取得するインシデントのステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は Active, New, Closed です。

Incident Severities to Fetch 必須

取得するインシデントの重大度。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は Informational, Low, Medium, High です。

Use the same approach with event creation for all alert types? Optional

オンにすると、コネクタはすべてのアラートタイプに同じアプローチを使用します。オフにすると、コネクタは Azure Sentinel のスケジュール設定されたアラートタイプに異なるアプローチを使用し、アラートの詳細で指定されたクエリを実行して、アラートの原因となったイベントの取得を試みます。

デフォルトではオフになっています。

Use whitelist as a blacklist 必須

オンにすると、動的リストがブロックリストとして使用されます。

デフォルトではオフになっています。

Proxy Server Address 省略可

使用するプロキシ サーバーのアドレス。

Proxy Server Username 省略可

認証に使用するプロキシのユーザー名。

Proxy Server Password 省略可

認証に使用するプロキシ パスワード。

Max Backlog Incidents per Cycle 必須

1 回のコネクタ実行中にバックログから取得するインシデントの数。

デフォルト値は 10 です。

StartTimeFallback 必須

Start Time アラート フィールドのフォールバックとして使用するインシデントまたはアラート属性のカンマ区切りリスト(降順)。また、作成されたイベントに新しい Siemplify_Start_Time 属性が追加されます。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

フォールバック フィールドが見つからない場合、コネクタは createdTimeUTC 属性を使用します。createdTimeUTC 属性がない場合、コネクタはアラートが Google SecOps SOAR に取り込まれた時刻を使用します。

デフォルト値は properties_firstActivityTimeGenerated, properties_startTimeUtc,properties_createdTimeUtc, properties_firstAlertTimeGenerated です。

EndTimeFallback 必須

End Time アラート フィールドのフォールバックとして使用するインシデントまたはアラート属性のカンマ区切りリスト(降順)。また、作成されたイベントに新しい Siemplify_End_Time 属性が追加されます。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

フォールバック フィールドが見つからない場合、コネクタは createdTimeUTC 属性を使用します。createdTimeUTC 属性がない場合、コネクタはアラートが Google SecOps SOAR に取り込まれた時刻を使用します。

デフォルト値は properties_lastActivityTimeGenerated, properties_endTimeUtc,properties_createdTimeUtc, properties_lastAlertTimeGenerated です。

Enable Fallback Logic Debug? 省略可

オンにすると、コネクタは、フォールバックに使用される値を含むデバッグ フィールドを作成されたイベントに追加します。

デフォルトではオフになっています。

VendorFieldFallback 必須

DeviceVendor フィールドの代替として使用するインシデント属性のカンマ区切りのリスト(降順)。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

デフォルト値は vendorName です。

ProductFieldFallback 必須

DeviceVendor フィールドの代替として使用するインシデント属性のカンマ区切りのリスト(降順)。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

デフォルト値は ProductName です。

EventFieldFallback 必須

Event Field Name パラメータのフォールバックとして使用するインシデント属性のカンマ区切りリスト(降順)。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

デフォルト値は kind です。

Max New Incidents per cycle 必須

1 回のコネクタ実行で処理するインシデントの数。

デフォルト値は 10 です。

Wait For Scheduled/NRT Alert Object 省略可

有効にすると、コネクタはスケジュール設定された/NRT アラート オブジェクトが使用可能になるまで待機します。

Scheduled Alerts Events Limit to Ingest 省略可

1 つの Azure Sentinel スケジュール設定アラートまたは NRT アラートで取り込むイベントの最大数。

デフォルト値は 100 です。

Incidents Padding Period (minutes) 省略可

コネクタがインシデントを取得して返す期間(分単位)。これらのインシデントは時系列順ではありません。

Create Siemplify Alerts for Sentinel incidents that do not have entities? 省略可

オンにすると、コネクタはエンティティのない Microsoft Sentinel インシデントから Google SecOps アラートを作成します。それ以外の場合、コネクタはスケジュール設定されたアラートと NRT アラートに対してのみ Google SecOps アラートを作成し、他のすべての Microsoft Sentinel インシデント タイプをスキップします。

デフォルトではオフになっています。

Incident's Alerts Limit to Ingest 省略可

Microsoft Sentinel インシデントごとに取り込むアラートの最大数。

Alert Name Template 省略可

指定すると、コネクタは Microsoft Sentinel API レスポンスで返されたインシデント データのこの値を使用して、Siemplify Alert Name フィールドに入力します。

プレースホルダは、[name of the field] の形式で指定できます(例: Sentinel incident - [title])。

このフィールドの最大長は 256 文字です。

値が指定されていない場合、または無効なテンプレートを指定した場合、コネクタはデフォルトのアラート名を使用します。

Rule Generator Template 省略可

指定すると、コネクタは Microsoft Sentinel API レスポンスで返されたインシデント データのこの値を使用して、Siemplify Rule Generator フィールドに入力します。

プレースホルダは、[name of the field] の形式で指定できます(例: Sentinel incident - [severity])。

このフィールドの最大長は 256 文字です。

値が指定されていない場合、または無効なテンプレートを指定した場合、コネクタはデフォルトのルール生成ツールの値を使用します。

[Alert Name] フィールドと [Rule Generator] フィールドをカスタマイズします。

このコネクタを使用すると、アラート名テンプレート パラメータとルール生成ツール テンプレート パラメータを使用して、Siemplify アラート名 フィールドとルール生成ツール フィールドの値をカスタマイズできます。テンプレートの場合、コネクタは API から返された Microsoft Sentinel インシデント データから情報を取得します。

次の例は、API から返されたインシデント データを表示し、アラートで使用可能なフィールドを参照して、テンプレートに使用できるようにします。

{
            "id": "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/providers/Microsoft.SecurityInsights/Incidents/d4f632be-0689-93f7-57a6-f27bfabbbad1",
            "name": "d4f632be-0689-93f7-57a6-f27bfabbbad1",
            "etag": "\"79004534-0000-0d00-0000-63590d610000\"",
            "type": "Microsoft.SecurityInsights/Incidents",
            "properties": {
                "title": "Incident title",
                "description": "",
                "severity": "Low",
                "status": "New",
                "owner": {
                    "objectId": null,
                    "email": null,
                    "assignedTo": null,
                    "userPrincipalName": null
                },
                "labels": [],
                "firstActivityTimeUtc": "2022-10-26T07:00:09.3857965Z",
                "lastActivityTimeUtc": "2022-10-26T09:07:02.1083312Z",
                "lastModifiedTimeUtc": "2022-10-26T10:35:13.0254798Z",
                "createdTimeUtc": "2022-10-26T10:34:55.7454638Z",
                "incidentNumber": 380925,
                "additionalData": {
                    "alertsCount": 102,
                    "bookmarksCount": 0,
                    "commentsCount": 0,
                    "alertProductNames": [
                        "Azure Sentinel"
                    ],
                    "tactics": [
                        "InitialAccess",
                        "Persistence"
                    ]
                },
                "relatedAnalyticRuleIds": [
                    "/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/Microsoft.SecurityInsights/alertRules/8a3ca5c5-7875-466e-accd-3bcb2881cdb0"
                ],
                "incidentUrl": "https://portal.azure.com/#asset/Microsoft_Azure_Security_Insights/Incident/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.OperationalInsights/workspaces/WORKSPACE/Microsoft.SecurityInsights/Incidents/d4f632be-0689-93f7-57a6-f27bfabbbad1",
                "providerName": "Azure Sentinel",
                "providerIncidentId": "380925"
            }
        }

コネクタルール

  • コネクタは、ブロックリストと動的リストをサポートしています。

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

Microsoft Sentinel インシデント トラッキング コネクタ

Microsoft Sentinel Incident Tracking Connector を使用して、Microsoft Sentinel インシデントを操作し、Sentinel インシデントの更新を新しい Google SecOps アラートとして取得します。動的リストを使用して、取得するインシデント名を指定できます。このコネクタでは、SourceGroupIdentifier パラメータに基づいて Google SecOps アラートのグループ化を構成することをおすすめします。

コネクタの入力

コネクタを構成するには、次のパラメータを使用します。

パラメータ
Product Field Name 必須

商品名が保存されるフィールドの名前。

デフォルト値は product_type です。

Event Field Name 必須

イベント名が保存されるフィールドの名前。

デフォルト値は event_type です。

Environment Field Name 省略可

環境名が保存されるフィールドの名前。

環境フィールドがない場合、デフォルトの環境が使用されます。

デフォルト値は "" です。

Environment Regex Pattern 省略可

Environment Field Name フィールドで見つかった値に対して実行する正規表現パターン。

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

このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。

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

Azure Subscription ID 必須

Azure サブスクリプション ID。

Entra ID Directory ID 必須

Microsoft Entra テナント ID。

Api Root 必須

統合で使用する API ルート URL。

デフォルト値は https://management.azure.com です。

OAUTH2 Login Endpoint Url 必須

OAuth 2.0 認証に使用するエンドポイント URL。

Azure Resource Group 必須

Microsoft Sentinel が配置されている Azure リソース グループの名前。

Azure Sentinel Workspace Name 必須

操作する Microsoft Sentinel ワークスペースの名前。

Client ID 必須

この統合に使用される Microsoft Entra アプリケーション(クライアント)ID。

Client Secret 必須

Microsoft Entra クライアント シークレットの値。

Script Timeout (Seconds) 必須

現在のスクリプトを実行している Python プロセスのタイムアウト上限。

デフォルト値は 480 秒です。

Verify SSL Optional

選択すると、統合によって Microsoft サーバーへの接続用の SSL 証明書が有効かどうかが検証されます。

デフォルトで選択されます。

Max Hours Backwards 必須

最初のコネクタの反復処理の前にインシデントを取得する時間数。このパラメータは、コネクタを初めて有効にした後の最初のコネクタの反復処理にのみ適用されます。

デフォルト値は 24 時間です。

Incident Statuses to Fetch 必須

取得するインシデントのステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は Active, New, Closed です。

Incident Severities to Fetch 必須

取得するインシデントの重大度。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。

デフォルト値は Informational, Low, Medium, High です。

Max Incidents per Cycle 必須

1 回のコネクタ実行中にバックログから取得するインシデントの数。

デフォルト値は 10 です。

Use the same approach with event creation for all alert types? Optional

選択すると、コネクタはすべてのアラートタイプに同じアプローチを使用します。

選択しない場合、コネクタは Microsoft Sentinel のスケジュール設定されたアラートタイプに異なるアプローチを使用し、アラートの詳細で指定されたクエリを実行して、アラートの原因となったイベントの取得を試みます。

デフォルトでは選択されていません。

Incidents Tags To Ingest 省略可

取り込むインシデント タグのカンマ区切りのリスト。コネクタは、このリストのタグを持たないインシデントを無視します。

Use whitelist as a blacklist 必須

選択すると、動的リストがブロックリストとして使用されます。

デフォルトでは選択されていません。

Backlog Expiration Timer 必須

コネクタがインシデントをバックログに保持する期間(分単位)。

デフォルト値は 60 分です。

StartTimeFallback 必須

Start Time アラート フィールドのフォールバックとして使用するインシデント属性またはアラート属性のカンマ区切りのリスト(降順)。また、作成されたイベントには新しい SecOps_Start_Time 属性が適用されます。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

フォールバック フィールドが見つからない場合、コネクタは createdTimeUTC 属性を使用します。createdTimeUTC 属性がない場合、コネクタはアラートが Google SecOps SOAR に取り込まれた時刻を使用します。

デフォルト値は properties_firstActivityTimeGenerated, properties_startTimeUtc,properties_createdTimeUtc, properties_firstAlertTimeGenerated です。

EndTimeFallback 必須

End Time アラート フィールドのフォールバックとして使用するインシデント属性またはアラート属性のカンマ区切りのリスト(降順)。また、作成されたイベントに新しい SecOps_End_Time 属性が追加されます。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

フォールバック フィールドが見つからない場合、コネクタは createdTimeUTC 属性を使用します。createdTimeUTC 属性がない場合、コネクタはアラートが Google SecOps SOAR に取り込まれた時刻を使用します。

デフォルト値は properties_lastActivityTimeGenerated, properties_endTimeUtc,properties_createdTimeUtc, properties_lastAlertTimeGenerated です。

Enable Fallback Logic Debug? 省略可

選択すると、コネクタは、作成されたイベントにフォールバックに使用される値を含むデバッグ フィールドを追加します。

デフォルトでは選択されていません。

VendorFieldFallback 必須

DeviceVendor フィールドの代替として使用するインシデント属性のカンマ区切りのリスト(降順)。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

デフォルト値は vendorName です。

ProductFieldFallback 必須

DeviceVendor フィールドのフォールバックとして使用するインシデント属性のカンマ区切りのリスト(降順)。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

デフォルト値は ProductName です。

EventFieldFallback 必須

Event Field Name パラメータのフォールバックとして使用するインシデント属性のカンマ区切りのリスト(降順)。最初の属性の優先度が最も高くなります。次の属性がイベントに存在しないか空の場合、リストの次の優先度の値にフォールバックします。

デフォルト値は kind です。

Max Backlog Incidents per cycle 必須

1 回のコネクタ実行でバックログから取得するインシデントの数。

デフォルト値は 10 です。

Disable Overflow Optional

選択すると、コネクタはイベント オーバーフローを無効にします。

デフォルトでは選択されていません。

Total Number of Scheduled Alerts Events Limit to Ingest 省略可

1 つの Microsoft Sentinel スケジュールされたアラートまたは NRT アラートで取り込むイベントの最大数。

デフォルト値は 100 です。

Create Chronicle SOAR Alerts for Sentinel incidents that do not have entities? 省略可

選択すると、コネクタはエンティティのない Microsoft Sentinel インシデントから Google SecOps アラートを作成します。それ以外の場合、コネクタはスケジュール設定されたアラートと NRT アラートに対してのみ Google SecOps アラートを作成し、他のすべての Microsoft Sentinel インシデント タイプをスキップします。

デフォルトでは選択されていません。

Incident's Alerts Limit to Ingest 省略可

Microsoft Sentinel インシデントごとに取り込むアラートの最大数。

Incidents Padding Period (minutes) 省略可

コネクタがインシデントを取得して返すまでの期間(分)。コネクタはインシデントを時系列で返しません。

Alert Name Template 省略可

指定すると、コネクタは、Microsoft Sentinel API レスポンスで返されたインシデント データのこの値を Google SecOps SOAR アラート名に使用します。

プレースホルダは、[name of the field] の形式で指定できます(例: Sentinel incident - [title])。

このフィールドの最大長は 256 文字です。

値が指定されていない場合、または無効なテンプレートを指定した場合、コネクタはデフォルトのアラート名を使用します。

Rule Generator Template 省略可

指定すると、コネクタは、Google SecOps SOAR ルール生成ツールの Microsoft Sentinel API レスポンスで返されたインシデント データからこの値を使用します。

プレースホルダは、[name of the field] の形式で指定できます(例: Sentinel incident - [severity])。

このフィールドの最大長は 256 文字です。

値が指定されていない場合、または無効なテンプレートを指定した場合、コネクタはデフォルトのルール生成ツールの値を使用します。

How many hours to track ingested incident for updates 必須

コネクタが、すでに取り込まれた Sentinel インシデントを追跡して、新しいイベントやエンティティの追加、インシデントの詳細などの更新を行う期間。

デフォルト値は 24 時間です。

Wait For Scheduled/NRT Alert Object 省略可

有効にすると、コネクタはスケジュール設定された/NRT アラート オブジェクトが使用可能になるまで待機します。

Proxy Server Address 省略可

使用するプロキシ サーバーのアドレス。

Proxy Server Username 省略可

認証に使用するプロキシのユーザー名。

Proxy Server Password 省略可

認証に使用するプロキシ パスワード。

Incident Creation Time Filter (days) 省略可

インシデントを取得する現在時刻までの日数。指定すると、コネクタはこの期間内に作成されたインシデントのみを取得します。

この値は有効な正の整数である必要があります。これは高度なパラメータです。

コネクタルール

Microsoft Sentinel インシデント トラッキング コネクタは、ブロックリストと動的リストをサポートしています。

ジョブ

ジョブの詳細については、 新しいジョブを構成すると 高度なスケジューリングをご覧ください。

非推奨: Microsoft Sentinel - インシデントの同期

Microsoft Sentinel - Sync Incidents ジョブを使用して、Google SecOps アラートを Microsoft Sentinel インシデントと同期します。これにより、コメント、ステータス、タグが 2 つのシステム間で同期されます。

ジョブが正しい情報を識別するには、Google SecOps ケースに Microsoft Sentinel Incident タグが必要です。アラートが Microsoft Azure Sentinel Incident Connector v2 から発生していない場合は、ジョブが正しい情報を見つけられるように、ケースに Incident_ID コンテキスト値を追加する必要があります。

ジョブの動作

このジョブは主に次の 2 つの部分で構成されています。

  1. このジョブは、アラートのステータス、コメント、タグを Microsoft Sentinel から Google SecOps に同期します。
  2. このジョブは、Google SecOps から Microsoft Sentinel に更新を同期します。

このジョブは、安定したパフォーマンスを確保するために、1 回の反復処理で最大数のケースを処理します。ケースの最終更新時刻に基づいて、更新が漏れないようにします。

いずれかのシステムでアラートがクローズされると、ジョブはクローズを同期します。ステータスのマッピングは次のとおりです。

  • Malicious は、True Positive の理由で Closed の Microsoft Sentinel ステータスにマッピングされます。
  • Not Malicious は、False Positive の理由で Closed の Microsoft Sentinel ステータスにマッピングされます。
  • その他のクローズ値は、Unknown の理由で Microsoft Sentinel ステータス Closed にマッピングされます。

API レート制限に関する重要な注意事項

このジョブは、Microsoft Graph API を使用してインシデントを管理します。この API のレート制限は 1 分あたり 20 リクエストです。この上限に達するリスクを軽減するため、このジョブ専用に SecurityIncident.ReadWrite.All 権限を持つ別の Microsoft Entra ID アプリを設定することを強くおすすめします。

ジョブ パラメータ

[Microsoft Sentinel - Sync Incidents] ジョブには、次のパラメータが必要です。

パラメータ 説明
Environment Name

必須。

インシデントを同期する環境の名前。

デフォルト値は Default Environment です。

Azure Active Directory ID

必須。

Azure の一意のディレクトリ ID(テナント ID)。
OAUTH2 Login Endpoint Url

必須。

OAuth 2.0 エンドポイントの URL。

デフォルト値は https://login.microsoftonline.com です。

API Root

必須。

Graph API のベース URL。

デフォルト値は https://graph.microsoft.com です。

Client ID

必須。

Azure Active Directory に登録されているアプリケーションの一意の ID。
Client Secret

必須。

Client ID で使用される機密鍵。
Max Hours Backwards

必須。

インシデントを同期する過去の時間数。

デフォルト値は 24 です。

Verify SSL

必須。

Microsoft Sentinel サーバーの SSL 証明書を検証します。

デフォルトで有効になっています。

Microsoft Sentinel - インシデントの同期 V2

Sync Incidents V2 ジョブを使用して、Google SecOps アラートを Microsoft Sentinel インシデントと同期します。このジョブにより、コメント、ステータス、タグが両方のシステム間で双方向に同期されます。

ジョブの動作

  • 前提条件: ジョブが正しい情報を識別するには、Google SecOps ケースに Microsoft Sentinel Incident タグが必要です。このジョブは、Microsoft Azure Sentinel Incident Connector v2 からのアラートでのみ機能します。

  • 初期ロジック: 最初のイテレーションでは、Max Hours Backwards を使用して、開始時間が現在の時間から指定された時間を引いた値以上の時間をクエリします。後続の実行では、最後に処理されたアラートの start_time が使用されます。

  • ステータスの同期: ジョブは、両方のシステムでステータスの変更をモニタリングします。Microsoft Sentinel でインシデントがクローズされると、Google SecOps のケースとアラートのステータスが自動的に更新されます。

    • Microsoft Sentinel の理由が True positive - Suspicious activity の場合、Google SecOps のクローズ理由は Malicious に設定されます。

    • Microsoft Sentinel の理由が False Positive - Incorrect Alert Logic または False Positive - Inaccurate Data の場合、Google SecOps のクローズ理由は Not Malicious に設定されます。

    • 他のすべての値は、Google SecOps のクローズ理由 Inconclusive になります。

    この同期は、Google SecOps から Microsoft Sentinel にも機能します。

  • コメントの同期: Sentinel から Google SecOps へのコメントは、Microsoft Sentinel Incident INCIDENT_NUMBER: COMMENT の構造を使用します。

    Google SecOps から Sentinel へのコメントは、Google SecOps Case CASE_ID: COMMENT の構造を使用します。

  • タグの同期: タグは、特定の接頭辞を使用して同期され、ソースの明確性が維持されます。

    • Google SecOps タグ: Google SecOps: TAG.
    • Microsoft Sentinel タグ: Microsoft Sentinel: TAG.
  • 重大度と割り当て先の同期: Microsoft Sentinel がこれらのフィールドの信頼できる情報源として機能します。重大度と割り当て先の同期は、Microsoft Sentinel から Google SecOps にのみ行われます。

  • 割り当て先の同期制御: Sync Assignee が無効になっている場合、割り当て先は Microsoft Sentinel から Google SecOps に同期されません。

ジョブ パラメータ

Sync Incidents V2 ジョブには、次のパラメータが必要です。

パラメータ 説明
Environment Name

必須。

インシデントを同期する環境の名前。

デフォルト値は Default Environment です。

Azure Subscription ID

必須。

Sentinel ワークスペースを含む Azure サブスクリプションの ID。

Azure Active Directory ID

必須。

Azure の一意のディレクトリ ID(テナント ID とも呼ばれます)。

OAUTH2 Login Endpoint Url

必須。

ジョブが認証トークンをリクエストする OAuth 2.0 エンドポイントの URL。

デフォルト値は https://login.microsoftonline.com です。

Management API Root

必須。

Management API のベース URL。ジョブは、このルート URL に特定の API 呼び出しを追加してデータを取得します。

デフォルト値は https://management.azure.com です。

Azure Resource Group

必須。

Sentinel ワークスペースが配置されている Azure リソース グループの名前。

Azure Sentinel Workspace Name

必須。

Microsoft Sentinel ワークスペースの名前。

Client ID

必須。

Azure Active Directory に登録されているアプリケーションの一意の ID。Microsoft Sentinel へのアクセス権が付与されています。

Client Secret

必須。

アプリケーションの機密キー。Client ID と組み合わせて、ジョブの認証と認可に使用されます。

Max Hours Backwards

必須。

現在の時刻より前にインシデントを同期する時間数。

デフォルト値は 24 です。

Sync Assignee

省略可。

選択すると、ジョブは Microsoft Sentinel から Google SecOps に割り当て先を同期します。

Verify SSL

必須。

選択すると、統合は、SSL 証明書を検証します。

デフォルトで有効になっています。

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