Creating User Roles

A user role is a title that contains permissions for users to manage security. Different roles are created with various combinations of permissions with the objective of segregation of duties for users who access the Server.

Identity Server supports the role-based authentication model where privileges of a user based on a role attached with.  

A user is associated with one or more roles (generally specified upon user creation), and each role is associated with zero or more permissions (also generally specified upon user creation). Therefore, the set of permissions owned by a user is determined by the roles assigned to that user.

If a user has several assigned roles, their permissions are added together.

By default, Identity Server comes with the following roles:

• Admin - Provides full access to all features and controls. By default, the user "admin" is assigned to both the "Admin" and the "Everyone" roles.
• Everyone - Every new user is assigned to this role by default. It does not include any permissions.
• System - This role is not visible in the Management Console.

To create a new user role

1. Log in to the Management Console by entering your user name and password.
   
2. Click Configure from the main menu to access the Configure menu.
   
3. In the Configure section, click Users and Roles to access the User Management page.
   
4. In the User Management section, click on the Users link.
   
5. The Users menu facilitates the Add New User, Bulk Import Users, Change Password, Assign Roles, View Roles, and Manage User Profile features.
   
6. Click on the Add New Role link.

7. In the Add Role page, enter the role details.
   
   
   

   The Domain label specifies the user-store where the role information is saved. The domain is set to PRIMARY by default in the single-user-store option, whereas in the multiple-user-store, all the user-stores are populated in the domain drop-down list allowing you to choose the required user-store.

8. There are two options available with the Add Role page, namely Role Only and Role with Permissions options. Click the Finish button to save the role with no permissions. Clicking the Next button directs you to the Role with Permissions option.

   The permission model of WSO2 Identity Server is hierarchical. Permissions can be assigned to a role in a fine-grained or a coarse-grained manner. For example, you can either select the whole class of permissions, such as Configure, by checking the corresponding box, or you can expand that class and select one or several items.

   
   

9. The Permission List page shows two methods, namely “Save Role Only” and “Attaching Users With the Role” .
10. Click the Finish button after marking the required permissions in the permission list tree. This enables you to save the role with the specified permissions. Clicking the “Next” button directs you to the Attaching Users With the Role option.
11. Select the users to be assigned to the role. You can conduct a search by name, or view all users by entering "*" into the search field.
    
12. The User List page enables you to Select all on this page, Unselect all on this page, Select all from page 1, and Unselect all from page 1. You may also select the individual check boxes to choose the required users.
13. Click on the Finish button to assign the selected users to the role.
14. A new role is created with the specified user list. The role name is displayed in the Roles list.
    

From here, you can rename roles, assign new permissions and users, and delete a role.