本頁面由 Cloud Translation API 翻譯而成。

將 Mandiant Attack Surface Management 與 Google SecOps 整合

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

整合版本：9.0

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

整合參數

整合 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 中產生密鑰，請依序前往「帳戶設定」>「API 金鑰」>「產生新金鑰」。
`Project Name`	選填。要在整合中使用的專案名稱。如果您使用 `Access Key` 和 `Secret Key` 參數進行驗證，則必須使用這個參數才能執行「搜尋 ASM 實體」和「搜尋問題」動作。
`GTI API Key`	選填。 Google Threat Intelligence 的 API 金鑰。如要使用 Google 威脅情報進行驗證，請將 `API Root` 參數值設為 `https://www.virustotal.com`。使用 Google Threat Intelligence API 金鑰進行驗證時，系統會優先採用這種方法，而非其他驗證方法。
`Verify SSL`	必填。如果選取這個選項，整合服務會驗證連線至 Mandiant 伺服器的 SSL 憑證是否有效。 (此為預設選項)。

如需在 Google SecOps 中設定整合功能的操作說明，請參閱「設定整合功能」。

如有需要，您之後可以變更。設定整合執行個體後，您就可以在劇本中使用該執行個體。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「回覆『你的工作台』中的待處理動作」和「執行手動動作」。

取得 ASM 實體詳細資料

使用「Get ASM Entity Details」動作，傳回 Mandiant Attack Surface Management 實體的相關資訊。

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

動作輸入內容

「Get ASM Entity Details」(取得 ASM 實體詳細資料) 動作需要下列參數：

參數說明

參數	說明
`Entity ID`	必填。以半形逗號分隔的實體 ID 清單，用於擷取詳細資料。

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」(取得 ASM 實體詳細資料) 動作可傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`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`	動作失敗。檢查伺服器的連線、輸入參數或憑證。

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

動作失敗。

檢查伺服器的連線、輸入參數或憑證。

指令碼結果

下表列出使用「取得 ASM 實體詳細資料」動作時，指令碼結果輸出的值：

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

搜尋 ASM 實體

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

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

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

動作輸入內容

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

參數	說明
`Entity Name`	選填。以半形逗號分隔的實體名稱清單，用於尋找實體。為避免動作失敗，請勿在設定這個參數的值時使用 `/` 斜線字元。
`Minimum Vulnerabilities Count`	選填。與傳回實體相關的安全性弱點數量。
`Minimum Issues Count`	選填。與傳回實體相關的問題數量。
`Tags`	選填。以半形逗號分隔的標記名稱清單，用於搜尋實體。
`Max Entities To Return`	選填。要傳回的實體數量。預設值為 `50`。最大值為 `200`。
`Critical or High Issue`	選填。如果選取這個選項，動作只會傳回有 `High` 或 `Critical` 相關問題的實體。預設為未選取。

動作輸出內容

「搜尋 ASM 實體」動作會提供下列輸出內容：

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

JSON 結果

以下範例顯示使用「Search ASM Entities」(搜尋 ASM 實體) 動作時收到的 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」(搜尋 ASM 實體) 動作可傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`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`	動作失敗。檢查伺服器的連線、輸入參數或憑證。

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

動作失敗。

檢查伺服器的連線、輸入參數或憑證。

指令碼結果

下表列出使用「搜尋 ASM 實體」動作時，指令碼結果輸出的值：

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

搜尋問題

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

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

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

動作輸入內容

「搜尋問題」動作需要下列參數：

參數	說明
`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": []
}

輸出訊息

「搜尋問題」動作可能會傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`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`	動作失敗。檢查伺服器的連線、輸入參數或憑證。

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

動作失敗。

檢查伺服器的連線、輸入參數或憑證。

指令碼結果

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

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

更新問題

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

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

動作輸入內容

「更新問題」動作需要下列參數：

參數說明

參數	說明
`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`。

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。

動作輸出內容

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

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

輸出訊息

「更新問題」動作可以傳回下列輸出訊息：

輸出訊息訊息說明

Successfully updated issue with ID "ISSUE_ID" in Mandiant ASM. 動作成功。

輸出訊息	訊息說明
`Successfully updated issue with ID "ISSUE_ID" in Mandiant ASM.`	動作成功。
`Error executing action "Update Issue". Reason: ERROR_REASON`	動作失敗。檢查伺服器的連線、輸入參數或憑證。

Error executing action "Update Issue". Reason:
      ERROR_REASON

動作失敗。

檢查伺服器的連線、輸入參數或憑證。

指令碼結果

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

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

連接器

如需在 Google SecOps 中設定連接器的詳細操作說明，請參閱「擷取資料 (連接器)」。

Mandiant ASM - 問題連接器

使用 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 中產生密鑰，請依序前往「帳戶設定」>「API 金鑰」>「產生新金鑰」。
`Project Name`	選填。要在整合中使用的專案名稱。如果您使用 `Access Key` 和 `Secret Key` 參數進行驗證，就必須設定這個屬性。
`GTI API Key`	選填。 Google Threat Intelligence 的 API 金鑰。如要使用 Google 威脅情報進行驗證，請將 `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 專業人員尋求答案。