Zum Inhalt springen

AS2-Kommunikation in Jitterbit EDI

Einführung

AS2 (Applicability Statement 2) ist ein Protokoll zum sicheren und zuverlässigen Datenaustausch über das Internet und eine beliebte Methode für Unternehmen, EDI-Dokumente mit ihren Handelspartnern auszutauschen.

Wenn Ihr Partner einen AS2-Endpunkt anbietet, können Sie diesen zum Senden und Empfangen von Dokumenten nutzen, indem Sie eine AS2-Kommunikationseinstellung konfigurieren und diese dem Partner zuweisen. Diese Seite zeigt Ihnen, wie Sie dies tun.

AS2-Verbindung erstellen

Wichtig

Um AS2-Kommunikation zu aktivieren, muss Ihr Partner seine Firewall konfigurieren (die IP-Adresse zur Allowlist hinzufügen): 40.71.22.62 (für Harmony-Konten in Nordamerika) oder 20.166.31.85 (für EMEA und APAC) für ein- und ausgehende Kommunikation.

Führen Sie diese Schritte aus, um eine AS2-Verbindung zu erstellen:

  1. Klicken Sie auf Neu > AS2-Verbindung. Das Panel Neue AS2-Verbindung erstellen wird angezeigt:

    Neue AS2-Verbindung erstellen

  2. Stellen Sie die folgenden Umschalter ein:

    • Duplikat-Transaktionsprüfung: Aktivieren Sie diese Option, um auf doppelte Transaktionen zu prüfen, die über diese Verbindung übertragen werden.

      Hinweis

      Dies gilt nur für EDI und nicht für EDIXml- oder XCBL-Dokumente.

    • Aktiv: Aktivieren Sie diese Option, um die Verbindung zur Verwendung verfügbar zu machen.

  3. Legen Sie in der Gruppe der Grundeinstellungen Werte für die folgenden Felder fest:

    • Name: Der Name der Verbindung.

    • Sende-URL: Die vom Handelspartner bereitgestellte URL zum Senden von Dokumenten über die AS2-Verbindung. Sie muss als Teil der AS2-Konfiguration enthalten sein.

      Empfangs-URLs mit IP-Adressen für Firewall-Allowlists

      Stellen Sie sicher, dass die IP-Adresse, die der Region Ihres Harmony-Kontos entspricht, in der Firewall-Allowlist Ihres Handelspartners für ein- und ausgehende Kommunikation enthalten ist:

      Region Empfangs-URL IP-Adresse
      Nordamerika https://na.as2.jitterbitedi.com/CompanyAS2/PartnerAS2/Receiver.aspx 40.71.22.62
      EMEA https://emea.as2.jitterbitedi.com/CompanyAS2/PartnerAS2/Receiver.aspx 20.166.31.85
      APAC https://emea.as2.jitterbitedi.com/CompanyAS2/PartnerAS2/Receiver.aspx (APAC verwendet die EMEA-URL.) 20.166.31.85

    • Empfangs-URL: Die partnerspezifische Empfangs-URL für diese Verbindung, die aus der Region Ihres Kontos und den konfigurierten Werten AS2-Unternehmens-ID und AS2-Partner-ID generiert wird. Dieses Feld ist schreibgeschützt und wird dynamisch aktualisiert, wenn Sie Werte in den Feldern AS2-Unternehmens-ID und AS2-Partner-ID eingeben. Klicken Sie auf das Symbol Empfangs-URL kopieren, um die URL zu kopieren und mit Ihrem Handelspartner zu teilen.

    • Verbindungs-Timeout: Das anfängliche Verbindungs-Timeout. Maximal 3 Zeichen.

    • AS2-Unternehmens-ID: Der AS2-Unternehmensidentifikator.

    • AS2-Partner-ID: Der AS2-Partneridentifikator.

  4. (Optional) Erweitern Sie die Registerkarte Proxy-Einstellungen, und legen Sie dann Werte für die folgenden Felder fest:

    Grundeinstellungen

    • Proxy: Aktivieren Sie den Proxy-Server.

    • Adresse: Die Adresse des Proxy-Servers.

    • Domäne: Die Domäne des Proxy-Servers.

    • Benutzername: Der Benutzername des Proxy-Servers.

    • Passwort: Das Passwort des Proxy-Servers.

  5. (Optional) Erweitern Sie die Registerkarte HTTP-Einstellungen, und legen Sie dann Werte für die folgenden Felder fest:

    HTTP-Einstellungen

    • Authentifizierung: Aktivieren Sie die HTTP-Authentifizierung.

    • Authentifizierungstyp: Der HTTP-Authentifizierungstyp. Wählen Sie einen der folgenden Optionen:

  6. Basic: Nicht verschlüsselte Base64-codierte Anmeldedaten verwenden (RFC 2617).

    -   **Digest:** Verschlüsselte Base64-codierte Anmeldedaten verwenden ([RFC 2617]).

    • Authentication user: Der Benutzername für die HTTP-Authentifizierung.

    • Authentication password: Das Passwort für die HTTP-Authentifizierung.

    • Subject: Der Betreff, der den Zweck des Endpunkts beschreibt.

  7. (Optional) Erweitern Sie die Registerkarte Encryption settings, und legen Sie Werte für die folgenden Felder fest:

    Encryption settings

    • Signature algorithm: Der Algorithmus zum Signieren von Nachrichten. Wählen Sie einen der folgenden aus:

      • MD5
      • SHA1
      • SHA-224
      • SHA-256 (Standard)
      • SHA-384
      • SHA-512
      • SHA-512/224
      • SHA-512/256

    • Encryption algorithm: Der Algorithmus zum Verschlüsseln von Nachrichten. Wählen Sie einen der folgenden aus:

      • 3DES (Standard)
      • AES-128
      • AES-192
      • AES-256
      • RC2

    • Sign: Aktivieren, um unsignierte eingehende Nachrichten abzulehnen.

    • Encrypt: Aktivieren, um unverschlüsselte eingehende Nachrichten abzulehnen.

    • Request MDN: Eine MDN (Message Disposition Notification) anfordern.

    • Request MDN signed: Eine signierte MDN anfordern.

    • Compress: Aktivieren, um ZLIB-Komprimierung zu verwenden.

  8. (Optional) Erweitern Sie die Registerkarte Certificate:

    Certificate

    Die Registerkarte hat zwei Bereiche:

    • My certificates: Zertifikate für Ihre Organisation. Dies sind private Zertifikate, die im Format pfx vorliegen müssen und nur private Schlüssel enthalten.

    • Partner certificates: Zertifikate für den Handelspartner. Dies sind öffentliche Zertifikate, die im Format .cer vorliegen müssen und nur öffentliche Schlüssel enthalten.

    Hochgeladene oder erstellte Zertifikate werden als Zeile angezeigt und zeigen den Namen, das Ablaufdatum und die folgenden Symbole:

    • Assign: Das Zertifikat der Verbindung zuweisen.

    • Download: Das Zertifikat als .cer-Datei herunterladen.

    • Delete: Das Zertifikat löschen. Um die Aktion zu bestätigen, geben Sie das Wort DELETE in das Textfeld des Dialogs ein, und klicken Sie dann auf die Schaltfläche Delete.

    Gehen Sie wie folgt vor, um ein Zertifikat hochzuladen:

    1. Klicken Sie auf das Symbol Upload für eine der Parteien.

    2. Geben Sie im geöffneten Bereich Werte für Certificate name und Password ein:

      Certificate upload

    3. Klicken Sie auf die Schaltfläche Upload file, und wählen Sie die Zertifikatdatei aus. (Akzeptierte Dateitypen sind .cer und .pfx.)

    4. Klicken Sie im Bereich Upload certificate auf die Schaltfläche Save.

    Gehen Sie wie folgt vor, um ein Zertifikat für Ihre Organisation zu erstellen:

    1. Klicken Sie auf das Symbol Create.

    2. Geben Sie im geöffneten Bereich Werte für Certificate name und Validity years ein:

      Certificate create

    3. Klicken Sie im Bereich Create a new certificate auf die Schaltfläche Save.

  9. (Optional) Klicken Sie im Bereich Create a new AS2 connection auf die Schaltfläche Test connection, um die AS2-Konnektivität eines Partners, das Vorhandensein von Zertifikaten und eine erfolgreiche Nachrichtenübertragung mit MDN-Bestätigung zu bestätigen.

  10. Klicken Sie im Bereich Create a new AS2 connection auf die Schaltfläche Save. Die neue Verbindung ist nun bereit, damit Sie sie einem Partner zuweisen können.

