Cisco Secure Firewall Management Center Event Streamer 集成指南，版本 7.2.0
非歧视性语言
此产品的文档集力求使用非歧视性语言。在本文档集中，非歧视性语言是指不隐含针对年龄、残障、性别、种族身份、族群身份、性取向、社会经济地位和交叉性的歧视的语言。由于产品软件的用户界面中使用的硬编码语言、基于 RFP 文档使用的语言或引用的第三方产品使用的语言，文档中可能无法确保完全使用非歧视性语言。 深入了解思科如何使用包容性语言。
当地语言翻译版本说明
思科可能会在某些地方提供本内容的当地语言翻译版本。请注意，翻译版本仅供参考，如有任何不一致之处，以本内容的英文版本为准。
- 已更新:
- 2023年8月8日
Chapter: Event Streamer 简介
简介
思科 Event Streamer（也称为 eStreamer）能让您通过流传输将 Cisco Secure Firewall 系统事件发送到外部客户端应用。您可以从管理中心通过流传输发送主机、发现、关联、合规性白名单、入侵、用户活动、文件、恶意软件和连接数据。
请注意，NGIPSv、Firepower 服务、Firepower Threat Defense Virtual 和 Firepower 威胁防御不支持 eStreamer。要从这些设备通过流传输发送事件，可以在这些设备向其报告的管理中心上配置 eStreamer。
eStreamer 使用自定义应用层协议与连接的客户端应用通信。因为 eStreamer 的目的只是返回客户端请求的数据，所以本指南主要介绍请求的数据的 eStreamer 格式。
创建 eStreamer 客户端并将其与 Cisco Secure Firewall 系统集成需要执行三个主要步骤：
1. 编写一个使用 eStreamer 应用协议与管理中心或受管设备交换消息的客户端应用。eStreamer SDK 包含一个标准客户端应用。
2. 配置一个管理中心或设备以将所需类型的事件发送到您的客户端应用。
eStreamer 版本 7.2的重大变更
添加了对接收完全限定事件的支持。请参阅 请求完全限定事件
已将基于 Python 的新参考客户端添加到 SDK。请参阅 运行 eStreamer Python 标准客户端
使用本指南
总体来看，eStreamer 服务是通过流传输将数据从 Cisco Secure Firewall 系统发送到发出请求的客户端的一种机制。该服务可以通过流传输发送以下类别的数据：
本文主要介绍 eStreamer 返回的数据结构。本文的章节如下：
- 了解 eStreamer 应用协议，此章对 eStreamer 通信进行了概述，详细说明了编写 eStreamer 客户端应用的一些要求，并且介绍了用于向 eStreamer 服务发送命令和接收来自该服务的数据的四种类型的消息。
- 了解入侵和关联数据结构，此章介绍了用于返回由入侵检测和关联组件生成的事件数据的数据格式，以及用于描述入侵和关联事件的数据格式。
- 了解发现和连接数据结构，此章介绍了用于返回发现事件、用户事件和连接事件数据的数据格式。
- 了解主机数据结构，此章介绍了 eStreamer 在收到主机信息请求消息时用于返回完整主机信息数据的数据格式。
- 配置eStreamer，此章介绍了如何在管理中心或受管设备上配置 eStreamer。此章还介绍了 eStreamer 命令行开关，并且提供了手动启动和停止 eStreamer 服务以及配置管理中心或受管设备以自动启动 eStreamer 的说明。
- 数据结构示例，此章提供了二进制格式的 eStreamer 消息数据包示例。
- 了解旧版数据结构，此章介绍了当前产品不再使用、但是旧客户端可能使用的旧数据结构的结构。
必备条件
要了解此指南中的信息，您应大体上熟悉 Cisco Secure Firewall 系统的功能和术语以及其组件的功能，尤其应熟悉这些组件生成的不同类型的事件数据。对于不熟悉的术语或产品特定的术语，其定义通常可以从《Cisco Secure Firewall eStreamer 集成指南》获取。
Cisco Secure Firewall 系统发行版的产品版本
本指南通篇使用版本号来描述管理中心和受管设备生成的事件的数据格式。 Cisco Secure Firewall 系统产品版本 表按主要发行版列出了每个产品的版本。
文档约定
eStreamer 消息数据类型约定 表列出了本文中用于介绍 eStreamer 消息中采用的各种数据字段格式的名称。eStreamer 服务使用的数字常数通常为无符号整数值。除非另有说明，位字段使用低顺序位。例如，在包含五位标志数据的单字节字段中，低顺序五位将包含数据。
最佳实践
使用 eStreamer 时，思科给出了以下建议以最佳利用 API。
- 考虑使用以 Python 编写的 Cisco 可插拔 eStreamer 客户端作为客户端基础，这样您只需构建一个插件即可设置 SIEM 方案的数据格式。
- 构建您的 eStreamer 客户端，以支持 API 可以提供的所有内容，因为方案的每一部分都至少对一小部分客户群很重要。
– 了解消息结构 - 逐渐了解 eStreamer 集成指南。
– 花时间获取在元数据和代码结构中定义的记录 - 其中很大一部分能够解析消息。
– 从一般意义上了解元数据的工作方式，例如，元数据记录被提前发送。
– 了解对象模型 - 记录如何相互关联以及哪些元数据与哪些记录相关。
- 实施强大的错误处理和日志记录，以便在出现问题时，您可以查看消息和导致问题的情况，而不必重现错误。
- 仔细挑选您的语言。解析似乎不需要进行大量计算，但当每秒钟有数千个事件时，一切都非常重要。诸如 C、C++、Go 等编译语言将比 Python/JavaScript 更快。 这种方法的缺点是缺乏可移植性。
- 如果您实施多线程处理 或常规处理，请明白处理元数据的任何方法都必须按顺序处理消息 - 这必须包括无序传送更正。
- 查看现有的 eStreamer 实施，了解其他人过去如何实现您的目标。访问以下某些资源：
– https://splunkbase.splunk.com ，并搜索 eStreamer
– https://software.cisco.com/download/home/ ，在“选择产品”旁边，选择“浏览全部”，再选择“安全性”，然后依次选择“防火墙”、“防火墙管理”、“Firepower 管理中心虚拟设备”、“Firepower 系统工具和 API”。
反馈