--- title: "将Cato数据与Google SecOps集成" slug: "integrating-cato-data-with-google-secops" updated: 2026-10-23T23:17:36Z published: 2026-10-23T23:17:36Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-google-secops" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # 将Cato数据与Google SecOps集成 > [!TIP] > **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](/v1/docs/managing-admin-roles-using-rbac). - 链接到Google云项目的Google SecOps实例,并启用了Chronicle API。 - 在Google SecOps创建webhook馈送的权限,以及在链接的Google云项目中创建API密钥的权限。 - [事件集成入门](/v1/docs/getting-started-with-event-integrations)中描述的前提条件,包括任何必需的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命令行参数之外。示例结束时临时证书变量被丢弃。 ```bash (  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. (可选)配置事件和流量筛选器以控制发送哪些记录。请参阅[过滤器](/docs/zh/integrating-cato-data-with-google-secops#filters)。 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 密钥。 | ## 其他资源 - [Google SecOps:设置 SIEM Webhook](https://docs.cloud.google.com/chronicle/docs/ingestion/setup-siem-webhook)