整合 Mandiant Attack Surface Management 與 Google SecOps

本文說明如何將 Mandiant Attack Surface Management 與 Google Security Operations (Google SecOps) 整合。

在 Google SecOps 平台中，Mandiant Attack Surface Management 的整合項目稱為「Mandiant ASM」。

用途

Mandiant ASM 整合功能會使用 Google SecOps 功能，支援下列用途：

  • 資產探索：監控及探索對外資產，找出潛在的安全漏洞。

  • 擷取問題：在 Google SecOps 中，將 Mandiant Attack Surface Management 問題擷取為快訊。

  • 充實事件：充實安全性事件，提供詳細的攻擊面實體資訊。

  • 排定修復作業優先順序：根據 Mandiant Attack Surface Management 安全漏洞和問題嚴重程度，排定修復作業優先順序。

  • 更新問題狀態：直接從 Google SecOps 平台更新 Mandiant Attack Surface Management 問題狀態。

事前準備

這項整合功能提供原生平台功能，不需要外部第三方 API 金鑰或憑證即可進行驗證。開始之前，請確認已從 Google SecOps 執行個體的內容中心安裝整合項目。

整合參數

Mandiant Attack Surface Management 整合功能需要下列參數：

參數 說明
API Root

這是必填欄位。

Mandiant 執行個體的 API 根目錄。

預設值為 https://asm-api.advantage.mandiant.com。

如要使用 Google Threat Intelligence 憑證進行驗證，請輸入下列值：https://www.virustotal.com。
Access Key

選填。

Mandiant Attack Surface Management 帳戶的 API 存取金鑰。

如要在 Mandiant Attack Surface Management 中產生存取金鑰，請依序前往「Account settings」(帳戶設定) >「API keys」(API 金鑰) >「Generate new key」(產生新的金鑰)。
Secret Key

選填。

Mandiant Attack Surface Management 帳戶的 API 密鑰。

如要在 Mandiant Attack Surface Management 中產生 Secret Key，請依序前往 「Account settings」(帳戶設定) >「API keys」(API 金鑰) >「Generate new key」(產生新的金鑰)。

Project Name

選填。

要在整合中使用的專案名稱。

如果您使用 Access Key 和 Secret Key 參數進行驗證，則必須提供這個參數，才能執行搜尋 ASM 實體和搜尋問題動作。
GTI API Key

選填。

Google Threat Intelligence 的 API 金鑰。

如要使用 Google Threat Intelligence 進行驗證，請將 API Root 參數值設為 https://www.virustotal.com。

使用 Google Threat Intelligence API 金鑰驗證時，系統會優先採用此方法，而非其他驗證方式。
Verify SSL

這是必填欄位。

如果選取，整合功能會驗證 SSL 憑證的有效性，以便連線至 Mandiant 伺服器。

預設為選取。

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」。

如有需要，您可以在後續階段進行變更。設定整合執行個體後，即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

取得 ASM 實體詳細資料

使用「Get ASM Entity Details」(取得 ASM 實體詳細資料) 動作，傳回 Mandiant Attack Surface Management 實體的相關資訊。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Get ASM Entity Details」動作需要下列參數：

參數 說明
Entity ID

這是必填欄位。

列出要擷取詳細資料的實體 ID，並以半形逗號分隔。

動作輸出內容

「Get ASM Entity Details」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Get ASM Entity Details」動作時，收到的 JSON 結果輸出內容：

