Die folgenden Dokumente beschreiben die Installation & Konfiguration der AEP.API Microservices.
Das AEP.API System besteht aus mehreren Microservices um AEP.API Nachrichten zu verarbeiten.
AEP.API Workflows
Eine Übersicht über das Zusammenspiel der AEP.API Services finden Sie in der AEP.API Beschreibung.
Installation
Work in Progress…
Infrastruktur & Abhängigkeiten
Zu benötigter Infrastruktur und Abhängigkeiten werden folgende Dokumente zur Verfügung gestellt:
- RabbitMQ - Zum Betrieb des AEP.API-Systems wird zwingend ein Message-Broker ( z.B. RabbitMQ) benötigt.
- FSS & HSM - Zum Betrieb des AEP.API-Systems wird zwingend ein FSS und ein HSM benötigt.
Daneben benötigt der api-address-service eine Datenbank. Weitere Details zu den Datenbanken sind der Dokumentation der einzelnen Microservices zu entnehmen.
Microservice Konfiguration
Die Konfiguration der AEP.API Microservices ist auf den jeweiligen Seiten beschrieben:
Mandanten konfigurieren
Alle Mandanten müssen innerhalb des Systems konfiguriert werden. Eine Anleitung diesbezüglich finden Sie hier.
Zertifikate
Bevor das AEP.API System in Betrieb genommen werden kann, müssen je Mandant Zertifikate erstellt und eingespielt werden.
Darüber hinaus müssen auch Aussteller-Zertifikate & Partner-Zertifikate importiert werden.
Anbindung an Backend-Systeme und Monitoring
Das AEP.API System verfügt zum Austausch von API-Anfragen mit dem Backend/Monitoring-Systemen über drei AMQP-Schnittstellen:
Die Schnittstellen-Dokumentation (interner Link) stellt unser Support Ihnen bei Anfrage gerne zur Verfügung. Dies lässt sich beispielsweise durch AsyncAPI Studio darstellen.
Anbindung an die B2B (Standard)
Im Standard-Fall wird das AEP.API-System an eine B2B angeschlossen. Diese fungiert hierbei gleichzeitig
- als API-Anfrage Monitoring-System (über den B2B Nachrichten-Monitor)
- als Speicher für die API-Anfragen und (bei Bedarf) als Adapter für eine Archivierung
- als Adapter für Backend-Systeme zur fachlichen Verarbeitung der API-Anfragen (z.B. ein SAP ISU mit IDOCxml Mapping)
Dazu ist auf Seiten der B2B zusätzlich
- der B2B-Message-Service als AMQP Adapter der B2B zu installieren, welcher genau die AMQP Schnittstellen des AEP.API-Systems implementiert, und
- das B2B Customizing für die API-Verarbeitung einzurichten.