AS4 端口

Version 24.3.9111

AS4 端口

AS4 端口支持通过 AS4 协议发送和接收消息。

概述

AS4 连接配置在两个位置。AS4 个人设置部分应配置有本地 AS4 ID 和私钥证书。而每个 AS4 端口可以为特定的单个交易伙伴配置连接设置。当输入文件由指定 AS4 端口处理时，这些文件将被打包并发送到端口指定的交易伙伴。

当知行之桥通过 AS4 接收文件时，将尝试将文件路由到特定的 AS4 端口。该应用程序使用 AS4 消息中的 AS4 ID 来确定应接收该文件的 AS4 端口。将文件路由到 AS4 端口时，该文件将放置在端口的 Receive 目录中，或传递到工作流中的下一个连接的端口。

个人设置

必须先配置 AS4 配置文件，然后各个 AS4 端口才能建立连接。单击导航栏上的 个人设置，然后单击 AS4 选项卡。

AS4 个人设置

个人信息

用于标识本地配置文件的设置。

AS4 ID 你的 AS4 ID。由知行之桥发送的消息必须定位该 ID，并且传出消息将使用该值来标识消息的始发者。AS4 ID 区分大小写。
AS4 ID 类型 可选的 AS4 ID 类型声明。如果指定，则此值应该是 AS2 ID 所属的域。

个人证书

与解密和签名的私钥证书有关的设置。

私钥证书 用来解密收到的消息和发送消息的签名。该证书不能和外部分享。单击创建证书按钮以生成一个新的自签名证书，该证书可以在 AS4 事务中使用。还将生成具有相同文件名和扩展名 “.cer” 的公钥证书。
证书密码 私钥证书的密码。

应用程序 URL

与从公共网站访问知行之桥有关的设置和显示。

接收 URL 知行之桥用来侦听传入的 AS4 消息的 URL。该 URL 应该通给所有交易伙伴。

日志

管理日志的创建和存储的设置。

日志级别 端口生成的日志的详细程度。当请求支持时，请将其设置为 Debug。
日志循环周期 创建新日志文件之前等待的天数。
日志删除周期 删除旧日志文件之前等待的天数。

特殊设置

特殊设置 适用于特定用例。

其他设置 允许在以分号分隔的列表中配置隐藏的端口设置，例如setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

特殊设置

特殊设置 适用于特定用例。

其他设置 允许在以分号分隔的列表中配置隐藏的端口设置，例如setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

端口配置

配置完 AS4 个人设置后，可以在工作流页面中创建 AS4 端口，并为特定的交易伙伴进行配置。

设置

配置

端口 Id 端口的静态、唯一标识符。
端口类型 显示端口类型及其用途的描述。
端口描述 一个可选字段，用于提供端口及其在流中的角色的自由格式描述。

交易伙伴信息

用于识别和连接到特定 AS4 交易伙伴的设置。

交易伙伴 ID 目标交易伙伴的 AS4 ID。此值包含在传出的 AS4 消息中，以确保将其传递给期望的接收者，并且还用于将传入的 AS4 消息路由到适当的 AS4 端口。
交易伙伴 ID 类型 AS4 ID 的可选类型声明。如果指定，则此值应该是标识所属的域。
交易伙伴 URL 交易伙伴的公共接口，可以向其发送 AS4 消息。
协议管理交易的共享 AS4 协议。这是 ENTSOG 配置文件中所必需的。

连接信息

设置指定交易伙伴的相关连接参数。

消息发送安全性 是否签名／加密传出的 AS4 消息。强烈建议签名和加密。
消息接收安全性 是否要求传入的 AS4 消息存在签名和加密。如果收到的消息没有必需的安全性参数，将出现错误。
压缩是否压缩发送消息。
连接超时时间 端口在出现超时错误之前将等待连接响应的时长。
个人信息 在 AS4 交换中使用的 AS4 配置文件。配置文件可帮助确定共享的配置设置，以确保交易伙伴之间的兼容性。设置配置文件将自动更新端口中的相关配置选项。
消息通道 AS4 交换应通过的通道。如果未指定通道，则隐式分配默认消息分区通道（MPC）。MPC 在发送或接收请求时很重要，因为只有在分配的 MPC 中排队的消息才能响应请求并在响应中返回。

