将Cato数据与Google SecOps集成

Prev Next

Important: This integration is a preview and subject to change. The certification process is underway.

概览

使用Google SecOps集成分析Cato网络和安全数据,并在Google安全运营(Google SecOps,前身为Chronicle)中分析其他安全遥测。原生集成直接将数据推送到Google SecOps HTTPS webhook馈送,用于监控和调查。

您可以在Cato管理应用程序(CMA)中配置集成。 Cato发送换行分隔的JSON,每行一个记录,并使用Google云API密钥和馈送的webhook密钥进行身份验证。

此集成与通过Cato eventsFeed API检索数据的Google Chronicle集成是分开的。

Google SecOps数据来源

您可以选择事件、流量或两者:

  • 事件:记录网络和安全性活动,例如: 访问权限策略匹配、威胁、连接性变更和审计活动。

  • 流量:网络流量记录,添加应用程序和用户上下文,以及汇总会话详细信息,例如: 字节数、数据包数和持续时间。

每个记录都包含一个data_source字段,值为events或flows。根据您的流量,流量数据可能比事件数据产生更多的体积。

Prerequisites

  • 在CMA的资源部分内编辑集成的权限。有关详细信息,请参阅管理管理员角色使用RBAC.

  • 链接到Google云项目的Google SecOps实例,并启用了Chronicle API。

  • 在Google SecOps创建webhook馈送的权限,以及在链接的Google云项目中创建API密钥的权限。

  • 事件集成入门中描述的前提条件,包括任何必需的IP白名单。

使用实例

这些示例假设相关的数据来源已被摄入,并且用于关联记录的字段已一致解析。

事件

验证UDM映射后,创建一个YARA-L规则,将可疑登录与同一时间窗口内的Cato威胁事件相关联。

流量

使用统计搜索识别异常大的出站传输,然后检查关联的Cato事件以获取策略或威胁上下文。

创建Google SecOps集成

创建一个webhook 提要和 Google Cloud API 密钥,使用curl测试端点,然后在 CMA 中输入提要 URL 和凭证。

步骤 1:在 Google SecOps 中创建 HTTPS Webhook 提要

要创建 webhook 提要:

  1. 登录 Google SecOps,转到 设置 > 提要。

  2. 点击 添加新项目,并输入 提要名称,例如 Cato Networks。

  3. 对于 来源类型,选择 Webhook。

  4. 选择 Cato 记录的 日志类型。

  5. 点击 下一步。

  6. 将 分隔符 设置为 \n,这样 Google SecOps 会将每个换行符分隔的 JSON 记录作为单独的日志条目进行导入。

  7. (可选)配置 资产名称空间 和 导入标签。

  8. 点击 下一步,检查提要配置,然后点击 提交。

  9. 点击 生成密钥。复制密钥,并在离开界面之前安全存储。 Google 不会再次显示它。

  10. 在 详细信息 标签中,从 端点信息 中复制提要端点 URL。使用完整的 URL,包括 :importPushLogs 后缀。

  11. 确认提要已启用。

生成另一个密钥会使之前的密钥无效。如果在配置 Cato 后旋转密钥,请立即在 CMA 中更新 Webhook 访问密钥 以避免传输中断。

步骤 2:创建 Google Cloud API 密钥

要创建 API 密钥:

  1. 在 Google Cloud 控制台中选择与您的 Google SecOps 实例链接的项目。

  2. 转到 API 和服务 > 凭据。

  3. 点击 创建凭证 > API 密钥。

  4. 将密钥限制为 Chronicle API 并保存限制。

  5. 复制 API 密钥并安全存储。

您也可以使用已限制为 Chronicle API 的现有 API 密钥进行链接项目。

步骤 3:使用 curl 测试端点

在 CMA 中配置集成之前,直接向 Google SecOps 发送测试请求。这有助于从 Cato 集成中分离端点和身份验证问题。

测试端点:

  1. 用完整的提要端点网址替换ENDPOINT_URL,从步骤1中获取。当被提示时,输入步骤2中的Google Cloud API密钥和步骤1中的提要密钥。

  2. 更新示例时间戳到当前UTC时间,然后运行以下命令。将每个JSON对象保留在其自身的行内;命令在一个请求中发送两个记录:

    在交互式Bash shell中运行整个示例(如果需要,先运行bash)。在隐藏提示下输入证书;不要将其插入命令。示例禁用shell追踪,通过标准输入传递认证头,通过使用--header @-,将证书保存在外壳历史记录和curl命令行参数之外。示例结束时临时证书变量被丢弃。

    (
      set +axv
      set -euo pipefail
      unset CATO_TEST_API_KEY CATO_TEST_WEBHOOK_SECRET
      IFS= read -r -s -p 'Google Cloud API密钥: ' CATO_TEST_API_KEY
      builtin printf '\n' >&2
      case "$CATO_TEST_API_KEY" in
        ''|*$'\r'*) builtin printf '输入一个非空的证书,没有回车。\n' >&2; exit 1 ;;
      esac
      IFS= read -r -s -p 'Webhook密钥: ' CATO_TEST_WEBHOOK_SECRET
      builtin printf '\n' >&2
      case "$CATO_TEST_WEBHOOK_SECRET" in
        ''|*$'\r'*) builtin printf '输入一个非空的证书,没有回车。\n' >&2; exit 1 ;;
      esac
    
      builtin printf '%s\n' "X-goog-api-key: ${CATO_TEST_API_KEY}" "X-Webhook-Access-Key: ${CATO_TEST_WEBHOOK_SECRET}" | \
        curl -q --fail --show-error --include --max-time 30 -X POST "ENDPOINT_URL" \
      --header @- \
      -H "Content-Type: application/json" \
      --data-binary '{"message":"测试事件来自Cato 1","timestamp":"2026-07-14T12:00:00Z"}
    {"message":"测试事件来自Cato 2","timestamp":"2026-07-14T12:00:01Z"}'
    )
  3. 检查HTTP响应是否有错误。成功的请求返回HTTP 2xx状态。

  4. 在Google SecOps中,搜索最近的原始日志中来自Cato 1的测试事件和来自Cato 2的测试事件。允许几分钟进行摄取,然后确认它们显示为两个单独的日志条目。如果两个记录显示在一个日志条目中,请检查提要的分割分隔符是否设置为\n。此示例检查连接性和记录分割;它不验证所有Cato事件和流量的解析映射。

