Roles

Overview

Roles define what a user can do within Cortx OS by combining one or more Permission Sets. A role represents a functional responsibility such as an administrator, contributor, reviewer, or viewer.
Roles act as the bridge between Permission Sets and users, allowing access to be assigned in a scalable and structured way through User Groups or direct user assignment.

Steps

  1. Click the user avatar → select Manage Workspace.

  2. Navigate to Organizations → select your organization.

  3. Open Access ManagementRoles.

  4. Click Create Role and provide a role name and description.

  5. Attach one or more Permission Sets to the role.

  6. Save the role.

Managing Roles

  • View all roles defined in the organization.

  • Edit role details or update attached Permission Sets.

  • Assign roles to User Groups.

  • Review where a role is currently assigned.

  • Disable or update roles without changing underlying Permission Sets.

Changes to a role automatically affect all users and groups that inherit it.

Best Practices

  • Design roles around job functions, not individuals.

  • Keep roles lightweight by reusing Permission Sets.

  • Avoid frequent edits to roles that are widely assigned.

  • Use clear, descriptive role names aligned with responsibilities.

  • Periodically review roles to ensure continued relevance.

Was this article helpful?

On this page