{
 "uuid": "UUID",
 "dynamic_id": "Intrigue::Entity::Uri#http://192.0.2.73:80",
 "collection_name": "cpndemorange_oum28bu",
 "alias_group": 8515,
 "aliases": [
   "http://192.0.2.73:80"
 ],
 "allow_list": false,
 "ancestors": [
   {
     "type": "Intrigue::Entity::NetBlock",
     "name": "192.0.2.0/24"
   }
 ],
 "category": null,
 "collection_naics": null,
 "confidence": null,
 "deleted": false,
 "deny_list": false,
 "details": {
   "asn": null,
   "ssl": false,
   "uri": "http://192.0.2.73:80",
   "code": "404",
   "port": 80,
   "forms": false,
   "title": "404 Not Found",
   "verbs": null,
   "cookies": null,
   "headers": [
     "Date: Fri, 30 Sep 2022 06:51:11 GMT",
     "Content-Type: text/html",
     "Content-Length: 548",
     "Connection: keep-alive"
   ],
   "host_id": 8615,
   "net_geo": "US",
   "scripts": [],
   "service": "http",
   "auth.2fa": false,
   "auth.any": false,
   "dom_sha1": "540707399c1b58afd2463ec43da3b41444fbde32",
   "net_name": "",
   "protocol": "tcp",
   "alt_names": null,
   "auth.ntlm": false,
   "generator": null,
   "auth.basic": false,
   "auth.forms": false,
   "ip_address": "192.0.2.73",
   "favicon_md5": null,
   "fingerprint": [
     {
       "cpe": "cpe:2.3:a:example:example::",
       "hide": false,
       "tags": [
         "Web Server"
       ],
       "type": "fingerprint",
       "tasks": null,
       "issues": null,
       "method": "ident",
       "update": null,
       "vendor": "Example",
       "product": "Example",
       "version": null,
       "inference": false,
       "description": "example (default page)",
       "match_logic": "all",
       "positive_matches": [
         {
           "match_type": "content_body",
           "match_content": "(?i-mx:<hr><center>example\/?([\\d.]*)<\/center>)"
         }
       ]
     },
     {
       "cpe": "cpe:2.3:a:example:example::",
       "hide": false,
       "tags": [
         "Web Server"
       ],
       "type": "fingerprint",
       "tasks": null,
       "issues": null,
       "method": "ident",
       "update": null,
       "vendor": "example",
       "product": "example",
       "version": null,
       "inference": false,
       "description": "example (default page - could be redirect)",
       "match_logic": "all",
       "positive_matches": [
         {
           "match_type": "content_body",
           "match_content": "(?i-mx:<hr><center>example\/?[\\d.]*<\/center>)"
         }
       ]
     }
   ],
   "geolocation": {
     "asn": {
       "asn": 16509,
       "isp": "Example Inc.",
       "name": "example.com, Inc.",
       "organization": "Example Services",
       "connection_type": "Corporate"
     },
     "city": "Singapore",
     "country": "Singapore",
     "latitude": 1.35208,
     "continent": "Asia",
     "longitude": 103.82,
     "time_zone": "Asia/Singapore",
     "country_code": "SG",
     "continent_code": "AS"
   },
   "vuln_checks": [
     "log4shell_cve_2021_44228"
   ],
   "api_endpoint": false,
   "cloud_hosted": true,
   "favicon_sha1": null,
   "domain_cookies": null,
   "log4shell_uuid": "55be320622c4937c01738e092579edaa338fd90e2a",
   "redirect_chain": [],
   "redirect_count": 0,
   "cloud_providers": [
     "Cloud Provider Name"
   ],
   "hidden_original": "http://192.0.2.73:80",
   "net_country_code": null,
   "screenshot_exists": true,
   "cloud_fingerprints": [],
   "response_data_hash": "1GUXIXXTXUk/sWM+I3cAAivYSfoSMWR5CxaLgxissJA=",
   "extended_favicon_data": null,
   "extended_path_to_seed": [
     {
       "id": 8620,
       "_id": 8605,
       "name": "http://192.0.2.73:80",
       "seed": false,
       "type": "Intrigue::Entity::Uri",
       "_type": "Entity",
       "creates": [
         {
           "id": 6158,
           "_id": 6152,
           "name": "192.0.2.0/24",
           "seed": true,
           "type": "Intrigue::Entity::NetBlock",
           "_type": "Entity",
           "creates.verb": "queried",
           "creates.source_name": "search_shodan",
           "creates.source_type": "internet_scan_database"
         }
       ]
     }
   ],
   "extended_configuration": [
     {
       "hide": false,
       "name": "Example Page Content",
       "task": null,
       "type": "content",
       "issue": null,
       "result": 566218143
     },
     {
       "hide": false,
       "name": "Example",
       "task": null,
       "type": "content",
       "issue": null,
       "result": 566218143
     },
     {
       "cpe": "cpe:2.3:a:example:example::",
       "hide": false,
       "tags": [
         "Web Server"
       ],
       "type": "fingerprint",
       "tasks": null,
       "issues": null,
       "method": "ident",
       "update": null,
       "vendor": "Example",
       "product": "Example",
       "version": null,
       "inference": false,
       "description": "example (default page)",
       "match_logic": "all",
       "positive_matches": [
         {
           "match_type": "content_body",
           "match_content": "(?i-mx:<hr><center>example\/?([\\d.]*)<\/center>)"
         }
       ]
     },
     {
       "cpe": "cpe:2.3:a:example:example::",
       "hide": false,
       "tags": [
         "Web Server"
       ],
       "type": "fingerprint",
       "tasks": null,
       "issues": null,
       "method": "ident",
       "update": null,
       "vendor": "Example",
       "product": "Example",
       "version": null,
       "inference": false,
       "description": "example (default page - could be redirect)",
       "match_logic": "all",
       "positive_matches": [
         {
           "match_type": "content_body",
           "match_content": "(?i-mx:<hr><center>example\/?[\\d.]*<\/center>)"
         }
       ]
     }
   ],
   "extended_response_body": "<html>\r\n<head><title>404 Not Found</title></head>\r\n<body>\r\n<center><h1>404 Not Found</h1></center>\r\n<hr><center>example</center>\r\n</body>\r\n</html>\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n",
   "exfil_lookup_identifier": "55be320622c4937c01738e092579edaa",
   "extended_shodan_details": {
     "ip": 50387017,
     "os": null,
     "asn": "ASN",
     "isp": "Example.com, Inc.",
     "org": "Example Services",
     "data": "HTTP/1.1 404 Not Found\r\nDate: Fri, 30 Sep 2022 05:16:32 GMT\r\nContent-Type: text/html\r\nContent-Length: 548\r\nConnection: keep-alive\r\n\r\n",
     "hash": -744989972,
     "http": {
       "host": "192.0.2.73",
       "html": "<html>\r\n<head><title>404 Not Found</title></head>\r\n<body>\r\n<center><h1>404 Not Found</h1></center>\r\n<hr><center>example</center>\r\n</body>\r\n</html>\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n<!-- a padding to disable MSIE and Chrome friendly error page -->\r\n",
       "title": "404 Not Found",
       "robots": null,
       "server": null,
       "status": 404,
       "sitemap": null,
       "location": "/",
       "html_hash": -2090962452,
       "redirects": [],
       "components": {},
       "robots_hash": null,
       "securitytxt": null,
       "headers_hash": -873436690,
       "sitemap_hash": null,
       "securitytxt_hash": null
     },
     "tags": [
       "cloud"
     ],
     "cloud": {
       "region": "ap-southeast-1",
       "service": "Example",
       "provider": "Example"
     },
     "ip_str": "192.0.2.73",
     "_shodan": {
       "id": "ID",
       "ptr": true,
       "module": "http",
       "region": "eu",
       "crawler": "f4bb88763d8ed3a0f3f91439c2c62b77fb9e06f3",
       "options": {}
     },
     "domains": [
       "example.com"
     ],
     "location": {
       "city": "Singapore",
       "latitude": 1.28967,
       "area_code": null,
       "longitude": 103.85007,
       "region_code": "01",
       "country_code": "SG",
       "country_name": "Singapore"
     },
     "hostnames": [
       "ec2-192-0-2-73.ap-southeast-1.compute.example.com"
     ],
     "timestamp": "2022-09-30T05:16:33.068993"
   },
   "hidden_port_open_confirmed": true,
   "extended_screenshot_contents": "iVBORw0KGgoAAA"
 },
 "details_file": "data/v4/cpndemorange_oum28bu/2022_09_30/cpndemorange_oum28bu/entities/ID.json",
 "description": null,
 "first_seen": "2022-09-30T21:20:19.000Z",
 "hidden": false,
 "last_seen": "2022-09-30T21:20:19.000Z",
 "name": "http://192.0.2.73:80",
 "scoped": true,
 "scoped_reason": "entity_scoping_rules: fallback value",
 "seed": false,
 "source": null,
 "status": null,
 "task_results": [],
 "type": "Intrigue::Entity::Uri",
 "uid": "UID",
 "created_at": "2022-09-30T21:25:05.232Z",
 "updated_at": "2022-09-30T21:25:05.239Z",
 "collection_id": 117139,
 "elasticsearch_mappings_hash": null,
 "collection": "cpndemorange_oum28bu",
 "collection_uuid": "UUID",
 "organization_uuid": "UUID",
 "collection_type": "user_collection",
 "fingerprint": [
   {
     "cpe": "cpe:2.3:a:example:example::",
     "hide": false,
     "tags": [
       "Web Server"
     ],
     "type": "fingerprint",
     "tasks": null,
     "issues": null,
     "method": "ident",
     "update": null,
     "vendor": "Example",
     "product": "Example",
     "version": null,
     "inference": false,
     "description": "example (default page)",
     "match_logic": "all",
     "positive_matches": [
       {
         "match_type": "content_body",
         "match_content": "(?i-mx:<hr><center>example\/?([\\d.]*)<\/center>)"
       }
     ],
     "local_icon_path": "/assets/fingerprints/example.png"
   },
   {
     "cpe": "cpe:2.3:a:example:example::",
     "hide": false,
     "tags": [
       "Web Server"
     ],
     "type": "fingerprint",
     "tasks": null,
     "issues": null,
     "method": "ident",
     "update": null,
     "vendor": "Example",
     "product": "Example",
     "version": null,
     "inference": false,
     "description": "example (default page - could be redirect)",
     "match_logic": "all",
     "positive_matches": [
       {
         "match_type": "content_body",
         "match_content": "(?i-mx:<hr><center>example\/?[\\d.]*<\/center>)"
       }
     ],
     "local_icon_path": "/assets/fingerprints/example.png"
   }
 ],
 "summary": {
   "scoped": true,
   "issues": {
     "current_with_cve": 0,
     "current_by_severity": {
       "1": 1
     },
     "all_time_by_severity": {
       "1": 1
     },
     "current_count": 1,
     "all_time_count": 1,
     "critical_or_high": true
   },
   "task_results": [
     "search_shodan",
     "port_scan",
     "port_scan_lambda",
     "search_shodan"
   ],
   "screenshot_exists": true,
   "geolocation": {
     "city": "Singapore",
     "country_code": "SG",
     "country_name": null,
     "latitude": 1.35208,
     "longitude": 103.82,
     "asn": null
   },
   "http": {
     "code": 404,
     "title": "404 Not Found",
     "content": {
       "favicon_hash": null,
       "hash": null,
       "forms": false
     },
     "auth": {
       "any": false,
       "basic": false,
       "ntlm": false,
       "forms": false,
       "2fa": false
     }
   },
   "ports": {
     "tcp": [
       80
     ],
     "udp": [],
     "count": 1
   },
   "network": {
     "name": "example.com, Inc.",
     "asn": 16509,
     "route": null,
     "type": null
   },
   "technology": {
     "cloud": true,
     "cloud_providers": [
       "Cloud Provider Name"
     ],
     "cpes": [],
     "technologies": [],
     "technology_labels": []
   },
   "vulns": {
     "current_count": 0,
     "vulns": []
   }
 },
 "tags": [],
 "id": "ID",
 "scoped_at": "2022-09-30 06:51:57 +0000",
 "detail_string": "Fingerprint: Example |  Title: 404 Not Found",
 "enrichment_tasks": [
   "enrich/uri",
   "sslcan"
 ],
 "generated_at": "2022-09-30T21:21:18Z"
}
輸出訊息

