v2.0.0

v2.0.0 is a major backwards incompatible release.

In version 1, the generated challenge nonces were stored in a JSR107 compatible cache. However, in case the website had a CSRF vulnerability, this made the solution vulnerable to forged login attacks. In version 2, a session-backed challenge nonce store must be used instead to mitigate this attack.

The Web eID authentication token format changed in version 2. In version 1, the authentication token was in the OpenID X509 ID Token (JWT) format in order to be compatible with the standard OpenID Connect ID Token specification. The JWT format was found out to be undesirable, as it implies that the claims presented in the Web eID authentication token can be trusted and processed, while they actually cannot be trusted. Therefore a custom JSON-based format was adopted for the Web eID authentication token in version 2.

Detailed overview of the changes and upgrade instructions are available here.

Changes

See the list of changes in the v2.0.0 milestone.

Backwards incompatible changes

• the Maven group ID and package namespace changed from org.webeid to eu.webeid,
• a session-backed challenge nonce store that implements the ChallengeNonceStore interface is required instead of a JSR107 cache,
• usages of the withNonceCache() method should be removed,
• authentication token validation method signature has changed,
• CertUtil is renamed into CertificateData.

See upgrade instructions for details.

Packages

The v2.0.0 Maven package is available in the GitLab Package Repository.

v2.0.0-rc1

refactor(challenge): change ChallengeNonceStore type from abstract cl…

v1.2.0

Changes

• make OCSP service configurable, verify OCSP responder certificate and response signature.

Full list of changes is in the v1.2.0 milestone.

Backwards incompatible changes

• org.webeid.security.util.CertUtil has been renamed to org.webeid.security.certificate.CertificateData.

Packages

Maven package is available in GitLab Package Repository.

v1.1.0

Changes:

• use ZonedDateTime instead of LocalDateTime to avoid unexpected results nearby daylight saving clock change times,
• add more tests.

Full list of changes is in the v1.1.0 milestone.

Maven package is available in GitLab Package Repository.

v1.0.2

• Add ESTEID-SK 2015 old Mobile-ID policy to disallowed policies
• Rework README

Maven package is available in GitLab Package Repository.

v1.0.1

• Make using nonce extension configurable during OCSP requests.
• Use standard JCE PKIX classes for certificate trust validation.

Maven package available in GitLab Package Repository.

v1.0.0

First published release.

Maven package available in GitHub Packages (authentication required) and publicly from GitLab Packages.