Systemintegration über AS2 erstellen

Einführung

Portbase bietet verschiedene Protokolle an, um Nachrichten zwischen Ihrem internen System und dem Port Community System (PCS) auszutauschen. Dieser Artikel erklärt, wie Sie Nachrichten über das AS2-Protokoll senden und abrufen können.

Einen Überblick über die anderen Protokolle finden Sie hier

Bevor Sie beginnen

In diesem Artikel gehen wir davon aus, dass:

• Ihre Organisation bereits eine AS2-Verbindung hat oder dass unsere Kollegen von Integration Services Sie kontaktiert haben, um diese einzurichten. Noch keine Verbindung? Lesen Sie dann zuerst diesen Artikel über das Anfordern einer Systemintegration.
• Sie als technischer Administrator für das Erstellen und Verwalten von Systemintegrationen verantwortlich sind und Zugriff auf die Anwendung Systemintegrationen (EDIFACT/XML) im PCS haben. Noch kein Zugriff? Sehen Sie sich dann diesen Artikel dazu an, wie Sie Zugriff auf die Anwendung erhalten können.

Integrationen verwalten

Das Verwalten Ihrer AS2- und sFTP-Integrationen erfolgt über den PCS-Dienst Systemintegrationen (EDIFACT/XML). Diesen finden Sie im Port Community System (PCS). 

Integration vorbereiten

Im Systemintegrationen-Portal sehen Sie eine Übersicht der bestehenden Integrationen. Dies ist der Ort, um Ihre Integration zu konfigurieren oder Ihren Softwarelieferanten zur Verwaltung zu autorisieren. Über die Option Details (auf der rechten Seite) erhalten Sie weitere Details und Einstellungen zu dieser Integration. 

URL- und Verbindungsdaten von Portbase für die neue Integration

Im ersten Block What do I need to connect to finden Sie die Angaben von Portbase, um die neue Integration in Ihrer AS2-Client-Software einzurichten. Über die Optionen Encryption certificate und Signing certificate können Sie die Zertifikate von Portbase herunterladen. Portbase unterstützt nur synchronous MDN.

AS2-Profil hinzufügen

Im zweiten Block fügen Sie ein oder mehrere AS2-Profile hinzu. Ein AS2-Profil enthält die Verbindungsdaten des AS2-Servers Ihrer Organisation. Pro Verbindung kann maximal 1 Profil aktiv sein.

1. Wählen Sie Add AS2 profile, um der Integration ein Profil hinzuzufügen.

   

2. Geben Sie im Profil die Daten ein, um sich mit Ihrer Organisation zu verbinden.
3. Wählen Sie Add AS2 profile, um alle Einstellungen zu speichern.

4. Das hinzugefügte AS2-Profil ist jetzt in den Details der Integration sichtbar, aber noch nicht aktiviert.

   

5. Wählen Sie im Profil das 3-Punkte-Menü aus, um die Optionen für das Profil zu sehen. Wählen Sie hier Activate for outbound, um das Profil zu aktivieren. Ob ein Profil aktiv ist, sehen Sie im Feld Outbound active. Wenn die Verbindung aktiv ist, steht dort true und wenn sie inaktiv ist, false.

   

Wir unterstützen mehrere Profile für eine Integration, aber pro Verbindung kann eines aktiv sein. Beim Löschen eines aktiven Profils wird nicht automatisch ein anderes Profil aktiv gemacht.

Zertifikat hinzufügen

In diesem Bildschirm fügen Sie die Zertifikate für das Signieren und Verschlüsseln der AS2-Nachrichten hinzu. Es ist nicht verpflichtend, hierfür unterschiedliche Zertifikate zu verwenden. Wir unterstützen das Importieren von Zertifikaten im .pem-Format, und Sie können sowohl ein einzelnes Zertifikat als auch eine Zertifikatskette verwenden.

Wählen Sie Add certificate, um den Zertifikat-Dialog zu öffnen.

Im Dialog Add certificate wählen Sie den Zweck des Zertifikats aus und wählen Sie aus, welches Zertifikat Sie für diesen Zweck verwenden möchten. Pro Zweck müssen Sie die Auswahl eines Zertifikats über die Schaltfläche Add certificate bestätigen. Sie können nicht beide Zwecke (Verschlüsseln und Signieren) direkt in diesem Dialog konfigurieren. 

Sie können sowohl ein self-signed Zertifikat als auch ein Zertifikat einer Zertifizierungsstelle (CA) bereitstellen:

• Self-signed Zertifikat: Laden Sie nur das Zertifikat hoch. Es ist keine Kette erforderlich, da ein self-signed Zertifikat sein eigener Aussteller ist.
• CA-Zertifikat: Laden Sie das vollständige Zertifikat einschließlich der vollständigen Kette in einer .pem-Datei hoch. Ordnen Sie die Zertifikate in der richtigen Reihenfolge an: zuerst das eigene (Leaf-)Zertifikat, danach die Zwischenzertifikate und zuletzt das Root-Zertifikat. Bei einem CA-Zertifikat ist die vollständige Kette verpflichtend, andernfalls kann die Vertrauensbeziehung nicht hergestellt werden und das Zertifikat wird abgelehnt. 

Sie können also ein self-signed Zertifikat und ein CA-Zertifikat mit vollständiger Kette über dasselbe Feld zum Hochladen von Zertifikaten bereitstellen.

Testen der Integration

Die Integration ist jetzt eingerichtet und bereit zum Testen. Prüfen Sie, ob Sie von Ihrem AS2-Client aus über die neue Integration eine Verbindung zum Portbase-AS2-Server herstellen können, und kontaktieren Sie Portbase, um die Verbindung von Portbase zu Ihrem AS2-Server zu prüfen.

Wenn Sie Fragen zu Ihrer AS2-Systemintegration mit Portbase haben, kontaktieren Sie uns bitte über integration@portbase.com