Cisco Vulnerability Management を Google SecOps と統合する

このドキュメントでは、Cisco Vulnerability Management を Google Security Operations(Google SecOps)と統合する方法について説明します。

ユースケース

次のエクスプロイトを阻止し、正確に対応するために必要なコンテキストに基づく分析情報と脅威インテリジェンスを入手します。

統合のパラメータ

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

パラメータ名 種類 デフォルト値 必須 説明
API ルート 文字列 はい Cisco Vulnerability Management 統合の API ルート。
API トークン パスワード はい Cisco Vulnerability Management 統合の API トークン。
SSL を確認する bool オン はい 選択すると、統合は Cisco Vulnerability Management への接続時に SSL 証明書を検証します。デフォルトで選択されます。

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

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できます。複数のインスタンスを構成してサポートする方法の詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、 デスクから保留中のアクションに対応するとケースで手動アクションを実行するをご覧ください。

Ping

Cisco Vulnerability Management への接続性をテストします。

パラメータ

なし

実行

このアクションはエンティティを使用せず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 説明 種類
出力メッセージ * アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。
成功した場合:
「指定された接続パラメータを使用して Cisco Vulnerability Management サーバーに正常に接続されました」と出力されます。

アクションが失敗し、プレイブックの実行が停止します。
成功しなかった場合:
「Cisco 脆弱性の管理 サーバーへの接続に失敗しました。エラーは {0}」.format(exception.stacktrace)
一般

エンティティの拡充

Cisco Vulnerability Management の情報を使用してエンティティを拡充します。

パラメータ

パラメータ名 種類 デフォルト値 必須 説明
外部 ID CSV いいえ アセットに関連付けられている外部 ID のカンマ区切りのリスト。外部 ID で検索されたアセットは、エンティティと並行して検索されます。

