Role Assignments for OIDC Groups

Enterprise Edition

Roles can always be associated with single users. For Enterprise Edition users it is also possible to associate KKP roles with groups as passed via the OIDC login flow. This will assign the role to anyone who is authenticated with the specific group.


  • The list of groups a user is part of is passed by Dex. This depends on the Dex connector that has been configured and might slightly vary. Some connectors like the Google connector require special configuration to be able to read group information.
  • If you are not sure which groups you are part of, the /api/v1/me API endpoint returns information about the groups that KKP is aware of.
  • For GitOps scenarios, the GroupProjectBinding CRD can be used to replicate the UI-based workflow.

Binding Roles to Groups

Group bindings can be configured from the “Groups” project panel.

Group Bindings Overview

From this view, new group bindings can be created via the “Add Group” button.

Group Binding Wizard

Be aware that group names are not further validated as KKP does not have access to a complete list of groups in the OIDC backend. This way, group permissions can be pre-provisioned even if no user with a specific group membership has signed into KKP yet.

The role associated with a group can be updated later on to reflect changes in responsibilities. Group bindings can later be removed from the list of bindings by deleting it from the list.

Be aware that as of KKP 2.21.0 (when this feature was introduced), there was no group support for MLA Grafana access yet. As of KKP 2.21.2 groups are supported in MLA Grafana.