核心功能
- 现代基于 SOAP 的 B2B 消息传递,支持多种配置文件(ENTSOG、e-SENS、BDEW 和 eDelivery)
- 具有令牌认证和证书管理的高级安全功能
- 支持推送和拉取两种消息模式
- 支持通过服务和操作定义处理业务协议
- 全面支持消息属性和自定义请求头
- 已获得 Drummond Group 认证
概述
AS4 连接需要在两个位置进行配置。首先在 AS4 配置文件页面配置本地 AS4 参与方标识符和私钥证书。然后,为单个交易伙伴在各个 AS4 端口中配置专用连接设置。当输入文件由 AS4 端口处理时,它会被打包并发送到指定的交易伙伴。 当 知行之桥 通过 AS4 接收文件时,会尝试将文件路由到特定的 AS4 端口。应用程序使用 AS4 消息中的 AS4 参与方标识符来确定应由哪个 AS4 端口接收该文件。文件路由到 AS4 端口后,会放入该端口的交易 Tab,或传递到工作流中下一个已连接的端口。 AS4 端口支持共享连接。这意味着在一个端口中创建的连接和配置也会显示在设置 > 连接 Tab 中,以便在其他 AS4 端口中重复使用。配置文件配置
必须先配置 AS4 配置文件,才能与各个 AS4 端口建立连接。单击导航栏上的配置文件,然后单击 AS4 Tab。AS4 配置文件 Tab
个人 ID
用于标识本地配置文件的设置。个人证书
与私有解密和签名证书相关的设置。轮转证书
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 端口生成的日志的详细程度。当请求支持时,请将其设置为 Debug。 |
| 日志轮换间隔 | 创建新日志文件之前等待的天数。 |
| 日志删除间隔 | 删除旧日志文件之前等待的天数。 |
应用程序 URL
与从公网访问 知行之桥 相关的设置和显示值。其他
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
端口配置
配置全局 AS4 配置文件设置后,可在工作流页面为每个交易伙伴创建并配置单独的 AS4 端口。设置 Tab
配置
连接信息
与指定交易伙伴连接参数相关的设置。回执
与发送 AS4 消息时请求回执相关的设置。业务协议详情
与 AS4 业务协议共享详情相关的设置。配置前应与交易伙伴确认这些值。高级设置
高级 Tab
消息属性
可以提供一组以名称-值对形式指定的自定义消息属性,作为传出消息的一部分包含在内。在 UI 中设置名称-值对,等同于在消息到达 AS4 端口之前对消息执行<arc:set attr="Header:AS4-MessageProperty" value="Name=Value" />。
可以根据消息内容动态覆盖消息属性,或指定 string 以外的类型。为此,请使用类似以下脚本添加消息头:
AS4-MessagePropertyType 中指定的名称必须与 AS4-MessageProperty 中使用的名称匹配。多个属性用分号分隔。例如,以下示例在上述脚本基础上扩展了一个 integer 属性:
其他设置
先前类别中未包含的设置。代理设置
这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。
| 设置 | 描述 |
|---|---|
| 代理类型 | 基于代理的防火墙使用的协议。 |
| 代理主机 | 基于代理的防火墙的名称或 IP 地址。 |
| 代理端口 | 基于代理的防火墙的 TCP 端口。 |
| 代理用户 | 用于通过基于代理的防火墙进行身份验证的用户名。 |
| 代理密码 | 用于对基于代理的防火墙进行身份验证的密码。 |
| 身份验证方案 | 保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。 |
消息
消息设置确定端口如何搜索消息并在处理后管理它们。
| 设置 | 描述 |
|---|---|
| 保存到已发送文件夹 | 选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。 |
| 已发送文件夹方案 | 端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。 |
日志
用于管理日志创建和存储的设置。
| 设置 | 描述 |
|---|---|
| 日志级别 | 指定要记录在端口日志目录中的信息类型:
|
| 日志文件夹结构 | 指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。 |
| 保留消息副本 | 指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。 |
其他
特殊设置适用于特定用例。
| 设置 | 描述 |
|---|---|
| 其他设置 | 允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。 |
自动化 Tab
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。
| 设置 | 描述 |
|---|---|
| 最大工作线程数 | 此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
| 最大文件数 | 分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。 |
警报 Tab
SLA Tab
建立连接
创建新连接时,首先提供一个名称,然后完成以下设置。 用于识别并连接到特定 AS4 交易伙伴的设置。高级连接设置
单击高级 Tab 设置以下连接选项。令牌认证
与使用和要求令牌认证相关的设置。备用本地配置文件
此特定 AS4 端口中用于覆盖配置文件页面 AS4 配置的设置。设置备用本地配置文件后,可以为某些交易伙伴使用不同的本地证书和标识符。TLS 客户端认证
需要双向 TLS 认证时,与客户端认证相关的设置。其他设置
先前类别中未包含的设置。配置 BDEW 配置文件
BDEW(Bundesverband der Energie- und Wasserwirtschaft,即德国能源和水工业联合会)AS4 配置文件是由德国能源和水务行业定义的消息规范。配置 AS4 端口使用 BDEW 配置文件时,必须先添加以下消息头,然后才能将消息传递给端口。个人配置文件配置
AS4 配置文件包含交易伙伴用于识别你的关键信息。它在“配置文件”页面的 AS4 Tab 中配置。 首先,请指定以下信息:参与方标识符
与电子邮件交换中的电子邮件地址类似,它用于标识 AS4 传输中的伙伴。 将参与方标识符设置为能有意义地标识你或你的组织的值。此处设置的值会在 知行之桥 发起的 AS4 传输头部中发送。 参与方标识符是共享配置文件信息时与交易伙伴交换的信息之一。交易伙伴应在其 AS4 系统中使用此值,以便处理来自该标识符的请求。个人证书
私钥证书用于签名传出消息并解密传入消息。AS4 配置文件使用 PKCS#12 格式(.pfx 或 .p12 文件)的私钥证书。- 在私钥证书下拉菜单中单击上传证书,从磁盘选择现有证书。
- 单击创建证书创建新的自签名证书。这会创建一个新的私钥证书以及同名的公钥证书(.cer 文件)。
接收 URL
此值基于设置 > 高级中的基础 URL 和默认的 知行之桥 侦听端点生成。 请与交易伙伴共享此值,以便他们能够成功向 知行之桥 发送 AS4 消息。交易伙伴设置
交易伙伴负责提供连接其 AS4 端点所需的特定设置。每个 AS4 端口都必须配置为单一交易伙伴关系。 以下 AS4 配置选项为必需:交易伙伴标识符
交易伙伴提供其参与方标识符,这是其配置文件中用于在 AS4 传输中标识组织的部分。该标识符用于传出请求的头部,以指示预期接收者。此值区分大小写,因此配置新的交易伙伴时,请确保大小写正确。