HTTP-Header für AS2 Nachrichten anpassen

Wenn Sie AS2 Nachrichten an Handelspartner senden, müssen Sie möglicherweise die HTTP-Header anpassen, um bestimmte Anforderungen zu erfüllen oder die Kompatibilität mit der AS2 Serverkonfiguration Ihres Partners zu verbessern. Diese AWS CloudFormation Vorlage erstellt eine Infrastruktur, um benutzerdefinierte HTTP-Header für AS2 Nachrichten zu ermöglichen, die über gesendet werden. AWS Transfer Family Es richtet ein Amazon API Gateway und eine Lambda-Funktion ein, die als Proxy fungiert und die dynamische Änderung von Headern ermöglicht, die von den Servern der Handelspartner AS2 benötigt werden.

Verwenden Sie diese Vorlage, um Folgendes zu tun:

• Fügen Sie AS2 ausgehenden Nachrichten benutzerdefinierte HTTP-Header hinzu

• Überschreiben Sie die Standard-Header-Werte mit benutzerdefinierten Werten

  Wichtig

  Seien Sie vorsichtig, wenn Sie Standard-Header-Werte überschreiben, da dies zu Sendefehlern führen kann: Einige AS2 Header sind erforderlich.

• Stellen Sie die Kompatibilität mit Handelspartnern sicher, die spezielle Header-Anforderungen haben

Vorlagen – Übersicht

Die Vorlage erstellt die folgenden Hauptkomponenten:

• Eine Lambda-Funktion, die Nachrichten verarbeitet und weiterleitet AS2

• Ein Amazon API Gateway zur Bereitstellung der Lambda-Funktion

• IAM-Rollen und -Berechtigungen für die Lambda-Funktion

• Bedingte Ressourcen für die HTTPS-Unterstützung

Die Vorlagendatei ist hier verfügbar: Vorlage für dynamische HTTP-Header.

So funktioniert’s

1. Das Amazon API Gateway empfängt eingehende AS2 Nachrichten von AWS Transfer Family.

2. Die Anfrage wird an die Lambda-Funktion weitergeleitet.

3. Die Lambda-Funktion verarbeitet die Anfrage und fügt nach Bedarf Header hinzu oder ändert sie.

4. Die geänderte Anfrage wird dann an den Server des Partners AS2 weitergeleitet.

5. Die Antwort vom Server des Partners wird über Lambda und Amazon API Gateway an AWS Transfer Family zurückgesendet.

Wichtigste Funktionen

• Dynamische Änderung der Kopfzeile: Ermöglicht die Anpassung des Betreff-Headers und das Hinzufügen weiterer erforderlicher Header.

• Protokollunterstützung: Funktioniert sowohl mit HTTP- als auch mit HTTPS-Protokollen.

• Flexible Konfiguration: Ermöglicht die Angabe von Partnerhost, Port und Pfad.

Implementierungsinformationen

Die Vorlage implementiert die folgenden Schlüsselkomponenten:

Lambda-Funktion

Der Kern der Lösung ist eine Lambda-Funktion von Node.js, die:

• Empfängt Anfragen vom Amazon API Gateway

• Ändert Header auf der Grundlage der Konfiguration und der eingehenden Anforderungsdaten

• Leitet die geänderte Anfrage an den Server des Partners weiter AS2

• Verarbeitet sowohl HTTP- als auch HTTPS-Protokolle

• Beinhaltet Fehlerbehandlung und Protokollierung

Amazon API Gateway

Eine HTTP-API ist eingerichtet, um:

• Empfangen Sie eingehende AS2 Nachrichten

• Anfragen an die Lambda-Funktion weiterleiten

• Antworten zurück an AWS Transfer Family

Vorlagenparameter

Geben Sie die Informationen für die Vorlagenparameter wie folgt ein. Beachten Sie, dass es sich bei all diesen Parametern um Zeichenketten handelt.

• Environment: Dieser Parameter wird verwendet, um die Ressourcen zu benennen, die die Vorlage erstellt, und zwar unabhängig davon, ob sie für eine Entwicklungs- oder Produktionsumgebung bestimmt sind. Gültige Werte sind dev und prod.

• PartnerHost: Die IP-Adresse oder der Hostname des AS2 Partnerservers.

• PartnerPort: Die Portnummer für den AS2 Partnerserver. Wenn nicht angegeben, wird standardmäßig 80 für HTTP und 443 für HTTPS verwendet.

• PartnerPath: der Pfad zum AS2 Endpunkt auf dem Partnerserver

• ProtocolType: das für die AS2 Kommunikation zu verwendende Protokoll: Gültige Werte sind HTTP und HTTPS.

Bedingte Ressourcen

Für die HTTPS-Unterstützung erstellt die Vorlage unter bestimmten Bedingungen:

• Eine Lambda-Schicht für CA-Zertifikate

• HTTPS-spezifische Konfiguration in der Lambda-Funktion

Bereitstellung und Verwendung

Um AS2 HTTP-Header mithilfe einer CloudFormation Vorlage anzupassen

1. Öffnen Sie die AWS CloudFormation Konsole unter https://console.aws.amazon.com/cloudformation.

2. Wählen Sie im linken Navigationsbereich Stack aus.

3. Wählen Sie Create stack (Stack erstellen) und dann With new resources (standard) (Mit neuen Ressourcen (Standard)).

4. Wählen Sie im Abschnitt Voraussetzung — Vorlage vorbereiten die Option Vorhandene Vorlage auswählen aus.

5. Kopieren Sie diesen Link, die Vorlage für dynamische HTTP-Header, und fügen Sie ihn in das Amazon S3 S3-URL-Feld ein.

6. Wählen Sie Weiter aus.

7. Füllen Sie die Parameterdetails mit Ihren Informationen aus. Diese sind detailliert inVorlagenparameter.

8. Wählen Sie Weiter aus. Wählen Sie auf der Seite „Stack-Optionen konfigurieren“ erneut Weiter aus.

9. Überprüfen Sie die Details für den Stack, den Sie gerade erstellen, und wählen Sie dann Stapel erstellen aus.

   Anmerkung

   Unten auf der Seite müssen Sie unter Funktionen angeben, dass dadurch AWS CloudFormation möglicherweise Ressourcen AWS Identity and Access Management (IAM) erstellt werden.

Nach der Bereitstellung dieses AWS CloudFormation Stacks:

1. Notieren Sie sich die Amazon API Gateway Gateway-Endpunkt-URL, die in den Stack-Ausgaben angegeben ist.

2. Aktualisieren Sie Ihren vorhandenen AWS Transfer Family Connector, um diesen neuen Amazon API Gateway Gateway-Endpunkt zu verwenden.

3. Die Lösung verarbeitet nun AS2 Nachrichten und fügt Header wie konfiguriert hinzu oder ändert sie.

Warnung

Ändern Sie nur den Betreff-Header oder fügen Sie Header hinzu, die Ihr Partner ausdrücklich erwartet. Das Ändern anderer Header kann zu Übertragungsfehlern führen.