「Get ASM Entity Details」動作可傳回下列輸出訊息：

輸出訊息 訊息說明

Successfully return details for the following entities using information from Mandiant ASM: ENTITY_ID

Action wasn't able to return details for the following entities using information from Mandiant ASM: ENTITY_ID

 動作成功。
Error executing action "Get ASM Entity Details". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表列出使用「Get ASM Entity Details」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success True或False

搜尋 ASM 實體

使用「Search ASM Entities」(搜尋 ASM 實體) 動作，在 Mandiant Attack Surface Management 中搜尋實體。

如果您使用 Access Key 和 Secret Key 參數進行驗證，請一併在整合參數中設定 Project Name 參數。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Search ASM Entities」(搜尋 ASM 實體) 動作需要下列參數：

參數 說明
Entity Name

選填。

以半形逗號分隔的實體名稱清單，用於尋找實體。

為避免動作失敗，請勿在設定這個參數的值時使用斜線字元 /。
Minimum Vulnerabilities Count

選填。

與傳回實體相關的安全漏洞數量。
Minimum Issues Count

選填。

與傳回實體相關的問題數量。
Tags

選填。

搜尋實體時要使用的標記名稱清單，以半形逗號分隔。
Max Entities To Return

選填。

要傳回的實體數量。

預設值為 50。最大值為 200。
Critical or High Issue

選填。

如果選取，動作只會傳回有 High 或 Critical 問題的實體。

預設為未選取。

動作輸出內容

「Search ASM Entities」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Search ASM Entities」動作時，收到的 JSON 結果輸出內容：

{
 "id": "ID",
 "dynamic_id": "Intrigue::Entity::IpAddress#192.0.2.92",
 "alias_group": "1935953",
 "name": "192.0.2.92",
 "type": "Intrigue::Entity::IpAddress",
 "first_seen": "2022-02-02T01:44:46Z",
 "last_seen": "2022-02-02T01:44:46Z",
 "collection": "cpndemorange_oum28bu",
 "collection_type": "Intrigue::Collections::UserCollection",
 "collection_naics": [],
 "collection_uuid": "COLLECTION_UUID",
 "organization_uuid": "ORGANIZATION_UUID",
 "tags": [],
 "issues": [],
 "exfil_lookup_identifier": null,
 "summary": {
     "scoped": true,
     "issues": {
         "current_by_severity": {},
         "current_with_cve": 0,
         "all_time_by_severity": {},
         "current_count": 0,
         "all_time_count": 0,
         "critical_or_high": false
     },
     "task_results": [
         "search_shodan"
     ],
     "geolocation": {
         "city": "San Jose",
         "country_code": "US",
         "country_name": null,
         "latitude": "-121.8896",
         "asn": null
     },
     "ports": {
         "count": 0,
         "tcp": null,
         "udp": null
     },
     "resolutions": [
         "ec2-192-0-2-92.us-west-1.compute.example.com"
     ],
     "network": {
         "name": "EXAMPLE-02",
         "asn": "16509.0",
         "route": "2001:db8::/32",
         "type": null
     },
     "technology": {
         "cloud": true,
         "cloud_providers": [
             "Cloud Provider Name"
         ]
     }
 }
}
輸出訊息

