ICAP 端口 - 知行之桥文档

ICAP 端口支持与中的互联网内容适配协议 (ICAP) 服务器无缝集成。此端口充当应用程序和 ICAP 兼容服务器之间的中介，从而促进内容适配服务，尤其是实时安全扫描。

关键功能

实时内容适配和安全扫描
支持请求修改 (REQMOD) 和响应修改 (RESPMOD) 模式
支持 TLS 加密，确保安全通信
可自定义 HTTP 封装，兼容旧系统
灵活的身份验证选项，包括私有证书支持
可用作流程中的”转换”步骤。标记为需要注意的文件会产生错误，而其他文件则照常继续执行流程。

端口配置

此部分包含所有可配置的端口属性。

设置

与端口核心配置相关的设置。

设置	描述
端口 ID	端口的静态唯一标识符。
端口类型	显示端口名称及其功能描述。
端口描述	可选字段，用于对端口及其在工作流中的角色进行自由格式描述。
ICAP URI	（必需）要连接的 ICAP 服务器的 ICAP 统一资源标识符 (URI)。必须采用以下格式：`icap://<hostname>:<port>/<service_name>`。
ICAP 头	可选标头，用于满足特定服务器的要求。使用此选项可添加要包含在传出 ICAP 请求中的自定义 ICAP 请求标头。
TLS 配置	勾选此项可为 ICAP 连接启用 TLS 加密。
TLS 服务器证书	用于验证 TLS/SSL 服务器身份的公钥证书。仅当 ICAP 服务器启用了 TLS 时才需要此项。将其设置为 `Any Certificate` 可无条件信任 ICAP 服务器的身份。仅在启用 TLS 配置时才相关。
本地文件命名方案	为端口输出消息分配文件名的方案。可以在文件名中使用宏来动态包含标识符和时间戳等信息。更多信息，请参阅宏。

高级选项卡

TLS 客户端身份验证

设置	描述
私钥证书	选择、创建或上传用于身份验证的 TLS 证书。
证书密码	访问私钥证书所需的密码。

其他设置

设置	描述
ICAP 模式	指定 ICAP 事务的类型：使用 REQMOD 进行请求修改，或使用 RESPMOD 进行响应修改。默认为 REQMOD。
头中的 Script	允许在发出查询之前求值标头中的 Script 表达式。例如，`[_ \| now('yyyy-MM-dd')]` 求值当前日期，`[_message.header:headername]` 求值输入消息上下文中的 headername 标头。
URL 中的 Script	允许在发出查询之前求值 URL 中的 Script 表达式。例如，`[_ \| now('yyyy-MM-dd')]` 求值当前日期，`[_message.header:headername]` 求值输入消息上下文中的 headername 标头。
预览大小	控制发送到 ICAP 服务器的消息正文预览的大小。`Automatic` 选项会让客户端使用 OPTIONS 请求查询服务器，以确定最佳预览大小。或者，可以指定预览大小的确切数字（以字节为单位）。
数据块大小	预览阶段后发送的每个数据块的最大大小（以字节为单位）（或对于没有预览的请求）。默认值为 16KB。
超时（秒）	端口在抛出超时错误之前等待连接响应的时间（以秒为单位）。默认值为 60 秒。
响应标头	以逗号分隔的 ICAP 响应标头名称列表（例如 `X-Infection-Found,X-Scan-Result`）将被提取并作为元数据添加到已处理的消息中。
TLS 已启用协议	建立传出连接时支持的 TLS/SSL 协议列表。最佳实践是仅使用 TLS 协议。SSL v2 和 SSL v3 被认为存在漏洞，只有在贸易伙伴不支持更高版本时才应使用。请注意，TLS v1.3 尚未被普遍采用，如果目标服务器不支持它，可能会被拒绝。

代理设置

日志

杂项

自动化

自动化设置

与端口自动处理文件相关的设置。

设置	描述
发送	到达端口的文件是否自动作为 ICAP 事务发送。

性能

告警选项卡

SLA 选项卡

事务

此选项卡列出了与端口关联的所有消息。使用搜索栏查找特定消息，或点击漏斗图标应用过滤器。您可以按时间、消息方向和／或状态进行过滤。收到的响应会显示在此选项卡上。

事件

事件	描述
Response	此事件允许扩展端口解析来自 ICAP 服务器的回复的方式。默认情况下，端口会根据 ICAP 服务器的状态代码最终确定消息。但是，由于 ICAP 服务器也可以在响应标头中包含扫描详细信息，因此可以通过 Response 事件对这些标头应用自定义逻辑，以实现更精细的控制。此事件不会创建任何输出；但是，可以使用 `arc:throw` 关键字来阻止文件（例如，如果特定标头值指示扫描失败）。
Before Send	此事件在端口完全准备好文件以发送/处理文件之后，但在实际发送/处理发生之前触发。
After Receive	此事件在端口收到文件之后触发。

Response 事件中可用的参数如下：

StatusCode：ICAP 响应状态代码（例如 200、204 或 4xx）
_response：ICAP 响应。您可以使用 [_response.header:xxx] 获取特定的响应头。
_message：用于引用输入消息（响应头和正文），并将响应头添加到输出中。

宏

示例