回执

与发送 AS4 消息时请求回执相关的设置。

请求回执 是否应返回回执以响应收到的 AS4 消息，以及是否期望对发送的 AS4 消息返回回执。
回执方式 接收回执应作为对传出的 AS4 消息的直接响应（同步），还是稍后使用独立连接（异步）返回。除非 AS4 消息的大小非常大（通常为 50MB），在这种情况下，处理消息并传递同步回执可能会增加连接超时时间，否则其它情况下建议使用同步 MDN。

交易伙伴证书

与交易伙伴提供的公钥证书有关的设置。

加密证书 发送消息时用于 AS4 加密的公钥证书。该证书必须与交易伙伴的使用的解密证书配对，并且在共享 AS4 配置详细信息时，交易伙伴应提供此公钥证书。
验证证书 接收消息时用于验证 AS4 签名的公钥证书。该字段通常是不必要的。大多数 AS4 参与方将使用相同的证书进行签名和解密，如果未指定此字段，则应用程序将使用加密证书来验证签名。
TLS 服务器证书 用于验证 TLS/SSL 服务器身份的公钥证书。仅在交易伙伴的 AS4 系统需要 HTTPS（而不是 HTTP）时才需要。如果交易伙伴不提供 TLS 服务器证书，此设置可以留空，以允许底层 OS/JVM 执行证书验证，或者将其设置为 “Any Certificate”，以无条件信任目标服务器的身份。

业务协议详情

与 AS4 商业协议的共享详细信息有关的设置。在配置之前，应与交易伙伴确认这些值。

服务接受消息的业务流程。
服务操作 在业务流程中执行的操作或活动。
服务类型 为服务提供上线文的可选限定符。
发送方（From Role） 消息发送方的角色。根据交易伙伴协议，在发送和接收 AS4 请求时，这些角色可以颠倒或保持不变。此值用于结果 AS4 SOAP 信封的 PartyInfo 元素中。
接收方（To Role） 消息接收方的角色。根据交易伙伴协议，在发送和接收 AS4 请求时，这些角色可以颠倒或保持不变。此值用于结果 AS4 SOAP 信封的 PartyInfo 元素中。

自动化

自动化设置

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

发送到达端口的文件是否将自动作为 AS4 消息发送。
重试间隔（分） 失败之后，重试发送前的等待时间。当服务器发送无响应，或者收到否定响应以表明未收到文件时，将触发重试。
最大重试次数 端口处理输入文件的最大次数。是否成功基于服务器相应和回执的验证（如需要回执）。如果设置为 0，那么端口将无限次尝试处理失败文件。
重发间隔（分） 重新发送后收到确认消息之前的时间。服务器收到文件后触发重新发送，但是在预期的时间范围内未提供异步回执。
最大重发尝试次数（异步） 如果需要异步回执时，端口处理输入文件的最大次数。是否成功基于服务器在正确相应后异步回执是否在重发间隔内返回（如果服务器没有正确响应，那么最大重试次数会被使用）。如果设置为 0，那么端口将无限次尝试处理失败文件。
接收端口是否应自动发出获取请求以接收来自交易伙伴的消息。
Pull 间隔 自动获取请求之间的间隔。
分每次执行等待的分钟数。仅当执行间隔被设置为 Minute 时适用。
第几分钟/小时 每小时计划的分钟偏移量。仅当执行间隔被设置为 Hourly 时适用。例如，如果将此值设置为 5，将在 1:05、2:05、3:05 自动执行脚本。
时在指定的某一天内进行消息处理的时间。仅当执行间隔被设置为 Daily 或 Weekly 或 Monthly 时适用。
天进行消息处理的某一天。仅当执行间隔被设置为 Weekly 或 Monthly 时适用。
Cron 表达式 表示 cron 表达式的任意字符串，用于确定何时执行。仅当执行间隔被设置为 Advanced 时适用。

性能

