--- title: "将 Cato 数据集成到 Palo Alto Cortex" slug: "integrating-cato-data-with-cortex-xdr" updated: 2026-11-14T00:10:36Z published: 2026-11-14T00:10:36Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-cortex-xdr" --- > ## 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 数据集成到 Palo Alto Cortex > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## **概览** 使用 Palo Alto Cortex 集成将 Cato 网络和安全性数据包括在现有的监控、关联与调查工作流中。本地集成直接从 Cato 发送数据到您的 Cortex 租户,这样您可以在集中平台中分析 Cato 活动及其他来源的数据。这帮助您的安全运营中心关联数据、创建警报和搜索威胁,而无需额外的数据收集机制。 ### **Palo Alto Cortex 数据来源** Palo Alto Cortex 集成支持两种数据来源: - **事件:**当网络或系统发生特定活动时生成,例如匹配访问权限策略或检测到威胁时。这些记录提供关于安全性和访问权限策略执行的离散、实时洞察。数据使用 Cato 的 [事件架构](https://api.catonetworks.com/documentation/#definition-EventFieldName) 发送。 - **流量:**源自网络流量(5元组),随着应用程序级信息的出现,可从 Cato 引擎进行丰富。除了应用程序和用户上下文外,流量还包括聚合会话数据,如字节、数据包和持续时间,提供随时间推移的完整网络活动视图。 [appStats schema](https://api.catonetworks.com/documentation/#definition-AppStatsFieldName)代表流字段的完整集合。 默认情况下,新的集成仅导出 **事件**。**流量** 数据来源可以生成显著更多的数据量与事件相比。确切的数量取决于您的流量。您可以在 CMA 中配置多个集成,以便根据需要发送不同的数据来源。 ### **条件** - 要添加连接器,您必须具有编辑者权限(在**资源**部分中)对**集成**。有关详细信息,请参阅[使用RBAC管理管理员角色](/v1/docs/managing-admin-roles-using-rbac)。 - 具有添加权限的 Cortex 租户可添加一个**自定义 - 基于 HTTP 的采集器**数据源。 - 您的 Cortex 输入网址和 HTTP 收集器令牌。 - 回顾 [事件集成入门](/v1/docs/getting-started-with-event-integrations)中的所有 Cato 事件集成的先决条件。 ## **使用实例** ### **事件** 示例公司使用 Cortex 进行集中安全监控。作为 Cato 客户,拥有关于网络活动、威胁、用户数据、设备及其他流量方面的 Cato 数据。管理员使用此集成将数据直接发送到 Cortex,安全运营中心团队与其他来源一起处理。 ### **流量** 样本公司的安全分析师识别出一个用户访问可能与数据泄露有关的高风险应用程序的可疑事件。仅使用 Cato 事件,分析师可以看到策略决定、用户身份和应用程序,但无法了解传输了多少数据或会话持续时间。 通过聚合流量数据,分析师可以查看完整的会话上下文,包括传输的总字节数、数据包数量和会话持续时间。这使分析师能够判断活动是涉及最少互动还是大型数据传输,后者可能表明数据泄露。 ## **创建 Palo Alto Cortex 集成** 要将Cato数据上传到Cortex,首先在Cortex中创建一个超文本传输协议收集器,确认端点接受数据,然后在CMA中创建集成。 ### **步骤1:在Cortex内创建超文本传输协议收集器** Cortex仅在生成时显示令牌值。在关闭对话框之前复制它。如果丢失它,请生成一个新令牌并使用它。 供应商和产品值决定了摄取数据的数据集以及应用的解析器。我们建议下列值以实现集成一致性。 **要创建收集器:** 1. 登录到您的Cortex租户。 2. 转到**自定义-HTTP基础收集器**并点击**添加实例**。 3. 在**启用超文本传输协议日志收集**对话框中,输入一个**名称**,如`Cato Networks`。 4. 设置**压缩**为**未压缩**并将**日志格式**设置为**JSON**。 5. (**可选**)将**供应商**设置为`Cato Networks`,将**产品**设置为`Cato Cloud`。 6. 点击**保存与生成令牌**。 7. 复制令牌值并安全存储,并注意收集器的摄取网址。 ### **步骤2:使用curl测试端点** 在CMA中配置集成之前,确认您的API密钥、端点及索引工作正常。这有助于隔离Cortex端的问题与CMA集成的问题。 使用`Content-Type: application/json`头来匹配由Cato集成发送的请求: 运行整个示例于交互式**Bash** shell中(如有需要,先运行`bash`)。在隐藏提示中输入凭证;不要将它们插入命令中。示例禁用shell跟踪,并通过标准输入传递认证头部使用`--header @-`,避免凭证进入shell历史记录和curl命令行参数中。示例结束时临时凭证变量将被丢弃。 ```bash (  set +axv  set -euo pipefail  unset CATO_TEST_TOKEN  IFS= read -r -s -p 'Cortex HTTP collector token: ' 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: ${CATO_TEST_TOKEN}" | \    curl -q -X POST "https://" \  --header @- \  -H "Content-Type: application/json" \  --data-binary $'{"message":"来自curl的测试事件","event_type":"测试"}\n' ) ``` 1. 将`<your-collector-url>`替换为您的收集器网址。 2. 在隐藏提示中输入第1步中的超文本传输协议收集器令牌。 一个成功的请求会返回一个超文本传输协议2xx状态。 3. 在Cortex中,搜索`test event from curl`以确认文件已到达。 ### **步骤3:在CMA中创建集成** **创建 Palo Alto Cortex 集成:** 1. 从 CMA 的导航菜单,转到 **资源** > **集成**。 2. 打开 **已配置集成** 标签页,点击**新建** 将打开**新集成**面板。 3. 选择 **Palo Alto Cortex**。**功能**自动设置为**数据导出**。 4. 在**认证**下拉菜单中,选择 **HTTP 收集器令牌认证用于 Palo Alto Cortex**。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/image(252).png?sv=2026-02-06&spr=https&st=2026-11-19T05%3A36%3A24Z&se=2026-11-19T06%3A36%3A24Z&sr=b&sp=r&sig=d6f0X6uMS9pa0nb4TLYJaWS2CR6GOV9aQgQmB7upJFU%3D) 5. 输入此集成的**名称**和可选的**描述**。 6. 输入在步骤 2 测试的 **摄取网址**,例如 `https://api-tenant.xdr.us.paloaltonetworks.com/logs/v1/event`。 7. 输入在 Cortex 中生成的 **HTTP 收集器令牌**。 8. 在**数据来源**下,选择**事件**、**流量**或两者。 9. **(可选)**添加过滤器以控制发送到 Cortex 的数据,[如下面所述](/docs/zh/integrating-cato-data-with-cortex-xdr#filters)。 10. 点击 **保存**。 刷新 **集成**页面。集成在**已配置集成**表中显示为**已连接**状态。 ## **过滤器** 使用过滤器控制导出到 Cortex 的 Cato 数据。这有助于减少摄取成本,最小化噪声,并将调查重点放在对特定站点、用户或区域最相关的数据上。您还可以使用过滤器将不同子集的数据路由到不同的 SIEM 环境。 使用过滤器组定义基于任何[事件字段](/v1/docs/cato-event-schema)或字段组合的过滤器。每个组中的条件使用 AND 逻辑。在组之间应用 OR 逻辑。 - **事件过滤器** - 点击 **添加过滤器** 来定义条件,或者 **添加组** 来添加过滤器组。 - **流量过滤器** - 当选择 **流量**作为数据来源时可用。遵循与事件过滤器相同的逻辑。 过于狭窄的过滤器可能在不显示任何错误的情况下排除所有内容。如果在保存集成后 Cortex 中未收到任何数据,请首先检查过滤器配置。 ## **故障排查** | **问题** | **解决方案** | | --- | --- | | 集成显示 **连接错误** | 确认摄取网址和 HTTP 收集器令牌正确输入,并与您在步骤 2 测试的结果匹配。确认令牌在 Cortex 中未被撤销。 | | 事件到达,但显示为原始文本而不是解析字段 | 确认收集器设置为**JSON**日志格式,并设置为**未压缩**,如步骤1所述。 | | 没有事件到达Cortex | 检查事件过滤器。过于狭窄的过滤器可能会排除所有数据而不会报告错误。 | | 没有流量到达Cortex | 确认在**数据来源**下选择**流量**,并检查流量过滤器是否有太严格的条件。 | | 保存后集成不会显示**已连接**状态 | 刷新**集成**页面。如果状态没有改变,请验证在Cortex中的HTTP收集器令牌和摄取网址。 |