Skip to content

EPMDEDP-17150: docs: document username_claim/username_prefix for Keycloak EKS OIDC setup#386

Merged
SergK merged 1 commit into
mainfrom
update-k8s-oidc-setup
Jul 5, 2026
Merged

EPMDEDP-17150: docs: document username_claim/username_prefix for Keycloak EKS OIDC setup#386
SergK merged 1 commit into
mainfrom
update-k8s-oidc-setup

Conversation

@SergK

@SergK SergK commented Jul 5, 2026

Copy link
Copy Markdown
Member

Kubernetes falls back to the sub claim prefixed with the issuer URL when username_claim is unset, producing an unreadable username in kubectl output, RBAC errors, and audit logs. Document setting username_claim to preferred_username (not email, which Kubernetes rejects when email_verified is false — common for SAML-brokered upstream IdPs like Azure AD) and pinning username_prefix to "-", across the current docs, all three versioned snapshots, and the original Keycloak+EKS blog post.

…loak EKS OIDC setup

Kubernetes falls back to the sub claim prefixed with the issuer URL when
username_claim is unset, producing an unreadable username in kubectl output,
RBAC errors, and audit logs. Document setting username_claim to
preferred_username (not email, which Kubernetes rejects when email_verified
is false — common for SAML-brokered upstream IdPs like Azure AD) and pinning
username_prefix to "-", across the current docs, all three versioned
snapshots, and the original Keycloak+EKS blog post.

Signed-off-by: Sergiy Kulanov <sergiy_kulanov@epam.com>
@SergK SergK requested a review from a team as a code owner July 5, 2026 14:06
@github-actions

github-actions Bot commented Jul 5, 2026

Copy link
Copy Markdown

Azure Static Web Apps: Your stage site is ready! Visit it here: https://gentle-pebble-0839af61e-386.westus2.4.azurestaticapps.net

@SergK SergK merged commit a67c7b9 into main Jul 5, 2026
6 checks passed
@SergK SergK deleted the update-k8s-oidc-setup branch July 5, 2026 14:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant