Roles

Through roles you can manage access control in Micetro.

Objects (servers, zones, scopes, IP addresses, etc.) in Micetro are accessed through Roles configured with Permissions. Users and Groups do not have direct access to objects, only if they’re assigned to roles. Administrators can control a user or group’s access by assigning or removing them from roles.

Note

This page is for generic management of roles. See General roles, Specific roles, and Legacy roles for the particularities of the different role types.

Adding a new role

Through this function, you add new roles to Micetro.

  1. Navigate to Admin ‣ Configuration and select Roles in the filtering sidebar. The built-in roles are displayed here, as well as all other roles that have been added to Micetro already.

  2. Click the Create button. The Create role dialog box displays.

../../../_images/admin-new-role.png
Role name

Give the new role a name.

Description

Brief description for the role.

Tip

Using clear and descriptive names and descriptions makes access management easier.

  1. Switch over to the Access tab and set the permissions. (See Permissions.)

  2. When all necessary information and permissions are configured, click Save.

Note

The default for new roles is General roles.

Tip

See Example role configuration: DHCP read-only for an example process for creating a role anew.

Editing a role

Through this function, you can edit the role’s name, description, permissions, and attached users/groups.

  1. Navigate to Admin ‣ Configuration and select Roles in the filtering sidebar.

  2. To select a single role, click on the role’s name. To select multiple roles, press/hold the Ctrl (Cmd on Mac) key and then click on each role’s name.

  3. From the ellipsis menu, select Edit role properties or use Actions ‣ Edit role properties.

  4. Make the desired changes to the role’s information. In the Users and Groups tabs you can remove users/groups from the role.

  5. Click Save to save the changes.

Deleting a role

Through this function, you remove a role from Micetro.

Note

Built-in roles cannot be removed.

  1. Navigate to Admin ‣ Configuration and select Roles in the filtering sidebar.

  2. To remove a single role, click on the role’s name. To remove multiple roles, press/hold the Ctrl (Cmd on Mac) key and then click on each role’s name.

  3. From the ellipsis menu, select Remove role or use Actions ‣ Remove role.

  4. To remove the role, click the Yes button. The role is removed.

Duplicating a role

It is possible to duplicate roles and copy the original’s configured permissions, users, and groups to a new role.

  1. Navigate to Admin ‣ Configuration ‣ Roles in the web application.

  2. Use the + Create –> From existing role action from the top bar.

../../../_images/duplicate-role.png
  1. Select the role to duplicate, and name the new role.

  2. Select which properties (permissions, groups, roles) to copy.

  3. Click Create.

Tip

See Example role configuration: DNS zone read-write for an example process for creating a role from an existing template.