--- title: "将 Cato 数据集成到 Stellar Cyber" slug: "integrating-cato-data-with-stellar-cyber" updated: 2026-11-18T00:09:15Z published: 2026-11-18T00:09:15Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-stellar-cyber" --- > ## 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 数据集成到 Stellar Cyber > [!TIP] > **Important:** This integration is a preview and subject to change. The certification process is underway. ## 概览 使用 Stellar Cyber 集成来分析 Cato 网络和安全性数据于 Stellar Cyber 开放式 XDR。该原生集成直接将数据发送到 XDR Connect 的 webhook,在此配置标准化和字段映射以进行搜索和威胁狩猎工作流程。 您在 Cato 管理应用程序(CMA)中进行集成配置。 Cato 发送包含 JSON 数组的 HTTPS POST 请求,并使用 Stellar Cyber 的 API 令牌进行认证。 此**数据导出**集成与Stellar Cyber API集成是分开的。 ### Stellar Cyber数据来源 Cato支持导出以下数据来源: - **事件:**记录网络和安全活动,例如策略匹配、威胁、连接性更改和审计活动。 - **流量:**网络流记录添加应用程序和用户上下文及汇总会话详情,例如字节、数据包和持续时间。 每个记录包括一个`data_source`字段,其值为`events`或`flows`。流量数据可能比事件数据生成显著更多的体量,具体取决于您的流量。 选择与Stellar Cyber目的地配置相匹配的Cato数据来源。 ### Prerequisites - 编辑者在CMA的**资源**部分中为**集成**设置权限。有关详细信息,请参阅[管理管理员角色使用RBAC](/v1/docs/managing-admin-roles-using-rbac). - 提供XDR Connect的Stellar Cyber部署。有关详细信息,请参阅[Stellar Cyber:配置XDR连接器](https://docs.stellarcyber.ai/prod-docs/7.0.x/Configure/Connectors/XDR-Connector-new-UI.htm)。 - 在Stellar Cyber RBAC中为管理员创建目的地提供**添加/编辑/删除XDR连接器**访问权限,并且有权生成具有**XDR连接器摄取**权限的API令牌。 - 用于导出计划时配置标准化的代表性Cato JSON记录。 - [事件集成入门](/v1/docs/getting-started-with-event-integrations)中描述的前提条件,包括任何必需的IP白名单设置。 ## 使用实例 ### 事件 将Cato事件发送到Stellar Cyber进行调查,以便与其他数据一同分析网络和安全活动。例如,分析师可以搜索最近的Cato威胁事件,并审核其用户、应用程序和站点信息。自动威胁搜寻规则可以提供额外的检测和自定义警报。 ### 流量 使用流量记录来为调查添加会话上下文。传输的字节数、数据包计数和会话持续时间帮助分析师评估是否需进一步调查可疑活动是否涉及短暂连接或大量传输。 ### Using a Custom TLS Certificate (Optional) If your destination presents a certificate signed by a private Certificate Authority (CA), or a self-signed certificate, you can include the root CA certificate in the configuration. The destination’s server certificate is verified before sending data. **Note:** This is server certificate verification only. It is not client-certificate (mTLS) authentication. For destinations that use a private CA, paste the root CA certificate and any intermediate certificates. For self-signed certificates, paste the server’s own certificate. Enter only public certificates in PEM text format, up to a maximum size of 128 KiB. PFX, P12, and DER files, private keys, and CSRs are not supported. Never paste a private key. If your destination uses a certificate from a publicly trusted CA, leave the option cleared. If your destination is an on-premises SIEM or collector, you may need to allow the Cato Management Application (CMA) IP addresses to receive logs. Add these addresses to the allow list in Cato Remote Port Forwarding and in any firewall between Cato and your destination. See the [CMA IP allow list](/v1/docs/cma-ip-allowlist) for the current addresses. ## 创建Stellar Cyber集成 创建Stellar Cyber API令牌和XDR连接器,然后使用生成的Webhook网址和令牌在CMA中配置数据导出集成。 ### 步骤 1:创建 Stellar Cyber API 令牌 Stellar Cyber推荐具有**XDR连接器摄取**权限的仅摄取角色。 API 密钥与身份相关联,而不是与单个连接器相关联。 **创建API令牌:** 1. 使用具有创建所需API密钥权限的账户登录Stellar Cyber。 2. 点击您的账户名称并选择**个人资料**。 3. 在**API 密钥**标签页中,为具有**XDR连接器摄取**权限的身份创建一个API令牌。 4. 复制令牌并安全存储。根据您组织的轮换策略选择其到期时间;Stellar Cyber推荐90天到期。 ### 步骤 2:在 Stellar Cyber 中创建 XDR 连接器 **创建目标连接器:** 1. 进入 **系统 > 集成 > 连接器**,点击 **创建**,然后选择 **XDR连接器**。 2. 输入唯一的连接器名称,例如`cato_events`。 3. 在**原始日志输入**中,粘贴计划导出的来源的代表性Cato JSON记录。包含要映射的字段,包括时间戳和`data_source`。 4. 在**常规**步骤中,在**生成连接器链接**下点击**生成并复制连接器链接**。保存完整生成的Webhook网址。 5. 选择目标**租户**。 6. (可选)配置 **租户映射**以使用输入JSON中的租户标识符进行记录路由。如果记录包含供应商租户ID,请配置适当的映射表。 7. 在**规范化**步骤中,配置**供应商**、**来源**和**命名空间**。 8. 选择与来源匹配的**索引类型**。 Stellar Cyber描述**Syslog**用于事件,**流量**用于网络流。创建连接器后无法更改此选择。 9. 在**字段映射**中,启用**时间戳映射**并选择来源字段和时间戳格式。没有此映射,Stellar Cyber使用摄取时间作为事件时间戳。 10. 将原始字段映射到Stellar Cyber架构字段或自定义命名空间字段。如果您有映射模板,请使用**使用模板**。 11. 点击 **显示输出** 并检查标准化样本、字段类型和时间戳。 12. (可选)在 **丰富** 步骤中配置丰富功能。 13. 点击 **完成 & 应用**。 使用完整生成的网址进行部署。托管实例通常使用 443 端口上的 HTTPS。数据分析器目的地使用生成的主机名和端口 8889。 ### 步骤 3:在 CMA 中创建集成 **要创建 Stellar Cyber 集成:** 1. 从 CMA 导航菜单,进入 **资源 > 集成**。 2. 打开 **已配置的集成** 标签页并点击 **新建**。 3. 选择 **Stellar Cyber** 和 **数据导出** 功能。 4. 输入 **名称** 和可选的 **描述**。 5. 对于 **摄取网址**,粘贴在步骤 2 中生成的完整 webhook URL。 6. (可选)要包括自定义 TLS 证书,请选中 **信任私有 CA 或自签名证书** 复选框,并粘贴 根 CA 证书。欲了解更多信息,请参见 [使用自定义 TLS 证书](/"/v1/docs/integrating-cato-data-with-stellar-cyber#using-a-custom-tls-certificate%5C")。 7. 对于 **Bearer 令牌**,粘贴具有摄取权限的 API 令牌。只输入令牌;Cato 会添加 `Bearer` 前缀。 8. 在 **数据源** 下,选择与 Stellar Cyber 目的地的索引类型和标准化配置匹配的源。 9. (可选)为选定的来源配置过滤器。参阅 [过滤器](/docs/zh/integrating-cato-data-with-stellar-cyber#filters)。 10. 点击 **保存**。 Cato 加密存储 API 令牌并不再显示。当轮换令牌时更新集成。 ### 步骤 4:验证摄取和标准化 **验证 Cato 数据是否到达 Stellar Cyber:** 1. 在 CMA 中,打开 **已配置的集成** 并确认集成已离开 **正在配置**,且未显示认证或目的地错误。必要时刷新页面。 2. 为每个配置的数据源生成最近的 Cato 事件或网络流量。 3. 在 Stellar Cyber 中,进入 **系统 > 集成 > 连接器** 并找到 XDR Connect 连接器。 4. 记录到达后,点击 **查看事件**。确认每个 Cato 记录单独显示。 5. 选择一个记录的 **更多信息**。在 **JSON** 标签页上,检查已解析的字段。在 **详细信息** 标签页上,检查标准化字段。 6. 验证目的地租户、索引、命名空间和时间戳。确认 `data_source` 是否与配置的 Cato 来源匹配。 ## 过滤器 使用事件和流量过滤器来限制导出到Stellar Cyber的Cato数据。这有助于控制摄取量,并将调查重点放在相关活动上。 组内的过滤条件使用与逻辑。单独的群组使用或逻辑。 - **事件过滤器** - 单击 **添加过滤器** 以定义条件,或单击 **添加群组** 以添加另一个过滤群组。 - **流量过滤器** - 当选择 **流量** 时可用。它使用与事件过滤器相同的分组逻辑。 过于严格的过滤器可能不报告错误就排除所有记录。如果没有数据到达,请检查所选数据源和过滤条件。 ## 已知局限性 - 创建Stellar Cyber XDR连接器后,索引类型和命名空间不能更改。在启用导出之前选择目标配置。 - 连接器有一个默认的目的地租户。路由记录到其他租户需要租户映射和传入JSON中的适当标识符。 - Stellar Cyber不支持第三方警报集成或通过XDR Connect摄取的数据的基于ML的检测。自动威胁搜寻规则可以提供额外检测和自定义警报。 - API密钥是基于身份的。使用具有仅摄取权限的令牌,并根据策略进行轮换。 - 您不能自定义Cato集成的请求正文格式、内容类型或认证头。 ## 故障排查 | 问题 | 解决方案 | | --- | --- | | 认证失败,出现超文本传输协议 401 或 403 错误 | 确认 API 令牌有效,并且其身份具有 **XDR Connector Ingestion** 权限。替换已过期或已撤销的令牌并更新 CMA 中的 **Bearer 令牌**。 | | 目的地不可达或返回超文本传输协议 404 | 复制生成的 Webhook 链接的完整内容。检查实例主机名,对于数据分析器目的地,检查端口 8889 和网络可达性。 | | 请求被拒绝或者单个记录未显示 | 检查目的地响应,并联系 Cato 支持,提供受影响的时间范围和错误详情,不包括 API 令牌。 | | 数据到达了错误的索引或命名空间 | 检查目的地的索引类型和命名空间。这些在创建后无法编辑;请用正确的值创建目的地并更新相应的 Cato 集成。 | | 字段或时间戳不正确 | 在**规范化**步骤中检查时间戳和字段映射。使用代表性样本并通过**显示结果**检查结果。若无时间戳映射,事件时间戳为摄取时间。 | | 集成看起来健康但没有数据到达 | 审查数据源选择和过滤器,生成匹配的 Cato 活动,并检查默认租户以及任何租户映射配置。 | | 只有一个预期源到达 | 检查每个 Cato 集成的数据源选择和过滤器与其 Stellar 目的地配置的匹配情况。 |