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

# SCIM Setup with Azure Active Directory

> Configure SCIM provisioning with Azure AD to automatically sync users and roles with Amplify.

## Overview

SCIM (System for Cross-domain Identity Management) enables automatic user provisioning and deprovisioning between Azure Active Directory and Amplify.

This guide walks you through setting up SCIM provisioning using Azure AD.

***

## Create Enterprise Application in Azure

1. Go to **Azure Portal → Azure Active Directory → Enterprise Applications**

<Frame>
  <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/1.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=a831eebae0da4bc255c4ccd52932310c" alt="1" width="1055" height="296" data-path="images/1.png" />
</Frame>

1. Click **+ New Application**
2. Select **Create your own application**
3. Enter a name (e.g., *“Your App SCIM Provisioning”*)
4. Choose:
   > **Integrate any other application you don’t find in the gallery**
5. Click **Create**

***

## Configure SCIM Provisioning

<Frame>
  <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/2.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=03b18d4ef625bdac2e87c56f5f8bb96d" alt="2" width="1502" height="638" data-path="images/2.png" />
</Frame>

1. Open the created enterprise application
2. Navigate to **Provisioning** → Click **Get started**
3. Set **Provisioning Mode** to `Automatic`

### Enter the following details:

* **Tenant URL**

[https://api.amplify.xyz/api/scim/azure](https://api.amplify.xyz/api/scim/azure)

* **Secret Token**

Amplify credentials

<Warning>
  Credential format matters Make sure the Secret Token follows the exact format:\
  `{{email:password}}`
</Warning>

4. Click **Test Connection**

* You should see: **“Connection successful”**\
  \\
  <Frame>
    <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/4-1.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=af64318ca75f734575dcc09835f34dcf" alt="4" width="349" height="95" data-path="images/4-1.png" />
  </Frame>

5. Set **Scope**:

* `Sync only assigned users and groups`\\
  <Frame>
    <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/5.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=2dcd9154e27c66ebc82ef9c5d7808510" alt="5" width="1434" height="928" data-path="images/5.png" />
  </Frame>

6. Click **Save**

***

## Assign Users

To assign users for provisioning:

1. Go to **Users** in the application
2. Click **+ Add user**\
   \\
   <Frame>
     <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/6.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=018eebef493182206340bd2177627b7a" alt="6" width="1400" height="454" data-path="images/6.png" />
   </Frame>

### Important\\

\\

<Frame>
  <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/7.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=a8831ab8e22b8c7bf05d6ff1fe6c3df9" alt="7" width="930" height="657" data-path="images/7.png" />
</Frame>

<Info>
  Role mapping Add a **Department** for the user to manage roles in Amplify.\
  Ensure a role with the same name exists in Amplify.
</Info>

3. Select users to provision to your application
4. Click **Assign**\
   \\
   <Frame>
     <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/image-17.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=2326153c0292dee59eaddf0c9166052b" alt="Image" width="1512" height="342" data-path="images/image-17.png" />
   </Frame>

***

## Enable and Monitor Provisioning

1. Go to **Provisioning**
2. Set **Provisioning Status** to `On`
3. Click **Save**

***

## What Happens Next

* Azure will begin syncing users automatically
* Sync runs approximately every **40 minutes**
* Users and role mappings will be reflected in Amplify\
  \\
  <Frame>
    <img src="https://mintcdn.com/ifax/Cjt9fpBb8RQjHWXg/images/9-1.png?fit=max&auto=format&n=Cjt9fpBb8RQjHWXg&q=85&s=d9b983dc4dce3ee560f95bd5b3f488cc" alt="9" width="1466" height="834" data-path="images/9-1.png" />
  </Frame>
