Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

发送和接收 AS2 消息

本节介绍发送和接收 AS2 消息的过程。它还提供了与 AS2 消息相关的文件名和位置的详细信息。

下表列出了 AS2 消息的可用加密算法以及何时可以使用这些算法。

发送 AS2 消息流程

出站进程定义为从 Amazon 外部客户端或服务发送的消息或文件。出站消息的顺序如下：

AS2 处理支持许多 RFC 4130 协议，重点关注常见使用案例并与启用 AS2 的现有服务器实现集成。有关支持的配置详细信息，请参阅 。

接收 AS2 消息流程

入站流程定义为正在传输到 Amazon Transfer Family 服务器的消息或文件。入站消息的顺序如下：

通过 HTTPS 发送和接收 AS2 消息

本节介绍如何配置使用 AS2 协议通过 HTTPS 发送和接收消息的 Transfer Family 服务器。

通过 HTTPS 发送 AS2 消息

要使用 HTTPS 发送 AS2 消息，请使用以下信息创建一个连接器：

通过 HTTPS 接收 AS2 消息

Amazon Transfer Family AS2 服务器目前仅通过端口 5080 提供 HTTP 传输。但是，您可以使用自己选择的端口和证书在您的 Transfer Family 服务器 VPC 终端节点前的网络或应用程序负载均衡器上终止 TLS。使用这种方法，您可以让传入的 AS2 消息使用 HTTPS。

先决条件

您可以配置网络负载平衡 (NLB) 或 Application Load Balancer (ALB)。下表列出了每种方法的优缺点。

下表提供了使用 NLB 与 ALB 终止 TLS 时的功能差异。

Configure NLB

此过程介绍如何在您的 VPC 中设置面向互联网的网络负载均衡器 (NLB)。

创建网络负载均衡器并将服务器的 VPC 端点定义为负载均衡器的目标

1. 在 https://console.aws.amazon.com/ec2/ 中打开 Amazon Elastic Compute Cloud 控制台。

2. 在导航窗格中，选择负载均衡器，然后选择创建负载均衡器。

3. 在网络负载均衡器下，选择创建。

4. 在基本配置部分，输入以下信息：

   • 对于名称，为负载均衡器输入一个描述性名称。

   • 对于 Scheme，选择 Internet-facing。

   • 在 IP 地址类型中，选择 IPv4。

5. 在网络映射部分中，输入以下信息：

   • 对于 VPC，请选择您已创建的虚拟私有云 (VPC)。

   • 在映射下，选择与公有子网关联的可用区，这些子网位于您用于服务器端点的同一 VPC 中。

   • 对于每个子网的IPv4 地址，请选择您分配的弹性 IP 地址之一。

6. 在侦听器和路由部分中，输入以下信息：

   • 对于协议，选择 TLS。

   • 对于端口，输入 5080。

   • 对于默认操作，选择创建目标组。有关创建新目标组的详细信息，请参阅 创建目标组。

   创建目标组后，在默认操作字段中输入其名称。

7. 在安全侦听器设置部分，在默认 SSL/TLS 证书区域中选择您的证书。

8. 选择创建负载均衡器以创建您的 NLB。

9. （可选，但推荐）打开网络负载均衡器的访问日志以保持完整的审计跟踪记录，如网络负载均衡器的访问日志中所述。

   我们建议执行此步骤，因为 TLS 连接已在 NLB 终止。因此，反映在您的 Transfer Family AS2 CloudWatch 日志组中的源 IP 地址是 NLB 的私有 IP 地址，而不是贸易伙伴的外部 IP 地址。

Configure ALB

此过程介绍如何在您的 VPC 中设置 Application Load Balancer (NLB)。

创建 Application Load Balancer 并将服务器的 VPC 终端节点定义为负载均衡器的目标

1. 在 https://console.aws.amazon.com/ec2/ 中打开 Amazon Elastic Compute Cloud 控制台。

