HTTP协议配置选项
要从转发 HTTP 或 HTTPS 请求的设备收集事件,请将日志源配置为使用 HTTP。
HTTP是一种入站被动协议。 HTTP在配置的监听端口上充当 HTTP ,并将任何收到的POST请求的请求正文转换为事件。 它支持 HTTPS 和 HTTP 请求。
| 参数 | 描述 |
|---|---|
| 协议配置 | 从列表中选择 HTTP。 |
| 日志源标识 | 输入日志源的唯一名称。 日志源标识 可以是任何有效值,并且不需要引用特定服务器。 它也可以是与 日志源名称相同的值。 请确保为每个日志源提供唯一的名称。 |
| 侦听端口 | IBM QRadar 用于接收 HTTP 接收器事件的端口。 缺省端口为 12469。 重要信息: 请勿使用端口 514。 端口 514 由标准 Syslog 侦听器使用。
|
| 通信类型 | 协议创建HTTP类型。
|
| 服务器证书 | 选择下列其中一个服务器证书选项。
|
| 服务器证书友好名称 | QRadar 证书库中提供的证书的友好名称,在 QRadar
Certificate Management 应用程序中上载。 重要信息: QRadar
Certificate Management 应用程序在 QRadar 7.3.3 修订包 6 或更高版本上受支持。
|
| PKCS12 服务器证书路径 | 包含专用密钥和证书链的 PKCS12 文件的绝对路径。 如果选择 PKCS12 证书链和密码 作为服务器证书选项,那么将显示此参数。 |
| PKCS12 密码 | PKCS12 文件的密码。 如果选择 PKCS12 证书链和密码 作为服务器证书选项,那么将显示此参数。 |
| PKCS12 证书别名 | 要使用的 PKCS12 文件中证书条目的别名。 如果 PKCS12 文件中有多个条目,那么必须提供别名以指定要使用的证书条目。 当存在多个证书条目时,请将此字段留空以使用单个证书条目。 如果选择 PKCS12 证书链和密码 作为服务器证书选项,那么将显示此参数。 |
| 使用 HTTP 认证令牌报头 | 这样就可以启用 HTTP 标头认证。 启用后,尝试HTTP Server通信的客户必须通过请求头提供有效的访问令牌。 |
| 认证令牌头名称 | HTTP被添加到 HTTP中,包含有关正在使用的认证头和关联凭证的信息。 认证头: 指示正在使用的认证类型。 公共认证头包括 Basic , Digest 和 Bearer。 |
| 认证令牌值 | 头中包含的令牌值取决于正在使用的认证方案。 例如,对于基本认证, "令牌值" 由以 Base64 格式编码的用户名和密码组成。 |
| 相互 TLS 认证信任库 | 如果选择 具有相互 TLS 的 HTTPS (mTLS) 通信类型,请选择其中一种信任库类型。
|
| 定制信任库文件路径 | 定制信任库的绝对路径。 必须将定制信任库复制到日志源的 QRadar Console 或 Event Collector 。 |
| 定制信任库密码 | 定制信任库的密码。 |
| 启用签发者验证 | 验证客户机证书是否由特定证书或公用密钥发放。 常见用例是验证是否使用了特定的中间 CA 来发放客户机证书。 |
| 颁发者证书或公用密钥 | PEM 格式的根或中间签发者证书或公用密钥。 输入证书,包括以下文本: -----BEGIN CERTIFICATE----- -----END CERTIFICATE----- 或者输入公用密钥,包括以下文本: -----BEGIN PUBLIC KEY----- -----END PUBLIC KEY----- 如果已启用 启用签发者验证 参数,那么将显示此参数。 |
| 使用 CN 允许列表 | 指定建立信任后客户机证书必须匹配的公共名称的列表或模式。 输入纯文本或正则表达式。 通过在新行上输入每个条目来定义多个条目。 以下列表显示了要在 CN Allowlist中使用的公共名称条目类型的示例。
缺省情况下,此参数处于禁用状态。 |
| 检查证书撤销 | 针对客户机证书撤销列表检查证书撤销状态。 要配置此选项,您必须能够通过网络连接到 X509v3客户端证书的CRL分发点字段指定URL ,且URL 必须仅支持证书吊销列表(CRL)格式。 不支持 OSCP。 |
| 客户机证书路径 (不推荐) | 设置客户机证书的绝对路径。 必须将客户机证书复制到日志源的 QRadar Console 或 Event Collector 。 如果选择 具有相互 TLS 的 HTTP (mTLS) 作为 通信类型,并选择 磁盘上的客户机证书 (不推荐) 作为 相互 TLS 认证信任库,那么将显示此参数。 |
| 事件解析方法 |
|
| 用作网关日志源 | 选择此选项可使收集的事件流经 QRadar® 流量分析引擎,并使 QRadar 自动检测一个或多个日志源。 |
| 使用预测解析 | 如果启用此参数,那么算法将从事件中抽取日志源标识模式,而不针对每个事件运行正则表达式,这将提高解析速度。 但是,在极少数情况下,算法可以进行不正确的预测。 仅对您期望接收高事件速率且需要更快解析的日志源类型启用预测解析。 启用 用作网关日志源 参数时,可以启用预测解析。 |
| 日志源标识模式 | 选择 用作网关日志源 选项时,请使用此选项为已处理的事件定义定制日志源标识。 如果未配置 日志源标识模式 ,那么 QRadar 会将事件作为未知通用日志源接收。 日志源标识模式 字段接受键/值对 (例如 key= value) ,以定义要处理的事件的定制日志源标识以及要自动发现的日志源 (如果适用)。 键 是标识格式字符串,它是生成的源或源值。 值是用于评估当前有效内容的关联正则表达式模式。 值 (正则表达式模式) 还支持捕获组,这些组可用于进一步定制键 (Identifier Format String)。 可以通过在新行上输入每个模式来定义多个键/值对。 使用多个模式时,将按顺序对其进行求值,直到找到匹配项为止。 找到匹配项时,将显示定制日志源标识。 以下示例显示了多键/值对函数:
|
| EPS 调速 | 每秒 QRadar 摄入的最大事件数。 如果数据源超过 EPS 调速,那么数据收集将延迟。 仍会收集数据,然后在数据源停止超过 EPS 调速时采集数据。 缺省值 5000。 |
| 启用 Advanced Server 配置选项 | 启用此参数以配置更多服务器选项。 如果未启用此参数,那么将使用缺省值。 |
| 最大有效内容长度 (字节) | 单个事件的最大有效内容大小 (以字节为单位)。 当事件的有效内容大小超过此值时,将拆分该事件。 缺省值为 8192 ,并且不得大于 32767。 当您启用 启用高级服务器配置选项 参数时,将显示此参数。 |
| TLS 协议 | 此协议中可接受的 TLS 版本。 使用为服务器选择的版本发送请求。 从 QRadar 7.5.0 UP5 开始,支持 TLSv1.3 。 从 QRadar 7.3.3 FP10, 7.4.3 FP3和 7.5.0 CR 起,不再支持 重要信息: TLSv1.0 和 TLSv1.1 。 未来发行版可能不支持 TLSv1.0 和 TLSv1.1。
|
| 最大 POST 方法请求长度 (MB) | POST 方法请求主体的最大大小 (MB)。 如果 POST 请求正文大小超过此值,则返回 HTTP 状态代码。 缺省值为 5 ,并且不得大于 10。 当您启用 启用高级服务器配置选项 参数时,将显示此参数。 |
| 发布请求处理程序线程 | 分配用于处理接收到的发布请求的处理线程数。 如果处理线程跟不上传入的帖子数据,就会返回 HTTP 429。 当您启用 启用高级服务器配置选项 参数时,将显示此参数。 |