Einrichtung B2BbP barzahlen.de

Einrichtung der B2BbP als EAI für die Kommunikation zwischen SAP und barzahlen.de

Einführung

In der Kommunikation zwischen SAP und Barzahlen.de muss vor allem die technische Hürde der heterogenen Webservice Technologien überwunden werden. Barzahlen.de bietet eine REST-WS Schnittstelle an und das SAP kommuniziert bevorzugt über SOAP-WS. Die B2BbP hängt sich als EAI dazwischen und bietet zur SAP die SOAP-Schnittstellen und in Richtung barzahlen.de REST-Schnittstellen an. Die Dokumentation beschreibt die ToDo‘s für die Konfiguration der B2BbP, damit die Kommunikation zwischen SAP und Barzahlen.de gewährleistet wird.

Bedingungen

Die Dokumentation ist nur im Zusammenhang mit dem entsprechenden b3p_barzahlen_customizing.zip von Next Level Integration gültig. Nach aktueller Planung muss die B2BbP Engine ab Version 1911.1.x eingespielt werden.

Vorarbeiten

Java Keystore (https Ausgehend)

Für die Kommunikation zu Barzahlen.de, wird eine https Kommunikation verwendet. Es sollte zur Validierung der Zertifikate, diese in einem Javakeystore (*.jks) entsprechend auf dem B2BbP Server hinterlegt werden. Dateipfad und Passwort werden in der späteren Konfiguration benötigt.

Dispatcher (https Eingehend)

Der Request Barzahlen zur B2BbP erfolgt im Netzwerk meist über einen oder mehrerer vorgeschalteten Apache. Diese werden als Firewall und / oder Loadbalancer fungieren. Der Erste Dispatcher sollte den https-Requests entschlüsseln die B2BbP verschatten (Beispiel: https://kunde.de/barzahlen/push und die Request an die B2BbP auf http://<myhost>:<myport>/b2bbp-engine/rs/plain/barzahlen/... (http://<myhost>:<myport>/b2bbp-engine/rs/plain/barzahlen/push) weiterleiten.

Der Loadbalancer meist der B2BbP vorgeschaltet sollte entsprechend angepasst werden. Siehe Beispiel:

JkMount /b2bbp-engine/ws/* dispatcher
JkMount /b2bbp-engine/rs/* dispatcher

B2BbP EAI Dokumentation

Die vorliegende Konfiguration stammt aus der initialen Projekteinführung von Barzahlen mit der erstmaligen Nutzung der B2BbP als EAI Plattform. Die folgenden Dokumentationen können nützlich im Zusammenhang mit Kundenindividuellen Systemlandschaften und Anforderungen sein. Wenn zum Beispiel noch ein Proxyuser oder Passwort beim Versenden von Request notwendig ist.

Kommunikation SAP zu Barzahlen.de

Hier wird die synchrone Kommunikation zwischen SAP (SOAP) zur B2BbP nach Barzahlen.de (Rest) beschrieben. Die Kommunikation erfolgt dabei über den Channel EAI_SOAP_TO_REST_SYNC. Hierunter fallen die Schnittstellen:

create_v4
completed_v4
invalidate_v4
get_info_v4
change_v4

Die B2BbP stellt hierbei unter der URL http://myhost:myport/b2bbp-engine/ws/barzahlen einen SOAP Webservice (BARZAHLEN-WS) zur Verfügung. Dieser Service ist unter der Extension EAI_WS_CONFIG konfiguriert. Hier müssen folgende Properties angepasst werden:

EAI_WS_CONFIG

BARZAHLEN-WS_INBOUND_AUTHENTICATION_USER
BARZAHLEN-WS_INBOUND_AUTHENTICATION_PASSWORD

Es folgt das dynamische Mapping welches über die EAI_MAPPING_CONFIG konfiguriert wird. Das Mapping ist in den Extension unter EAI_MAPPING_... abgelegt. Danach Erfolgt der Aufruf des Rest-SenderService und das senden des Payloads an barzahlen.de. Die Konfiguration des RestSender Service erfolgt direkt über den Service und dort auch dynamisch über die Extension EAI_OUTBOUND_SERVICE_CONFIG. Folgende Parameter müssen noch ersetzt werden:
RestSenderService

PROXY_PORT => der B2BbP wenn verwendet
PROXY_SERVER => der B2BbP wenn verwendet
TRUSTSTORE_PATH => Pfadangabe zum Truststore *jks
TRUSTSTORE_PASSWORD => Passwort des Truststore
Das Mapping des Request wird wieder dynamisch an über EAI_MAPPING_CONFIG konfiguriert.

Push Kommunikation Barzahlen.de zu SAP

Hier wird die Asynchrone Kommunikation der Push Schnittstelle beschrieben. Dabei sendet Barzahlen.de (Rest) eine Nachricht an SAP (SOAP). Die Kommunikation ist über den Channel EAI_REST_TO_SOAP_ASYNC definiert. Folgende Schnittstellen werden dabei umgesetzt:

push_v4

Die B2BbP stellt hier unter der URL http://<myhost>:<myport>/b2bbp-engine/rs/plain/barzahlen/push einen REST Webservice (BARZAHLEN-RS) zur Verfügung. Der RestService ist dabei über die Extension EAI_RS_CONFIG definiert. Folgende Parameter müssen dabei angepasst werden:

EAI_RS_CONFIG

BARZAHLEN-RS.LoginFilter.INBOUND_AUTHENTICATION_USER.DEFAULT
BARZAHLEN-RS.LoginFilter.INBOUND_AUTHENTICATION_PASSWORD.DEFAULT

Das Mapping erfolgt wieder dynamisch wie bereits zu Beginn beschrieben. Der Aufruf des SOAP Webservices erfolgt über den SoapSenderService der in der Extension EAI_OUTBOUND_SERVICE_CONFIG konfiguriert wird

EAI_OUTBOUND_SERVICE_CONFIG

BARZAHLEN-RS_SENDER_USER => (SAP User)
BARZAHLEN-RS_SENDER_PASSWORD => (verschlüsseltes Passwort)
BARZAHLEN-RS_SENDER_URL_BZ_push_v4 => Host und Port des SAP Systems

SAP SOAMANAGER Dokumentation

Folgende Consumer-Proxys müssen über den SOAMANAGER gepflegt werden. Dabei werden die SOAP Services der Firma DSC GmbH verwendet.

Consumer-Proxy

/CPI/CO_BZF_CHANGE_S_V4 si_PROXY_change_amount_v4
/CPI/CO_BZF_COMPLETED_S_V4 si_PROXY_completed_v4
/CPI/CO_BZF_CREATE_S_V4 si_PROXY_create_v4
/CPI/CO_BZF_GET_INFO_S_V4 si_PROXY_get_info_v4
/CPI/CO_BZF_INVALIDATE_S_V4 si_PROXY_invalidate_v4

Der Logische Port ist bei den Consumerproxys als Standart zu definieren. Die Einstellungen sind für alle Consumer-Proxys gleich. Ausnahme sind die Operationseinstellungen.