Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Senden und Empfangen von AS2-Nachrichten

In diesem Abschnitt werden die Prozesse zum Senden und Empfangen von AS2-Nachrichten beschrieben. Es enthält auch Details zu Dateinamen und Speicherorten, die mit AS2-Nachrichten verknüpft sind.

In der folgenden Tabelle sind die verfügbaren Verschlüsselungsalgorithmen für AS2-Nachrichten aufgeführt und wann Sie sie verwenden können.

Prozess zum Empfangen einer AS2-Nachricht

Der eingehende Prozess ist definiert als eine Nachricht oder Datei, die auf Ihren AWS Transfer Family Server übertragen wird. Die Reihenfolge für eingehende Nachrichten ist wie folgt:

Senden und Empfangen von AS2-Nachrichten über HTTPS

In diesem Abschnitt wird beschrieben, wie Sie einen Transfer Family-Server konfigurieren, der das AS2-Protokoll zum Senden und Empfangen von Nachrichten über HTTPS verwendet.

Senden Sie AS2-Nachrichten über HTTPS

Um AS2-Nachrichten über HTTPS zu senden, erstellen Sie einen Connector mit den folgenden Informationen:

Empfangen Sie AS2-Nachrichten über HTTPS

AWS Transfer Family AS2-Server bieten derzeit nur HTTP-Transport über Port 5080 an. Sie können TLS jedoch auf einem Netzwerk- oder Anwendungs-Load Balancer vor Ihrem VPC-Endpunkt des Transfer Family-Servers beenden, indem Sie einen Port und ein Zertifikat Ihrer Wahl verwenden. Mit diesem Ansatz können Sie dafür sorgen, dass eingehende AS2-Nachrichten HTTPS verwenden.

Voraussetzungen

Sie können entweder einen Network Load Balance (NLB) oder einen Application Load Balancer (ALB) konfigurieren. In der folgenden Tabelle sind die Vor- und Nachteile der einzelnen Ansätze aufgeführt.

In der folgenden Tabelle sind die Unterschiede in den Funktionen aufgeführt, wenn Sie ein NLB im Vergleich zu einem ALB verwenden, um TLS zu beenden.

Configure NLB

Dieses Verfahren beschreibt, wie Sie einen Network Load Balancer (NLB) mit Internetanschluss in Ihrer VPC einrichten.

Um einen Network Load Balancer zu erstellen und den VPC-Endpunkt des Servers als Ziel des Load Balancers zu definieren

1. Öffnen Sie die Amazon Elastic Compute Cloud-Konsole unter. https://console.aws.amazon.com/ec2/

2. Wählen Sie im Navigationsbereich Load Balancers und dann Create Load Balancer aus.

3. Wählen Sie im Bereich Network Load Balancer die Option Erstellen.

4. Geben Sie im Abschnitt Grundkonfiguration die folgenden Informationen ein:

   • Geben Sie unter Name einen beschreibenden Namen für den Load Balancer ein.

   • Wählen Sie für Schema. Internet-facing

   • Wählen Sie für den IP-Adresstyp IPv4 aus.

5. Geben Sie im Abschnitt Netzwerkzuordnung die folgenden Informationen ein:

   • Wählen Sie für VPC die Virtual Private Cloud (VPC) aus, die Sie erstellt haben.

   • Wählen Sie unter Zuordnungen die Availability Zones aus, die den öffentlichen Subnetzen zugeordnet sind, die in derselben VPC verfügbar sind, die Sie mit Ihren Serverendpunkten verwenden.

   • Wählen Sie für die IPv4-Adresse jedes Subnetzes eine der Elastic IP-Adressen aus, die Sie zugewiesen haben.

6. Geben Sie im Abschnitt Listener und Routing die folgenden Informationen ein:

   • Wählen Sie für Protokoll die Option TLS aus.

   • Geben Sie im Feld Port 5080 ein.

   • Wählen Sie als Standardaktion die Option Zielgruppe erstellen aus. Einzelheiten zum Erstellen einer neuen Zielgruppe finden Sie unterErstellen einer Zielgruppe.

   Nachdem Sie eine Zielgruppe erstellt haben, geben Sie ihren Namen in das Feld Standardaktion ein.

