Roles

Roles define the set of permissions a user has within an organization. The role library is shared by all organizations under the current application. The system comes with two default roles pre-configured, and you can also create custom roles based on your business needs to achieve granular permission control.

Path: Log in to the RootAuth console → Navigate to the target application → Click User Management in the top navigation bar → Select Roles

 

1. Role List

The role list displays all roles under the current application (including system-preset and custom roles), supporting search, creation, and management operations.

List Features:

• Default Roles: The system pre-configures Admin and Member. Admin is the default role and is marked with a "Default" badge.

• Deletion Restrictions: Default roles and roles that are currently in use cannot be deleted.

• Search: Supports fuzzy searching by role name.

• Create Role: The "+ Create Role" button is located in the upper-right corner of the list.

2. Creating a Role

Steps:

1. Click the "+ Create Role" button in the upper-right corner of the role list to open the creation form.

2. Fill in the following information:

   • Role Name (required): Must be unique within the same application.

   • Role Code (required): A unique identifier. Cannot be modified after creation. Format restrictions: only lowercase letters, numbers, hyphens (-), and underscores (_) are allowed.

   • Description (optional): Explains the purpose of the role for team understanding.

3. Click "Create Role" to submit. The new role will appear in the list immediately.

3. Role Details

Click on a role name in the role list or "Edit Role" to access the details page, where you can view and edit role information.

3.1 Basic Information

3.2 Deleting a Role

A red "Delete" button is located at the bottom of the page. Deletion is subject to the following restrictions:

• Default Roles: Cannot be deleted; the button is grayed out.

• Roles in Use: If the role is currently assigned to any user in any organization, clicking "Delete" will prompt you to first reassign all users to other roles or remove them from the organization before retrying the deletion.

• When deletion is possible, clicking "Delete" opens a confirmation dialog. After confirmation, the role is permanently deleted.