2. 在导航窗格中，选择负载均衡器，然后选择创建负载均衡器。

3. 在应用程序负载均衡器下，选择创建。

4. 在 ALB 控制台中，在端口 443 (HTTPS) 上创建一个新的 HTTP 监听器。

5. （可选）。如果要设置相互身份验证 (mTLS)，请配置安全设置和信任存储。

   1. 将您的 SSL/TLS 证书附加到侦听器。

   2. 在 “客户证书处理” 下，选择相互身份验证 (mTLS)。

   3. 选择 “使用信任存储进行验证”。

   4. 在 “高级 mTLS 设置” 下，通过上传您的 CA 证书来选择或创建信任存储。

6. 创建一个新的目标组，并将 Transfer Family AS2 服务器端点的私有 IP 地址添加为端口 5080 上的目标。有关创建新目标组的详细信息，请参阅 创建目标组。

7. 为目标组配置运行状况检查，使其在端口 5080 上使用 TCP 协议。

8. 创建新规则，将 HTTPS 流量从侦听器转发到目标组。

9. 将侦听器配置为使用您的 SSL/TLS 证书。

设置负载均衡器后，客户端通过自定义端口侦听器与负载均衡器进行通信。然后，负载均衡器通过端口 5080 与服务器通信。

测试从弹性 IP 地址访问服务器

使用弹性 IP 地址或网络负载均衡器的 DNS 名称通过自定义端口连接到服务器。

使用 AS2 连接器传输文件

AS2 连接器在贸易伙伴之间建立关系，将 AS2 消息从 Transfer Family 服务器传输到合作伙伴拥有的外部目的地。

您可以使用 Transfer Family 通过引用连接器 ID 和文件路径发送 AS2 消息，如以下 start-file-transfer Amazon Command Line Interface (Amazon CLI) 命令所示：

aws transfer start-file-transfer --connector-id c-1234567890abcdef0 \
--send-file-paths "/DOC-EXAMPLE-SOURCE-BUCKET/myfile1.txt" "/DOC-EXAMPLE-SOURCE-BUCKET/myfile2.txt"

要获取连接器详细信息，请运行以下命令：

aws transfer list-connectors

该 list-connectors 命令会返回连接器的连接器 ID、URL 和 Amazon 资源名称 (ARN)。

要返回特定连接器的属性，请使用要使用的 ID 运行以下命令：

aws transfer describe-connector --connector-id your-connector-id

describe-connector 命令返回连接器的所有属性，包括其 URL、角色、配置文件、消息处置通知 (MDN)、标签和监控指标。

您可以通过查看 JSON 和 MDN 文件来确认合作伙伴已成功接收文件。这些文件是根据 文件名和位置 中描述的约定命名的。如果您在创建连接器时配置了日志记录角色，则还可以检查 CloudWatch 日志中是否有 AS2 消息的状态。

要查看 AS2 连接器的详细信息，请参阅 查看 AS2 连接器详细信息。有关创建 AS2 连接器的更多信息，请参阅 配置 AS2 连接器。

文件名和位置

本部分讨论 AS2 传输的文件命名约定。

对于入站文件传输，需要注意以下方面：

对于出站传输，命名类似，不同之处在于没有传入的消息文件，而且，已传输消息的传输 ID 会添加到文件名中。传输 ID 由 StartFileTransfer API 操作返回（或者当其他流程或脚本调用此操作时）。

您还可以查看 CloudWatch 日志以查看转账的详细信息，包括任何失败的转账。

状态代码

下表列出了您或您的合作伙伴发送 AS2 消息时可以记录到 CloudWatch 日志中的所有状态代码。不同的消息处理步骤适用于不同的消息类型，并且仅用于监控。“已完成” 和 “失败” 状态表示处理的最后一步，在 JSON 文件中可见。

示例 JSON 文件

本部分列出了入站和出站传输的示例 JSON 文件，包括传输成功和传输失败的示例文件。

