Google Cloud API

本文档提供了相关指导，可帮助您配置Google Cloud API 并将其与 Google Security Operations 集成。

使用场景

Google Cloud API 集成使用 Google SecOps 功能来支持以下用例：

  • 自动化资源管理：跨 Google Cloud服务（例如 Compute Engine 或 Cloud Storage）执行操作，以动态修复威胁或管理基础设施。

  • 身份和访问权限治理：以编程方式调整 Identity and Access Management 政策或角色，以响应检测到的安全事件。

  • 自定义 API 编排：与任何未进行专门集成的已启用 Google Cloud API 交互，为复杂的 Playbook 提供最大的灵活性。

  • 无密钥身份验证：使用 Workload Identity 安全地访问 Google Cloud 资源，消除与静态服务账号密钥相关的风险。

准备工作

在 Google SecOps 平台中配置集成之前，请验证您是否具备以下条件：

  • 已启用目标 API：确定并启用您计划自动化的特定Google Cloud 服务。

  • IAM 权限：确保您的身份具有执行特定操作所需的角色。

  • 身份验证方法：在推荐的 Workload Identity 或服务账号 JSON 密钥之间进行选择，以进行身份验证。

确定并启用目标 API

由于此集成是通用网关，因此没有固定的 API。 具体要求取决于您的具体应用场景。您必须在项目中启用目标 API（例如 Compute Engine、Cloud Storage 或 IAM），才能通过集成执行这些 API。

请按照以下步骤识别并启用目标 API：

  1. 在 Google Cloud 控制台中，前往 API 和服务 > 库。

  2. 搜索并启用所需的服务。

配置 IAM 权限

此集成使用的服务账号或身份必须具有适当的 IAM 角色。

  • 最小权限原则：仅授予预期 API 调用所需的特定角色。

  • 动态要求：权限因操作而异。例如，管理资源所需的角色与列出资源所需的角色不同。

选择身份验证方法

Google SecOps 支持为此集成使用两种身份验证路径：

使用 Workload Identity 进行身份验证（推荐）

Workload Identity 是最安全的方法，因为它无需管理或轮替长期有效的 JSON 密钥。它利用服务账号模拟 让平台能够安全地访问您的资源

识别 Google SecOps 实例身份

请按照以下步骤查找实例的唯一身份：

  1. 在 Google SecOps 中，前往内容中心 > 响应集成。

  2. 选择 Google Cloud API 集成。

  3. 在 Workload Identity 邮箱字段中输入目标服务账号邮箱。

  4. 点击保存，然后点击测试。测试预计会失败。

  5. 点击测试右侧的 close_small，然后在出错提示中搜索以 gke-init-python@... 或 soar-python@... 开头的身份电子邮件。

  6. 复制此唯一邮箱。

授予模拟权限

完成以下步骤，授权实例身份访问您的资源：

  1. 在 Google Cloud 控制台中，前往 IAM 和管理 > 服务账号。

    转到“服务账号”

  2. 选择目标服务账号，然后依次前往权限 > 授予访问权限。

  3. 将唯一邮箱粘贴到新的主账号字段中，并分配 Service Account Token Creator 角色 (roles/iam.serviceAccountTokenCreator)。

使用 JSON 密钥进行身份验证

仅当您的环境中无法使用 Workload Identity 时，才使用此方法。

请按照以下步骤使用服务账号 JSON 密钥对集成进行身份验证：

  1. 在 Google Cloud 控制台中，创建服务账号。

  2. 前往密钥标签页，然后依次选择添加密钥 > 创建新密钥。

  3. 选择 JSON 作为密钥类型，然后下载文件。

  4. 复制此文件的全部内容，并在 Google SecOps 中的集成配置期间将其粘贴到 Service Account Json File Content 中。

将 Google Cloud API 与 Google SecOps SOAR 集成

集成需要以下参数：

参数 说明
Test URL 可选

用于验证对 Google Cloud API 的身份验证的测试网址。此参数使用 GET 请求。
Service Account Json File Content 可选

服务账号密钥 JSON 文件的内容。

您可以配置此参数、Workload Identity Email 参数，或设置上述所有集成参数。

如需配置此参数，请提供您在创建服务账号时下载的服务账号密钥 JSON 文件的完整内容。

如需详细了解如何将服务账号用作身份验证方法，请参阅服务账号概览和服务账号模拟。

在此集成中，使用服务账号密钥 JSON 文件进行身份验证的优先级高于 Workload Identity 电子邮件。
Organization ID 可选

要在集成中使用的组织 ID。

如需在执行操作期间从此参数中检索值，请设置以下占位符：{{org_id}}。

Project ID 可选

要在集成中使用的项目 ID。

如需在执行操作期间从此参数中检索值，请设置以下占位符：{{project_id}}。
Quota Project ID 可选

