HTTP v2

本文档提供了有关如何将 HTTP v2 与 Google Security Operations 的 SOAR 模块集成并使用执行 HTTP 请求操作的指南。

集成版本：5.0

概览

使用 HTTP v2 与第三方产品集成，无需编写代码，并解决执行 API 请求、处理文件和管理异步流程等用例。

身份验证流程

根据您要向哪个产品进行身份验证，HTTP v2 支持以下身份验证流程：

  • 基本身份验证流程
  • API 密钥流程
  • 专用身份验证流程

基本身份验证流程

在基本身份验证流程中，使用 Test URL、Basic Auth Username 和 Basic Auth Password 参数进行身份验证。

API 密钥流程

在 API 密钥流程中，使用 Test URL、API Key Field Name 和 API Key Field Value 参数进行身份验证。

专用身份验证流程

在专用身份验证流程中，系统会使用以下两步验证：

  1. 某项操作生成了访问令牌。

    当 Ping 或 Execute HTTP Request 操作运行时，集成会检索身份验证所需的参数。

  2. 操作使用生成的访问令牌对 API 请求进行身份验证。

专用身份验证流程需要以下集成参数：

  • Dedicated Auth API Request Method
  • Dedicated Auth API Request URL
  • Dedicated Auth API Request Headers
  • Dedicated Auth API Request Body
  • Dedicated Auth API Request Token Field Name

如需详细了解集成参数，请参阅将 HTTP v2 与 Google SecOps 集成。

如需使用响应中的令牌，请在 Dedicated Auth API Request Token Field Name 参数中提供密钥名称。在以下响应示例中，密钥名称为 access_token：

{
   "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCIO4",
   "expires_in": 1799,
   "token_type": "bearer"
}

如需应用令牌，集成需要以下专用占位符：{{integration.token}}。在载荷中提供此占位符后，集成会使用生成的令牌。

如果 JSON 响应中的 access_token 键以嵌套形式显示，请为 Dedicated Auth API Request Token Field Name 参数值提供完整的令牌位置。例如，您可以提供嵌套响应的 data_access_token 键，而不是 access_token，如下所示：

{
   "data": {
       "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCIZMI3DQAQsYibMpO4",
       "expires_in": 1799,
       "token_type": "bearer"
   }
}

以下示例展示了对 Crowdstrike API 的专用身份验证流程的请求：

POST /falconx/entities/submissions/v1 HTTP/1.1
Host: api.crowdstrike.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6
Content-Length: 209

{
   "sandbox": [{
       "sha256": "9854c9dfded29d8442499daba01082ba5d164aa02e44",
       "environment_id": 100,
       "submit_name": "filename.pdf"
   }]
}

此示例使用 Authorization 标头和 Bearer 令牌向 API 进行身份验证。为了在标头中填充正确的信息，HTTP v2 集成需要以下输入：Authorization: Bearer {{integration.token}}。

将 HTTP v2 与 Google SecOps 集成

集成需要以下参数：

参数 说明
Test URL 可选

用于基本身份验证或 API 密钥身份验证流程的测试网址。
Basic Auth Username 可选

一个参数，用于将基本身份验证标头添加到每个操作执行中，与 Basic Auth Password 参数一起使用。

同时提供基本身份验证用户名和基本身份验证密码参数。
Basic Auth Password 可选

一个参数，用于与基本身份验证用户名参数一起添加到每个操作执行中，作为基本身份验证标头。

同时提供基本身份验证用户名和基本身份验证密码参数。
API Key Field Name 可选

包含 API 密钥的标头的名称。

同时提供 API 密钥字段名称和 API 密钥 Secret 参数，以将它们添加到每次操作执行中。
API Key Secret 可选

API 密钥密文值。

同时提供 API 密钥字段名称和 API 密钥 Secret 参数，以将它们添加到每次操作执行中。
Dedicated Auth API Request Method 可选

在专用身份验证 API 流程中用于生成访问令牌的方法。

默认值为 POST。

Dedicated Auth API Request URL 可选

在专用身份验证 API 流程中用于生成访问令牌的 API 请求，例如 https://api.crowdstrike.com/oauth2/token。
Dedicated Auth API Request Headers 可选

在专用身份验证 API 流程中用于生成访问令牌的标头。