実行

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

  • CVE
  • IP アドレス
  • ホスト名

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
   "Entity": "Entity",
   "EntityResult":
       {
           "id": 1177,
           "status": "open",
           "closed_at": null,
           "created_at": "2025-02-06T09:00:16Z",
           "due_date": "2024-09-03",
           "notes": "Unknown",
           "port": [],
           "priority": 10,
           "identifiers": [
               "CVE-2024-38107"
           ],
           "last_seen_time": "2025-02-06T08:59:24.000Z",
           "scanner_score": null,
           "fix_id": 2692956,
           "scanner_vulnerabilities": [
               {
                   "port": null,
                   "external_unique_id": "CVE-2024-38107",
                   "open": true
               }
           ],
           "asset_id": 101,
           "connectors": [
               {
                   "id": 160084,
                   "name": "Custom CSV",
                   "connector_definition_name": "Custom CSV",
                   "vendor": "Cisco"
               }
           ],
           "service_ticket": null,
           "urls": {
               "asset": "api.trial1.eu.kennasecurity.com/assets/101"
           },
           "solution": "The following products are affected by this vulnerability:<ul><li><i>Operating System</i> <b>microsoft windows_10_1507</b></li><li><i>Operating System</i> <b>microsoft windows_10_1607</b></li><li><i>Operating System</i> <b>microsoft windows_10_1809</b></li><li><i>Operating System</i> <b>microsoft windows_10_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_10_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_23h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_24h2</b></li><li><i>Operating System</i> <b>microsoft windows_server_2012</b></li><li><i>Operating System</i> <b>microsoft windows_server_2016</b></li><li><i>Operating System</i> <b>microsoft windows_server_2019</b></li><li><i>Operating System</i> <b>microsoft windows_server_2022</b></li><li><i>Operating System</i> <b>microsoft windows_server_2022_23h2</b></li></ul>The following remediations or software updates can fix your system:<ul><li><b>windows_11_24h2</b> version needs to be updated to version 10.0.26100.1457 or greater.</li><li><b>windows_server_2022_23h2</b> version needs to be updated to version 10.0.25398.1085 or greater.</li><li><b>Windows 10 Version 20H2 Build 10240</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041782\">5041782</a>.</li><li><b>Windows 10 Version 1607 Build 14393</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041773\">5041773</a>.</li><li><b>Windows 10 Version 1809 Build 17763</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041578\">5041578</a>.</li><li><b>Windows 10 Version 21H2 Build 19044</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041580\">5041580</a>.</li><li><b>Windows 10 Version 22H2 Build 19045</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041580\">5041580</a>.</li><li><b>Windows 11 Version 21H2 Build 22000</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041592\">5041592</a>.</li><li><b>Windows 11 Version 22H2 Build 22621</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041585\">5041585</a>.</li><li><b>Windows 11 Version 23H2 Build 22631</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041585\">5041585</a>.</li><li><b>Windows Server 2012</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041851\">5041851</a>.</li><li><b>Windows Server 2012 R2</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041828\">5041828</a>.</li><li><b>Windows Server 2016</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041773\">5041773</a>.</li><li><b>Windows Server 2019</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041578\">5041578</a>.</li><li><b>Windows Server 2022 Build 20348</b> needs to be patched with: <a href=\"https://support.microsoft.com/en-in/help/5041160\">5041160</a>.</li></ul>Refer to these referenced URL(s) for more information on remediation:<br/><ul><li><a href=\"https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-38107\">https://msrc.microsoft.com/update-guide/vulnerability/CVE-2024-38107</a></li></ul>",
           "patch": true,
           "patch_published_at": "2024-08-13T18:15:10.000Z",
           "cve_id": "CVE-2024-38107",
           "cve_description": "Windows Power Dependency Coordinator Elevation of Privilege Vulnerability",
           "cve_published_at": "2024-08-13T18:15:10.000Z",
           "description": null,
           "wasc_id": null,
           "severity": 7,
           "threat": 3,
           "popular_target": false,
           "active_internet_breach": false,
           "easily_exploitable": false,
           "malware_exploitable": false,
           "remote_code_execution": false,
           "predicted_exploitable": false,
           "platform_types": [
               "operating system"
           ],
           "cvss_v2": {
               "exploit_subscore": 3.1,
               "impact_subscore": 10.0,
               "score": 6.8,
               "temporal_score": 5.6
           },
           "cvss_v3": {
               "exploit_subscore": 1.8,
               "impact_subscore": 5.9,
               "score": 7.8
           },
           "custom_fields": [],
           "first_found_on": "2024-08-13T00:00:00Z",
           "top_priority": false,
           "risk_meter_score": 28,
           "closed": false
       }

}
エンティティ拡充

接頭辞: CiscoVM_

拡充フィールド名 ロジック - 適用するタイミング
priority JSON で利用可能な場合
重要度 JSON で利用可能な場合
脅威 JSON で利用可能な場合
ソリューション JSON で利用可能な場合
patch_available JSON で利用可能な場合
説明 JSON で利用可能な場合
published_at JSON で利用可能な場合
risk_score JSON で利用可能な場合
拡充テーブル アセット

接頭辞: CiscoVM_

拡充フィールド名 ロジック - 適用するタイミング
os JSON で利用可能な場合
priority JSON で利用可能な場合
vulnerabilities_count JSON で利用可能な場合
設定されます。 JSON で利用可能な場合
last_seen_time JSON で利用可能な場合
タグ JSON で利用可能な場合
ip_address JSON で利用可能な場合
hostname JSON で利用可能な場合
fqdn JSON で利用可能な場合
risk_score JSON で利用可能な場合
asset_groups JSON で利用可能な場合
ケースウォール
結果のタイプ 説明 種類
出力メッセージ * アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

1 つのエンティティにデータが利用可能な場合(is_success = true):
print "Successfully enriched the following entities in Cisco Vulnerability Management: {entity.identifier}".

1 つのエンティティにデータが利用できない場合(is_success=true):
print "アクションは、Cisco Vulnerability Management の次のエンティティを拡充できませんでした: {entity.identifier}"