您用于 Google Cloud API 和结算的 Google Cloud 项目 ID。此参数要求您向服务账号授予 Service Usage Consumer 角色。

集成会将此参数值附加到所有 API 请求。

如果您未为此参数设置值，则集成会从您的 Google Cloud 服务账号中检索项目 ID。
Workload Identity Email 可选

服务账号的客户端邮箱。

您可以配置此参数或 Service Account Json File Content 参数。

在此集成中，使用服务账号密钥 JSON 文件进行身份验证的优先级高于 Workload Identity 电子邮件。

如需使用 Workload Identity 模拟服务账号，请向服务账号上的 Google SecOps 实例身份授予 Service Account Token Creator 角色。 如需详细了解 Workload Identity 以及如何使用这些身份，请参阅工作负载的身份。
OAuth Scopes 可选

执行 Google Cloud API 请求所需的 OAuth 范围的英文逗号分隔列表。
Verify SSL 必需

如果选中，集成会验证用于连接到 Google Cloud 服务的 SSL 证书是否有效。

默认处于选中状态。

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

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

操作

如需详细了解操作，请参阅 在工作桌上响应待处理的操作和在案例中运行手动操作。

执行 HTTP 请求

使用执行 HTTP 请求操作，针对目标网址构建并执行自定义 HTTP API 请求。

此操作不会在 Google SecOps 实体上运行。

操作行为

此操作支持复杂的行为，包括异步轮询、动态载荷构建和文件管理。

异步轮询

提供 Expected Response Values 时，操作会以异步模式运行。在此模式下，操作会重复轮询目标端点，以跟踪响应的状态（例如，等待长时间运行的任务完成）。

该操作会根据参数中提供的 JSON 条件评估响应正文，并继续执行，直到满足条件或操作超时。

条件逻辑

该操作支持以下逻辑来跟踪响应状态：

  • 单字段匹配：操作会等待特定字段达到单个值。

    {
  "state": "finished"
}

  • 多个值（OR 逻辑）：如果字段与所提供列表中的任何值匹配，操作就会停止执行。这对于在“成功”和“错误”状态下停止以避免不必要的轮询非常有用。

    {
  "state": ["finished", "error"]
}

  • 多个字段（AND 逻辑）：操作会等待，直到所有指定字段同时与其各自的值匹配。

    {
  "state": "finished",
  "percentage": "100"
}

  • 组合逻辑：您可以在 JSON 对象中组合多个条件。

    {
  "state": ["finished", "error"],
  "percentage": "10"
}
JSON 解析行为

在评估条件时，该操作遵循以下规则：

  • 全局搜索：该操作会在整个 JSON 响应对象中搜索指定的键。请提供与 JSON 中完全一致的键名称，不要在前面添加父对象名称或使用前缀（例如，使用 "state"，而不是 "data_state" 或 "data-state"）。

  • 多个相同的键：如果响应在 JSON 层次结构的不同级别包含多个同名键，则只有当所有匹配的键名都满足相同的预期值时，才会达到预期输出。

    例如，如需在 JSON 响应中搜索 finished 状态并忽略其他状态，请将 Expected Response Values 中的所有 state 键设置为 finished：

    {
"data": {
  "state": "finished"
  },
  "state": "finished"
}
正文载荷构造

该操作会根据 Headers 中提供的 Content-Type 标头构建请求正文。

以下是用于以下构造示例的 Body Payload 输入：

{
  "Id": "123123",
  "sorting": "asc"
}

  • application/x-www-form-urlencoded：该操作会生成载荷 Id=123123&sorting=asc。

  • application/json：该操作会生成以下 JSON 载荷：

    {
  "Id": "123123",
  "sorting": "asc"
}

  • XML：如果第三方产品需要 XML，请直接在 Body Payload 中提供 XML 格式的输入：

    <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
<soap:Body>
  <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
    <ubiNum>500</ubiNum>
  </NumberToWords>
</soap:Body>
</soap:Envelope>
文件处理

该操作支持以下文件管理工作流：

  • 下载文件：

    • 如需以 base64 格式返回文件数据作为 JSON 结果的一部分，请选择 Base64 Output。

    • 如需将文件直接保存到支持请求墙中作为 ZIP 归档文件，请选择 Save To Case Wall。

  • 上传文件：如需上传文件，请将其转换为 base64 编码的字符串，并将其作为 Body Payload 值的一部分。

    以下示例展示了转换为 base64 编码字符串的图片文件：

    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

  • 安全：对于敏感文件（例如恶意软件），请选择 Password Protect Zip。这会自动使用密码 infected 对使用 Save To Case Wall 创建的已保存 ZIP 归档文件进行加密。

Playbook 块配置