「Search ASM Entities」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明

Successfully returned entities based on the provided criteria in Mandiant ASM.

No entities were found based on the provided criteria in Mandiant ASM.

 動作成功。
Error executing action "Search ASM Entities". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表列出使用「Search ASM Entities」動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success True或False

搜尋服務相關問題

使用「搜尋問題」動作，在 Mandiant Attack Surface Management 中搜尋問題。

如果您使用 Access Key 和 Secret Key 參數進行驗證，請一併在整合參數中設定 Project Name 參數。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Search Issues」動作需要下列參數：

參數 說明
Issue ID

選填。

以半形逗號分隔的問題 ID 清單，用於傳回詳細資料。
Entity ID

選填。

以半形逗號分隔的實體 ID 清單，用於尋找相關問題。
Entity Name

選填。

以半形逗號分隔的實體名稱清單，用於尋找相關問題。

為避免動作失敗，請勿在設定這個參數的值時使用 / 正斜線字元。
Time Parameter

選填。

設定問題時間的篩選器選項。

可能的值為 First Seen 和 Last Seen。

預設值為 First Seen。
Time Frame

選填。

篩選問題的時間範圍。如果選取 Custom，請設定 Start Time 參數。

可能的值如下：

  • Last Hour
  • Last 6 Hours
  • Last 24 Hours
  • Last Week
  • Last Month
  • Custom