すべてのデータが利用できない場合(is_success=false):
指定されたエンティティの情報が見つかりませんでした。

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

認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:
「アクション「エンティティの拡充」の実行エラー」が出力されます。理由: {0}」.format(error.Stacktrace)
全般

アセットの更新

Cisco Vulnerability Management から Google SecOps エンティティに関連付けられたアセット情報を更新します。

パラメータ

パラメータ名 種類 デフォルト値 必須 説明
外部 ID CSV いいえ アセットに関連付けられている外部 ID のカンマ区切りのリスト。外部 ID で検索されたアセットは、エンティティと並行して検索されます。
ステータス DDL 1 つ選択

有効な値:
  • 有効
  • 無効
  • 1 つ選択
いいえ アセットのステータス。
注 文字列 いいえ アセットのメモ。

実行

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

  • IP アドレス
  • ホスト名

アクションの結果

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

ケースウォール

結果のタイプ 説明 種類
出力メッセージ * アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

1 つのエンティティにデータが利用可能な場合(is_success = true):
「Cisco Vulnerability Management で次のエンティティが正常に更新されました: {entity.identifier}」を出力します。

1 つのエンティティが見つからない場合(is_success=true):
「アクションは、Cisco 脆弱性の管理 で次のエンティティを更新できませんでした: {entity.identifier}」を出力します。

すべてのデータが利用できない場合(is_success=false):
指定されたエンティティはいずれも更新されませんでした。


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

認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:
「アクション「アセットの更新」の実行エラー。理由: {0}」.format(error.Stacktrace)
全般

アセットの脆弱性を一覧表示する

Cisco Vulnerability Management からエンティティに関連付けられた脆弱性に関する情報を返します。

パラメータ

パラメータ名 種類 デフォルト値 必須 説明
外部 ID CSV いいえ アセットに関連付けられている外部 ID のカンマ区切りのリスト。外部 ID で検索されたアセットは、エンティティと並行して検索されます。
返される最小のリスク スコアリング Int いいえ 脆弱性に関連付けられたリスクスコア。指定すると、アクションは、[Lowest Risk Score To Return] で指定されたリスク スコアリングよりも低いリスク スコアリングを持つすべての脆弱性をフィルタリングします。

実行

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

  • IP アドレス
  • ホスト名

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
JSON の結果
{
   "Entity": "Entity",
   "EntityResult": [
       {
           "id": 1177,
           "status": "open",
           "closed_at": null,
           "created_at": "2025-02-06T09:00:16Z",
           "due_date": "2024-09-03",
           "notes": "Unknown",
           "port": [],
           "priority": 10,
           "identifiers": [
               "CVE-2024-38107"
           ],
           "last_seen_time": "2025-02-06T08:59:24.000Z",
           "scanner_score": null,
           "fix_id": 2692956,
           "scanner_vulnerabilities": [
               {
                   "port": null,
                   "external_unique_id": "CVE-2024-38107",
                   "open": true
               }
           ],
           "asset_id": 101,
           "connectors": [
               {
                   "id": 160084,
                   "name": "Custom CSV",
                   "connector_definition_name": "Custom CSV",
                   "vendor": "Cisco"
               }
           ],
           "service_ticket": null,
           "urls": {
               "asset": "api.trial1.eu.kennasecurity.com/assets/101"
           },
           "solution": "The following products are affected by this vulnerability:<ul><li><i>Operating System</i> <b>microsoft windows_10_1507</b></li><li><i>Operating System</i> <b>microsoft windows_10_1607</b></li><li><i>Operating System</i> <b>microsoft windows_10_1809</b></li><li><i>Operating System</i> <b>microsoft windows_10_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_10_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_21h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_22h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_23h2</b></li><li><i>Operating System</i> <b>microsoft windows_11_24h2</b></li><li><i>Operating System</i> <b>microsoft windows_server_2012</b></li><li>",
           "patch": true,
           "patch_published_at": "2024-08-13T18:15:10.000Z",
           "cve_id": "CVE-2024-38107",
           "cve_description": "Windows Power Dependency Coordinator Elevation of Privilege Vulnerability",
           "cve_published_at": "2024-08-13T18:15:10.000Z",
           "description": null,
           "wasc_id": null,
           "severity": 7,
           "threat": 3,
           "popular_target": false,
           "active_internet_breach": false,
           "easily_exploitable": false,
           "malware_exploitable": false,
           "remote_code_execution": false,
           "predicted_exploitable": false,
           "platform_types": [
               "operating system"
           ],
           "cvss_v2": {
               "exploit_subscore": 3.1,
               "impact_subscore": 10.0,
               "score": 6.8,
               "temporal_score": 5.6
           },
           "cvss_v3": {
               "exploit_subscore": 1.8,
               "impact_subscore": 5.9,
               "score": 7.8
           },
           "custom_fields": [],
           "first_found_on": "2024-08-13T00:00:00Z",
           "top_priority": false,
           "risk_meter_score": 28,
           "closed": false
       }
   ]
}
ケースウォール
結果のタイプ 説明 種類
出力メッセージ * アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