传输成功的示例出站文件：

{
  "requester-content-type": "application/octet-stream",
  "message-subject": "File xyzTest from MyCompany_OID to partner YourCompany",
  "requester-file-name": "TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-from": "MyCompany_OID",
  "connector-id": "c-c21c63ceaaf34d99b",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 3198,
  "mdn-message-id": "OPENAS2-11072022063009+0000-df865189-1450-435b-9b8d-d8bc0cee97fd@PartnerA_OID_MyCompany_OID",
  "mdn-subject": "Message be18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa has been accepted",
  "as2-to": "PartnerA_OID",
  "transfer-id": "dedf4601-4e90-4043-b16b-579af35e0d83",
  "file-path": "/DOC-EXAMPLE-BUCKET/as2testcell0000/openAs2/TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-message-id": "fbe18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa",
  "timestamp": "2022-07-11T06:30:10.791274Z"
}

传输失败的示例出站文件：

{
  "failure-code": "HTTP_ERROR_RESPONSE_FROM_PARTNER",
  "status-code": "FAILED",
  "requester-content-type": "application/octet-stream",
  "subject": "Test run from Id da86e74d6e57464aae1a55b8596bad0a to partner 9f8474d7714e476e8a46ce8c93a48c6c",
  "transfer-size": 3198,
  "requester-file-name": "openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "as2-message-id": "9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "failure-message": "http://Test123456789.us-east-1.elb.amazonaws.com:10080 returned status 500 for message with ID 9a9cc9ab-7893-4cb6-992a-5ed8b90775ff@718de4cec1374598",
  "transfer-id": "07bd3e07-a652-4cc6-9412-73ffdb97ab92",
  "connector-id": "c-056e15cc851f4b2e9",
  "file-path": "/DOC-EXAMPLE-BUCKET-4c1tq6ohjt9y/as2IntegCell0002/openAs2/openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "timestamp": "2022-07-11T21:17:24.802378Z"
}

传输成功的示例进站文件：

{
  "requester-content-type": "application/EDI-X12",
  "subject": "File openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat sent from MyCompany to PartnerA",
  "client-ip": "10.0.109.105",
  "requester-file-name": "openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.dat",
  "as2-from": "MyCompany_OID",
  "status-code": "COMPLETED",
  "disposition": "automatic-action/MDN-sent-automatically; processed",
  "transfer-size": 1050,
  "mdn-subject": "Message Disposition Notification",
  "as2-message-id": "OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID",
  "as2-to": "PartnerA_OID",
  "agreement-id": "a-f5c5cbea5f7741988",
  "file-path": "processed/openAs2TestInboundAsyncMdn-necco-5Ab6bTfCO.OPENAS2-11072022233606+0000-5dab0452-0ca1-4f9b-b622-fba84effff3c@MyCompany_OID_PartnerA_OID.dat",
  "server-id": "s-5f7422b04c2447ef9",
  "timestamp": "2022-07-11T23:36:36.105030Z"
}

传输失败的示例进站文件：

{
  "failure-code": "INVALID_REQUEST",
  "status-code": "FAILED",
  "subject": "Sending a request from InboundHttpClientTests",
  "client-ip": "10.0.117.27",
  "as2-message-id": "testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "as2-to": "0beff6af56c548f28b0e78841dce44f9",
  "failure-message": "Unsupported date format: 2022/123/456T",
  "agreement-id": "a-0ceec8ca0a3348d6a",
  "as2-from": "ab91a398aed0422d9dd1362710213880",
  "file-path": "failed/01187f15-523c-43ac-9fd6-51b5ad2b08f3.testFailedLogs-TestRunConfig-Default-inbound-direct-integ-0c97ee55-af56-4988-b7b4-a3e0576f8f9c@necco",
  "server-id": "s-0582af12e44540b9b",
  "timestamp": "2022-07-11T06:30:03.662939Z"
}