将 Azure API 与 Google SecOps 集成

本文档介绍了如何将 Azure API 与 Google Security Operations 集成。

使用场景

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

  • 通用 Microsoft 365 调查：使用自定义 HTTP 请求功能查询任何 Microsoft Graph 端点，使分析师能够通过单一界面收集 Teams、SharePoint 和 Exchange 中的数据。

  • 自定义突发事件修复：在没有专用的“一键式”操作时，执行有针对性的 POST 或 PATCH 请求，以修复 Azure 服务中的威胁，确保快速响应新出现的漏洞。

  • 自动数据注入：从各种 Azure 代码库中按计划注入安全性事件和审核日志，以保持对云环境的全面了解。

  • 安全处理恶意软件：使用内置的受密码保护的 ZIP 归档文件功能，安全地下载和分析可疑文件，防止意外执行恶意内容。

  • 持久身份验证管理：使用刷新令牌续订作业自动轮替 OAuth 2.0 令牌，确保自动化 playbook 和搜寻作业能够不间断地安全访问 Microsoft 365 服务。

准备工作

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

  • Microsoft Entra ID 应用：在 Microsoft Entra ID 门户中注册的应用，用于促进 API 通信。

  • 客户端 ID 和客户端密钥：通过应用注册生成的有效凭据。

  • 租户 ID：Azure Active Directory 实例的唯一标识符。

  • 重定向网址：与集成参数中提供的重定向 URI 匹配的已配置重定向 URI。

  • API 权限（范围）：根据您打算查询的 Azure 服务分配给应用的特定权限。

  • 刷新令牌：有效期为 90 天的令牌，是永久委托访问权限所必需的。

  • 刷新令牌续订作业：一项关键的安全自动化功能，用于防止因令牌过期而导致集成失败。

Azure API 身份验证设置

Azure API 集成支持两种类型的身份验证。所需的一组权限取决于您查询的特定 API 请求和 Azure 服务。

  • 应用权限：API 请求从 Microsoft Entra ID 中配置的应用的角度执行。此设置仅需要客户端 ID 和客户端密钥。

  • 委托权限：API 请求代表已配置模拟的特定用户执行。

建立委托身份验证

如需使用委托权限，您必须按照以下步骤手动生成初始刷新令牌：

  1. 在集成配置中提供 Client ID、Client Secret、Scope、Redirect URL 和 Tenant ID。

  2. 运行获取授权操作。

  3. 在浏览器中打开该操作生成的链接，然后复制生成的重定向链接。

  4. 将重定向的链接作为输入提供给生成令牌操作。

  5. 复制该操作返回的令牌，并在集成配置期间将其输入到 Refresh Token 中。

配置刷新令牌续期

初始刷新令牌的有效期为 90 天。为确保服务不中断，请配置刷新令牌续订作业，以自动更新集成实例的刷新令牌。

集成参数

Azure API 集成需要以下参数：

参数 说明
Microsoft Login API Root

必填。

用于 Azure API 身份验证的 Microsoft Identity Platform 登录服务的 API 根。

默认值为 https://login.microsoftonline.com。
Microsoft Graph API Root

必填。

用于 Azure API 操作的 Microsoft Graph 服务的 API 根。

默认值为 https://graph.microsoft.com。
Client ID

必填。

Azure API 账号的客户端 ID。
Client Secret

必填。

Azure API 账号的客户端密钥。
Tenant ID

必填。

Azure API 账号的租户 ID。
Refresh Token

可选。

用于委托访问 Azure API 账号的刷新令牌。

此令牌的有效期为 90 天，可在初始设置中获取。
Verify SSL

可选。

如果选中，集成会在连接到 Azure API 服务器时验证 SSL 证书。

默认处于启用状态。
Redirect URL

可选。

与 Microsoft Entra ID 应用关联的重定向 URI。

默认值为 http://localhost。
Test URL

必填。

用于通过 GET 请求验证 Azure API 身份验证的网址。
Scopes

必填。

Azure API 身份验证范围的逗号分隔列表。

如需了解如何在 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

可选。

用于请求的 HTTP 方法（动词）。

可能的值如下：

  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS

默认值为 GET。
URL Path

必填。

执行请求的 API 端点。此路径可以选择性地包含查询参数。
URL Params

可选。

网址的查询参数，以 JSON 对象的形式提供。

这是此参数的推荐输入方法，因为它们会附加到 URL Path 中已定义的任何查询参数。
Headers

可选。

HTTP 请求的标头，以 JSON 对象的形式提供。

标头控制身份验证等各个方面，并定义 Body Payload 的格式（使用 Content-Type）。
Cookie

可选。

构建到 HTTP Cookie 标头中的 Cookie，以 JSON 对象的形式提供。

此参数会替换 Headers 中提供的任何 Cookie 值。
Body Payload

可选。

HTTP 请求的内容载荷，以 JSON 对象的形式提供。

