Austauschen von AS2-Nachrichten mithilfe von Workflows in Azure Logic Apps

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Wenn Sie AS2-Nachrichten in Workflows, die Sie mit Azure Logic Apps erstellen, senden und empfangen möchten, können Sie den AS2 (v2)-Connector verwenden. Dieser stellt Aktionen bereit, die die AS2-Kommunikation unterstützen und verwalten. Wenn Sie Nachverfolgungsfunktionen benötigen, ist der ursprüngliche AS2-Connector weiterhin verfügbar, ist aber veraltet.

Mit Ausnahme der Nachverfolgungsfunktionen bietet der AS2 (v2)-Connector die gleichen Funktionen wie der ursprüngliche AS2-Connector, wird nativ mit der Azure Logic Apps-Runtime und bietet erhebliche Leistungsverbesserungen in Bezug auf Nachrichtengröße, Durchsatz und Wartezeit. Im Gegensatz zum ursprünglichen AS2-Connector erfordert der AS2 (v2)-Connector keine Verbindung mit Ihrem Integrationskonto. Stellen Sie stattdessen sicher, dass Sie, wie in den Voraussetzungen beschrieben, Ihr Integrationskonto mit der Logik-App-Ressource verbinden, in der Sie den Connector verwenden möchten.

In diesem Artikel wird gezeigt, wie Sie einem bestehenden Logik-App-Workflow die AS2-Aktionen für die Codierung und Decodierung hinzufügen. Der AS2 (v2)-Connector enthält keine Trigger, sodass Sie einen beliebigen Trigger verwenden können, um Ihren Workflow zu starten. In den Beispielen dieses Artikels wird der Anforderungstrigger verwendet.

Technische Referenz für den Connector

Der AS2-Connector hat verschiedene Versionen, die auf dem Typ der logischen Anwendung und der Hostumgebung basieren.

Logik-App Environment Connector-Version
Verbrauch Azure Logic Apps mit mehreren Mandanten Verwaltete AS2 (v2)- und AS2-Connectors (Standardklasse). Der AS2 (v2)-Connector bietet nur Aktionen, aber Sie können jeden Trigger verwenden, der für Ihr Szenario funktioniert. Weitere Informationen finden Sie in der folgenden Dokumentation:

- Referenz zum verwalteten AS2-Connector
- Verwaltete AS2 (v2)-Connectorvorgänge
- B2B-Protokollgrenzwerte für Nachrichtengrößen
- Verwaltete Connectors in Azure Logic Apps
Verbrauch Integrationsdienstumgebung (Integration Service Environment, ISE) Verwaltete AS2 (v2)- und AS2-Connectors (Standardklasse) und AS2-ISE-Version, die andere Nachrichtengrenzwerte als die Standardklasse aufweist. Der AS2 (v2)-Connector bietet nur Aktionen, aber Sie können jeden Trigger verwenden, der für Ihr Szenario funktioniert. Weitere Informationen finden Sie in der folgenden Dokumentation:

- Referenz zum verwalteten AS2-Connector
- Verwaltete AS2 (v2)-Connectorvorgänge
- ISE-Nachrichtenlimits
- Verwaltete Connectors in Azure Logic Apps
Standard Einzelmandanten-Azure Logic Apps und App Service-Umgebung v3 (nur Windows-Pläne) Integrierter AS2 (v2)-Connector und verwalteter AS2-Connector. Die integrierte Version unterscheidet sich wie folgt:

– Die intergrierte Version bietet nur Aktionen, aber Sie können jeden Trigger verwenden, der für Ihr Szenario funktioniert.

- Die integrierte Version kann direkt auf virtuelle Azure-Netzwerke zugreifen. Sie benötigen kein lokales Datengateway.

Weitere Informationen finden Sie in der folgenden Dokumentation:

- Referenz zum verwalteten AS2-Connector
- Vorgänge für den integrierten AS2 (v2)-Connector
- Integrierte Connectors in Azure Logic Apps

AS2 (v2)-Vorgänge

Der AS2 (v2)-Connector verfügt über keine Trigger. In der folgenden Tabelle werden die Aktionen beschrieben, die der AS2 (v2)-Connector für das Einrichten der Sicherheit und Zuverlässigkeit beim Übertragen von Nachrichten bereitstellt:

Aktion BESCHREIBUNG
AS2-Codierung-Aktion Stellt Verschlüsselung, eine digitale Signatur und Bestätigungen durch Benachrichtigungen über den Nachrichtenstatus (Message Disposition Notifications, MDNs) bereit, die beim Unterstützen der Nichtabstreitbarkeit helfen. Diese Aktion wendet z. B. AS2/HTTP-Header an und führt die folgenden Aufgaben aus, wenn sie konfiguriert ist:

