--- title: "使用自定义超文本传输协议 (HTTP) 推送集成发送数据" slug: "integrating-cato-data-with-custom-http-push" updated: 2026-11-18T00:09:13Z published: 2026-11-18T00:09:13Z canonical: "knowledge.catonetworks.com/integrating-cato-data-with-custom-http-push" --- > ## 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. # 使用自定义超文本传输协议 (HTTP) 推送集成发送数据 ## 概况 对于那些没有专用 Cato 集成但需要向系统上传数据的组织,我们提供自定义 HTTP 推送集成。 使用**自定义 HTTP 推送**集成将事件和可选的流量直接上传到任何接受 JSON 或新行分隔 JSON (NDJSON) 的外部平台。数据在生成时会被连续推送,而不是按计划定期获取。这允许下游系统无需轮询即可接收到近乎实时的更新。 ### 常见使用案例 - **SIEM 和 SOC 平台 -** 示例公司使用 [IPS 可疑活动监控功能](https://knowledge.catonetworks.com/v1/docs/monitoring-suspicious-activity-with-ips-sam),生成大量安全事件。他们决定将这些数据集中到现有的 SIEM 平台,但没有专门的 Cato 集成。示例公司启用事件集成,并配置一个指向其 SIEM 的 HTTP 吞吐端点的自定义 HTTP 推送集成,以便所有 IPS 事件自动流向 SIEM 进行关联、警报和与其他安全数据一起的长期保留。 - **自定义日志收集和分析 -** 示例公司希望将 Cato 事件数据导入他们的内部分析管道用于操作报告。他们上线了一个基于 HTTP 的日志收集器以接收数据,并在其 Cato 帐户中配置了一个自定义 HTTP 推送集成,以便在事件生成时持续推送到收集器,而无需从 Cato 轮询更新。 ### 交付可靠性 数据以尽力传输方式发送。如果目的地端点不可用或返回认证错误,Cato 将自动按照以下计划尝试重新连接: - **短期重试:** 1 分钟、5 分钟、10 分钟、15 分钟、1 小时、6 小时和 24 小时 - **长期重试:** 在最初的 24 小时后进行每日重试,继续最多长达 7 天 如果在7天内集成仍然无法连接,则整个集成的连续重试尝试将停止,直到端点配置问题得到解决。 ### 原生集成与自定义HTTP推送 Cato 提供专门构建的集成,用于将事件导出到常用平台,包括 [Splunk](/v1/docs/integrating-cato-data-with-splunk)、[Microsoft Sentinel](/v1/docs/integrating-cato-events-with-microsoft-sentinel)、[CrowdStrike](/v1/docs/integrating-cato-events-with-crowdstrike) 和 [Azure Storage](/v1/docs/integrating-cato-events-with-azure-storage-account)。当您的目的地提供本地集成时,我们建议使用它。优势在于它针对该平台进行了优化,可能提供平台特定的功能。 当您的目的地没有专用集成,或您需要将事件传递到自定义应用程序或服务时,请使用自定义 HTTP 推送集成。 ### 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. ### 过滤器 使用过滤器控制哪些事件被导出。这有助于降低摄取成本,减少噪声,并将调查集中在对特定站点、用户或地区最相关的事件上。您还可以使用过滤器将不同子集的事件路由到不同的 SIEM 环境。 ![](https://cdn.document360.io/81d0367c-2b69-4ba8-b412-1c8f46ce677e/Images/Documentation/36659528448669.png?sv=2026-02-06&spr=https&st=2026-11-19T06%3A08%3A51Z&se=2026-11-19T07%3A08%3A51Z&sr=b&sp=r&sig=vV4NA2CRqnAzxfr%2Bi9sYQAT4ksqIgkPEajIl%2BLbNE14%3D) 使用过滤器组定义基于任何 [事件字段](/v1/docs/understanding-event-fields)或字段组合的过滤器。每个组中的条件使用 AND 逻辑。在组之间应用 OR 逻辑。截图中的过滤器配置集成以导出: - 事件 **来源**自巴黎或马德里,属于互联网防火墙 **子类型**,并导致除了监控或提示 **操作**之外的其他结果 - **用户名**包含测试 ## 条件 在配置自定义 HTTP 推送集成之前,请验证目标平台支持以下所有功能: - HTTP POST或PUT请求 - JSON或换行分隔的JSON(NDJSON) - 标准Cato负载,无需自定义请求体、供应商专用包装或额外指令 负载结构是固定的。字段不能添加、移除或重新排列。 总结: - 如果目的地平台能准确接收 Cato 发送的纯 JSON 对象或 NDJSON 事件流,则通常视为兼容。示例包括SentinelOne、Securonix和Trend AI。 - 如果一个平台的接收API要求在请求体中添加专有负载结构,例如信封、包装或控制行,则不兼容。示例包括Elastic和Datadog。 ## 设置自定义超文本传输协议推送集成 ### 步骤1:收集参数 从目标平台获取: - **接收网址:**接受事件的超文本传输协议终端 - **认证详细信息:**集成支持自定义头部、API密钥、Bearer令牌或基础认证。如果您的供应商希望前缀值(例如Bearer ),则要输入整个字符串——包括前缀——作为单一值。它在Cato端加密存储。 ### 步骤2:使用curl进行测试 独立验证目的地使用命令行curl请求。这可以隔离供应商端的问题(认证、端点、负载接受)并提供一个可直接在连接器设置中重复使用的有效请求。 以下示例显示了一个用于 Elastic 的 curl 请求,但未成功: ```bash curl -X POST "https:///_bulk" \ -H "Authorization: ApiKey " \ -H "Content-Type: application/x-ndjson" \ --data-binary $'{"create":{"_index":"logs-cato.events-default"}}\n{"message":"test event from curl","event_type":"test","timestamp":"2026-07-05T12:00:00Z"}\n' ``` 这不符合连接器的要求,即使 curl 请求本身可能在 Elastic 上成功。负载需要在每行事件之前有一个创建指令行;集成无法注入额外行,因为主体格式是固定的。 以下示例显示了一个用于 SentinelOne 的 curl 请求,并成功: ```bash curl -i "https://ingest.us1.sentinelone.net/services/collector/raw?sourcetype=cato_events" \ -H "Authorization: " \ -H "Content-Type: application/x-ndjson" \ --data-binary $'{"event_type":"test"}\n' ``` 这有效,因为 SentinelOne 的 HEC 原始端点每行接受一个纯事件对象——没有包装,没有额外指令——这正好是连接器发送的。当类似的curl测试成功时,可以逐字使用它在连接器设置中。 - **网址:**粘贴完整的端点,包括查询参数(例如,?sourcetype=cato_events) - **认证:**自定义头→头名称Authorization,值设置为您的真实令牌(存储为机密)。 - **正文:**设置内容类型来匹配您测试过的(application/x-ndjson在此。) 如果您的curl测试成功,继续第3步。 ### 步骤3:配置连接器 1. 在CMA中,进入**资源>集成>配置集成**,然后点击**新建**。 2. 在**集成**下,选择**自定义HTTP集成**。 3. 在**功能**下,选择**数据导出**。 4. 在**认证**下,选择与您用curl验证过的方法相匹配的方法(自定义头、API密钥、Bearer令牌或基础认证)。 5. 输入**名称**和可选的**描述**。 6. 输入在curl中测试过的**网址**—相同的端点。 7. (可选)要包含一个自定义TLS证书,勾选 **信任一个私有CA或自签名证书** 复选框并粘贴 根CA证书。欲了解更多信息,请参阅 [使用自定义TLS证书](/v1/docs/sending-cato-data-to-external-platforms-http-push#using-a-custom-tls-certificate) 8. 添加您的**自定义头部**(或等效认证字段)—继续使用成功的curl命令中的准确头名称和值。每个值可以作为**机密**或**明文**存储。 9. 在**正文**下,确认内容类型(默认是`application/json`;也支持NDJSON)。 连接器发送的请求体**不可配置:**您不能添加自定义字段或重构负载。 10. 在**数据来源**下,选择**事件**、**流量**或两者。 11. (可选范围是使用**事件过滤器**和**流量过滤器**(匹配已配置的过滤器组的任意一个)。欲知详情,请参见上面的[过滤器](/v1/docs/sending-cato-data-to-external-platforms-http-push#filters1)。 12. 选择是否**跟踪连接器事件中的错误**。建议这样做以便传递故障显示为您可以警报的事件。 13. 保存配置并确认状态显示**已连接**。 ## 故障排除 - **Curl成功但Cato显示连接错误:**仔细检查在Cato中输入的头/认证是否确切匹配您在curl中使用的,包括任何必需的前缀(例如Bearer)作为加密值的一部分。 - **没有事件到达我的外部平台:**检查您的事件过滤器/流量过滤器。过滤过狭可能默默排除所有内容。 - **供应商拒绝负载:**审查先决条件。您的供应商很可能需要一个此连接器无法生成的自定义主体结构。 ## 文章变更日志 | 日期 | 说明 | | --- | --- | | 2026年8月4日 | - 添加详细的使用案例 - 添加[过滤器](/v1/docs/sending-cato-data-to-external-platforms-http-push#filters1)部分 | ## 常见问题 #### 问:我能否同时推送到多个端点? 答:您应针对每个目的地配置单独的自定义HTTP推送集成。 #### 问:这是否取代原生集成(Splunk、Sentinel、CrowdStrike等)? 答:不。若存在原生Cato集成,请使用。自定义HTTP推送集成适用于没有专用集成的平台或非SIEM目的地。 #### 问:如果我的供应商不在支持列表中怎么办? 答:检查其HTTP接收API是否接受普通JSON或NDJSON且不需要包装结构。如果是,先用curl测试,然后按此页面描述配置连接器。 #### 问:我能否自定义JSON正文或添加字段? 答:不能。负载架构是固定的。