以 JSON 对象的形式提供标头，例如：

    {
    "Content-type": "application/x-www-form-urlencoded"
    }
Dedicated Auth API Request Body 可选

在专用身份验证 API 流程中用于生成访问令牌的请求正文。以 JSON 对象的形式提供参数值，例如：

    {
    "client_id": "CLIENT_ID",
    "client_secret": "CLIENT_SECRET"
    }
Dedicated Auth API Request Token Field Name
 可选

包含生成的访问令牌的字段的名称。如需在操作中使用访问令牌，请使用以下占位符： {{integration.token}}。

令牌生成响应使用下划线 (_) 作为分隔符。
CA Certificate 可选

用于验证安全连接的证书授权机构 (CA) 证书。

如果您使用远程代理连接到本地产品，请通过向集成提供 CA 证书来增加一层额外的安全保障，以确保连接的完整性。提供 CA 证书后，所有 API 请求都会使用该证书。

此参数接受以 base64 编码字符串形式提供的 CA 证书。
Verify SSL 必需

如果选中此选项，系统会验证所有集成连接的 SSL 证书是否有效。

此选项将会默认选中。

建议为环境中集成的每个第三方产品分别创建一个 HTTP v2 集成实例。如需详细了解多个集成实例，请参阅支持多个实例。

如何使用 HTTP v2 集成

本部分介绍了如何通过修改执行 HTTP 请求操作参数来使用 HTTP v2 集成。

使用正文载荷参数

为确保正文构建正确，请在 Headers 参数中提供正确的 Content-Type 标头。执行 HTTP 请求操作会针对以下相同的参数输入生成不同的载荷：

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

对于 "Content-Type:" "application/x-www-form-urlencoded" 标头值，生成的载荷为 Id=123123&sorting=asc。

对于 "Content-Type": "application/json" 标头值，生成的载荷如下所示：

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

使用 XML 时，请提供 XML 格式的输入，如下所示：

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
 <soap:Body>
   <NumberToWords xmlns="http://www.dataaccess.com/webservicesserver/">
     <ubiNum>500</ubiNum>
   </NumberToWords>
 </soap:Body>
</soap:Envelope>

使用异步流程

创建和运行搜索作业等异步 API 流程需要等待结果完成处理，然后才能执行下一个 API 请求。例如，您可以在 Google SecOps SIEM 中创建搜索作业，等待搜索作业完成执行，然后使用 Expected Response Values 参数检索结果。

在以下响应示例中，state 键可以包含 error、in_progress 或 finished 值：

{
   "state": "in_progress",
   "percentage": "10"
}

您可以请求以异步模式运行“执行 HTTP 请求”操作，直到响应包含 finished 状态为止，方法是将 Expected Response Values 参数设置为以下值：

{
   "state": "finished"
}

为了在发生错误时不等待超时，请在参数值中提供额外的条件。在以下输入示例中，当状态为 finished 或 error 时，操作会停止运行：

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

在以下示例中，当状态为 finished 且百分比键值为 100 时，操作会停止运行：

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

您可以在一个输入中组合多个关键条件，例如：

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

您可以配置 Expected Response Values 参数，以预期特定键值对的输出。“执行 HTTP 请求”操作会在整个 JSON 响应对象中搜索特定键，并且仅当您将所有匹配的键名称设置为相同的预期键值时，才会认为已达到预期输出。例如，对于在 JSON 响应中搜索 finished 状态匹配项并忽略任何其他状态的操作，请将 Expected Response Values 参数输入中的所有 state 键设置为 finished 值：

{
"data": {
  "state": "finished"
  },
  "state": "finished"
}

Expected Response Values 参数从嵌套的 JSON 对象中检索所需的值。对于以下示例，请仅提供 state 键，而不提供 data_state 或 data-state：

{
   "data": {
       "state": [
           "finished",
           "error"
       ],
       "percentage": "100"
   }
}

处理文件

处理文件包含两个单独的工作流程：

  • 下载文件
  • 上传文件

下载文件

“执行 HTTP 请求”操作可以将文件作为 JSON 对象中的 base64 输出返回，也可以将文件作为 zip 文件保存到支持请求的 Case Wall 中。

如需以 base64 格式返回作为 JSON 结果一部分的数据，请选择 Base64 Output 参数。如需将文件保存到 Case Wall，请选择 Save To Case Wall 参数。

