--- title: "将 Cato 数据与 Exabeam 进行集成" slug: "integrating-cato-data-with-exabeam" updated: 2026-10-23T23:17:33Z published: 2026-10-23T23:17:33Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-exabeam" --- > ## 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 数据与 Exabeam 进行集成 > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## 概概览 使用 Exabeam 集成分析 Cato 网络及安全数据,并将其与 Exabeam 新尺度安全运营平台中的其他数据来源 一起分析。原生集成直接向 JSON Webhook 云收集器发送数据,因此您的安全运营中心可以搜索 Cato 记录,并将其用于监控和调查工作流程。 您可在 Cato 管理应用程序 (CMA) 中配置集成。 Cato 发送包含 JSON 数组的 HTTPS POST 请求,与收集器的 Bearer 令牌进行认证。在 Exabeam 中解析 Cato 字段可能需要额外的配置。 ### Exabeam 数据来源 您可以发送 **事件**,**流量**,或两者皆是: - **事件:**网络和安全活动记录,例如访问权限策略匹配、威胁、连接性变更和审计活动。 - **流量:**网络流量记录,增加应用程序和用户上下文以及汇总的会话详情,例如字节数、数据包和持续时间。 每个记录包含`数据来源` 字段,其值为 `事件` 或 `流量`。流量数据可能会比事件数据生成显著更多的体积,具体取决于您的流量情况。 ### Prerequisites - **资源**部分中**集成**的编辑者权限,位于CMA。有关详细信息,请参阅[使用RBAC管理管理员角色](/v1/docs/managing-admin-roles-using-rbac)。 - 具有管理 **云收集器** 权限的 Exabeam 新尺度部署。 - [事件集成入门](/v1/docs/getting-started-with-event-integrations)中描述的预备条件,包括任何必需的 IP 白名单。 ## 使用实例 这些例子假设相关的数据来源已被摄入,并且用于关联记录的字段已被一致解析。 ### 事件 通过检查其 Cato 威胁事件,与身份提供者登录记录一起在 Exabeam 搜索时间轴中调查一个怀疑被入侵的账户。使用匹配的用户信息和时间戳来构建活动序列。 ### 流量 添加该账户的 Cato 流记录到调查中,以评估接触的目的地、连接时长以及信息传输量。 ## 创建 Exabeam 集成 在 Exabeam 中创建一个 JSON Webhook 云收集器,然后利用其目标网址和认证令牌在 CMA 中配置集成。 ### 步骤 1:在 Exabeam 中创建 Webhook 云收集器 **创建收集器:** 1. 登录 Exabeam 并前往 **采集器 > 云采集器**。 2. 点击 **新建采集器** 并选择 **Webhook**。 3. 输入一个描述性名称,例如 `Cato Networks`。 4. 在 **格式** 下选择 **JSON**。此格式允许 Exabeam 从 Cato 发送的 JSON 数组中提取单个记录。 5. (可选)选择一个**站点**和**时区**。 6. 点击**安装**。 Exabeam 显示认证令牌和目的地 URL。复制这两个值并安全存储令牌。 7. 点击 **前往概览** 并确认采集器已出现。 使用为您的采集器生成的完整 URL,包括区域主机名和`/logs/json`路径。 ### 步骤 2:使用 curl 测试端点 在 CMA 中配置集成之前,直接发送测试请求到 Exabeam。这有助于隔离来自 Cato 集成的端点和认证问题。 **测试端点:** 1. 将 `<api-fqdn>` 替换为您测试端点的 API 主机名。在隐藏提示处输入采集器令牌。此示例使用 Bash 语法来处理以换行符分隔的 JSON。 2. 将示例时间戳更新为当前 UTC 时间,然后运行以下命令: 在交互式**Bash** Shell 中运行整个示例(如有需要,先运行 `bash`)。在隐藏提示处输入凭据;不要将其插入命令中。该示例禁用 shell_trace 追踪并通过标准输入传递认证标头,使用 `--header @-`,避免凭证进入 shell 历史和 curl 命令行参数。示例完成后临时凭据变量将被丢弃。 ```bash ( set +axv set -euo pipefail unset CATO_TEST_TOKEN IFS= read -r -s -p 'Exabeam 采集器令牌:' CATO_TEST_TOKEN builtin printf '\n' >&2 case "$CATO_TEST_TOKEN" in ''|*$'\r'*) builtin printf '请输入一个非空凭证,不要包含回车键。\n' >&2; exit 1 ;; esac builtin printf '%s\n' "Authorization: Bearer ${CATO_TEST_TOKEN}" | \ curl -q --fail --show-error --include --max-time 30 -X POST 'https:///ingest/api/v1/third_party_log/hec' \ --header @- \ -H "Content-Type: text/plain" \ --data-binary $'{"timestamp": "2026-10-20T10:00:03Z", "msg": "ndjson log line 1"}\n{"timestamp": "2026-10-20T10:00:05Z", "msg": "ndjson log line 2"}\n' ) ``` 3. 检查 HTTP 响应中是否出现错误。成功的请求将返回 HTTP 2xx 状态。 4. 在 Exabeam 中搜索 `ndjson log line 1` 和 `ndjson log line 2`,并确认它们作为独立记录出现。 此测试检查目的地是否接受示例请求。在下面配置集成后,验证 Cato 数据并进行解析。 ### 步骤 3:在 CMA 中创建集成 **要创建Exabeam集成:** 1. 从CMA导航菜单,前往**资源>集成**。 2. 打开**已配置的集成**标签,点击**新建**。 3. 选择**Exabeam**和**数据导出**功能。 4. 输入**名称**和可选的**描述**。 5. 对于**摄取网址**,粘贴Exabeam生成的完整目的地网址。 6. 针对**Bearer令牌**,粘贴收集器的认证令牌。仅输入令牌;Cato添加`Bearer`前缀。 7. 在**数据来源**下,选择**事件**、**流量**或两者。 8. (可选)配置事件和流量过滤器以控制发送哪些记录。请参阅[过滤器](/docs/zh/integrating-cato-data-with-exabeam#filters)。 9. 点击 **保存**。 Cato以加密形式存储令牌,并不再显示。在旋转收集器令牌时,更新集成。 ### 步骤 4:验证摄取和解析 **验证Cato数据是否到达Exabeam:** 1. 在CMA中,查看集成状态。如有需要,刷新页面并检查认证或目的地错误。 2. 在Exabeam中,转到**Collectors > Cloud Collectors > 概览**,打开Cato采集器,并确认它正在接收数据。 3. 为每个选定的数据来源生成一个最近的Cato事件或网络流量。 4. 使用**Exabeam搜索**通过显著的值或`data_source`字段查找最近的Cato记录。当选择两个来源时,验证具有`events`和`flows`值的记录。 5. 检查Cato字段是否已解析。如果记录仍未解析,请使用Exabeam的自动解析器生成器或日志流工作流程配置解析,遵循Exabeam的指导。 ## 过滤器 使用事件和流量过滤器限制导出的Cato数据到Exabeam。这有助于控制数据摄取量,并将调查重点放在相关活动上。 组内的过滤条件使用与逻辑。分组使用或逻辑。 - **事件过滤器** – 点击**添加过滤器**定义条件,或点击**添加组**以添加另一个过滤器组。 - **流量过滤器** – 在选择**流量**时可用。它使用与事件过滤器相同的分组逻辑。 过于严格的过滤器可能会排除所有记录而不报告错误。如果没有数据到达,请检查选定的数据来源和过滤条件。 ## 已知局限性 - Exabeam的通用Webhook云采集器不包含预配置内容支持。您可能需要开发Cato记录的解析器。 - Exabeam将未压缩的批处理请求限制在32 MB和两分钟的请求持续时间内。 - 对Exabeam站点元数据的更改可能需要长达五分钟才能出现在Webhook日志中。 - 您无法自定义Cato集成的请求主体格式、内容类型或认证头。 ## 故障排查 | 问题 | 解决方案 | | --- | --- | | 认证失败返回HTTP 401或403 | 确认令牌属于目的地采集器,且未过期或被撤销。复制或重新生成采集器令牌,并在CMA中更新**Bearer Token**。 | | 目的地不可达或返回HTTP 404 | 从Exabeam复制完整的目的地URL。检查区域主机名和`/logs/json`路径。 | | 目的地返回超文本传输协议 400 或拒绝记录 | 确认收集器使用**JSON**格式,并且Cato使用收集器的JSON目的地网址。 | | 集成看起来运行状况良好,但没有数据到达 | 检查数据来源选择和过滤器,生成匹配的Cato活动,并在Exabeam中查看收集器的**概览**。允许几分钟进行数据摄取。 | | 只有事件或只有流量到达 | 确认选择了所需来源,并查看每个来源的过滤器组。 | | 记录到达但字段没有被解析 | 检查原始记录,并使用Exabeam的自动解析生成器或日志流工作流程进行解析配置。 | | 请求在高流量时失败 | 检查收集器错误以了解批量大小和请求持续时间限制。联系Cato支持,提供受影响的时间范围和目的地响应,排除认证令牌。 | ## 其他资源 - [Exabeam: Webhook Cloud Collector](https://docs.exabeam.com/en/collectors/all/cloud-collectors-administration-guide/onboard-cloud-collectors/webhook-cloud-collectors/webhook-cloud-collector.html)