# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://knowledgebase.autorabit.com/product-guides/arm/arm-administration/user-management/users-roles-and-permissions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
