add release notes

1 files changed, 32 insertions, 0 deletions

diff --git a/doc/PDFAS5_Release_Notes.md b/doc/PDFAS5_Release_Notes.md
new file mode 100644
index 00000000..70bba7ec
--- /dev/null
+++ b/doc/PDFAS5_Release_Notes.md
@@ -0,0 +1,32 @@
+# PDF-AS v5.0 Release vom xx.06.2026
+
+Mit dem Major-Release PDF-AS 5.0 erfolgt eine Migration auf aktuelle Software-Infrastruktur.
+Demnach sind beim Einspielen des Updates einige Änderungen notwendig.
+Wir empfehlen, das Update zunächst in einer Testumgebung einzuspielen und die erfolgreiche Migration im entsprechenden Use-Case zu testen.
+
+### Änderungen in dieser Version
+
+- An der Kernbibliothek PDF-AS:
+    - Die Multi-Stage-API für die programmatische Verwendung von PDF-AS hat sich geändert. `setCertificate` und `setSignature` führen jetzt direkt die dazugehörige Operation durch. Der Aufruf von `process` fällt weg.
+    - Das Zertifikat eines MOA-Connectors (Wert `moa.sign.Certificate`) kann nun auch direkt base64-encoded angegeben werden. Hierzu wird ein Prefix `base64:` gefolgt vom Base64-encoded Zertifikat verwendet.
+    - Ein Timeout oder Fehler bei der Verbindung zum MOA-Connector gibt nun einen eigens definierten PDF-AS-Fehlercode `11022` (`ERROR_SIG_CONNECT_ERROR`) zurück.
+    - Java 17
+    - Apache PDFBox 3.0.6
+- An PDF-AS Web:
+    - Umstellung von PDF-AS-Web auf Spring Boot 4.0.6. Die PDF-AS-Web-Konfigurationsdatei, angegeben über `-Dpdf-as-web.conf`, kann auch zur Angabe von Spring-Konfigurationsparametern genutzt werden.
+    - Eine vollwertige JSON-API, funktionell gleichwertig zur SOAP-API, wurde hinzugefügt. Für weitere Informationen verweisen wir auf die Dokumentation zur Anbindung externer Webanwendungen an PDF-AS 5.0, sowie auf die maschinenlesbare OpenAPI-Dokumentation.
+    - Für jeden MOA-Connector kann nun ein konfigurierbares Timeout gewählt werden. Setzen Sie hierzu den Wert `moal.(id).timeout` auf das gewünschte Timeout in Millisekunden.
+
+### Durchführen eines Updates von PDF-AS Web
+
+Das Major-Release 5.0 bringt einige Änderungen mit sich.
+
+PDF-AS-Web wurde auf Java 17 migriert. PDF-As-Web 5.0 sollte also mit einem geeigneten Servlet-Container (wie z.B. Tomcat 11) betrieben werden.
+
+PDF-AS-Web wurde auf Spring Boot migriert. Hierdurch ändert sich der notwendige Parameter für externe Logging-Einstellungen. PDF-AS wird mit einer geeigneten Standard-Konfiguration für das Logging ausgeliefert, die Logdateien der Form `pdfas.log` in den Tomcat-Logordner schreibt. Für eine Konfiguration über eine externe Konfigurationsdatei muss der frühere Parameter `logback.configurationFile` durch den Spring-Boot-Parameter `logging.config` ersetzt werden.
+
+Der Security-Layer-Einsprungpunkt der ID Austria (`bku.mobile.url`) hat sich geändert. Die mitgelieferte Beispiel-Konfiguration beinhaltet den aktuellsten Wert (`https://service.a-trust.at/mobile/https-security-layer-request/default.aspx`). Falls eine Konfiguration einer älteren Instanz übernommen wird, sollte dieser Wert angepasst werden.
+
+Zum verbesserten Monitoring von PDF-AS-Web wird der Spring Boot Admin Client mit ausgeliefert, um eine Integration in einen Monitoring-Server zu ermöglichen. Im Standardzustand ist dieser deaktiviert. Um ihn zu aktivieren, sollten `spring.boot.admin.client.enabled` und `spring.boot.admin.client.url` entsprechend gesetzt werden.
+
+Der Parameter `web.upload.RequestsizeMax` wurde zur besseren Konsistenz zu `web.upload.requestsizeMax` umbenannt.