# Users, Roles & Permissions

AutoRABIT (ARM) organizes access with **users**, **roles**, and **permissions**. Understanding these layers helps you grant just-right privileges while keeping administrative tasks manageable.

***

## Users in ARM <a href="#users-in-arm" id="users-in-arm"></a>

### Super Administrator <a href="#super-administrator" id="super-administrator"></a>

The **Super Administrator** (Super Admin) has the highest privileges in ARM.

* Create other admins
* Install and configure agents
* Add users to admin groups

> **Super Admin safeguards**\
> \&#xNAN;*Super Admin* and **the currently logged-in user** are locked for **all** user-management actions: they cannot be added, deleted, suspended, edited, or delegated.

### Org Administrators <a href="#org-administrators" id="org-administrators"></a>

**Org Administrators** (Admins) access the **Admin Dashboard** to manage users, roles, and modules. An admin can hold multiple roles; ARM always applies the most permissive combination.

Admin-level capabilities include:

* Add, edit, or delete users
* Export user lists to CSV
* Enforce SSO
* Manage roles and permissions

### General Users <a href="#general-users" id="general-users"></a>

General users work in ARM modules according to permissions their Admin assigns. They **do not** see the Admin Dashboard.

***

## Create a New User Account <a href="#create-a-new-user-account" id="create-a-new-user-account"></a>

1. Log in to ARM.
2. Go to **Admin › Users** and click **Add User**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F1yNEbVSOLMSQyKihIFbS%2Fimage.png?alt=media&#x26;token=b31a30e7-fd89-4855-946b-16740850cc52" alt="Add User button in the Users list"><figcaption></figcaption></figure>
3. Fill **User Details** and assign **Role Permissions**.
4. Choose **Save & Activate** (immediate) or **Save Now & Activate Later**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FC01z09hoP0HSZoLhYx2i%2Fimage.png?alt=media&#x26;token=cd5b2e04-d12e-42a4-9b5d-d6100d20f698" alt="User details form with role selection"><figcaption></figcaption></figure>
5. The new user receives an email to set a password.
6. The user appears in **Admin › Users**.

***

## Edit a User Account <a href="#edit-a-user-account" id="edit-a-user-account"></a>

1. In **Admin › Users**, locate the user and click **Edit**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FTU4ajTePunJTjwAbXR9S%2Fimage.png?alt=media&#x26;token=27a57df8-db4b-441b-8234-fd5573cb0d95" alt="Edit icon for user row"><figcaption></figcaption></figure>
2. Update fields (Username and Email are immutable).
3. Click **Save**.

***

## Delete or Suspend a User <a href="#delete-or-suspend-a-users-account" id="delete-or-suspend-a-users-account"></a>

* **Delete User** – permanently remove the account.

  <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FTKiqLgF8hyD0u9KHcovv%2Fimage.png?alt=media&#x26;token=abfe00f6-3e71-4052-8224-f96cb20a5ccc" alt="Trash-can icon to delete a user"><figcaption></figcaption></figure>
* **Activate / De-activate** – toggle suspension.

  <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FI0vczM6HJOeDRgIf2MJW%2Fimage.png?alt=media&#x26;token=d3be4b40-6850-4939-9890-00622e0d5a5e" alt="Activate/De-activate toggle button"><figcaption></figcaption></figure>

Confirm the action to proceed.

***

## Enforce Single Sign-On (SSO) <a href="#enforce-single-signon-sso" id="enforce-single-signon-sso"></a>

1. Open **My Account** › **SSO Configuration**.
2. Check **Disable login with AutoRABIT credentials** and click **Save**.

Admins can still log in with username/password.\
To override SSO for select users, uncheck **Enforce SSO** next to their names.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FeoUCJKVec2vANXULMcYC%2Fimage.png?alt=media&#x26;token=10cc04fd-99da-4e88-9898-d3be48fa98d8" alt="Override Enforce SSO checkboxes for selected users"><figcaption></figcaption></figure>

> When you disable standard login, **Enforce SSO** auto-checks for all users.

***

## Export Users <a href="#export-users" id="export-users"></a>

Admins can download all user data as CSV.

1. In **Admin › Users**, click **Export All Users**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FuRCD4MrwxZpBl1fHl4xP%2Fimage.png?alt=media&#x26;token=972c6618-ad1e-4900-a491-0517383dbdcd" alt="Export All Users button"><figcaption></figcaption></figure>
2. Select fields and click **Export**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FGHqGHvFppGaBxgcTrmYg%2Fimage.png?alt=media&#x26;token=ea49df43-f12b-45f6-bfa9-7e30a54c7d3d" alt="Field-selection dialog for CSV export" width="511"><figcaption></figcaption></figure>
3. A CSV downloads to your computer.

> **Location privacy** – If a user blocks location sharing, ARM uses IP-based location.

***

## Creating and Editing Roles <a href="#creating-and-editing-roles" id="creating-and-editing-roles"></a>

1. Go to **Admin › Roles**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F5n3nZXFcBdRL37JmPf6M%2Fimage.png?alt=media&#x26;token=33ebf828-77f0-4a74-9147-6f2a6b58481e" alt="Roles option in Admin menu" width="251"><figcaption></figcaption></figure>
2. Click **Create Role**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FZcjGc8BhI4i25j0aRGTQ%2Fimage.png?alt=media&#x26;token=42092b9c-9177-4b11-b005-4d16e20adca1" alt="Create Role button"><figcaption></figcaption></figure>
3. Provide a **Role Name**, **Description**, and tick permissions.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FGtIJx5dPrXLRncl8iLp5%2Fimage.png?alt=media&#x26;token=c2ede1e6-51d8-49c8-ba42-b44cafff60b9" alt="Role permissions checklist" width="563"><figcaption></figcaption></figure>
4. Click **Save**.

> *The default **Admin** role has full permissions and cannot be edited or renamed.*

***

## User Permissions <a href="#user-permission" id="user-permission"></a>

1. Open **Admin › Permissions**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FoZWM3M5joz5lt8M9Im2Q%2Fimage.png?alt=media&#x26;token=ea558829-cabc-4baa-b789-cee72edcda7c" alt="Permissions tab in Admin menu" width="251"><figcaption></figcaption></figure>
2. Select two or more users and click **Bulk Assignment**.

   <figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FUdawHQjO2LMiGDRdu0yM%2Fimage.png?alt=media&#x26;token=c0b6e116-1f66-42db-9ebb-e7360d9b9bb0" alt="Bulk Assignment button"><figcaption></figcaption></figure>

Admins are hidden on this screen because they already hold full access.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FK0DS3LDwWtwUWIVNh8T2%2Fimage.png?alt=media&#x26;token=a44bbd49-4437-41b6-a116-e3fe2e9730c2" alt="Assign roles and modules to selected users"><figcaption></figcaption></figure>

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FbPYhJkgjzOdh6xtCvufx%2Fimage.png?alt=media&#x26;token=e24a99ad-f394-466d-9657-2722009406f4" alt="Save confirmation after assigning permissions" width="563"><figcaption></figcaption></figure>

***

## FAQ

### I’m an admin but can’t see certain branches or commits.

Your ARM account may belong to a different organization than those resources.

### Why can’t I see the User Management section anymore?

Your roles/permissions were changed. Contact another Org Administrator.

### Deleted users still appear in lists.

* Their **credentials** may still exist in **Admin › Credential Manager**.
* Repositories may reference those credentials—update or re-register.

### Why do some users lack access to certain ARM features?

Check their roles in **Admin › Roles**; only Admins have unrestricted access.
