You are reading the documentation for an outdated Corteza release. 2024.9 is the latest stable Corteza release.

Role Management

A role is a security group which may or may not have access to specific user interfaces or system resources based on your security model.

A role can have a series of users who are provided with the security model defined by the given role.

Refer to the access control section for details on how to define your security model.

The user interface

The role management user interface resides in the Corteza Admin web application, under system  roles.

Annotated image

Tips and tricks

Modular design

DevNote @todo

Listing roles

To list current system roles:
  1. Navigate to system  roles,

  2. optionally insert the filtering parameters.

  3. The list refreshes automatically.

Annotated image

Creating roles

You can only define permissions for existing roles.

To create a new role:
  1. Navigate to system  roles,

  2. click on the new button,

  3. insert the parameters for the new role,

  4. press the submit button.

Annotated image

Editing roles

To edit an existing role:
  1. Navigate to system  roles,

  2. click on the edit button next to the role you wish to edit,

  3. update the parameters for the updated role,

  4. press the submit button.

Annotated image

Archiving roles

To archive an existing role:
  1. Navigate to system  roles,

  2. click on the edit button next to the role you wish to archive,

  3. click and confirm the archive button.

Annotated image

Deleting roles

Instead of deleting roles, you can archive the role.

To delete an existing role:
  1. Navigate to system  roles,

  2. click on the edit button next to the role you wish to delete,

  3. click and confirm the delete button.

Annotated image

Cloning role permissions

To clone the role’s permissions to another role:
  1. Navigate to system  roles,

  2. click on the clone permissions button,

  3. select the roles you wish to clone the permissions to,

  4. press the clone button.

The screenshot shows the clone permissions button.
Figure 1. The screenshot shows the clone permissions button.
role clone permissions
Figure 2. The screenshot shows clone permissions to dialog, to select roles for cloning permission to.