7. Wählen Sie im Abschnitt Einstellungen für sichere Listener Ihr Zertifikat im Bereich SSL/TLS Standardzertifikat aus.

8. Wählen Sie Create Load Balancer aus, um Ihren NLB zu erstellen.

9. (Optional, aber empfohlen) Aktivieren Sie die Zugriffsprotokolle für den Network Load Balancer, um einen vollständigen Audit-Trail zu führen, wie unter Zugriffsprotokolle für Ihren Network Load Balancer beschrieben.

   Wir empfehlen diesen Schritt, da die TLS-Verbindung am NLB beendet wird. Daher ist die Quell-IP-Adresse, die in Ihren CloudWatch AS2-Protokollgruppen von Transfer Family wiedergegeben wird, die private IP-Adresse der NLB und nicht die externe IP-Adresse Ihres Handelspartners.

Configure ALB

Dieses Verfahren beschreibt, wie Sie einen Application Load Balancer (ALB) in Ihrer VPC einrichten.

Um einen Application Load Balancer zu erstellen und den VPC-Endpunkt des Servers als Ziel des Load Balancers zu definieren

1. Öffnen Sie die Amazon Elastic Compute Cloud-Konsole unter. https://console.aws.amazon.com/ec2/

2. Wählen Sie im Navigationsbereich Load Balancers und dann Create Load Balancer aus.

3. Wählen Sie unter Application Load Balancer Create (Erstellen) aus.

4. Erstellen Sie in der ALB-Konsole einen neuen HTTP-Listener auf Port 443 (HTTPS).

5. (Optional). Wenn Sie die gegenseitige Authentifizierung (mTLS) einrichten möchten, konfigurieren Sie Sicherheitseinstellungen und einen Trust Store.

   1. Hängen Sie Ihr SSL/TLS Zertifikat an den Listener an.

   2. Wählen Sie unter Umgang mit Client-Zertifikaten die Option Gegenseitige Authentifizierung (mTLS) aus.

   3. Wählen Sie Mit Trust Store verifizieren aus.

   4. Wählen Sie unter Erweiterte mTLS-Einstellungen einen Trust Store aus oder erstellen Sie ihn, indem Sie Ihre CA-Zertifikate hochladen.

6. Erstellen Sie eine neue Zielgruppe und fügen Sie die privaten IP-Adressen Ihrer Transfer Family AS2-Serverendpunkte als Ziele auf Port 5080 hinzu. Einzelheiten zum Erstellen einer neuen Zielgruppe finden Sie unter. Erstellen einer Zielgruppe

7. Konfigurieren Sie Zustandsprüfungen für die Zielgruppe so, dass sie das HTTP-Protokoll auf Port 5080 verwendet.

8. Erstellen Sie eine neue Regel, um den HTTPS-Verkehr vom Listener an die Zielgruppe weiterzuleiten.

9. Konfigurieren Sie den Listener so, dass er Ihr SSL/TLS Zertifikat verwendet.

Nachdem Sie den Load Balancer eingerichtet haben, kommunizieren die Clients mit dem Load Balancer über den benutzerdefinierten Port-Listener. Anschließend kommuniziert der Load Balancer über Port 5080 mit dem Server.

Testen Sie den Zugriff auf den Server von einer Elastic IP-Adresse aus

Stellen Sie über den benutzerdefinierten Port eine Verbindung zum Server her, indem Sie eine Elastic IP-Adresse oder den DNS-Namen des Network Load Balancer verwenden.

Übertragung von Dateien mithilfe eines AS2-Connectors

AS2-Konnektoren stellen eine Beziehung zwischen Handelspartnern für die Übertragung von AS2-Nachrichten von einem Transfer Family-Server an ein externes, partnereigenes Ziel her.

Sie können Transfer Family verwenden, um AS2-Nachrichten zu senden, indem Sie auf die Connector-ID und die Pfade zu den Dateien verweisen, wie im folgenden () -Befehl veranschaulicht: start-file-transfer AWS Command Line Interface AWS CLI

aws transfer start-file-transfer --connector-id c-1234567890abcdef0 \
--send-file-paths "/amzn-s3-demo-source-bucket/myfile1.txt" "/amzn-s3-demo-source-bucket/myfile2.txt"

