Skip to content

RHIDP-6570: Document the permission support to RBAC plugin #1079

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions assemblies/assembly-configuring-authorization-in-rhdh.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,7 @@ include::assembly-managing-authorizations-by-using-external-files.adoc[leveloffs

include::assembly-configuring-guest-access-with-rbac-ui.adoc[leveloffset=+1]

include::modules/authorization/proc-delegating-rbac-access.adoc[leveloffset=+1]

include::modules/authorization/ref-rbac-permission-policies.adoc[leveloffset=+1]

Expand Down
35 changes: 35 additions & 0 deletions modules/authorization/proc-delegating-rbac-access.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
[id='proc-delegating-rbac-access_{context}']
= Delegating role-based access controls (RBAC) access in {product}

An enterprise customer requires the ability to delegate role-based access control (RBAC) responsibilities to individual team leads. In this scenario, you, as the administrator, can provide access to the RBAC plugin specifically to designated users, such as team leads. Each team lead is then able to manage permissions exclusively for users within their respective team or department, without visibility into or control over permissions outside their assigned scope.

The expected results of delegating RBAC access are as follows:

* Team leads can manage RBAC settings for their teams independently.
* Visibility of other users' or teams' permissions is restricted.
* Administrators retain overarching control while delegating team-specific access.

.Prerequisites
* Your {product-very-short} instance is up and running with RBAC plugin installed and configured.
* You have administrative access to {product-very-short}.

.Procedure
. In your {product-very-short} instance, navigate to the *Administration -> RBAC* page.
. Create a new role designated for team leads.
+
For more information about creating a role, see xref:proc-rbac-ui-create-role_title-authorization[Creating a role in the {product} Web UI].

. Add the appropriate users or groups to the newly created role.
. Define the necessary permissions for the role based on the tasks the team leads are expected to manage. For example, you can allow team leads to access the RBAC UI and save permission changes for added users or groups.
. Apply access conditions to scope the role’s visibility and control to specific users or groups. For example, you can limit each team lead’s access to only their team.
. Save the changes.

.Verification
Log in as a team lead and verify the following:

* The RBAC UI is accessible.
* Only the assigned users or group is visible.
* Permissions outside the scoped team are not viewable or editable.