Diese Seite beschreibt die Migration zu neueren AS4 Releases.
Migration zu 2023-08 02
Guide zur Migration von Version 2023-08 zur Version 2023-08 02.
CSR & Zertifikatserstellung
Der CSR-Service unterstützt nun das Integrieren der AS4-Adresse in ein CSR/Zertifikat. Dies wird vom BDEW vorgeschrieben. Falls Sie bereits zuvor Zertifikate mit Hilfe des CSR-Service generiert haben, müssen Sie die Zertifikate mit der neuen Service-Version erneut generieren.
Weitere Details zur Konfiguration der AS4-Adresse im CSR finden Sie in der Dokumentation zur Zertifikatserstellung.
Routing Key Update
Für AS4 Marktübertragungsnachrichten wird nun die korrekte AS4 ServiceId https://www.bdew.de/as4/communication/services/MP genutzt. Entsprechend müssen die RabbitMQ Bindings angepasst werden, die bisher die falsche ServiceId genutzt haben. Dies betrifft die Exchanges as4.inbound und as4.receipt.outbound. Die Konfiguration der Exchanges ist hier beschrieben.
AS4-Address-Service Tabellen
Der AS4-Address-Service nutzt zusätzliche neue Tabellen. Diese werden automatisch angelegt.
Pathswitch Delivery
Der Adresswechsel wird nun an die B2B übertragen. Hierfür muss sowohl auf Seiten des AS4-Address-Service als auch auf Seiten des B2B-Message-Service die entsprechende Exchange & Queue konfiguriert werden: as4.pathswitch.delivery.
Falls bereits zuvor Pathswitch-Prozesse erfolgreich abgeschlossen worden sind, müssen diese alle nun wiederholt werden, um die B2B korrekt zu benachrichtigen. Dies lässt sich erreichen, indem AS4 in der B2B-Admin-UI deaktiviert und danach wieder reaktiviert wird.
Beim AS4-Address-Service wird die Exchange wie folgt konfiguriert: externalPathswitchEventExchangeName. (Wenn nicht konfiguriert, ist der Default automatisch korrekt eingestellt).
Beim B2B-Service wird die Queue wie folgt konfiguriert: externalPathswitchEventExchangeName. (Wenn nicht konfiguriert, ist der Default automatisch korrekt eingestellt).
Weitere Details sind der Dokumentation der beiden Services zu entnehmen.
mTLS
AS4-Outbound-Sender & AS4-Inbound-Endpoint unterstützen nun mTLS (vom BDEW vorgeschrieben). Per Default ist mTLS deaktiviert. Wenn Sie möchten, dass die Services mTLS einsetzen, muss die Konfiguration per application.properties entsprechend ergänzt werden. Weitere Details finden Sie in der Dokumentation der jeweiligen Services.
Migration zu 2023-08
Guide zur Migration von Version 2023-04 zur Version 2023-08.
Zentrale Änderung mit diesem Release: Umstellung auf asynchrone Kommunikation zwischen dem AS4 System und dem Mako System.
Empfohlene Reihenfolge:
- Service AS4-Inbound-Market-Message-Service entfernen
- Aktualisierung auf AS4-Release 2023-08
- CSR-Service Datenbank & Schema anlegen & anbinden
- RabbitMQ Queues aktualisieren
- B2B Customizing umstellen
Service AS4-Inbound-Market-Message-Service entfernen
Der Service AS4-Inbound-Market-Message-Service wird ab dem Release 2023-08 nicht mehr benötigt und kann entfernt werden.
Aktualisierung der Versionen
Alle Anwendungen sind auf die neuesten Versionen zu aktualisieren.
CSR-Service Datenbank
Der CSR-Service benötigt nun eine SQL Datenbank. Diese ist über die application.properties anzubinden. Weitere Details sind der Doku zu entnehmen.
RabbitMQ Queues
Die genutzten Queues & Exchanges haben sich teilweise geändert. Die Queues & Exchanges werden zum einen in den application.properties der jeweiligen Services konfiguriert, zum anderen sind die in RabbitMQ selbst zu hinterlegen.
Bitte aktualisieren Sie zunächst die application.properties aller AS4 Services sowie die des B2B-Message-Service. Passen Sie die RabbitMQ Konfiguration entsprechend der Dokumentation des jeweiligen Service an (z.B. Abgleich mit der Konfiguration im jeweiligen Abschnitt Anhang).
Die Konfiguration auf Seiten RabbitMQ kann von den Services größtenteils vollautomatisch vorgenommen werden, sofern sie die Standard Queues verwenden. In diesem Fall entfernen sie einfach alle Queues und Exchanges aus RabbitMQ, sonfern diese leer sind, und lassen Sie sie von den Services automatisch neu anlegen. Starten Sie hierfür die Services neu. Vor dem Neustart müssen einige Queues manuell angelegt werden, Details hierzu finden Sie hier.
B2B Customizing
Das synchrone Customizing ist veraltet. Bitte bauen Sie das Customizing zurück.
Konfigurieren Sie stattdessen das asynchrone Customizing.
Teilweise verwenden die Customizings ähnliche Strukturen. Es kann effizienter sein, statt eines vollständigen Rückbaus Teile des alten Customizings umzuschreiben. Z.B. verwenden beide Customizings einen RestClientService im Outbound Workflow. Allerdings müssen die RestClientServices unterschiedlich konfiguriert werden.
View Me Edit Me