Microsoft Sentinel
このドキュメントでは、Microsoft Sentinel を Google SecOps と統合する方法について説明します。
この統合では、1 つ以上のオープンソース コンポーネントを使用します。この統合の完全なソースコードのコピーを Cloud Storage バケットからダウンロードできます。
ユースケース
- オンプレミス ホストと、Microsoft 365 や Microsoft 365 Cloud App Security などのクラウドベースの Microsoft サービスの両方から流れるイベントに基づいて、Sentinel で作成されたアラートをモニタリングして検査します。
- 特定のインシデントを調査しながら、Sentinel で収集され、相関付けられたデータを拡充に使用します。アナリストは、Sentinel で収集して保存したデータを調査に使用できます。たとえば、特定の情報に「ドリルダウン」する(アラートデータを検査する、Syslog ログを検査するなど)、特定の期間のアクティビティや特定のホストからのアクティビティをクエリするなどです。
前提条件
Microsoft Security Insights API に対してリクエストを実行するには、まず Microsoft Entra ID で認可を構成する必要があります。権限を構成する必要があります。
- Microsoft Entra アプリを作成します。
- クライアント シークレットを作成します。
- 登録済みの Microsoft Entra アプリに Microsoft Sentinel ワークスペースへのアクセス権を付与します。
- Microsoft Entra アプリケーションを使用してアクセス トークンを取得します。
Microsoft Entra アプリを作成する
ユーザー管理者またはパスワード管理者として Azure ポータルにログインします。
[Microsoft Entra ID] を選択します。
[App registrations] > [New registration] に移動します。
アプリの名前を入力します。
該当するサポートされているアカウントの種類を選択します。
[Register] をクリックします。
後で統合パラメータを構成するときに使用するために、アプリケーション(クライアント)ID とディレクトリ(テナント)ID の値を保存します。
クライアント シークレットを作成する
[証明書とシークレット] > [新しいクライアント シークレット] に移動します。
クライアント シークレットの説明を入力し、有効期限を設定します。
[追加] をクリックします。
クライアント シークレットの値(シークレット ID ではない)を保存して、統合を構成するときに
Client Secretパラメータ値として使用します。クライアント シークレットの値は 1 回だけ表示されます。
登録済みの Microsoft Entra に Microsoft Sentinel ワークスペースへのアクセス権を付与する
Microsoft Sentinel の [概要] ページに移動します。
[設定] をクリックします。
[アクセス制御(IAM)] をクリックします。
[ロールの割り当てを追加] セクションで、[追加] をクリックします。
次のパラメータを構成します。
ロール =
Azure Sentinel Contributor。アクセス権の割り当て先 =
default, Microsoft Entra ID user group, or service principal。
[選択] セクションで、アプリを検索する検索条件を指定し、アプリのロール割り当てを追加します。
Microsoft Sentinel のワークスペース ページに移動します。次のパラメータを見つけて構成します。
Azure Resource GroupAzure 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
}
}
}
ケースウォール
| 結果のタイプ | 値 / 説明 | 種類 |
|---|---|---|
| 出力メッセージ* | アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。
アクションが失敗し、ハンドブックの実行が停止します。
|
全般 |
コネクタ
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 |
必須
商品名が保存されるフィールドの名前。 デフォルト値は |
Event Field Name |
必須
イベント名が保存されるフィールドの名前。 デフォルト値は |
Environment Field Name |
省略可
環境名が保存されるフィールドの名前。 環境フィールドがない場合、デフォルトの環境が使用されます。 デフォルト値は |
Environment Regex Pattern |
省略可
デフォルト値の このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。 正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。 |
Azure Subscription ID |
必須 Azure サブスクリプション ID。 |
Azure Active Directory ID |
必須 Microsoft Entra テナント ID。 |
Api Root |
必須 統合で使用する management.azure.com API のルート 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 |
必須
取得するインシデントのステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 デフォルト値は |
Incident Severities to Fetch |
必須
取得するインシデントの重大度。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 デフォルト値は |
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 |
必須
商品名が保存されるフィールドの名前。 デフォルト値は |
Event Field Name |
必須
イベント名が保存されるフィールドの名前。 デフォルト値は |
Environment Field Name |
省略可
環境名が保存されるフィールドの名前。 環境フィールドがない場合、デフォルトの環境が使用されます。 デフォルト値は |
Environment Regex Pattern |
省略可
デフォルト値の このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。 正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。 |
Azure Subscription ID |
必須 Azure サブスクリプション ID。 |
Azure Active Directory ID |
必須 Microsoft Entra テナント ID。 |
Api Root |
必須 統合で使用する API ルート URL。 デフォルト値は |
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 |
必須
取得するインシデントのステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 デフォルト値は |
Incident Severities to Fetch |
必須
取得するインシデントの重大度。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 デフォルト値は |
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 |
必須
フォールバック フィールドが見つからない場合、コネクタは デフォルト値は |
EndTimeFallback |
必須
フォールバック フィールドが見つからない場合、コネクタは デフォルト値は |
Enable Fallback Logic Debug? |
省略可
オンにすると、コネクタは、フォールバックに使用される値を含むデバッグ フィールドを作成されたイベントに追加します。 デフォルトではオフになっています。 |
VendorFieldFallback |
必須
デフォルト値は |
ProductFieldFallback |
必須
デフォルト値は |
EventFieldFallback |
必須
デフォルト値は |
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 レスポンスで返されたインシデント データのこの値を使用して、 プレースホルダは、 このフィールドの最大長は 256 文字です。 値が指定されていない場合、または無効なテンプレートを指定した場合、コネクタはデフォルトのアラート名を使用します。 |
Rule Generator Template |
省略可
指定すると、コネクタは Microsoft Sentinel API レスポンスで返されたインシデント データのこの値を使用して、 プレースホルダは、 このフィールドの最大長は 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 |
必須
商品名が保存されるフィールドの名前。 デフォルト値は |
Event Field Name |
必須
イベント名が保存されるフィールドの名前。 デフォルト値は |
Environment Field Name |
省略可
環境名が保存されるフィールドの名前。 環境フィールドがない場合、デフォルトの環境が使用されます。 デフォルト値は |
Environment Regex Pattern |
省略可
デフォルト値の このパラメータを使用すると、正規表現ロジックを使用して環境フィールドを操作できます。 正規表現パターンが null か空の場合、または環境値が null の場合、最終的な環境の結果はデフォルト環境になります。 |
Azure Subscription ID |
必須 Azure サブスクリプション ID。 |
Entra ID Directory ID |
必須 Microsoft Entra テナント ID。 |
Api Root |
必須 統合で使用する API ルート URL。 デフォルト値は |
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 |
必須
取得するインシデントのステータス。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 デフォルト値は |
Incident Severities to Fetch |
必須
取得するインシデントの重大度。このパラメータは、カンマ区切りの文字列として複数の値を受け入れます。 デフォルト値は |
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 |
必須
フォールバック フィールドが見つからない場合、コネクタは デフォルト値は |
EndTimeFallback |
必須
フォールバック フィールドが見つからない場合、コネクタは デフォルト値は |
Enable Fallback Logic Debug? |
省略可
選択すると、コネクタは、作成されたイベントにフォールバックに使用される値を含むデバッグ フィールドを追加します。 デフォルトでは選択されていません。 |
VendorFieldFallback |
必須
デフォルト値は |
ProductFieldFallback |
必須
デフォルト値は |
EventFieldFallback |
必須
デフォルト値は |
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 アラート名に使用します。 プレースホルダは、 このフィールドの最大長は 256 文字です。 値が指定されていない場合、または無効なテンプレートを指定した場合、コネクタはデフォルトのアラート名を使用します。 |
Rule Generator Template |
省略可
指定すると、コネクタは、Google SecOps SOAR ルール生成ツールの Microsoft Sentinel API レスポンスで返されたインシデント データからこの値を使用します。 プレースホルダは、 このフィールドの最大長は 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 つの部分で構成されています。
- このジョブは、アラートのステータス、コメント、タグを Microsoft Sentinel から Google SecOps に同期します。
- このジョブは、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 |
必須。 インシデントを同期する環境の名前。デフォルト値は |
Azure Active Directory ID |
必須。 Azure の一意のディレクトリ ID(テナント ID)。 |
OAUTH2 Login Endpoint Url |
必須。 OAuth 2.0 エンドポイントの URL。デフォルト値は |
API Root |
必須。 Graph API のベース URL。デフォルト値は |
Client ID |
必須。 Azure Active Directory に登録されているアプリケーションの一意の ID。 |
Client Secret |
必須。 Client ID で使用される機密鍵。 |
Max Hours Backwards |
必須。 インシデントを同期する過去の時間数。デフォルト値は |
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 IncidentINCIDENT_NUMBER:COMMENT の構造を使用します。Google SecOps から Sentinel へのコメントは、
Google SecOps CaseCASE_ID:COMMENT の構造を使用します。タグの同期: タグは、特定の接頭辞を使用して同期され、ソースの明確性が維持されます。
- Google SecOps タグ:
Google SecOps:TAG. - Microsoft Sentinel タグ:
Microsoft Sentinel:TAG.
- Google SecOps タグ:
重大度と割り当て先の同期: Microsoft Sentinel がこれらのフィールドの信頼できる情報源として機能します。重大度と割り当て先の同期は、Microsoft Sentinel から Google SecOps にのみ行われます。
割り当て先の同期制御:
Sync Assigneeが無効になっている場合、割り当て先は Microsoft Sentinel から Google SecOps に同期されません。
ジョブ パラメータ
Sync Incidents V2 ジョブには、次のパラメータが必要です。
| パラメータ | 説明 |
|---|---|
Environment Name |
必須。 インシデントを同期する環境の名前。 デフォルト値は |
Azure Subscription ID |
必須。 Sentinel ワークスペースを含む Azure サブスクリプションの ID。 |
Azure Active Directory ID |
必須。 Azure の一意のディレクトリ ID(テナント ID とも呼ばれます)。 |
OAUTH2 Login Endpoint Url |
必須。 ジョブが認証トークンをリクエストする OAuth 2.0 エンドポイントの URL。 デフォルト値は |
Management API Root |
必須。 Management API のベース URL。ジョブは、このルート URL に特定の API 呼び出しを追加してデータを取得します。 デフォルト値は |
Azure Resource Group |
必須。 Sentinel ワークスペースが配置されている Azure リソース グループの名前。 |
Azure Sentinel Workspace Name |
必須。 Microsoft Sentinel ワークスペースの名前。 |
Client ID |
必須。 Azure Active Directory に登録されているアプリケーションの一意の ID。Microsoft Sentinel へのアクセス権が付与されています。 |
Client Secret |
必須。 アプリケーションの機密キー。 |
Max Hours Backwards |
必須。 現在の時刻より前にインシデントを同期する時間数。 デフォルト値は |
Sync Assignee |
省略可。 選択すると、ジョブは Microsoft Sentinel から Google SecOps に割り当て先を同期します。 |
Verify SSL |
必須。 選択すると、統合は、SSL 証明書を検証します。デフォルトで有効になっています。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。