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 提要:
登录 Google SecOps,转到 设置 > 提要。
点击 添加新项目,并输入 提要名称,例如
Cato Networks。对于 来源类型,选择 Webhook。
选择 Cato 记录的 日志类型。
点击 下一步。
将 分隔符 设置为
\n,这样 Google SecOps 会将每个换行符分隔的 JSON 记录作为单独的日志条目进行导入。(可选)配置 资产名称空间 和 导入标签。
点击 下一步,检查提要配置,然后点击 提交。
点击 生成密钥。复制密钥,并在离开界面之前安全存储。 Google 不会再次显示它。
在 详细信息 标签中,从 端点信息 中复制提要端点 URL。使用完整的 URL,包括
:importPushLogs后缀。确认提要已启用。
生成另一个密钥会使之前的密钥无效。如果在配置 Cato 后旋转密钥,请立即在 CMA 中更新 Webhook 访问密钥 以避免传输中断。
步骤 2:创建 Google Cloud API 密钥
要创建 API 密钥:
在 Google Cloud 控制台中选择与您的 Google SecOps 实例链接的项目。
转到 API 和服务 > 凭据。
点击 创建凭证 > API 密钥。
将密钥限制为 Chronicle API 并保存限制。
复制 API 密钥并安全存储。
您也可以使用已限制为 Chronicle API 的现有 API 密钥进行链接项目。
步骤 3:使用 curl 测试端点
在 CMA 中配置集成之前,直接向 Google SecOps 发送测试请求。这有助于从 Cato 集成中分离端点和身份验证问题。
测试端点:
用完整的提要端点网址替换
ENDPOINT_URL,从步骤1中获取。当被提示时,输入步骤2中的Google Cloud API密钥和步骤1中的提要密钥。更新示例时间戳到当前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"}' )检查HTTP响应是否有错误。成功的请求返回HTTP 2xx状态。
在Google SecOps中,搜索最近的原始日志中
来自Cato 1的测试事件和来自Cato 2的测试事件。允许几分钟进行摄取,然后确认它们显示为两个单独的日志条目。如果两个记录显示在一个日志条目中,请检查提要的分割分隔符是否设置为\n。此示例检查连接性和记录分割;它不验证所有Cato事件和流量的解析映射。
此测试检查目标是否接受示例请求并将其分割成单个日志条目。在下面进行集成配置后验证Cato数据和解析。
步骤4:在CMA中创建集成
创建Google SecOps集成:
从CMA导航菜单,转到资源 > 集成。
打开配置的集成标签页并点击新建。
选择Google SecOps和数据导出功能。
输入名称和可选的描述。
对于Webhook网址,粘贴步骤1中获取的完整提要端点网址。
对于 Google Cloud API 密钥,粘贴仅限于 Chronicle API 的 API 密钥。
对于 Webhook 访问密钥,粘贴该 feed 的秘密密钥。
在数据来源下,选择事件、流量或两者。
(可选)配置事件和流量筛选器以控制发送哪些记录。请参阅过滤器。
点击 保存。
Cato 将两个密钥加密存储,不再显示它们。编辑集成时,保持密钥不变以保持其存储值,或输入替换。
Cato 自动设置 X-goog-api-key、X-Webhook-Access-Key 和 Content-Type: application/json 头文件。您无需配置头文件。
步骤 5:验证摄取和解析
验证 Cato 数据是否达到 Google SecOps:
在 CMA 中,查看集成状态。如有必要,刷新页面并检查身份验证或目的地错误。
在 Google SecOps 中,转到 设置 > 供稿,打开 Cato 供稿,并查看其状态和最后摄取时间。
为每个选定的数据源生成最近的 Cato 事件或网络流量。
使用已配置在 feed 上的摄取标签或独特的 Cato 记录值搜索最近的原始日志。您还可以搜索具有值
events或flows的data_source字段。允许摄取几分钟。检查个别记录是否被解析及其时间戳和映射字段是否与 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,包括 |
集成看起来正常但没有数据到达 | 检查数据来源选择和过滤器,生成匹配的 Cato 活动,并查看 Feed 的摄取状态和解析器错误。 |
只有事件或只有流量到达 | 确认所需来源已选择,并且其过滤器允许匹配记录。检查每个来源是否发送到为其配置的 Feed。 |
原始记录到达,但字段未解析 | 对照步骤 1,查看 Feed 的 日志类型 和解析器配置。 |
请求被拒绝或在高流量情况下摄取延迟 | 检查目标错误的请求大小或吞吐量限制,联系 Cato 支持,提供受影响的时间范围和错误详细信息,但不包括 API 密钥和 Webhook 密钥。 |