– Signieren ausgehender Nachrichten.
– Verschlüsseln ausgehender Nachrichten.
– Komprimieren der Nachricht.
– Übertragen des Dateinamens im MIME-Header.
AS2-Decodierung-Aktion Stellt Entschlüsselung, eine digitale Signatur und Bestätigungen durch Benachrichtigungen über den Nachrichtenstatus (Message Disposition Notifications, MDNs) bereit. Diese Aktion führt z. B. die folgenden Aufgaben aus, wenn sie konfiguriert ist:

– Verarbeiten von AS2/HTTP-Headern.
– Abstimmen empfangener MDNs mit den ursprünglichen ausgehenden Nachrichten.
– Aktualisieren und Korrelieren von Datensätzen in der Nichtabstreitbarkeits-Datenbank.
– Schreiben von Datensätzen für AS2-Statusberichte.
– Ausgeben von base64-codierten Nutzlastinhalten.
– Ermitteln, ob MDNs erforderlich sind. Auf Grundlage der AS2-Vereinbarung wird bestimmt, ob MDNs synchron oder asynchron sein sollen.
– Generieren einer synchronen oder asynchronen MDN auf Grundlage der AS2-Vereinbarung.
– Festlegen der Korrelationstoken und Eigenschaften für MDNs.
– Überprüfen der Signatur.
– Entschlüsseln der Nachrichten.
– Dekomprimieren der Nachrichten.
– Suchen nach und Unterbinden von doppelten Nachrichten-IDs.

Voraussetzungen

  • Ein Azure-Konto und ein Azure-Abonnement. Sollten Sie noch kein Abonnement besitzen, können Sie sich für ein kostenloses Azure-Konto registrieren.

  • Die Logik-App-Ressource und der Workflow, in der bzw. dem Sie die AS2-Vorgänge verwenden möchten.

  • Eine Integrationskontoressource, um Artefakte für die Verwendung in Unternehmensintegrations- und B2B-Workflows zu definieren und zu speichern.

    Wichtig

    Für die Zusammenarbeit müssen sowohl Ihre Integrationskonto- als auch Ihre Logik-App-Ressource in demselben Azure-Abonnement und in derselben Azure-Region vorhanden sein.

  • Mindestens zwei Parteien (Handelspartner) in Ihrem Integrationskonto. Die Definitionen für beide Partner müssen denselben Qualifizierer für die Geschäftsidentität verwenden, der für dieses Szenario AS2Identity lautet.

  • Eine AS2-Vereinbarung in Ihrem Integrationskonto zwischen den Parteien, die an Ihrem Workflow teilnehmen. Jede Vereinbarung erfordert sowohl einen Host- als auch einen Gastpartner. Der Inhalt der Nachrichten zwischen Ihnen und dem*der Partner*in muss mit dem Vereinbarungstyp übereinstimmen.

  • Basierend darauf, ob Sie an einem Verbrauchs- oder Standard-Logik-App-Workflow arbeiten, erfordert Ihre Logik-App-Ressource möglicherweise einen Link zu Ihrem Integrationskonto:

    Logik-App-Workflow Link erforderlich?
    Nutzung - AS2(v2) Connector: Verbindung erforderlich, aber kein Link erforderlich.
    - AS2-Connector: Link erforderlich, aber keine Verbindung erforderlich.
    Standard - AS2 (v2)-Connector: Link erforderlich, aber keine Verbindung erforderlich.
    - AS2-Connector: Verbindung erforderlich, aber kein Link erforderlich.
  • Wenn Sie Azure Key Vault für die Zertifikatsverwaltung verwenden, überprüfen Sie, ob Ihre Tresorschlüssel die Vorgänge Verschlüsseln und Entschlüsseln zulassen. Andernfalls treten beim Codieren und Decodieren Fehler auf.

    1. Öffnen Sie im Azure-Portal Ihren Schlüsseltresor. Wählen Sie im Schlüsseltresormenü unter Einstellungen die Option Schlüssel aus.

    2. Wählen Sie im Bereich Schlüssel Ihren Schlüssel aus. Wählen Sie im Bereich Versionen die verwendete Schlüsselversion aus.

    3. Vergewissern Sie sich im Bereich Schlüsselversion unter Zulässige Vorgänge, dass die Vorgänge Verschlüsseln und Entschlüsseln ausgewählt sind, z. B.:

      Screenshot des Azure-Portals mit geöffneten Bereichen „Schlüsseltresor“, „Schlüssel“ und „Schlüsselversion“ und den ausgewählten Vorgängen „Verschlüsseln“ und „Entschlüsseln“

Codieren von AS2-Nachrichten

Wählen Sie die Registerkarte für Logik-App-Workflows vom Typ „Verbrauch“ oder „Standard“ aus:

