将 Cato 数据集成到 TrendAI

Prev Next

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管理管理员角色。

  • TrendAI Vision One 租户与 Agentic SIEM 和配置存储库权限以及 HTTP 事件收集器。

  • 足够的 Agentic SIEM 积分用于第三方数据摄取和所需的保留。

  • 事件集成入门中描述的前提条件,包括任何必需的 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。

  8. 在生成JWT令牌屏幕上,选择到期时间,然后点击生成令牌。

  9. 复制令牌,安全地存储它,然后点击关闭。

  10. 在存储库的采集器标签中,验证采集器的详细信息和端点网址。

步骤 2:使用 curl 测试端点

在配置CMA中的集成之前,直接发送测试请求到TrendAI。这有助于隔离端点和认证问题与Cato集成。

要测试端点:

  1. 使用步骤一中生成的完整/hec端点网址替代示例网址。在提示框中输入采集器的JWT令牌。

  2. 将示例时间戳更新为当前UTC时间,然后运行以下命令:

    在交互式Bash shell中运行整个示例(如果需要,先运行bash)。在隐藏的提示框中输入凭证;不要将它们插入命令中。示例禁用shell跟踪,并通过标准输入使用--header @-传递认证头,以避免凭证出现在shell历史记录和curl命令行参数中。示例完成后,临时凭证变量将被丢弃。

    (
      设置 +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://<api-fqdn>/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. (可选)配置事件和流量过滤器以控制发送哪些记录。请参阅 过滤器。

  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中使用的配置,审核收集器的供应商、产品和日志格式选择。

其他资源