--- title: "将 Cato 数据集成到 TrendAI" slug: "integrating-cato-data-with-trendai" updated: 2026-10-23T23:17:34Z published: 2026-10-23T23:17:34Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-trendai" --- > ## 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 数据集成到 TrendAI > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## 概览 使用 TrendAI 集成分析 Cato 网络和安全数据,同时分析其他安全数据在 TrendAI Vision One Agentic SIEM 中。原生集成通过 HTTPS 发数据到 TrendAI HTTP 事件收集器,这样您的 SOC 可以搜索 Cato 记录并在监控和调查工作流程中使用它们。 您可以在 Cato 管理应用程序(CMA)中配置集成。 Cato 发送 JSON 数组,内容类型为`application/json`,并使用在 TrendAI 中生成的持有者令牌进行认证。 ### TrendAI 数据来源 您可以选择 **事件**、**流量**或两者: - **事件:**网络和安全活动记录,例如访问权限策略匹配、威胁、连接性变更以及审计活动。 - **流量:**网络流量记录,提供应用程序和用户上下文以及汇总的会话详细信息,例如字节、数据包和持续时间。 每个记录包括一个`data_source`字段,值为`events`或`flows`。流量数据可以生成比事件数据更大的量,具体取决于您的流量。 ### Prerequisites - 在 CMA 的**资源**部分中负责**集成**的编辑权限。有关详细信息,请参阅[使用RBAC管理管理员角色](/v1/docs/managing-admin-roles-using-rbac)。 - TrendAI Vision One 租户与 Agentic SIEM 和配置存储库权限以及 HTTP 事件收集器。 - 足够的 Agentic SIEM 积分用于第三方数据摄取和所需的保留。 - [事件集成入门](/v1/docs/getting-started-with-event-integrations)中描述的前提条件,包括任何必需的 IP 允许列表。 ## 使用实例 这些示例假设相关数据来源已被摄取,并且用于关联记录的字段已被一致解析。 ### 事件 从 TrendAI 终端警报开始,在 XDR 数据探索器中搜索 Cato 事件以匹配的主机、IP 地址和时间信息来调查相关的网络活动。 ### 流量 审查终端警报周围的 Cato 流量以评估主机联系了哪些目的地,以及传输了多少数据。 ## 创建 TrendAI 集成 在TrendAI存储库中创建一个HTTP事件收集器,用curl测试其端点,然后使用其端点网址和JWT令牌在CMA中配置集成。 ### 步骤 1:在 TrendAI 中创建 HTTP 事件收集器 **准备 TrendAI 目的地:** 1. 登录到 TrendAI Vision One,然后转到 **Agentic SIEM & XDR > 数据源和日志管理 > 第三方日志存储库**。 2. 创建日志存储库或打开现有的。选择与您计划使用数据方式匹配的摄取和保留设置。 创建后您无法更改存储库的摄取类型。分析摄取支持分析、关联和威胁搜寻;归档摄取用于不常见的查询和保留要求。 3. 在存储库面板上,打开**采集器**标签页,然后点击**添加采集器**。 4. 选择供应商和产品的Cato数据,选择**JSON**作为日志格式,并选择日志使用的时区。 5. 输入采集器名称和描述。 6. 选择**HTTP事件收集**作为方法,并复制生成的`/hec`端点网址用于采集器。 7. 点击 ![add.png](https://support.catonetworks.com/hc/article_attachments/24218203581469)。 8. 在**生成JWT令牌**屏幕上,选择到期时间,然后点击**生成令牌**。 9. 复制令牌,安全地存储它,然后点击**关闭**。 10. 在存储库的**采集器**标签中,验证采集器的详细信息和端点网址。 ### 步骤 2:使用 curl 测试端点 在配置CMA中的集成之前,直接发送测试请求到TrendAI。这有助于隔离端点和认证问题与Cato集成。 **要测试端点:** 1. 使用步骤一中生成的完整`/hec`端点网址替代示例网址。在提示框中输入采集器的JWT令牌。 2. 将示例时间戳更新为当前UTC时间,然后运行以下命令: 在交互式**Bash** shell中运行整个示例(如果需要,先运行`bash`)。在隐藏的提示框中输入凭证;不要将它们插入命令中。示例禁用shell跟踪,并通过标准输入使用`--header @-`传递认证头,以避免凭证出现在shell历史记录和curl命令行参数中。示例完成后,临时凭证变量将被丢弃。 ```bash (  设置 +axv  设置 -euo pipefail  删除CATO_TEST_TOKEN  IFS= 读取 -r -s -p 'TrendAI JWT 令牌:' CATO_TEST_TOKEN  内建打印 '\n' >&2  情况 "$CATO_TEST_TOKEN" 在    ''|*$'\r'*) 内建打印 '输入不含回车的非空凭据。\n' >&2; 退出 1 ;;  esac  内建打印 '%s\n' "授权:Bearer ${CATO_TEST_TOKEN}" | \    curl -q --失败 --显示错误 --包含 --最大时间 30 -X POST 'https:///ingest/api/v1/third_party_log/hec' \  --header @- \  -H "内容类型:应用程序/json" \  -d '[{"timestamp": "2026-04-07T10:00:03Z", "消息": "json 日志线 1"},{"timestamp": "2026-04-07T10:00:05Z", "消息": "json 日志线 2"}]' ) ``` 3. 检查 HTTP 响应中是否有错误。成功请求返回 HTTP 2xx 状态。 4. 在TrendAI中,搜索目的地库中的`json日志线1`和`json日志线2`。确认两个记录单独出现。 此测试检查目标是否接受样本请求。在下面配置集成后,验证Cato数据和解析。 ### 步骤 3:在 CMA 中创建集成 **要创建TrendAI集成:** 1. 从 CMA 导航菜单,前往 **资源 > 集成**。 2. 打开 **配置的集成** 标签页,点击 **新建**。 3. 选择 **TrendAI** 和 **数据导出** 功能。 4. 输入 **名称** 和可选的 **描述**。 5. 对于 **摄取 URL**,粘贴 TrendAI 收集器生成的完整 `/hec` 端点 URL。 6. 对于 **Bearer 令牌**,粘贴收集器的 JWT 令牌。仅输入令牌;Cato 会添加 `Bearer` 前缀。 7. 在**数据来源**下,选择**事件**、**流量**或两者。 8. (可选)配置事件和流量过滤器以控制发送哪些记录。请参阅 [过滤器](/docs/zh/integrating-cato-data-with-trendai#filters)。 9. 点击 **保存**。 Cato 将令牌加密存储并不再显示。在你轮换 JWT 令牌时更新集成。 Cato 使用 `授权:Bearer <令牌>` header 进行认证。 ### 步骤 4:验证摄取和解析 **要验证 Cato 数据是否到达 TrendAI:** 1. 在 CMA 中,回顾集成状态。如果需要则刷新页面,并检查认证或目的地错误。 2. 在TrendAI中,打开仓库并审查收集器状态和摄取信息。 3. 为每个选定的数据源生成最近的Cato事件或网络流量。 4. 打开 **XDR数据浏览器** 搜索最近的Cato记录,使用独特的值或 `data_source` 字段。允许几分钟时间进行摄取。 5. 验证记录是否单独出现,以及它们的时间戳和解析字段是否与 Cato 活动匹配。对每个选定的来源,确认相应的`事件`或`流量`值。 ## 过滤器 使用事件和流量过滤器来限制导出到 TrendAI 的 Cato 数据。这有助于控制摄取量,将调查集中在相关活动上。 组内的过滤条件使用与逻辑。单独的组使用或逻辑。 - **事件过滤器:**点击**添加过滤器**定义条件,或点击**添加组**添加另一个过滤器组。 - **流量过滤器:**在选择**流量**时可用。它使用与事件过滤器相同的分组逻辑。 过于严格的过滤器可能会不报告错误而排除所有记录。如果没有数据到达,请检查所选数据来源和过滤条件。 ## 已知局限性 - 第三方数据摄取使用 Agentic SIEM 积分。超过默认保留期需要额外积分。 - 存储库的摄取类型在创建后不能更改。要使用不同的摄取类型,请创建另一个存储库。 - 如果 JWT 令牌过期或被撤销,传输会停止,直到您在 CMA 中更新令牌。 - 您无法自定义 Cato 集成的请求体格式、内容类型或认证头。 ## 故障排查 | 问题 | 解决方案 | | --- | --- | | 认证失败,并返回 HTTP 401 或 403 | 确认 JWT 令牌属于目标采集器并未过期或被撤销。如果需要,可生成替代品并在 CMA 中更新**承载令牌**。 | | 目的地无法到达 | 从 TrendAI 稽查细节中复制完整端点 URL,并确认在您的租户中该稽查器可用。 | | 目的地返回 HTTP 400 或 415 | 确认端点为此稽查器生成的`/hec` URL,凭证为有效的、未过期的 JWT,并且请求体为一个 JSON 数组。 Cato 使用`内容-类型:应用程序/json`发送请求体。 | | 集成看起来运行正常但无数据到达 | 审核数据源选择和过滤器,生成匹配的Cato活动,并检查TrendAI收集器的摄取信息和存储库设置。 | | 仅事件或仅流量到达 | 检查要求的来源是否已选择,并且它们的过滤器允许匹配记录。确认每个来源将发送到为其配置的目的地。 | | 记录到达,但字段未解析 | 根据步骤1中使用的配置,审核收集器的供应商、产品和日志格式选择。 | ## 其他资源 - [TrendAI: 超文本传输协议事件收集](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-dslm-tlc-api) - [TrendAI: 存储库](https://docs.trendmicro.com/en-US/documentation/article/trend-vision-one-log-repositories)