请求的格式（JSON 或 form-urlencoded）由 Headers 中设置的 Content-Type 决定。
Expected Response Values

可选。

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

可选。

如果选中，该操作会将响应数据保存为文件，并将其附加到案例墙。

该文件以 .zip 扩展名归档。除非启用了 Password Protect Zip，否则此 ZIP 文件不受密码保护。
Password Protect Zip

可选。

如果选择此选项，该操作会使用密码（例如 infected）对下载的 ZIP 归档文件（使用 Save To Case Wall 创建）进行加密。

在处理可疑或可能恶意的文件时，请使用此选项，以防止意外执行。

默认处于启用状态。
Follow Redirects

可选。

如果选中，该操作会自动遵循任何 HTTP 重定向响应（例如 301 或 302 状态代码）到达最终目标网址。

默认处于启用状态。
Fail on 4xx/5xx

可选。

如果选中，当 HTTP 响应返回客户端错误 (4xx) 或服务器错误 (5xx) 状态代码时，该操作会明确使步骤失败。

默认处于启用状态。
Base64 Output

可选。

如果选中，该操作会将 HTTP 响应正文转换为 Base64 编码的字符串。这对于处理或存储下载的文件非常有用。

编码字符串的大小不能超过 15 MB。
Fields To Return

必填。

操作在输出中返回的字段的英文逗号分隔列表。

可能的值如下：

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding

默认值为 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": "example_resource_name",
                       "description": "Description of the object to which the comment belongs."
                   },
                   {
                       "name": "example_user_role",
                       "description": "Description of the user role associated with the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "REDACTED_TRACE_ID",
       "Date": "REDACTED_DATE_TIME",
       "Server": "REDACTED_SERVER_NAME",
       "Content-Length": "REDACTED_VALUE"
   },
   "apparent_encoding": "ascii"
}
输出消息

执行 HTTP 请求操作可能会返回以下输出消息：

输出消息 消息说明

Successfully executed API request.

Successfully executed API request, but the status code 4xx_OR_5xx was returned. Please check the request or try again later.

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

操作失败。

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

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

脚本结果名称 值
is_success true 或 false

获取授权

使用获取授权操作启动 OAuth 流程，并获取包含委托身份验证所需的访问代码的链接。

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

操作输入

获取授权操作需要以下参数：

参数 说明
Oauth Scopes

必填。

以英文逗号分隔的权限（范围）列表，用于定义访问令牌和刷新令牌的访问权限级别。

默认值为 user.read, offline_access。

操作输出

获取授权操作会提供以下输出：

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

获取授权操作可能会返回以下输出消息：

输出消息 消息说明

Authorization URL generated successfully. To obtain a URL with access code,Please navigate to the link below as the user that you want to run the integration with., to get a URL with access code. Provide the URL with the access code should be provided next in the Generate Token action.

 操作成功。
Failed to generate the authorization URL! Error is ERROR_REASON

操作失败。

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

下表列出了使用获取授权操作时脚本结果输出的值：

脚本结果名称 值
is_success true 或 false

生成令牌

使用生成令牌操作获取委托身份验证所需的永久性刷新令牌。

此令牌是使用从获取授权操作收到的授权网址生成的。

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

操作输入

生成令牌操作需要以下参数：

参数 说明
Authorization URL

必填。

完整的重定向网址，其中包含从获取授权操作收到的授权代码。此网址用于请求和生成刷新令牌。

操作输出

生成令牌操作提供以下输出：

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

生成令牌操作可能会返回以下输出消息：

输出消息 消息说明

Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to enable the integration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. Note: We strongly recommend you configure the "Refresh Token Renewal Job" after you generate the initial refresh token so the job automatically renews and keeps the token valid.

 操作成功。
Failed to get the refresh token! Error is ERROR_REASON

操作失败。

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

下表列出了使用生成令牌操作时脚本结果输出的值：

脚本结果名称 值
is_success true 或 false

Ping

使用 Ping 操作测试与 Azure API 的连接。

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

操作输入

无。

操作输出

Ping 操作提供以下输出：

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

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

{
    "endpoint": "https://api.example-cloud-provider.com/v1.0/health"
}
输出消息

Ping 操作可能会返回以下输出消息：

输出消息 消息说明

Successfully tested connectivity.

 操作成功。
Failed to test connectivity. ERROR_REASON

操作失败。

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

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

脚本结果名称 值
is_success true 或 false

作业

如需详细了解作业，请参阅 配置新作业和 高级调度。

刷新令牌续订作业

使用刷新令牌续订作业定期更新为集成配置的刷新令牌。

默认情况下，刷新令牌每 90 天过期一次。我们建议您将此作业配置为每 7 天或 14 天自动运行一次，以使刷新令牌保持最新状态。

作业参数

刷新令牌续订作业需要以下参数：

参数 说明
Integration Environments

可选。

集成环境名称的英文逗号分隔列表，作业会为这些环境更新刷新令牌。

每个环境名称都必须用英文双引号括起来。

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