1 つのエンティティにデータが利用可能な場合(is_success = true):
「Cisco Vulnerability Management で次のエンティティの脆弱性が正常に一覧表示されました: {entity.identifier}」と出力されます。

1 つのエンティティが見つからない場合(is_success=true):
「アクションは、Cisco 脆弱性の管理 で次のエンティティを見つけることができませんでした: {entity.identifier}」と出力されます。

すべてのデータが利用できない場合(is_success=false):
指定されたエンティティはいずれも見つかりませんでした。

一部のエンティティに脆弱性がない場合(is_success=true):

Cisco Vulnerability Management で、指定された条件に基づく脆弱性が次のエンティティで見つかりませんでした。 {entity.identifier}

すべてのエンティティに脆弱性がない場合(is_success=true):

指定されたエンティティで、指定された条件に基づく脆弱性が見つかりませんでした。

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

認証情報が間違っている、サーバーに接続できない、その他など、致命的なエラーが発生した場合:
「アクション「アセットの脆弱性の一覧表示」の実行エラー」が出力されます。理由: {0}」.format(error.Stacktrace)
全般

データ エクスポートをリクエストする

Cisco Vulnerability Management からデータ エクスポートをリクエストし、結果をケースウォールに添付します。このアクションは Google SecOps エンティティでは実行されません。

この操作は非同期です。必要に応じて、Google SecOps IDE でスクリプト タイムアウト値を調整します。

パラメータ

パラメータ名 種類 デフォルト値 必須 説明
エクスポート形式 DDL JSON

有効な値:
  • JSON
  • JSONL
  • XML
はい データ エクスポートの形式。
モデルをエクスポート DDL アセット

有効な値:
  • アセット
  • 脆弱性
  • 修正
  • 検出結果
はい エクスポートする必要があるオブジェクトのモデル。
エクスポート フィールド CSV いいえ 返されるフィールドのカンマ区切りのリスト。
クエリフィルタ 文字列 いいえ エクスポートするデータをフィルタするクエリ。

実行

なし

アクションの結果

スクリプトの結果
スクリプトの結果名 値のオプション 例
is_success True/False is_success:False
ケースウォール
結果のタイプ 説明 種類
出力メッセージ * アクションが失敗したり、ハンドブックの実行が停止したりすることはありません。

データが利用可能な場合(is_success = true):
「Cisco Vulnerability Management でデータ エクスポートが正常に実行されました」と出力されます。

非同期メッセージ:
データのエクスポートが完了するのを待機しています…


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

認証情報が誤っている、サーバーへの接続がないなどの致命的なエラーの場合、その他:
次のように出力されます。「アクション「データ エクスポートのリクエスト」の実行エラー。理由: {0}」.format(error.Stacktrace)

レスポンスに error_message がある場合:

print "Error executing action "Request Data Export". 理由: {error_message}」
全般

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