Admin custom roles and permissions
This is the Intelligent Assets' Roles page:
![image-20240209-212052.png](../__attachments/2599256068/image-20240209-212052.png?inst-v=00a7a7be-0508-4b6c-9dbe-8063c38bb43c)
Three default roles are present out of the box: Administrator, Editor, and Viewer. Each role contains a selection of permissions that anyone assigned the role will have. These permissions include actions you can take within the application, such as creating or editing assets, as well as access to certain parts of the user interface, such as certain tabs on the assets page.
You can add your custom roles. You can build them from scratch or use an existing role as a template and start with all its assigned permissions.
![image-20240209-212127.png](../__attachments/2599256068/image-20240209-212127.png?inst-v=00a7a7be-0508-4b6c-9dbe-8063c38bb43c)
Here is an example of creating a new role using the Viewer’s permissions. You can add and remove permissions and alter the constraints associated with certain permissions. Constraints can finetune the permissions. For example, if you assign the ia.api.groups.read permissions to your role, you can decide whether users who have it can retrieve all groups versus only retrieving groups of which they are members.
![image-20240209-212218.png](../__attachments/2599256068/image-20240209-212218.png?inst-v=00a7a7be-0508-4b6c-9dbe-8063c38bb43c)
A few search and filter features in the edit modal can help you find particular permissions as you make your selections.
![image-20240209-212301.png](../__attachments/2599256068/image-20240209-212301.png?inst-v=00a7a7be-0508-4b6c-9dbe-8063c38bb43c)
Once you have created your custom role, it will appear in the list along with the default roles.
![image-20240209-212329.png](../__attachments/2599256068/image-20240209-212329.png?inst-v=00a7a7be-0508-4b6c-9dbe-8063c38bb43c)
You can assign your new role to users via the Users page by editing the user. If you don’t see your role in the list offered, ensure the user you are editing belongs to at least one of the groups your role belongs to. If you assign multiple roles to the user with conflicting permissions, your user will receive the most permissive abilities from the list.
![image-20240209-212430.png](../__attachments/2599256068/image-20240209-212430.png?inst-v=00a7a7be-0508-4b6c-9dbe-8063c38bb43c)