概述
支持和交易伙伴建立 AS2 连接,仅需简单的两步。首先,在 AS2 个人配置中配置本地 AS2 详情(标识符、私钥证书等等)。然后,在 工作流 页面上创建一个 AS2 端口,并配置特定交易伙伴的 AS2 详情。视频资源
观看此短视频,了解如何快速设置 AS2 端口。AS2 个人配置
个人配置页面 包含一个 AS2 部分,用于配置本地 AS2 详情。主要的配置细节包括:- AS2 标识符(该值向交易伙伴标识 是一个 AS2 实体)
- 私钥证书(用于解密传入消息和签署传出消息的证书)
AS2 标识符
AS2 标识符包含在传出的 AS2 消息中,并识别您为发送方。此外,传入的 AS2 消息必须寻址到此标识符才能被应用程序接受。AS2 标识符有一些限制:例如,不能包含空格字符,且区分大小写。除这些限制(以及交易伙伴施加的任何限制)外,AS2 标识符可以是任何双方约定的值。
私钥证书
私钥证书用于数字加密(解密和数字签名)。私钥证书包含一个与公钥配对的私钥。当交易伙伴使用您的公钥来保护 AS2 消息时,它能确保只有您可以使用配对的私钥解密该消息。 支持 PKCS#12 格式(.pfx 或 .p12 文件)的私钥证书,以及 PEM 编码的公钥证书(.cer 文件)。
创建新证书对
如果还没有用于 AS2 安全的私钥和公钥对, 支持创建自签名证书。自签名证书在 AS2 领域很常见,但某些交易伙伴可能要求从受信任的证书颁发机构 (CA) 购买证书。 要创建新的证书对,请在 私钥证书 下拉菜单中选择 创建证书:
- 常用名 (Common Name):使用该证书的服务器的主机名。它与序列号一起用于标识证书。
- 文件名:证书文件的名称,带有
.pfx扩展名。相应的公钥证书将被赋予相同的名称,扩展名为.cer。 - 序列号:唯一的序列号,与常用名结合使用以标识证书。
- 密码:访问私钥所需的密码。
- 有效期:决定证书的过期日期。
- 密钥长度:选择创建 512、1024、2048 或 4096 位密钥。
- 公钥类型:选择创建 X.509、OpenSSH 或 SSH2 公钥。
- 签名算法:对证书应用数字签名以验证其真实性时使用的算法。
data 目录中。该目录中的证书文件将出现在应用程序中任何证书类型设置的下拉列表中。
应用程序 URL
AS2 个人配置的 应用程序 URL 部分定义了交易伙伴向 发送 AS2 消息时可公开访问的端点。在 设置 > 高级 页面的 附加设置 部分设置 基准 URL 字段,指向托管 的机器或网络的基准 URL(例如https://mydomain.com/{siteNameShort})。以下端点是根据此域名值和应用程序 Web 服务器监听的端口生成的:
- 异步 MDN URL(如果需要异步 MDN,交易伙伴应将异步 MDN 回执 发送至此端点)
- 接收 URL(交易伙伴应将 AS2 消息发送至此端点)

AS2 端口配置
配置完 AS2 个人配置后,导航至 工作流 页面并创建一个 AS2 端口实例。每个 AS2 端口都配置了单个交易伙伴的 AS2 详情。
必填配置设置
AS2 配置详情必须由交易伙伴提供。交易伙伴至少必须提供以下详情:- AS2 标识符
- 传出 AS2 消息应发送到的 URL 或端点
- 用于加密的公钥证书或密钥


附加配置设置
伙伴可能会有额外要求,包括:- 同步或异步 MDN(在 设置 选项卡的 请求 MDN 回执 部分配置)
- 用于连接 HTTPS 服务器的 TLS 服务器证书(在 设置 选项卡的 交易伙伴证书 部分配置)
- 特定的加密或签名算法(在 高级 选项卡上的 加密算法 和 签名算法 中配置)
- 用于验证签名的独立证书(除加密证书外)(在 高级 选项卡的 伙伴签名证书 中配置)
测试 AS2 连接
完成交易伙伴的配置后,可以通过生成测试文档来测试传出连接。导航至 AS2 端口的 交易 选项卡,选择 更多 > 创建测试文件。 除非在 自动化 选项卡禁用了 发送自动化,否则端口会自动尝试处理这些测试文件。发送测试文件到配置的伙伴时发生的任何错误都会记录在 交易 选项卡,包括包含错误上下文和详情的日志文件。要进一步诊断连接问题,请使用 高级 选项卡上的 日志级别 和 日志消息 选项。 成功处理的文件在 交易 选项卡显示为绿色的 已发送 状态。成功发送测试文件即证明 AS2 配置正确。向交易伙伴提供 AS2 详情
正如交易伙伴必须提供其 AS2 配置详情以便为其配置 AS2 端口一样,您也必须向伙伴提供 AS2 配置详情。 至少需要向伙伴提供:- 您的 AS2 标识符
- 您的公钥或加密证书
- 您的接收 URL
公开 URL
向伙伴提供此信息最简单的方法是启用 AS2 个人配置中 应用程序 URL 处的 在 Public.rst 发布 AS2 个人配置设置 选项。公开 URL 字段包含一个可以提供给伙伴的链接:通过此链接,伙伴可以查看 AS2 配置设置并下载公钥或加密证书。公开 URL 的值与 接收 URL 字段不同,后者是交易伙伴发送 AS2 消息的地方,而 异步 MDN URL 字段是交易伙伴发送异步 MDN 回执的地方(如果需要异步 MDN)。
手动提供详情
或者,也可以手动向伙伴发送这些详情。在 AS2 个人配置 中查找 AS2 标识符 和 接收 URL 的值。 要向伙伴发送公钥或加密证书,请在磁盘上找到.cer 文件:
- 导航至 根安装目录
- 打开根目录中的
data文件夹 - 找到与 AS2 个人配置中 私钥证书 同名的
.cer文件(文件名相同,但扩展名为.cer而非.pfx) - 复制
.cer文件并共享给伙伴
发送 AS2 消息
成功建立传出 AS2 连接后,即可安全可靠地向交易伙伴发送文件。交易选项卡
放置在 AS2 端口 交易 选项卡中的文件将被端口排期发送。 如果 发送自动化 在 自动化 选项卡上已启用(默认启用),端口将自动轮询此文件夹以处理文件。或者,也可以从 交易 选项卡手动发送文件。勾选目标文件左侧的复选框,然后点击 发送 按钮。 还可以使用 交易 选项卡将文件上传到发送文件夹,如下图所示:
作为工作流的一部分发送
在大多数工作流中,文件在由 AS2 端口发送出去之前,会先由其他 端口处理。当另一个端口在工作流中连接到 AS2 端口时,文件会自动传递到 AS2 端口的发送文件夹。 在下面的工作流示例中,文件经 X12 端口 处理后,会自动添加到 AS2 端口的发送文件夹:
接收 MDN 回执
如果启用了 请求 MDN 回执,AS2 端口会自动等待 MDN 回执。如果 MDN 回执包含负面响应(例如,伙伴由于某种原因拒绝了交换),端口将报告错误而不是发送成功。 如果请求了异步 MDN,端口将保持在 等待 MDN 状态,直到伙伴返回 MDN。 建议使用同步 MDN,除非通过 AS2 交换的文件非常大(500MB 或更大)。接收 AS2 消息
当 AS2 消息到达 Web 服务器时,应用程序会将消息路由到特定的 AS2 端口。 使用消息头(AS2-To 和 AS2-From 标头)中的 AS2 标识符,将传入的文件路由到为发送该消息的伙伴配置的 AS2 端口。 如果应用程序找不到为传入消息配置的 AS2 端口(基于 AS2 标识符),应用程序日志 将记录错误,且文件不会被接收。输出选项卡
当通过 AS2 接收的文件被路由到特定的 AS2 端口(基于配置的 AS2 标识符)时,文件将到达该端口的 输出 选项卡。 如果 AS2 端口在工作流中连接到了其他端口,文件不会留在接收文件夹中,而是传递到工作流中的下一个端口。在下面的工作流示例中,通过 AS2 接收(并路由到此 AS2 端口)的文件会自动传递到 X12 端口进行进一步处理。