与端口资源分配相关的设置。

最大线程数 从线程池中消耗用于处理此端口上的文件的最大工作线程数。如果设置，这将覆盖 设置 > 自动化 页面上的默认设置。
最大文件数 分配给端口的每个线程发送的最大文件数。如果设置，这将覆盖 设置 > 自动化 页面上的默认设置。

通知

与配置警报和服务等级协议 (SLA) 相关的设置。

端口邮件设置

在执行 SLA 之前，需要设置电子邮件警报以获取通知。单击 配置通知 将打开一个新的浏览器窗口，转到系统设置，可以在其中设置系统范围的警报。有关详细信息，请参阅通知。

服务等级协议 (SLA) 配置

SLA 能够配置期望工作流中的端口发送或接收的数量，并设置期望满足该数量的时间范围。知行之桥在不满足 SLA 时发送电子邮件警告用户，并将 SLA 标记为 有风险，这意味着如果很快不满足 SLA，则会将其标记为 已违反。这使用户有机会介入并确定未满足 SLA 的原因，并采取适当的措施。如果在风险时间段结束时仍未满足 SLA，则将 SLA 标记为违反，并再次通知用户。

要定义 SLA，请单击 添加预期数量条件。

如果端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 所属的方向。
将 期待至少 设置为期望处理的最小交易数量（交易量），然后使用每字段指定时间范围。
默认情况下，SLA 每天都有效。要更改此设置，请取消选中每日，然后选中想要的一周中的几天的框。
使用 将状态设置为“有风险” 来指示何时应将 SLA 标记为存在风险。
默认情况下，在违反 SLA 之前不会发送通知。要更改此设置，请选中 发送“有风险”通知。

以下示例显示为预计周一至周五每天接收 1000 个文件的端口配置的 SLA。如果尚未收到 1000 个文件，则会在该时间段结束前 1 小时发送风险通知。

高级设置

令牌认证

与使用和要求令牌认证有关的设置。

令牌认证（接收） 身份认证令牌是否必须包含在传入的 AS4 消息中。如果启用，传入消息必须包含与在此选项下设置的用户名和密码字段匹配的用户名凭据。
令牌认证（发送） 验证令牌是否应包含在传出的 AS4 消息中。如果启用，传出消息将包含与在此选项下设置的用户名和密码字段匹配的用户名凭据。
密码认证类型 用户名令牌应采用纯文本格式还是加密摘要格式。

首选个人设置

此特定 AS4 端口的 个人设置页面中覆盖 AS4 配置的设置。设置备用本地配置文件可以为某些交易伙伴使用不同的本地证书和标识。

AS4 ID 你的 AS4 ID。将覆盖个人设置部分的 AS4 ID 设置。
AS4 ID 类型 （可选）你的 AS4 标识符类型。将覆盖个人设置部分中的 AS4 ID 类型。
私钥证书 用来解密传入消息和签署传出消息的证书。将覆盖个人设置部分的私钥证书设置。
证书密码 访问本地私钥证书所需的密码。

TLS 客户端认证

双向 TLS 认证时与客户端认证有关的设置。

使用个人设置界面设置 是否使用与个人设置界面中的私钥证书相同的证书作为 TLS 证书进行客户端身份认证。
私钥证书 用于 TLS 客户端认证的私钥证书。仅在未使用与个人设置页面相同的私钥的情况下适用。
证书密码 TLS 客户端认证证书的密码。

消息属性

在名称-值对中指定的任意一组定制消息属性，这些属性将包含在传出消息中。

其它设置

先前类别中未包含的设置。

协议参考 P-Mode 共享的 AS4 协议的处理方式属性。
协议参考类型 共享的 AS4 协议的参考类型属性。
附加 XML 文件 XML 是应该打包为 SOAP 消息的 MIME 附件，或是直接包含在 SOAP 正文中。
重复消息操作 当端口收到带有端口之前见过的消息 ID 的 AS4 消息时应如何表现。端口通过_记住_在重复消息间隔中指定的分钟数内收到的消息 ID 来检测重复消息。

