Manage users and roles
What a person can do in Excubius depends on the role they hold on each entity. You manage access under Settings › Users and roles, for the entity chosen in the picker and everything below it. This guide shows how to invite people, give and remove roles, map directory groups and deactivate accounts.
Before you begin
- You need the Entity admin role on the branch you manage. The page shows only the people, roles and invitations of the branches you administer.
- Sign-in with Microsoft Entra ID or Google is set up. There is no password to hand out. See Set up sign-in providers.
- People appear in the lists after their first sign-in. To give access to someone who has never signed in, invite them.
Roles and the limits on giving them
A role is given on an entity and applies to that entity and everything below it. On any entity a person's effective role is the highest one found there and on its ancestors, counting their own roles and those of their directory groups.
| Role | Can |
|---|---|
| Viewer | Read dashboards, alerts and resource detail; change their own settings |
| Operator | Everything a viewer can, plus acknowledge, silence, assign and resolve alerts, create Jira issues and start maintenance windows |
| Editor | Everything an operator can, plus change checks and thresholds and accept security risks |
| Entity admin | Everything an editor can, plus manage the branch's entities, resources, credentials, users, roles, invitations, registration, Slack channels and status page |
| Super admin | Everything, everywhere, including the instance and server settings |
When you give a role:
- You give it only on entities where you are Entity admin, on the entity itself or an ancestor.
- You never give a role above your own on that entity. An entity admin can make another entity admin, not a super admin.
- Only a super admin gives Super admin, and only on the root entity.
- The last super admin cannot be removed.
Invite someone
- Open Settings › Users and roles and choose the entity in the picker, for example Ciguapa Inc..
- Select the Invitations tab, then Invite someone.
- Enter the E-mail address, the Entity and the Role, for example
bo.diaz@ciguapa.example, Ciguapa Inc. › Production and Operator. - In Valid for (days), keep 7 or enter from 1 to 90.
- Select Create invitation. The Invitation link appears.
- Select Copy and send the link to the person through your usual channel. Excubius does not send e-mail.
The link is shown only once: Excubius stores a fingerprint of it, not the link itself. The person opens it, signs in with the account of that address and has the role at once. Until then the invitation is listed under Pending invitations with its expiry.
To cancel an invitation that has not been used, select the trash icon next to it, Revoke the invitation for that address.
Give a role to a person
Use this for someone who has already signed in at least once.
- In Settings › Users and roles, select the Role assignments tab.
- Under Give a role, set To to A person and choose them under Person.
- Choose the Entity and the Role. The list never offers a role above your own on that entity.
- Select Give role.
The role applies from the person's next request.
Give a role to a directory group
Roles for directory groups are part of the Enterprise plan. The option appears when the feature access.directory_groups is on.
Members of a Microsoft Entra ID group get the role through the groups in their sign-in token. The app registration must send the groups claim; see Register Excubius in Microsoft Entra ID.
- In the Microsoft Entra admin center, copy the group's Object ID.
- In Settings › Users and roles, select the Role assignments tab.
- Under Give a role, set To to A directory group.
- In Group, enter
entra:followed by the object ID, for exampleentra:3f2b9c41-7d5e-4a8b-9c6d-1e2f3a4b5c6d. Group names do not work. - Choose the Entity and the Role, then select Give role.
Members get the role from their next sign-in. The People tab shows such a role with via group.
| Change in the directory | When it takes effect in Excubius |
|---|---|
| Someone joins the group | At their next sign-in |
| Someone leaves the group | At their next sign-in. A session lasts up to 14 days without a new sign-in, so to cut access at once, also deactivate the person |
| The person belongs to more than 200 groups | Entra ID sends no groups, and the person gets no role through any group. Use Groups assigned to the application, or give the role to the person directly |
Change or remove a role
A person or a group has one role assignment per entity.
- In Settings › Users and roles, select the Role assignments tab.
- Find the assignment and select the remove icon next to it, Remove the role of that person or group.
- To change the role, give the new one as described above.
Removing a role takes effect on the person's next request. A role that came from an allowed-domain registration is not given back at their next sign-in.
Deactivate a person
Deactivating ends a person's access at their next request, without deleting their account or history.
- In Settings › Users and roles, select the People tab and find the person. Search by name or address if the list is long.
- In the Active column, switch them off.
To restore access, switch Active on again. Nobody can deactivate themselves. You can deactivate only people whose roles all lie inside the branches you administer and are not above your own.
A deactivated person who tries to sign in sees that their account is deactivated and that an administrator must activate it again.