Features & Nutzung
Der AEP api-webservice-client
- empfängt Daten für eine API-Anfrage vom Mako-System,
- ermittelt den Ziel API-Endpunkt des Marktpartners,
- erstellt und signiert die API-Anfrage,
- übermittelt die API-Anfrage mTLS verschlüsselt dem Marktpartner,
- empfängt die Antwort des Marktpartners und
- leitet diese an das Mako-System weiter.
Hardware Anforderungen
Eine Service-Instanz erfordert mindestens 512 MB RAM.
Wir empfehlen 0,4 CPU-Kerne je Instanz.
Logs werden auf die Festplatte geschrieben, entsprechend muss genügend Speicherplatz vorhanden sein.
Abhängigkeiten
Der Service greift auf einen Message-Broker zu, um Nachrichten zu empfangen und zu versenden.
Der Service nutzt die REST API des Security Server FSS. Der FSS muss im Hintergrund auf ein HSM zugreifen können.
Dieser Dienst stellt auch eine Verbindung zu anderen Diensten wie dem aep-api-address-service her, um die URL von Marktpartnern abzurufen.
Erforderliche Konfiguration für aep-api-webservice-client.properties
Legen Sie die URL für den FSS-Dienst und den API-Adressdienst fest
fss-server.url=http://fss:2223/fss/api/v1/
address-service.url=http://api-address-service:8080/aep-api-address-service
Sie können den Status der Adress-Einträge mit die dieser Eigenschaft konfigurieren.
Mögliche Werte sind OFFLINE, TEST, MAINTENANCE und ONLINE.
Wenn nichts ausgewählt wurde werden Einträge mit den Werten OFFLINE, MAINTENANCE und ONLINE zurückgegeben.
address-service.status=
Message-Broker einrichten
rabbitmq.host=localhost
rabbitmq.port=5672
rabbitmq.username=guest
rabbitmq.password=guest
Optionale Konfiguration aep-api-webservice-client.properties
Ändern Sie die Protokollierungsebene auf Root-Ebene. Der Standardwert ist INFO.
logging.level.root=INFO
Sie können die Protokollierungsstufe auch auf Paketebene ändern, indem Sie die folgende Eigenschaft verwenden
logging.level.aep.api.webservice.client=DEBUG
Die Signierung kann mit der folgenden Eigenschaft aktiviert oder deaktiviert werden. Der Standardwert für diese Eigenschaft ist true.
signingEnabled=true
AMQP Konfiguration
Die folgende Konfiguration legt Wiederholungsversuche in der Warteschlange fest. Der Standardwert ist auf 3 eingestellt.
consumerMaxAttempts=3
Die folgende Konfiguration besteht darin, die Austauschnamen und die maximale Parallelität für jede Warteschlange festzulegen. Nachfolgend finden Sie alle Standardwerte.
#----------------------------------Address Queue Config--------------------------------------------
addressRequestExchangeName=b2b.outbox
addressRequestQueueName=api.request.address
addressRequestGroup=default
addressRequestMaxConcurrency=50
#----------------------------------Sign queue config----------------------------------------
signRequestExchangeName=api.request.sign
signRequestGroup=default
signRequestMaxConcurrency=50
#-----------------------------------Response queue config-------------------------------------------
responseRequestExchangeName=api.request.response
responseRequestGroup=default
responseRequestMaxConcurrency=50
#-----------------------------------Send queue config-------------------------------------------
sendRequestExchangeName=api.request.send
sendRequestGroup=default
sendRequestMaxConcurrency=50