AS2Service

Der AS2Service integriert das Lobster AS2-System in den Lobster Integration Server.

XML-Konfiguration


Wichtiger Hinweis: Die Verfügbarkeit eines Services hängt von der erworbenen Lizenz ab und davon, ob der Service innerhalb der Konfigurationsdatei ./etc/factory.xml der Service-Factory eingetragen wurde (Änderungen erfordern Server-Neustart!). Dort finden Sie auch die zuständige Konfigurationsdatei für einen Service, ansonsten können Sie die Konfigurationsdatei des Services auch direkt in der GUI des Services bearbeiten (Änderungen erfordern Service-Neustart!).

Setzen des zu verwendenden Servlet-Kontexts für das Beantworten von AS2-Anfragen


Für die Beantwortung von AS2-Anfragen per HTTP wird beim AS2Service ein Servlet verwendet. Welcher HTTP-Server unter welchem Kontext das Servlet bereitstellen soll, wird mit folgendem XML-Fragment eingestellt.


<Call name="setContext">
<Arg>Main Server</Arg>
<Arg>/partner/*</Arg>
<Arg>/AS2Retrieve/*</Arg>
</Call>


Hierbei haben die drei Parameter folgende Bedeutung.


servername

Der beim HTTP-Server als Wert festgelegter Name, hier z. B. Main Server.

contextname

Der zu verwendende Kontext. Damit gemeint ist das Äquivalent zum Pfad zu einer durch eine URL repräsentierte Ressource. Eine Eigenheit, die sich von einem regulären Pfad unterscheidet, ist die Verwendung von Wildcards für das Festlegen, wo weitere Werte hinzukommen können. Ein Wert für den Kontext ist z. B. /partner/*.

pathspec

Der zu verwendende Pathspec. Damit gemeint ist das Äquivalent zum Dateinamen einer durch eine URL repräsentierte Ressource. Eine Eigenart, die sich von einem normalen Dateinamen unterscheidet, ist die Verwendung von Wildcards für das Festlegen, ob z. B. ein Pathinfo erlaubt ist oder nicht. Ein Wert für den Pathspec ist z. B. /AS2Retrieve/*.

Setzen eines AS2-PartnerManagers


Mit dem Setzen des AS2-PartnerManagers wird festgelegt, auf welche Weise die Partnerrelationen für AS2-Anfragen ermittelt werden sollen.

Mit folgendem XML-Fragment wird der AS2-PartnerManagers für den entsprechenden AS2Service festgelegt.


<Call name="setPartnerManager">
<Arg>
<New class="com.ebd.hub.services.as2.manager.commlog.PartnerManager">
</New>
</Arg>
</Call>

Allgemeine Einstellungen


images/download/attachments/189461482/Services_2-version-1-modificationdate-1737965062776-api-v2.png


(1) und (2) Der Name des HTTP-Servers, der zugehörige Kontext und Pfad für das Servlet, dass die AS2-Anfragen entgegennimmt.

(3) Der verwendete Partnermanager.

Einstellungen für den Partnermanager


images/download/attachments/189461482/Services_3-version-1-modificationdate-1737965062772-api-v2.png


(1) Name des kryptographischen Providers (hier BouncyCastle).

(2) LogService und LogManager für die Ausgabe von Log-Meldungen.

(3) Message Context und Message Queue. AS2-Events werden als Messages an diese Queue gesendet.

(4) Verwendeter AuthenticationService und CommunicationLogService.


Achtung: Für das Funktionieren des AS2Services ist starke Verschlüsselung notwendig. Standardinstallationen von Virtual Machines können unter Umständen hinsichtlich der Schlüsselgröße eingeschränkt sein, um Exportrestriktionen z. B. der USA zu entsprechen. Um in der Lage zu sein, Schlüsselgrößen zu verwenden, die von diesem Service benötigt werden, ist es daher eventuell notwendig, die Virtual Machine für starke Verschlüsselung freizuschalten. Für nähere Informationen ist hierbei die Dokumentation der Virtual Machine zurate zu ziehen.

Loglevel-Abhängigkeiten


Änderungen des Loglevels beim LogService haben keinen Einfluss auf das Logverhalten des AS2Services. Im Verbose-Mode werden die empfangenen Daten Base64-kodiert dem AS2-LogManager übergeben.