继续：端口像任何其他文件一样处理重复文件
忽略：端口默默地忽略（丢弃）入站文件
失败：端口引发错误并且不处理文件
重复间隔（分钟） 具有相同消息 ID 的消息在时间长度内（以分钟为单位）发送将被视为重复文件。换句话说，端口将记住已经接收到消息 ID 的时间。如果设置为 0，则将一直保存消息 ID，直到重新启动服务器为止。
加密算法 加密发送的 AS4 消息时使用的算法。
Pull URL 如果与交易伙伴 URL 不同时，请设置为获取请求应该发送到的接口。
回执 URL 如果与交易伙伴 URL 不同时，请设置为回执应该发送到的接口。
安全令牌格式 安全令牌使用哪种格式（证书参考）。
签名算法 签名发送消息时使用的算法，相应的收据将请求使用相同的算法。
延迟处理 放置在输入文件夹中的文件的处理延迟的时间量（以秒为单位）。这是一个遗留设置。最佳实践是使用 File 端口来管理本地文件系统，而不是此设置。
启用 TLS 建立发送连接时支持的 TLS／SSL 协议列表。强烈建议仅使用 TLS 协议。注意，一些过时的操作系统不支持 TLS 1.2。

代理设置

这些是一组设置，用于识别和验证代理（AS4 连接应通过该代理进行路由）。默认情况下，此部分使用设置页面上的全局设置。清除该复选框可提供特定于的端口的设置。

代理类型 基于代理的防火墙使用的协议。
代理主机 基于代理的防火墙的名称或 IP 地址。
代理端口 基于代理的防火墙的 TCP 端口。
代理用户 用于通过基于代理的防火墙进行身份验证的用户名。
代理密码 用于对基于代理的防火墙进行身份验证的密码。
身份验证方案 保留默认值 None 或选择以下身份验证方案之一：Basic、Digest、Proprietary或NTLM。

消息

消息设置 确定端口如何搜索消息并在处理后管理它们。可以将消息保存到你的 已发送 文件夹，或者可以根据 已发送 文件夹方案将它们保存，如下所述。

保存至 Sent 文件夹 选中此选项可将端口处理的文件复制到端口的已发送文件夹中。
已发送文件夹方案 端口根据选定的时间间隔对已发送文件夹中的文件进行分组。例如，选项每周（Weekly）指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在“Sent”文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

管理日志的创建和存储的设置。

日志级别 端口生成的日志的详细程度。当请求支持时，请将其设置为 Debug。
日志子文件夹方案 指端口根据选定的时间间隔对日志文件夹中的文件进行分组。例如，Weekly 选项表示端口每周创建一个新子文件夹并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在 Logs 文件夹中。对于处理大量事务的端口，使用子文件夹有助于保持日志井井有条并提高性能。
日志消息 选中此项可使已处理文件的日志条目包含文件本身的副本。如果禁用此功能，可能无法从输入或输出选项卡下载文件的副本。

特殊设置

特殊设置 适用于特定用例。

其他设置 允许在以分号分隔的列表中配置隐藏的端口设置，例如setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

个人设置

AS4 配置文件包含交易伙伴用于识别你的关键信息，并在应用程序的个人设置页中进行配置。

首先，请指定以下信息：

AS4 ID
个人证书

AS4 ID

与电子邮件交换中的电子邮件地址类似，这可以标识 AS4 传输中的交易伙伴。

将 AS4 ID 设置为有意义地标识你或组织的值。此处设置的值在知行之桥发起的 AS4 传输的头部中发送。

AS4 ID 是共享配置文件信息时与交易伙伴交换的一条信息。交易伙伴应在其 AS4 系统中使用此值，以便他们可以处理来自该标识的请求。

个人证书

私钥证书用于签名传出消息和解密传入消息。AS4 配置文件使用 PKCS#12 格式（.pfx 或 .p12 文件）的私钥证书。

在私钥证书列表点击上传证书选择一个已存在的证书。
通点击创建证书来创建新的自签名证书。此操作将创建具有新名称的私钥证书和公钥证书（.cer 文件）。

接收 URL

