将 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 中生成访问密钥，请依次前往账号设置 > 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 中配置集成，请参阅配置集成。

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

操作

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

获取 ASM 实体的详细信息

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

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

操作输入

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

参数 说明
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

操作失败。

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

下表列出了使用 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

操作失败。

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

下表列出了使用 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

操作失败。

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

下表列出了使用搜索问题操作时脚本结果输出的值：

脚本结果名称 值
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。

操作输出

更新问题操作提供以下输出：

操作输出类型 可用性
案例墙附件 不可用
案例墙链接 不可用
“支持请求墙”表格 不可用
丰富化表 不可用
JSON 结果 不可用
输出消息 可用
脚本结果 可用
输出消息

更新问题操作可以返回以下输出消息：

输出消息 消息说明
Successfully updated issue with ID "ISSUE_ID" in Mandiant ASM. 操作成功。
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

可选。

用于进行身份验证的代理密码。

需要更多帮助？从社区成员和 Google SecOps 专业人士那里获得解答。