AS2 v2-Connector

  1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource und den Workflow im Designer.

  2. Wählen Sie im Designer unter dem Trigger oder der Aktion, dem bzw. der Sie die AS2 (v2)-Aktion hinzufügen möchten, die Option Neuer Schritt aus.

  3. Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Standard aus. Geben Sie in das Suchfeld as2 ein.

  4. Wählen Sie in der Aktionenliste die Aktion namens AS2-Codierung aus.

    Screenshot des Designers im Azure-Portal für einen „Verbrauchs“-Workflow mit ausgewählter Aktion „AS2-Codierung“.

  5. Geben Sie im Aktionsinformationsfeld die folgenden Informationen an.

    Eigenschaft Erforderlich BESCHREIBUNG
    Zu codierende Nachricht Ja Die Nachrichtennutzdaten, beispielsweise die Textteilausgabe des Anforderungstriggers.

    1. Setzen Sie den Cursor in das Feld Zu codierende Nachricht, damit die Liste mit den dynamischen Inhalten geöffnet wird.
    2. Wählen Sie neben dem Abschnittsnamen Beim Empfang einer HTTP-Anforderung die Option Weitere anzeigen aus.
    3. Wählen Sie in der Ausgabeliste Text aus.
    AS2-Absender Ja Der Geschäftsbezeichner für den Absender der Nachricht, wie in Ihrer AS2-Vereinbarung angegeben, z. B. Fabrikam.
    AS2-Empfänger Ja Der Geschäftsbezeichner für den Empfänger der Nachricht, wie in Ihrer AS2-Vereinbarung angegeben, z. B. Contoso.

    Screenshot der Aktion „AS2-Codierung“ mit den Nachrichtencodierungseigenschaften

AS2-Connector

  1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource und den Workflow im Designer.

  2. Wählen Sie im Designer unter dem Trigger oder der Aktion, dem bzw. der Sie die AS2-Aktion hinzufügen möchten, die Option Neuer Schritt aus.

  3. Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Standard aus. Geben Sie in das Suchfeld as2 codieren ein.

  4. Wählen Sie in der Aktionenliste die Aktion namens In AS2-Nachricht codieren aus.

    Screenshot des Designers im Azure-Portal für einen „Verbrauchs“-Workflow mit ausgewählter Aktion „In AS2-Nachricht codieren“.

  5. Wenn Sie aufgefordert werden, eine Verbindung mit Ihrem Integrationskonto herzustellen, geben Sie die folgenden Informationen an:

    Eigenschaft Erforderlich BESCHREIBUNG
    Verbindungsname Ja Ein Name für die Verbindung
    Integrationskonto Ja Wählen Sie in der Liste der verfügbaren Integrationskonten das Konto aus, das Sie nutzen möchten.

    Beispiel:

    Screenshot eines Verbrauchsworkflows mit Verbindungsinformationen für „In AS2-Nachricht codieren“.

  6. Wählen Sie Erstellen, wenn Sie fertig sind.

  7. Geben Sie im Aktionsinformationsfeld die folgenden Informationen an.

    Eigenschaft Erforderlich BESCHREIBUNG
    AS2-From Ja Der Geschäftsbezeichner für den Absender der Nachricht, wie in Ihrer AS2-Vereinbarung angegeben, z. B. Fabrikam.
    AS2-To Ja Der Geschäftsbezeichner für den Empfänger der Nachricht, wie in Ihrer AS2-Vereinbarung angegeben, z. B. Contoso.
    body Ja Die zu codierenden Nachrichtennutzdaten, beispielsweise die Textteilausgabe des Anforderungstriggers.

    1. Setzen Sie Ihren Cursor in das Feld Text, damit die Liste mit den dynamischen Inhalten geöffnet wird.
    2. Wählen Sie neben dem Abschnittsnamen Beim Empfang einer HTTP-Anforderung die Option Weitere anzeigen aus.
    3. Wählen Sie in der Ausgabeliste Text aus.

    Screenshot der Aktion „In AS2-Nachricht codieren“ mit den Nachrichtencodierungseigenschaften.

Decodieren von AS2-Nachrichten

Wählen Sie die Registerkarte für Logik-App-Workflows vom Typ „Verbrauch“ oder „Standard“ aus:

