PDF-AS v5.0 Release vom 25.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
• Update sonstiger verwendeter Programmbibliotheken:
• logback-classic 1.5.25
• commons-cli 1.11.0
• commons-collections 4.5.0
• commons-codec 1.21.0
• jakarta.activation 2.1.4
• jakarta.xml.bind-api 4.0.4
• jakarta.jws 3.0.0
• gson 2.13.2
• org.apache.cxf 4.2.1

• 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.
• Integration von Spring Boot Admin Client 4.0.4 zum einfacheren Monitoring. Dieser ist standardmäßig deaktiviert und muss, falls gewünscht, über die Konfigurationsdatei aktiviert 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.
• Update sonstiger verwendeter Programmbibliotheken:
• commons-text 1.14.0
• zxing 3.5.0
• sitemesh 3.2.1
• hibernate 6.6.44.Final

Durchführen eines Updates von PDF-AS Web

Das Major-Release 5.0 bringt einige Änderungen mit sich.

Aus diesem Grund soll auf jeden Fall ein vollständiges Backup der existierenden PDF-AS-Web-Umgebung durchgeführt werden, bevor das Upgrade versucht wird.

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.

Das Releasepacket wurde um einen separaten PDF-AS-Web Build pdf-as-web-db-* ergänzt welcher das im Handbuch beschriebene Datenbank-Backend für die SOAP Schnittstelle bereits inkludiert.