Skip to main content
Version: Next

Roles example

To better understand the concept of roles, users, and priorities here is an example scenario.

Below is a table of users and their group assignments. Some users aren't members of any groups, some are members of a single group, and others are members of multiple groups. In this example, these users are coming from a SAML domain that was configured. When SAML domain members connect to Redtrust, Redtrust makes those users and any potential group memberships passed in the SAML assertion available for assignment to roles.

tip

Users only require a role for accessing the admin console, end users are able to login to the agents and use certificates defined in policies without needing to have a role assignment.

UserGroup membership
User ANone
User BGroup-1
User CGroup-1
User DGroup-1 & Group-2
User EGroup-2

In this example, Redtrust has been configured with the following Roles.

  • Administrator

  • Event viewer

  • Certificate manager

  • Development manager

Now that there are users available and roles have been created you can look at assigning those users to the roles and with some example priorities. This scenario has purposefully been made complex to illustrate the interactions between a Users/Groups Role assignment and priority level. In real world usage, role assignments are straightforward in many applications. Consider the below scenario:

RolePriorityUser/Group assignment
Administrator1User A, User B
Event Viewer0Group-1
Certificate manager1Group-2
Development manager1Group-2

Explanation of what roles were assigned from the above scenario and why.

UserAssigned roleWhy?
User AAdministratorUser A had no other assignments. They were assigned directly to the administrator role, which is their valid role assignment.
User BAdministratorWhile User B was a member of Group-1, since they were directly assigned to the administrator role, which is their valid role assignment. Note, that this is true even though the event viewer role had a higher priority (0 is the highest potential priority assignment).
User CEvent ViewerSince User C was a member of Group-1 and had no other potential assignments their role is event viewer.
User DEvent ViewerSince User D was a member of both Group-1 and Group-2, but the Event Viewer role has a higher priority User D was assigned to Event Viewer. To assign User D to the certificate manager role, change the priority of the Event Viewer role to 2 or higher.
User EN/ASince the certificate manager role and development manager role have the same priorities this role assignment won't be applied consistently. To assign User E to the development manager role assign the role directly to the user instead of the group.