Roles
A Role groups together a set of permissions. Roles
can be assigned to one or more User Groups
and each Role can have one or more Permissions
.
Permissions define granular API-level access control, such as being able to list all the users, being able to send email, etc.
The permissions of the role will be populated in the authenticated User’s Bearer tokens under the scope claim. The scope claim will then be verified by the service receiving a request. Roles are used to group low-level Permissions into reusable mappings.
Components of a Role
Field | Description | Example |
---|---|---|
Application | The name of the client application | My App Name , my-app-client-id |
Name of Role | The name of this role | My Sample Role |
Client Role | A selector for whether or not this is a client role | |
Description | The description of this role | This Role is for XYZ |
Permissions | The scopes for this role | auth.clients.list |
User Groups | The users groups associated with this role | My User Group |
Namespace | The namespace | default |