此页面由 Cloud Translation API 翻译。

将 Mandiant Attack Surface Management 与 Google SecOps 集成

集成版本：9.0

本文档介绍了如何将 Mandiant Attack Surface Management 与 Google Security Operations (Google SecOps) 集成。

在 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 中生成访问密钥，请依次前往账号设置 > API 密钥 > 生成新密钥。
`Secret Key`	可选。 Mandiant Attack Surface Management 账号的 API 密钥。如需在 Mandiant Attack Surface Management 中生成密钥，请依次前往账号设置 > API 密钥 > 生成新密钥。
`Project Name`	可选。要在集成中使用的项目名称。如果您使用 `Access Key` 和 `Secret Key` 参数进行身份验证，则必须使用此参数才能运行 Search ASM Entities 和 Search Issues 操作。
`GTI API Key`	可选。 Google Threat Intelligence 的 API 密钥。如需使用 Google 威胁情报进行身份验证，请将 `API Root` 参数值设置为 `https://www.virustotal.com`。当您使用 Google Threat Intelligence API 密钥进行身份验证时，该方法会优先于其他身份验证方法。
`Verify SSL`	必填。如果选择此项，集成会验证与 Mandiant 服务器的连接的 SSL 证书是否有效。此选项将会默认选中。

如需了解如何在 Google SecOps 中配置集成，请参阅配置集成。

如果需要，您可以在稍后阶段进行更改。配置集成实例后，您可以在 playbook 中使用该实例。如需详细了解如何配置和支持多个实例，请参阅支持多个实例。

操作

如需详细了解操作，请参阅处理“工作台”中的待处理操作和执行手动操作。

获取 ASM 实体的详细信息

使用 Get ASM Entity Details 操作可返回有关 Mandiant Attack Surface Management 实体的相关信息。

此操作不适用于 Google SecOps 实体。

操作输入

获取 ASM 实体的详细信息操作需要以下参数：

参数说明

参数	说明
`Entity ID`	必填。以英文逗号分隔的实体 ID 列表，用于检索详细信息。

Entity ID

必填。

以英文逗号分隔的实体 ID 列表，用于检索详细信息。

操作输出

获取 ASM 实体详情操作提供以下输出：

操作输出类型	可用性
案例墙附件	不可用
案例墙链接	不可用
“支持请求墙”表格	不可用
丰富化表	不可用
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"
}

输出消息

获取 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

操作失败。

检查与服务器的连接、输入参数或凭据。

脚本结果

下表列出了使用 Get ASM Entity Details 操作时脚本结果输出的值：

脚本结果名称	值
`is_success`	`True` 或 `False`

搜索 ASM 实体

使用 Search ASM Entities 操作在 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 结果

以下示例展示了使用搜索 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"
         ]
     }
 }
}

输出消息

搜索 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

操作失败。

检查与服务器的连接、输入参数或凭据。

脚本结果

下表列出了使用 Search ASM Entities 操作时脚本结果输出的值：

脚本结果名称	值
`is_success`	`True` 或 `False`

搜索问题

使用 Search Issues 操作在 Mandiant Attack Surface Management 中搜索问题。

如果您使用 Access Key 和 Secret Key 参数进行身份验证，还需在集成参数中配置 Project Name 参数。

此操作不适用于 Google SecOps 实体。

操作输入

搜索问题操作需要以下参数：

参数	说明
`Issue ID`	可选。要返回详细信息的 issue 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

操作失败。

检查与服务器的连接、输入参数或凭据。

脚本结果

下表列出了使用 Search Issues 操作时脚本结果输出的值：

脚本结果名称	值
`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 - 问题连接器从 Mandiant Attack Surface Management 中提取有关问题的信息。

动态列表过滤条件可与 category 参数搭配使用。

Mandiant ASM - 问题连接器需要以下参数：

参数	说明
`Product Field Name`	必填。存储商品名称的字段的名称。默认值为 `Product Name`。商品名称主要影响映射。为了简化和改进连接器的映射流程，默认值 `Product Name` 会解析为代码中引用的回退值。此参数的任何无效输入默认都会解析为回退值。
`Event Field Name`	必填。存储事件名称的字段的名称。默认值为 `entity_type`。
`Environment Field Name`	可选。存储环境名称的字段的名称。如果找不到环境字段，则环境为默认环境。
`Environment Regex Pattern`	可选。要对 `Environment Field Name` 字段中找到的值运行的正则表达式模式。此参数可让您使用正则表达式逻辑来操纵环境字段。使用默认值 `.*` 可检索所需的原始 `Environment Field Name` 值。如果正则表达式模式为 null 或空，或者环境值为 null，则最终环境结果为 `""`。
`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 中生成访问密钥，请依次前往账号设置 > API 密钥 > 生成新密钥。
`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 Username`	可选。用于进行身份验证的代理用户名。
`Proxy Password`	可选。用于进行身份验证的代理密码。