Manage users' roles in Magic

Roles are defining each user's access level to your system.


You can create more roles based on your system's logic and requirements. It is also possible to edit or delete the predefined roles on your system.


New roles

You can define new roles in your Magic environment. To do so, follow the simple steps listed below.

1- Navigate to "Users & roles" page.

2- In the Roles panel, right side of your screen, click on the little "plus button".

3- In the popup dialog, give a unique title to the role. You will later use this title to assign it to the users on your system.

4- Provide a brief description for this role, so later you know what access rights are associated with this role.

5- Click on the Create button and wait for the success message to be appeared on your screen.


There are a few points you need to know:


* Roles are an agreement defined in your system. So, the roles you create and the way you use them in your system will specify the access rights. For instance, you create a role and name it "Operator", then for each endpoint you create, you can specify which endpoint can be accessed (each operation individually) by "Operator". This way, you will specify the list of roles in your system and manage their access rights accordingly. 


* Name of the new roles cannot be duplicated compared to the existing roles.



Edit a role

The description of each role and be modified. 

You can edit the description of each role with a risk of making any interruption in the role's defined access rights.


1- Find the the specific role in the list.

2- Expand the row by clicking on it.

3- Select the vertical ellipsis ⋮ at the end of the row.

4- An action list will be appeared, now find the Edit role link in the list.

5- In the popped up dialog, make the necessary modifications on the description field.

6- Click on the Update button and wait until it is successfully updated. The dialog will be closed automatically.



Delete a role

Deleting a role is a little risky if the role is associated with one or more users.

In this case, you will be asked to confirm your action, so make sure you will read the dialog carefully.  


1- Find the the specific role in the list.

2- Expand the row by clicking on it.

3- Select the vertical ellipsis ⋮ at the end of the row.

4- An action list will be appeared, now find the Delete role ink in the list.

5- If there is any user linked to this role, a confirmation dialog will popup to inform you about the number of users linked to this role. You can decide whether to keep the role or permanently delete it. If no user is linked to the role, then the role will be automatically deleted.



Assigning a role to multiple users at the same time

All you need to do is to:

1- Select users, by checking the checkbox in front of each user's row.

2- Find the the specific role in the list.

3- Expand the row by clicking on it.

4- Select the vertical ellipsis ⋮ at the end of the row.

5- An action list will be appeared, now find the Add to selected users link in the list.



Was this article helpful?

1 out of 1 liked this article