Repository navigation
Clarify documentation of OS-level dependencies for Kerberos - #45764
Merged
Merged
Conversation
Closes keycloak#32527 Signed-off-by: Alex Szczuczko <aszczucz@redhat.com>
Member
Contributor
Author
|
@ahus1 Ideally someone with an understanding of the kerberos features would double check my analysis |
Closed
8000
sashyo
pushed a commit
to tide-foundation/keycloak-IGA
that referenced
this pull request
Jul 20, 2026
…#45764) Closes keycloak#32527 Signed-off-by: Alex Szczuczko <aszczucz@redhat.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #32527
For a long time the Kerberos authentication documentation has implied that freeipa or krb5-libs packages are a necessary dependency. This isn't actually the case. This causes concern and confusion in the case of the container deployment, which doesn't have these packages installed by default due to security hardening.
As evidenced by the use of the
org.ietf.jgsspackage, Keycloak uses the Java Generic Security Services API (JGSS) for kerberos, not krb5-libs via JNA. JGSS by default has no native dependencies. It will use a pure Java implementation unlesssun.security.jgss.nativeis set to trueUnless overridden by the
java.security.krb5.confproperty, JGSS will look for the kerberos configuration in the same place that krb5-libs puts it, i.e./etc/krb5.conf. This file seems to be the only actual dependency of Keycloak.This PR updates the migration, container, and server admin guides to make this distinction more apparent.