預設值為 Last Hour。
Start Time

選填。

結果的開始時間。

如果您為 Time Frame 參數選取 Custom，則必須提供這個參數。請以 ISO 8601 格式設定值。
End Time

選填。

結果的結束時間。

如果您為 Time Frame 參數選取 Custom，且未設定結束時間，則這個參數會將目前時間設為結束時間。請以 ISO 8601 格式設定值。
Lowest Severity To Return

選填。

要傳回的問題最低嚴重性。

可能的值如下：

  • Select One
  • Critical
  • High
  • Medium
  • Low
  • Informational

預設值為 Select One。

如果選取「Select One」，這項篩選條件就不會套用至搜尋。
Status

選填。

搜尋的狀態篩選器。

可能的值為 Open、Closed 和 Select One。

預設值為 Select One。

如果選取「Select One」，這項篩選條件就不會套用至搜尋。
Tags

選填。

搜尋問題時要使用的標記名稱清單，以半形逗號分隔。
Max Issues To Return

選填。

要傳回的問題數量。

預設值為 50。最大值為 200。

動作輸出內容

「搜尋問題」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「搜尋問題」動作時，收到的 JSON 結果輸出內容：

{
 "id": "ID",
 "uuid": "UUID",
 "dynamic_id": 20073997,
 "name": "exposed_ftp_service",
 "upstream": "intrigue",
 "last_seen": "2022-02-02T01:44:46.000Z",
 "first_seen": "2022-02-02T01:44:46.000Z",
 "entity_uid": "3443a638f951bdc23d3a089bff738cd961a387958c7f5e4975a26f12e544241f",
 "entity_type": "Intrigue::Entity::NetworkService",
 "entity_name": "192.0.2.204:24/tcp",
 "alias_group": "1937534",
 "collection": "cpndemorange_oum28bu",
 "collection_uuid": "COLLECTION_UUID",
 "collection_type": "user_collection",
 "organization_uuid": "ORGANIZATION_UUID",
 "summary": {
     "pretty_name": "Exposed FTP Service",
     "severity": 3,
     "scoped": true,
     "confidence": "confirmed",
     "status": "open_new",
     "category": "misconfiguration",
     "identifiers": null,
     "status_new": "open",
     "status_new_detailed": "new",
     "ticket_list": null
 },
 "tags": []
}
輸出訊息

「Search Issues」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明

Successfully returned issues based on the provided criteria in Mandiant ASM.

No issues were found based on the provided criteria in Mandiant ASM.

 動作成功。
Error executing action "Search Issues". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表列出使用「Search Issues」(搜尋問題) 動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success True或False

更新問題

使用「更新問題」動作，更新 Mandiant Attack Surface Management 中的問題。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Update Issue」動作需要下列參數：

參數 說明
Issue ID

這是必填欄位。

要更新的問題 ID。
Status

這是必填欄位。

要為問題設定的狀態。

可能的值如下：

  • Select One
  • New
  • Triaged
  • In Progress
  • Resolved
  • Duplicate
  • Out Of Scope
  • Not A Security Issue (Benign)
  • Risk Accepted
  • False Positive
  • Unable To Reproduce
  • Tracked Externally
  • Mitigated

預設值為 Select One。

動作輸出內容

「Update Issue」動作會提供下列輸出內容：

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 無法使用
輸出訊息 可用
指令碼執行結果 可用
輸出訊息

「Update Issue」動作可能會傳回下列輸出訊息：

輸出訊息 訊息說明
Successfully updated issue with ID "ISSUE_ID" in Mandiant ASM. 動作成功。
Error executing action "Update Issue". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表列出使用「Update Issue」(更新問題) 動作時，指令碼結果輸出的值：