AS2 v2-Connector

  1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource und den Workflow im Designer.

  2. Wählen Sie im Designer unter dem Trigger oder der Aktion, dem bzw. der Sie die AS2 (v2)-Aktion hinzufügen möchten, die Option Neuer Schritt aus.

  3. Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Standard aus. Geben Sie in das Suchfeld as2 ein.

  4. Wählen Sie in der Aktionenliste die Aktion namens AS2-Decodierung aus.

    Screenshot des Designers im Azure-Portal für einen „Verbrauchs“-Workflow mit ausgewählter Aktion „AS2-Decodierung“.

  5. Geben Sie im Aktionsinformationsfeld die folgenden Informationen an:

    Eigenschaft Erforderlich BESCHREIBUNG
    body Ja Der Text für die zu decodierende Nachricht, beispielsweise die Textteilausgabe des Anforderungstriggers.

    1. Setzen Sie Ihren Cursor in das Feld Text, damit die Liste mit den dynamischen Inhalten geöffnet wird.
    2. Wählen Sie neben dem Abschnittsnamen Beim Empfang einer HTTP-Anforderung die Option Weitere anzeigen aus.
    3. Wählen Sie in der Ausgabeliste Text aus.
    Headers Ja Die Header für die zu decodierende Nachricht, beispielsweise die Headerausgabe des Anforderungstriggers.

    1. Setzen Sie Ihren Cursor in das Feld Header, damit die Liste mit den dynamischen Inhalten geöffnet wird.
    2. Wählen Sie neben dem Abschnittsnamen Beim Empfang einer HTTP-Anforderung die Option Weitere anzeigen aus.
    3. Wählen Sie in der Ausgabeliste Header aus.

    Beispiel:

    Screenshot der Aktion „AS2-Decodierung“ mit eingegebenen Ausgaben „Text“ und „Header“ des Anforderungstriggers.

AS2-Connector

  1. Öffnen Sie im Azure-Portal Ihre Logik-App-Ressource und den Workflow im Designer.

  2. Wählen Sie im Designer unter dem Trigger oder der Aktion, dem bzw. der Sie die AS2-Aktion hinzufügen möchten, die Option Neuer Schritt aus.

  3. Wählen Sie unter dem Suchfeld Vorgang auswählen die Option Standard aus. Geben Sie in das Suchfeld as2 decodieren ein.

  4. Wählen Sie in der Aktionenliste die Aktion namens AS2-Nachricht decodieren aus.

    Screenshot des Designers im Azure-Portal für einen „Verbrauchs“-Workflow mit ausgewählter Aktion „AS2-Nachricht decodieren“.

  5. Wenn Sie aufgefordert werden, eine Verbindung mit Ihrem Integrationskonto herzustellen, geben Sie die folgenden Informationen an:

    Eigenschaft Erforderlich BESCHREIBUNG
    Verbindungsname Ja Ein Name für die Verbindung
    Integrationskonto Ja Wählen Sie in der Liste der verfügbaren Integrationskonten das Konto aus, das Sie nutzen möchten.

    Beispiel:

    Screenshot eines Verbrauchsworkflows mit Verbindungsinformationen für „AS2-Nachricht decodieren“.

  6. Wählen Sie Erstellen, wenn Sie fertig sind.

  7. Geben Sie im Aktionsinformationsfeld die folgenden Informationen an.

    Eigenschaft Erforderlich BESCHREIBUNG
    body Ja Die Nachrichtennutzdaten, beispielsweise die Textteilausgabe des Anforderungstriggers.

    1. Setzen Sie Ihren Cursor in das Feld Text, damit die Liste mit den dynamischen Inhalten geöffnet wird.
    2. Wählen Sie neben dem Abschnittsnamen Beim Empfang einer HTTP-Anforderung die Option Weitere anzeigen aus.
    3. Wählen Sie in der Ausgabeliste Text aus.
    Headers Ja Die Header für die zu decodierende Nachricht, beispielsweise die Headerausgabe des Anforderungstriggers.

    1. Setzen Sie Ihren Cursor in das Feld Header, damit die Liste mit den dynamischen Inhalten geöffnet wird.
    2. Wählen Sie neben dem Abschnittsnamen Beim Empfang einer HTTP-Anforderung die Option Weitere anzeigen aus.
    3. Wählen Sie in der Ausgabeliste Header aus.

    Screenshot der Aktion „AS2-Nachricht decodieren“ mit den Nachrichtendecodierungseigenschaften.

Beispiel

Wenn Sie eine uneingeschränkt funktionsfähige Logik-App und ein AS2 (v2)-Beispielszenario bereitstellen möchten, sehen Sie sich die Vorlage und das Szenario unter Azure Logic Apps - AS2 Send Receive (Azure Logic Apps – AS2: Senden/Empfangen) an.

Behandeln von Problemen

  • Probleme beim Senden signierter oder verschlüsselter Nachrichten

    Erwägen Sie, andere SHA256-Algorithmusformate auszuprobieren. Die AS2-Spezifikation stellt keine Informationen zu SHA256-Formaten bereit, sodass jeder Anbieter seine eigene Implementierung bzw. sein eigenes Format verwendet.

Nächste Schritte