此测试检查目标是否接受示例请求并将其分割成单个日志条目。在下面进行集成配置后验证Cato数据和解析。

步骤4:在CMA中创建集成

创建Google SecOps集成:

  1. 从CMA导航菜单,转到资源 > 集成。

  2. 打开配置的集成标签页并点击新建。

  3. 选择Google SecOps和数据导出功能。

  4. 输入名称和可选的描述。

  5. 对于Webhook网址,粘贴步骤1中获取的完整提要端点网址。

  6. 对于 Google Cloud API 密钥,粘贴仅限于 Chronicle API 的 API 密钥。

  7. 对于 Webhook 访问密钥,粘贴该 feed 的秘密密钥。

  8. 在数据来源下,选择事件、流量或两者。

  9. (可选)配置事件和流量筛选器以控制发送哪些记录。请参阅过滤器。

  10. 点击 保存。

Cato 将两个密钥加密存储,不再显示它们。编辑集成时,保持密钥不变以保持其存储值,或输入替换。

Cato 自动设置 X-goog-api-key、X-Webhook-Access-Key 和 Content-Type: application/json 头文件。您无需配置头文件。

步骤 5:验证摄取和解析

验证 Cato 数据是否达到 Google SecOps:

  1. 在 CMA 中,查看集成状态。如有必要,刷新页面并检查身份验证或目的地错误。

  2. 在 Google SecOps 中,转到 设置 > 供稿,打开 Cato 供稿,并查看其状态和最后摄取时间。

  3. 为每个选定的数据源生成最近的 Cato 事件或网络流量。

  4. 使用已配置在 feed 上的摄取标签或独特的 Cato 记录值搜索最近的原始日志。您还可以搜索具有值 events 或 flows 的 data_source 字段。允许摄取几分钟。

  5. 检查个别记录是否被解析及其时间戳和映射字段是否与 Cato 活动匹配。

过滤器

使用事件和流量筛选器来限制导出的 Cato 数据到 Google SecOps。这有助于控制摄取量并将调查集中在相关活动上。

组内的筛选条件使用 AND 逻辑。分组使用 OR 逻辑。

  • 事件过滤器 – 点击 添加过滤器 来定义条件,或点击 添加组 来添加另一个过滤组。

  • 流量过滤器 – 当选择流量时可用。它使用与事件过滤器相同的分组逻辑。

过于严格的过滤器可能在不报告错误的情况下排除所有记录。如果没有数据到达,请检查所选的数据来源和过滤条件。

已知局限性

  • Google SecOps 支持最大 4 MB 的 Webhook 请求大小和每个实例每秒最多 15,000 个查询(QPS)。

  • Cato 记录如何映射到 UDM 取决于 Feed 的日志类型和解析器配置。

  • 重新生成 Feed 密钥会使之前的密钥失效。旋转密钥时,请更新 CMA 中的 Webhook 访问密钥。

  • 您不能自定义 Cato 集成的请求正文格式、内容类型或头名称。

故障排查

问题

解决方案

认证失败,HTTP 状态码为 401 或 403

检查 Google 云 API 密钥是否属于链接项目并允许 Chronicle API。确认 Feed 密钥没有被替换,如果需要,更新 CMA 中的凭据。

目的地无法到达

从 详细信息 > 端点信息 中复制完整的 Feed 端点 URL,包括 :importPushLogs,并确认 Feed 已启用。

集成看起来正常但没有数据到达

检查数据来源选择和过滤器,生成匹配的 Cato 活动,并查看 Feed 的摄取状态和解析器错误。

只有事件或只有流量到达

确认所需来源已选择,并且其过滤器允许匹配记录。检查每个来源是否发送到为其配置的 Feed。

原始记录到达,但字段未解析

对照步骤 1,查看 Feed 的 日志类型 和解析器配置。

请求被拒绝或在高流量情况下摄取延迟

检查目标错误的请求大小或吞吐量限制,联系 Cato 支持,提供受影响的时间范围和错误详细信息,但不包括 API 密钥和 Webhook 密钥。

其他资源