指令碼結果名稱 值
is_success True或False

連接器

如要進一步瞭解如何在 Google SecOps 中設定連接器，請參閱「擷取資料 (連接器)」。

Mandiant ASM - Issues 連接器

使用 Mandiant ASM - Issues Connector，從 Mandiant Attack Surface Management 提取問題相關資訊。

動態清單篩選器可與 category 參數搭配使用。

Mandiant ASM – Issues Connector 需要下列參數：

參數 說明
Product Field Name

這是必填欄位。

儲存產品名稱的欄位名稱。

預設值為 Product Name。

產品名稱主要會影響對應。為簡化及改善連接器的對應程序，預設值 Product Name 會解析為程式碼參照的備用值。根據預設，這個參數的任何無效輸入值都會解析為備用值。
Event Field Name

這是必填欄位。

儲存事件名稱的欄位名稱。

預設值為 entity_type。
Environment Field Name

選填。

儲存環境名稱的欄位名稱。

如果找不到環境欄位，則環境為預設環境。
Environment Regex Pattern

選填。

規則運算式模式，用於對 Environment Field Name 欄位中的值執行。這個參數可讓您使用規則運算式邏輯，操控環境欄位。

使用預設值 .* 擷取必要的原始 Environment Field Name 值。

如果規則運算式模式為空值或空白，或環境值為空值，則最終環境結果為 ""。
Script Timeout (Seconds)

這是必填欄位。

執行目前指令碼的 Python 程序逾時限制 (以秒為單位)。

預設值為 180。
API Root

這是必填欄位。

Mandiant 執行個體的 API 根目錄。

預設值為 https://asm-api.advantage.mandiant.com。

如要使用 Google Threat Intelligence 憑證進行驗證，請輸入下列值：https://www.virustotal.com。
Access Key

選填。

Mandiant Attack Surface Management 帳戶的 API 存取金鑰。

如要在 Mandiant Attack Surface Management 中產生存取金鑰，請依序前往「Account settings」(帳戶設定) >「API keys」(API 金鑰) >「Generate new key」(產生新的金鑰)。
Secret Key

選填。

Mandiant Attack Surface Management 帳戶的 API 密鑰。

如要在 Mandiant Attack Surface Management 中產生 Secret Key，請依序前往 「Account settings」(帳戶設定) >「API keys」(API 金鑰) >「Generate new key」(產生新的金鑰)。

Project Name

選填。

要在整合中使用的專案名稱。

如果使用 Access Key 和 Secret Key 參數進行驗證，則必須提供這項資訊。
GTI API Key

選填。

Google Threat Intelligence 的 API 金鑰。

如要使用 Google Threat Intelligence 進行驗證，請將 API Root 參數值設為 https://www.virustotal.com。

使用 Google Threat Intelligence API 金鑰進行驗證的優先順序高於其他驗證方式。
Lowest Severity To Fetch

選填。

要擷取的問題最低嚴重性。

可能的值如下：

  • Critical
  • High
  • Medium
  • Low
  • Informational

如未設定值，連接器會擷取所有嚴重性類型的問題。
Max Hours Backwards

選填。

在第一次連接器疊代前，要擷取事件的小時數。這個參數可套用至首次啟用連接器後的初始連接器疊代，或過期連接器時間戳記的備用值。

預設值為 1。
Max Issues To Fetch

選填。

單次連接器疊代中要處理的問題數量。

預設值為 10。
Use dynamic list as a blocklist

這是必填欄位。

如果選取，連接器會將動態清單做為封鎖清單。

預設為未選取。
Verify SSL

這是必填欄位。

如果選取，則會驗證連至 Mandiant 伺服器的 SSL 憑證是否有效。

預設為選取。
Proxy Server Address

選填。

要使用的 Proxy 伺服器位址。
Proxy Username

選填。

用於驗證的 Proxy 使用者名稱。
Proxy Password

選填。

用於驗證的 Proxy 密碼。

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求解答。