以下配置演示了如何在 playbook 代码块中使用执行 HTTP 请求操作。通过此示例，您可以了解如何应用占位符和输入前缀。

将块输入用作占位符时，必须添加 Input. 前缀（例如 [Input.comment]）。

  • 方法：PUT

  • 网址路径：

    https://{API_URL}/[Input.table_name]/[Input.sys_id]

  • 标头：

    {
  "Content-type": "application/json; charset=utf-8",
  "Accept": "application/json",
  "User-Agent": "GoogleSecops"
}

  • Body Payload：

    {
  "work_notes": "[Input.comment]"
}

操作输入

执行 HTTP 请求操作需要以下参数：

参数 说明
Method 可选

请求中使用的方法。

默认值为 GET。

可能的值包括：
  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS
URL Path 可选

要执行的网址。

默认值为 https://。
URL Params 可选

网址参数。

该操作会使用提供的任何值以及您在网址路径参数中直接提供的值。

此参数需要 JSON 对象格式作为输入。默认值如下：

{
    "URL Field Name": "URL_FIELD_VALUE"
    }
Headers 可选

要在 HTTP 请求中使用的标头。

此参数需要 JSON 对象格式作为输入。默认值如下：

{
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
    "User-Agent" : "GoogleSecOps"
    }
Cookie 可选

要在 Cookie 标头中使用的参数。

此参数会覆盖 Headers 参数中提供的 Cookie。

此参数需要 JSON 对象格式作为输入。默认值如下：

{
    "Cookie_1": "COOKIE_1_VALUE"
    }
Body Payload
 可选

HTTP 请求的正文。该操作会根据 Headers 参数中提供的 Content-Type 标头值构建不同的载荷。

此参数需要 JSON 对象格式作为输入，除非第三方产品需要 XML 或 multipart/form-data 内容。如果您使用 API 请求提交或上传文件，请在正文载荷参数中提供文件的 base64 编码版本，并将标头设置为 "Content-type": "multipart/form-data"。

默认值如下：

{
    "Body Field Name": "BODY_FIELD_VALUE"
    }
Expected Response Values

可选。

包含定义响应正文所需状态的字段值对的 JSON 对象。
Save To Case Wall 可选

如果选择此选项，该操作会保存文件并将保存的文件附加到案例墙。该文件会以 .zip 扩展名归档。.zip 文件不受密码保护。

默认情况下不选择。
Password Protect Zip 可选

如果选择此操作，则该操作会将密码添加到使用 Save To Case Wall 参数创建的 .zip 文件中。密码如下：infected。

处理可疑文件时，请使用此参数。

默认处于选中状态。
Follow Redirects 可选

如果选中，该操作会遵循重定向。

默认处于选中状态。
Fail on 4xx/5xx 可选

如果选中此选项，当响应的状态代码为 4xx 或 5xx 错误时，操作会失败。

默认处于选中状态。
Base64 Output 可选

如果选中，该操作会将响应转换为 base64 格式。

下载文件时，请使用此参数。

JSON 结果不能超过 15 MB。

默认情况下不选择。
Fields To Return 必需

要返回的字段。可能的值如下：

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding
Request Timeout 必需

在操作失败之前等待服务器发送数据的时间。

默认值为 120 秒。

操作输出

执行 HTTP 请求操作提供以下输出：

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

以下示例说明了使用执行 HTTP 请求操作时收到的 JSON 结果输出：

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "item",
                       "description": "Object to which the comment belongs to."
                   },
                   {
                       "name": "author",
                       "description": "User who wrote the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "VALUE",
       "Date": "Fri, 03 Nov 2023 16:14:13 GMT",
       "Server": "Google Frontend",
       "Content-Length": "36084"
   },
   "apparent_encoding": "ascii"
}
输出消息

执行 HTTP 请求操作提供以下输出消息：

输出消息 消息说明

Successfully executed API request.

Successfully executed API request, but the status code {4xx/5xx} was returned. Please check the request or try again later.

 操作成功。
Failed to execute API request. Error: ERROR_REASON

操作失败。

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

下表介绍了使用执行 HTTP 请求操作时脚本结果输出的值：

脚本结果名称 值
is_success True 或 False

Ping

使用 Ping 操作测试与 Google Cloud的连接。

此操作不会在 Google SecOps 实体上运行。

操作输入

无。

操作输出

Ping 操作提供以下输出：

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

以下示例说明了使用 Ping 操作时收到的 JSON 结果输出：

{
"endpoint": "TEST_URL"
}
输出消息

Ping 操作会提供以下输出消息：

输出消息 消息说明
Successfully tested connectivity. 操作成功。
Failed to test connectivity.

操作失败。

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

下表介绍了使用 Ping 操作时脚本结果输出的值：

脚本结果名称 值
is_success True 或 False

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