v2.2.0
A Java 8-compatible release with back-ported changes (mainly OCSP-related fixes) from the main branch and updated dependencies.
Version 2 will continue to support Java 8, while version 3 requires Java 11 or newer.
Java 8 support has been extended until at least March 2026. If you need Java 8 support after that, please request it in this issue comments.
Minor backwards-incompatible changes
Although we adhere to semantic versioning principles, the following backwards-incompatible changes are included in the minor version 2.2.0. The updates are primarily structural and cosmetic rather than essential functionality changes, therefore we consider them compatible with a minor version increment.
Maven group ID updated to eu.webeid
The Maven group ID has been changed from org.webeid to eu.webeid. This change corresponds with the package namespace, domain of the official project website and emphasizes the focus on European Union eID cards.
Optional return values in CertificateData
The certificate subject field extraction methods in the CertificateData utility class now return Optional<String> instead of String. This change clarifies when a field is absent as opposed to when a certificate parsing error occurs. Users of these methods must now check for Optional<String> presence with isPresent() or using methods like orElse() or orElseThrow() to handle missing values.
Example
The old version 2-compatible Web eID Spring Boot example application was updated to use this version with these changes, which demonstrate how to adapt to the new Optional API and configuration changes. Note that digital signing will not work in this version of the example as only authentication was updated.
What's Changed
Full Changelog: v2.1.2...v2.2.0