Führen Sie den folgenden Befehl aus, um die Details für Ihre Konnektoren abzurufen:

aws transfer list-connectors

Der list-connectors Befehl gibt die Connector-IDs, URLs und Amazon-Ressourcennamen (ARNs) für Ihre Connectors zurück.

Um die Eigenschaften eines bestimmten Connectors zurückzugeben, führen Sie den folgenden Befehl mit der ID aus, die Sie verwenden möchten:

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

Der describe-connector Befehl gibt alle Eigenschaften für den Connector zurück, einschließlich seiner URL, Rollen, Profile, Message Disposition Notices (mDNS), Tags und Überwachungsmetriken.

Sie können anhand der JSON- und MDN-Dateien bestätigen, dass der Partner die Dateien erfolgreich erhalten hat. Diese Dateien werden gemäß den unter beschriebenen Konventionen benannt. Dateinamen und Speicherorte Wenn Sie beim Erstellen des Connectors eine Protokollierungsrolle konfiguriert haben, können Sie Ihre CloudWatch Protokolle auch auf den Status von AS2-Nachrichten überprüfen.

Informationen zum AS2-Connector finden Sie unter. Details zum AS2-Connector anzeigen Weitere Informationen zum Erstellen von AS2-Connectoren finden Sie unter. Konfigurieren Sie AS2-Konnektoren

Die AS2-Verarbeitung unterstützt viele der RFC 4130-Protokolle, wobei der Schwerpunkt auf allgemeinen Anwendungsfällen und der Integration in bestehende Serverimplementierungen liegt. AS2-enabled Einzelheiten zu den unterstützten Konfigurationen finden Sie unter. AS2-Konfigurationen

Dateinamen und Speicherorte

In diesem Abschnitt werden die Konventionen zur Benennung von Dateien für AS2-Übertragungen beschrieben.

Beachten Sie bei eingehenden Dateiübertragungen Folgendes:

Bei ausgehenden Übertragungen ist die Benennung ähnlich, mit dem Unterschied, dass es keine eingehende Nachrichtendatei gibt und außerdem die Übertragungs-ID für die übertragene Nachricht zum Dateinamen hinzugefügt wird. Die Übertragungs-ID wird von der StartFileTransfer API-Operation zurückgegeben (oder wenn ein anderer Prozess oder ein Skript diese Operation aufruft).

Sie können auch in den CloudWatch Protokollen die Details Ihrer Übertragungen einsehen, einschließlich aller fehlgeschlagenen Übertragungen.

Statuscodes

In der folgenden Tabelle sind alle Statuscodes aufgeführt, die in den CloudWatch Protokollen protokolliert werden können, wenn Sie oder Ihr Partner eine AS2-Nachricht senden. Verschiedene Schritte der Nachrichtenverarbeitung gelten für verschiedene Nachrichtentypen und dienen ausschließlich der Überwachung. Die Status COMPLETED und FAILED stellen den letzten Verarbeitungsschritt dar und sind in JSON-Dateien sichtbar.

JSON-Beispieldateien

In diesem Abschnitt sind JSON-Beispieldateien für eingehende und ausgehende Übertragungen aufgeführt, einschließlich Beispieldateien für erfolgreiche und fehlgeschlagene Übertragungen.

Beispiel für eine ausgehende Datei, die erfolgreich übertragen wurde:

{
  "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": "/amzn-s3-demo-bucket/as2testcell0000/openAs2/TestOutboundSyncMdn-9lmCr79hV.dat",
  "as2-message-id": "fbe18db8-7361-42ff-8ab6-49ec1e435f34@c9c705f0baaaabaa",
  "timestamp": "2022-07-11T06:30:10.791274Z"
}

Beispiel für eine ausgehende Datei, die nicht erfolgreich übertragen wurde:

{
  "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": "/amzn-s3-demo-bucket-4c1tq6ohjt9y/as2IntegCell0002/openAs2/openAs2TestOutboundWrongAs2Ids-necco-3VYn5n8wE.dat",
  "timestamp": "2022-07-11T21:17:24.802378Z"
}

Beispiel für eine eingehende Datei, die erfolgreich übertragen wurde:

{
  "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"
}

Beispiel für eine eingehende Datei, die nicht erfolgreich übertragen wurde:

{
  "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"
}