Certificate expiration notifications

Wenn ein Dokument über eine AS2-Verbindung gesendet oder empfangen wird, werden die Ablaufdaten der verwendeten Zertifikate überprüft. Wenn sich ein Zertifikat innerhalb von 30 Tagen dem Ablauf nähert oder bereits abgelaufen ist, geschieht Folgendes:

  • Eine Fehlermeldung wird einmal pro Tag für jedes ablaufende oder abgelaufene Zertifikat protokolliert. Sie ist auf der Seite Messaging sichtbar und lautet wie folgt, wobei [TP Name] der Name des Handelspartners und [Expiry Date] das Ablaufdatum des Zertifikats ist:

    AS2-Zertifikat für [TP Name] läuft am [Expiry Date] ab. Um sicherzustellen, dass die Kommunikation nicht unterbrochen wird, aktualisieren Sie das Zertifikat.

  • Eine Banner-Benachrichtigung wird auf jeder EDI-Seite angezeigt, bis Sie sie schließen. Sie wird beim nächsten Anmelden erneut angezeigt, solange ein Zertifikat noch abläuft oder abgelaufen ist.

Um eine Unterbrechung der Kommunikation mit Ihrem Handelspartner zu vermeiden, laden Sie ein Ersatzzertifikat hoch oder erstellen Sie eines, bevor das Ablaufdatum erreicht ist (siehe die Registerkarte „Zertifikat" oben, wo jede Zertifikatreihe das Ablaufdatum anzeigt).

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im EDI-Fehlerbehebungsleitfaden: