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.

Consumer-Sicherheit

Hier bitte die Authentifizierung aus der B2BbP eintragen. In diesem Fall User und Passwort

Messaging

Transporteinstellungen

Bei URL bitte http://myhost:myport/b2bbp-engine/ws/barzahlen eintragen.

Message-Attachments

Operationseinstellungen

Service-Definition

  • /CPI/BZF_SI_MW_PUSH_V4 /CPI/BZF_SI_MW_PUSH_V4

Bitte achten Sie darauf das der Service aktiv ist.

Provider-Sicherheit

Hier bitte die Authentifizierung zum SAP eintragen. Diese muss in der Extension EAI_OUTBOUND_SERVICE_CONFIG eingetragen werden.

Transporteinstellungen

Hier kann auch die URL für die Propertie BARZAHLEN-RS_SENDER_URL_BZ_push_v4 aus der Extension EAI_OUTBOUND_SERVICE_CONFIG identifiziert werden.

Message-Attachments

View Me   Edit Me