Skip to content

Raise generated cache-transport RSA keys to 3072 bits and allow ECDSA - #55224

Draft
ahus1 wants to merge 6 commits into
keycloak:mainfrom
ahus1:is-54496-jgroups-rsa-key-size
Draft

ahus1 wants to merge 6 commits into
keycloak:mainfrom
ahus1:is-54496-jgroups-rsa-key-size

Conversation

@ahus1

@ahus1 ahus1 commented Nov 16, 2026 •

Copy link
Copy Markdown
Member

Closes #54496

The generated cache-transport certificate follows BSI TR-02102-2, which asks for RSA keys of at least 3000 bits and deprecates PKCS#1 v1.5 signatures.

Decisions and assumptions

  • The default is RSA 3072 signed with RSASSA-PSS. Only the JGroups certificate opts into PSS; realm keys, client credentials and other callers of the shared certificate utilities keep PKCS#1 v1.5 to avoid breaking relying parties.
  • The SPI options algorithm (RSA default, or ECDSA), key-size (default 3072, minimum 2048) and curve (secp256r1 default, secp384r1, secp521r1) are added to the jgroups-mtls SPI. Invalid values fail at startup. The CLI options are expected to be removed in a future version, so this is meant to be backported to allow a graceful migration.
  • On startup a node compares the stored certificate with the configured key specification and regenerates it on mismatch. The replacement is conditional on the mismatch still existing, so concurrent nodes regenerate once. Running nodes pick up the new certificate through the existing trust-manager failure reload; no new notification was added, so a rolling upgrade can cause short-lived connection retries.
  • The private key is now stored as PKCS#8, as the existing PEM utilities write EC keys as SEC1 and cannot read them back.
  • The FIPS integration tests now run with clustered caches (--cache=ispn) so that they exercise certificate generation in FIPS mode. The Arquillian local mode is left in place and can be removed in a follow-up.
  • The clustered ECDSA test only asserts that two nodes form a cluster
  • The upgrade note is in changes-27_0_0.adoc; a backport needs to move it to the matching version file.

Closes keycloak#54496

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alexander Schwartz <alexander.schwartz@ibm.com>
ahus1 and others added 5 commits November 16, 2026 14:17
Closes keycloak#54496

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alexander Schwartz <alexander.schwartz@ibm.com>
Adds the startup check, logs the active certificate, and adds docs and release notes.

Closes keycloak#54496

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alexander Schwartz <alexander.schwartz@ibm.com>
Closes keycloak#54496

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alexander Schwartz <alexander.schwartz@ibm.com>
Closes keycloak#54496

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alexander Schwartz <alexander.schwartz@ibm.com>
Closes keycloak#54496

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Signed-off-by: Alexander Schwartz <alexander.schwartz@ibm.com>
@ahus1
ahus1 force-pushed the is-54496-jgroups-rsa-key-size branch from 77f2baf to 0d263ba Compare November 16, 2026 13:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Raise generated cache-transport RSA keys to 3072 bits

1 participant