该值是基于系统设置 - 高级设置中指定的网站地址结合知行之桥默认的侦听接口组成的。

此值应该与交易伙伴共享，以便他们可以成功向应用程序发送 AS4 消息。

交易伙伴的建立

交易伙伴负责提供连接到其 AS4 接口所需的特定设置。每个 AS4 端口应配置为与一个交易伙伴关系。

需要的 AS4 配置选项：

AS4 ID
交易伙伴 URL
交易伙伴证书
请求回执
服务
服务操作

AS4 配置的其它元素是可选的，并且需要与交易伙伴事先达成协议。与交易伙伴明确沟通，确定与特定伙伴成功沟通所需的字段。

交易伙伴 ID

交易伙伴提供他们的 AS4 ID，这是个人资料的一部分，用于识别 AS4 传输中的组织。该标识用于发送请求的消息头中以指示期望的接收者。

注意： 此值区分大小写，因此在配置新的交易伙伴时，请检查大小写是否正确。

交易伙伴 URL

交易伙伴 URL 是交易伙伴的 AS4 系统在其中侦听接收消息的公共接口。收到交易伙伴的 URL 后，请使用 Web 浏览器测试 URL，以检测任何常规的网络或连接问题。

在某些情况下，如果交易伙伴提供用于推送 AS4 传输，提取 AS4 传输和返回异步收据的单独 URL，则交易伙伴可能会提供多个 URL。在高级配置选项卡的获取 URL 和接收 URL 下配置其它 URL。

交易伙伴证书

必须为每个 AS4 端口配置目标交易伙伴的公钥证书。交易伙伴提供了加密和验证与其交换的 AS4 消息所需的证书。知行之桥接受 X.509 公钥证书（扩展名为 .cer，.der 或 .pem 的文件）。

通常，交易伙伴将提供一个证书，该证书应在加密证书字段中进行配置。

如果交易伙伴提供了多个证书，则他们应阐明每个证书的目的。如果交易伙伴提供完整的证书链（从商业证书颁发机构获取），则仅需要配置叶子证书（链中的最后一个证书）。有时，会使用单独的公共密钥证书来验证伙伴的数字签名。在这种情况下，请在验证证书处设置签名验证证书。

如果交易伙伴需要 TLS/SSL 连接，需要交易伙伴提供其 TLS 服务器的公钥证书。这应该在 TLS 服务器证书下设置。或者，可以将该字段设置为 “Any Certifcate”，隐式信任目标 TLS 服务器的身份。

请求回执

请求回执可保证 AS4 消息的不可否认性；换句话说，消息的成功传送是无可争议的。因此，强烈建议启用请求回执字段。回执的使用应事先与交易伙伴达成协议。

默认情况下，回执是同步传递的，这意味着回执是作为对 AS4 消息的直接响应而返回的。异步收据稍后在单独的连接中传递。AS4 消息的数据非常大的情况下，处理和传递同步回执可能会使连接超时持续时间紧张，除此以外建议使用同步回执。

服务和服务操作

服务、服务操作和其它商业协议的详细信息应与交易伙伴进行沟通。这些值有助于定义与交换的 AS4 消息关联的业务逻辑以及各方对消息的解释。

从 SMP 导入

如果交易伙伴具有服务元数据发布者（SMP）配置文件，则可以使用从 SMP 导入按钮导入这些设置。需要从配置中获取 SMP 配置文件的 SML 域，参与者 ID/Scheme 和文档 ID/Scheme。将使用从 SMP 配置文件读取的值自动调整端口设置。

发送和接收文件

配置 AS4 配置文件和特定交易伙伴的 AS4 端口后，可以安全地发送和接收文件。

发送文件

在 AS4 端口中，输入选项卡显示应发送到目标交易伙伴的文件。如果启用了自动发送，到达端口 Send 文件夹的文件将被自动封装并发送。传输成功以绿色 “Sent” 状态表示，警告和错误状态以黄色和红色表示。可以通过展开已传输文件行来访问传输失败或成功的日志文件。

创建测试文件按钮用于生成一些简单的测试文件，可以将这些测试文件发送给交易伙伴。