如果您处理的是恶意软件等敏感文件，请选择 Password Protect Zip 参数。对于所有受密码保护的 zip 文件，该操作会自动将密码设置为 infected。

上传文件

如需上传文件，请将文件转换为 base64 格式，然后将其作为 Body Payload 参数值的一部分提交。以下是将图片文件转换为 base64 格式的示例：

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

如需详细了解如何使用 Body Payload 参数，请参阅本文档的使用正文载荷参数部分。

代码块即代码

您可以使用 Google SecOps 中的 HTTP v2 集成和 playbook 块功能来构建可重用的内容。例如，您可以创建一个包含 HTTP v2 操作的 playbook 代码块，并配置集成以使用操作结果作为代码块输入。如需详细了解 playbook 块，请参阅使用 playbook 块。

创建 playbook 块

如需创建 playbook 代码块，请完成以下步骤：

  1. 在 Google SecOps 中，前往响应 > Playbook。
  2. 在 Playbook 网页导航栏中，选择添加“添加新 Playbook 或区块”。系统会打开新建窗口。
  3. 在新建窗口中，将 Type 参数设置为 Block。
  4. 对于 Choose Folder 参数，请选择要将新块保存到的文件夹。
  5. 对于 Environment 参数，请选择您的环境。
  6. 点击创建。系统会打开新代码块页面。配置新的 playbook 代码块，以便在多个 playbook 中使用。

以下部分展示了如何配置 playbook 块。

playbook 块配置示例

以下示例是一个自定义的“执行 HTTP 请求”操作，用于将评论发送到 ServiceNow。该操作使用自定义 playbook 区块创建的 comment、sys_id 和 table_name 参数作为输入参数。如需配置操作参数，请完成以下步骤：

  1. 将 Method 参数设置为 PUT。

  2. 将 URL Path 参数设置为以下值：

    https://SERVICE_NOW_INSTANCE.service-now.com/api/now/table/[Input.table_name]/[Input.sys_id]

  3. 将 Headers 参数设置为以下值：

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

  4. 将 Body Payload 参数设置为以下值：

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

如需将为块输入提供的值用作操作的占位符，占位符必须在参数名称前包含 Input. 前缀。如果块的输入为 keyname，则其占位符为 [Input.keyname]。

操作

HTTP v2 集成包含以下操作：

执行 HTTP 请求

使用 HTTP v2 集成执行 HTTP 请求。

使用此操作可创建自定义 HTTP 请求并返回有关该请求的信息。此操作中的所有参数均可修改。

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

操作输入

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

参数 说明
Method
 可选

要在请求中使用的方法。

默认值为 GET。

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

要执行的网址。
URL Params 可选

网址参数。

该操作会使用与 网址路径参数中直接提供的值一起提供的任何值。

例如，后端的 ?parameter=value&sorting=asc 字符串表示输入如下： 
    {
    "parameter": "value",
    "sorting": "asc"
    }

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

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

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

例如，包含 Accept 和 User-Agent 标头的 HTTP 请求需要以下输入：

    {
    "Accept": "application/json",
    "User-Agent": "Google Secops"
    }

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

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

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

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

例如，如需包含值为 PHPSESSID=298zf09hf012fh2; csrftoken=u32t4o3tb3gg43; 的 Cookie 标头，HTTP 请求需要以下输入：

    {
    "PHPSESSID": "298zf09hf012fh2",
    "csrftoken": "u32t4o3tb3gg43"
    }

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

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

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

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

默认值为：

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

预期响应值。

如果提供此参数，则操作以异步模式运行，并一直执行，直到收到预期值或超时。
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": "1ca450b35c66634a2ae01248cca50b19",
       "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 status code STATUS_CODE was in response.

操作成功。

Failed to execute API request. Error: ERROR_REASON

Failed to execute API request. Error: Invalid parameter "PARAMETER_NAME".

The JSON structure is invalid. Wrong value provided: VALUE

操作失败。

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

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

脚本结果名称 值
is_success True 或 False

Ping

使用此操作测试连接。

操作输入

无。

操作输出

Ping 操作提供以下输出：

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

在“支持请求墙”上，“Ping”操作会提供以下输出消息：

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

操作失败。

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

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

脚本结果名称 值
is_success True 或 False

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