> ## Documentation Index
> Fetch the complete documentation index at: https://docs.barndoor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Users and Groups

> How to add users to Barndoor and organize them into groups.

## Overview

Users and groups decide who can reach your MCP servers and LLMs through Barndoor. Groups let you grant access to many people at once: attach a group to an Access Control Center policy, and its membership decides who gets access. You can keep users and groups in sync from your identity provider (IdP) with SCIM, or manage them directly in Barndoor.

Users live under **Identity > Users** and groups under **Identity > Groups** in the Barndoor admin console.

## Recommended: Sync Users and Groups with SCIM

For most organizations, the best way to manage Barndoor users and groups is to provision them from your identity provider with SCIM. Your IdP stays the single source of truth, and Barndoor follows it automatically:

* **New hires get access automatically.** Users assigned to the Barndoor app in your IdP are created in Barndoor.
* **Deactivated users lose access automatically.** Users who are unassigned or deactivated in the IdP are deprovisioned in Barndoor.
* **Groups stay current.** Groups you push from the IdP appear on the **Groups** page with an **IdP** source badge, and membership changes sync with them.
* **Policies follow your org chart.** Because IdP groups can be attached to Access Control Center policies, access changes when someone changes teams in the IdP.

Setup steps depend on your IdP:

* [Connect Okta as your IdP](https://docs.barndoor.ai/how-tos/okta-oin-setup.md): see **Step 3: Configure SCIM Provisioning** and **Step 4: Assign Users and Groups**.
* [Connect Microsoft Entra ID as your IdP](https://docs.barndoor.ai/how-tos/entra-idp-setup.md): see **Part 3 — SCIM provisioning**.

> [!NOTE]
>
> When **SSO Enforcement** is enabled, users are managed in your identity provider, not in Barndoor. The **Invite Team Members** button is not available. IdP groups can never be edited in Barndoor but you can still create native groups (see [Managing Groups](#managing-groups)).

## Adding Users

If you aren't using SCIM, add people to Barndoor by inviting them from the **Users** page. Each invitee gets an email and creates their own account.

### The Users page

Navigate to **Identity > Users**. Four summary cards sit above the user list:

* **Total Users**: everyone in the organization, with the number currently active.
* **Barndoor Platform Admins**: users who hold the admin role.
* **Pending Invitations**: invitations not yet accepted, with the number that have expired.
* **Monitored Actions (30d)**: policy evaluations over the last 30 days.

Use **Search users** to find someone by name or email, and the **All Users** filter to narrow the list. Each row shows:

### Inviting team members

1. On the **Users** page, click **Invite Team Members** at the top right.
2. In the **Invite Team Members** dialog, enter each invitee's **First name**, **Last name**, and work email.
   * Click **+ Add another team member** to add more rows and invite several people at once.
   * Click the trash icon next to a row to remove that invitee before sending.
3. Click **Send Invites**.

The new users appear in the list with an **Invited** status until they accept.

> [!TIP]
>
> A user's Invitation Status may show **Invited** or **Invitation expired** for people who haven't accepted yet, with a **Resend invite** link. If an invitation shows **Invitation expired**, click **Resend invite** under the status to send a fresh one. The status changes back to **Invited**.

## Managing Existing Users

Manage a user from the row menu (three dots) at the end of their row on the **Users** page.

### Viewing user details

Choose **View Details** to open the user's page. It summarizes what the user has done through Barndoor over a selectable time range (for example, **30d**):

* **Monitored Actions**: total, allowed, and denied policy decisions, with a trend chart.
* **Activity Log**: a searchable list of requests, showing the AI agent, MCP server, status, and policy for each.
* **AI Agent Access**: the AI clients the user has connected, such as Claude or ChatGPT.
* **MCP Server usage**: requests per MCP server and the user's top actions.
* **Barndoor Platform Role**: the user's roles, with a **Remove Admin** button for admins.

### Assigning or removing the admin role

Admins manage AI governance in Barndoor, so give the role only to trusted team members.

**To make a user an admin:**

1. On the **Users** page, open the row menu for the user.
2. Choose **Assign Admin Role**.

The user's **Roles** column shows an **admin** badge, and the **Barndoor Platform Admins** count goes up by one.

**To remove the admin role**, do one of the following:

* On the **Users** page, open the row menu for the user and choose **Remove Admin Role**.
* On the user's details page, find the **Barndoor Platform Role** card and click **Remove Admin**.

The user becomes a standard user and their **Roles** column shows **None**.

> [!NOTE]
>
> Admin access may also be automatically assigned to users if you map admin access through an IdP group (see [Send IdP Groups to Barndoor](https://docs.barndoor.ai/how-tos/idp-setup.md#send-idp-groups-to-barndoor)).

### Deactivating a user

Deactivating a user removes their access to Barndoor immediately. Their account is kept, so you can restore them later.

1. On the **Users** page, open the row menu for the user.
2. Choose **Deactivate user**.
3. In the **Deactivate user** dialog, type `deactivate` to confirm.
4. Click **Deactivate user**.

The user stays in the list, dimmed, with a **Deactivated by admin** badge next to their name.

> [!NOTE]
>
> If you use SCIM, deactivate or unassign the user in your identity provider instead. Barndoor deprovisions them automatically.

### Restoring a user

Restoring a deactivated user gives them back their access. They must set a new password before they can sign in again.

1. On the **Users** page, find the user. Deactivated users are dimmed and marked **Deactivated by admin**.
2. Open the row menu for the user and choose **Restore user**.
3. In the **Restore user** dialog, type `restore` to confirm.
4. Click **Restore user**.

The user receives an email to set a new password. Once they do, they can sign in again.

## Managing Groups

Groups let you organize users into named sets so you can grant access to many people at once. Attach a group to an Access Control Center policy, and its membership decides who gets access.

### Understanding group types

Barndoor has two kinds of group. Both appear on the **Groups** page, marked by a **Source** badge.

| | Native groups | IdP groups |
| - | - | - |
| **Created by** | An admin in Barndoor | SCIM sync from your identity provider |
| **Source badge** | **Native** | **IdP/SCIM** |
| **View members in Barndoor** | Yes | Yes |
| **Edit in Barndoor** | Yes | No, manage them in your IdP |

The rest of this section covers native groups. To manage IdP groups, see [Recommended: Sync Users and Groups with SCIM](#recommended-sync-users-and-groups-with-scim).

### The Groups page

Navigate to **Identity > Groups**. Three summary cards sit above the list: **Total Groups**, **Native Groups**, and **IdP Groups**.

Use **Search groups** to filter the list by name. Each row shows:

* **Group**: the group name. Select a row to open its details.
* **Members**: the number of users in the group.
* **Source**: a **Native** or **IdP** badge.
* **Last Updated**: the date and time of the last change.
* The row menu (three dots): **View Details**, **Edit Group**, and **Delete Group**.

### Creating a group

1. On the **Groups** page, click **Create Group** at the top right.
2. In the **Create Group** dialog, enter a **Name** (required) and, optionally, a **Description**.
3. Click **Create**.

The group appears in the list with 0 members and a **Native** source badge. Next, add members.

### Adding members to a group

1. Open the group: select its row, or choose **View Details** from the row menu.
2. Click **Add Members**.
3. Search for users by name or email, and select one or more. Selected users appear as chips at the top of the dialog.
4. Click the confirm button, which shows the count (for example, **Add 3 members**).

The group details page shows the group name, source badge, member count, and a member table with **User**, **Groups**, and **Roles** columns. A new group shows "No data to display" until you add members.

### Removing members from a group

1. Open the group's details page.
2. Find the user in the member table. Use the search box or the **All Members** filter to narrow the list.
3. Open the row menu (three dots) and choose **Remove from Group**.

This removes the user from this group only. Their account and other group memberships are unchanged.

### Editing or deleting a group

**Edit Group** and **Delete Group** are available from the row menu on the **Groups** page and from the three-dot menu next to **Add Members** on the group details page.

> [!WARNING]
>
> Use caution when deleting. When you delete a group, references to it in any access policies are automatically removed.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.