Skip to main content

Administrators and auditors

Delegaris has two roles beyond what access rules give:

RoleWhat it can do
AdministratorEverything: every resource and action, accounts, access rules, approvals, activity, reports and settings
AuditorRead Activity and Reports, including the CSV downloads. Can change nothing. The role gives no access to machines

Everyone else sees only what their access rules give them.

Administrators named in the sign-in settings​

These administrators cannot be removed on the roles page, so nobody can lock everyone out:

  • The local administrator, while LOCAL_ADMIN_PASSWORD is set.
  • The groups and users named under Settings > Sign-in > Administrators, or, until the sign-in settings have been saved there, in ADMIN_GROUPS and ADMIN_USERS in the environment.

ADMIN_GROUPS and ADMIN_USERS take comma-separated names:

ADMIN_GROUPS=Delegaris-Admins
ADMIN_USERS=jsmith,jane.doe@corp.example

The same lists can be edited under Settings > Sign-in > Administrators, as Administrator groups and Administrator users, with Find… to search the directory. For Entra ID, use group object IDs. Once the sign-in settings are saved there, the saved lists replace ADMIN_GROUPS and ADMIN_USERS, and changing those in the environment no longer has any effect. To change these administrators, change the lists under Settings > Sign-in > Administrators (or, if the sign-in settings have never been saved, in the environment).

Whether someone is in one of these groups is read when they sign in. A change to their membership counts from their next sign-in.

Roles given in the web UI​

Open Settings > Access and scroll to Administrators and auditors. The table lists:

  • the administrators named in the sign-in settings (the saved Settings > Sign-in > Administrators lists, or ADMIN_GROUPS and ADMIN_USERS if those have never been saved), marked as not removable here
  • the local administrator account, if it is on
  • every role given here, with Remove

To give a role:

  1. Choose Administrator or Auditor.
  2. Choose Group or User.
  3. Type the group name or username, or use Find….
  4. Press Give role.

Changes apply at once. Nobody has to sign in again, for a new role or a removed one.

You cannot remove your own​

Remove is refused if it is the role that makes you an administrator: "That is the role that makes you an administrator. Ask another administrator to remove it." Another administrator can remove it for you.

What each role sees​

PageEveryoneAuditorAdministrator
Resources, Server groups, Bookings, ApprovalsYesYesYes
Activity, ReportsYesYes
Accounts, SettingsYes

An auditor sees only the resources their access rules give them, like anyone else. An administrator sees everything.

Administrators never need approval for anything, and are the approvers for any rule that names no approvers of its own. See Approvals.

Activity​

Giving and removing roles, and changes to the sign-in settings, are recorded in the activity log with who did it.

Next steps​