重发和重试

当交易伙伴伙伴将返回异步回执时，未在重发间隔持续时间内（默认为 60 分钟）返回回执时，将触发 AS4 重新发送，应用程序尝试重新发送传输。应用程序将持续重新发送消息，直到收到 MDN 或最大重发尝试次数（异步）用完为止。

当交易伙伴的 HTTP 响应提示服务器尚未接收到传输时（即响应不是肯定的 200 OK 状态），将触发重试。这通常表示网络或连接问题，通常是暂时的。应用程序将每隔重试间隔时长进行传输重试，直到接收到传输或最大重试次数用完为止。

接收文件

在 AS4 端口中，输出选项卡显示应用程序已接收并路由到端口的文件（基于传入的 AS4 消息中存在的 AS4 ID）。展开每个文件行，可以显示传输日志列表。

这些文件位于端口的 Receive 文件夹中。如果端口已连接到工作流中的其它端口，则文件将自动从 AS4 端口的 Receive 文件夹移动到工作流中下一个端口的 Send 目录。

宏

在文件命名策略中使用宏可以提高组织效率和对数据的上下文理解。通过将宏合并到文件名中，可以动态地包含相关信息，例如标识符、时间戳和消息头信息，从而为每个文件提供有价值的上下文。这有助于确保文件名反映对组织重要的详细信息。

知行之桥支持这些宏，它们都使用以下语法：%Macro%。

宏	描述
ConnectorID	替换为端口的 ConnectorID。
Ext	替换为端口当前正在处理的文件的文件扩展名。
Filename	替换为端口当前正在处理的文件的文件名（包括扩展名）。
FilenameNoExt	替换为端口当前正在处理的文件的文件名（不带扩展名）。
MessageId	计算端口输出的消息的 MessageId。
RegexFilename:pattern	将正则表达式模式应用于端口当前正在处理的文件的文件名。
Header:headername	替换为端口正在处理的当前消息的目标消息头 (`headername`) 的值。
LongDate	以常规格式计算系统的当前日期时间（例如，2024 年 1 月 24 日星期三）。
ShortDate	以 yyyy-MM-dd 格式计算系统的当前日期时间（例如 2024-01-24）。
DateFormat:format	以指定格式（`format`）计算系统的当前日期时间。有关可用的日期时间格式，请参阅示例日期格式
Vault:vaultitem	计算指定保管库项目的值。
AS4MessageId	替换为端口接收到的 AS4 消息的 MessageId。
ConversationId	替换为端口接收到的 AS4 消息的 ConversationId。
SenderRole	替换为端口接收到的 AS4 消息的 SenderRole。
ReceiverRole	替换为端口正在接收的 AS4 消息的 ReceiverRole。
Service	替换为端口接收到的 AS4 消息的服务。
Action	替换为端口接收到的 AS4 消息的服务操作。

示例

某些宏（例如 %Ext% 和 %ShortDate%）不需要参数，但其他宏则需要。所有带有参数的宏都使用以下语法：%Macro:argument%

以下是带有参数的宏的一些示例：

%Header:headername%：其中 headername 是消息上消息头的名称。
%Header:mycustomheader% 解析为输入消息上设置的 mycustomheader 消息头的值。
%Header:ponum% 解析为输入消息上设置的 ponum 消息头的值。
%RegexFilename:pattern%：其中“pattern”是正则表达式模式。例如，%RegexFilename:^([\w][A-Za-z]+)% 匹配并解析为文件名中的第一个单词，并且不区分大小写（test_file.xml解析为test）。
%Vault:vaultitem%：其中 vaultitem 是 vault 中项目的名称。例如，%Vault:companyname%解析为存储在保管库中的companyname项的值。
%DateFormat:format%：其中 format 是可接受的日期格式（有关详细信息，请参阅示例日期格式）。例如，%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%解析为文件上的日期和时间戳。

还可以创建更复杂的宏，如以下示例所示：

将多个宏组合在一个文件名中：%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT%
包括宏之外的文本：MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%
在宏中包含文本： %DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%