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

# Sync Members

> Automatically sync organization members through SCIM protocol. Version ≥ v2.7.0

## Overview

Dify Enterprise Edition supports automatic synchronization of your organization's existing structure through the [SCIM](https://scim.cloud/) (System for Cross-domain Identity Management) protocol, making it easier for admins to manage large teams efficiently.

* Standard SCIM 2.0 protocol support
* Automatic user and organization structure sync
* Works with major identity providers
* Real-time member updates

## Before You Start

To enable automatic synchronization, make sure you have:

1. Dify EE system administrator permissions
2. Access to your organization's identity provider backend
3. Understanding of your current identity provider type

## Setup Guide

### 1. Get Your SCIM Configuration

**1. Open Sync Settings**

In the enterprise dashboard, go to **Members** → **Sync Settings** from the left sidebar.

![Sync Settings Interface](https://assets-docs.dify.ai/2025/05/764e71213cadcaa45c62c56a2dc38cbf.png)

**2. Copy the SCIM Endpoint**

Find and copy the `SCIM 2.0 Base URL` shown on the page. You'll need this for your identity provider setup.

**3. Create an Authentication Token**

* Click **Get Token**
* The system generates an OAuth Bearer Token

> [!WARNING]
>
> This token appears only once. Copy and save it immediately in a secure location. If you lose it, you'll need to generate a new one.

**4. Save Your Configuration**

Keep these items safe for the next steps:

* SCIM Base URL
* OAuth Bearer Token

### 2. Connect Your Identity Provider

Select your identity provider below for specific setup instructions:

> [card] [Azure Active Directory](https://enterprise-docs.dify.ai/en/3.13.x/administer/members/synchronization/azure.md)
>
> Set up member sync with Azure AD

> [card] [Okta](https://enterprise-docs.dify.ai/en/3.13.x/administer/members/synchronization/okta.md)
>
> Set up member sync with Okta

## How SCIM Maps to Dify

Here's how SCIM resources work with Dify features:

| SCIM Resource Type | Maps to Dify | What You Can Do | Notes |
| - | - | - | - |
| User | Member (email, username, status) | Create, Update, Deactivate | Deactivating changes user status to "Disabled" but keeps their data |
| Group | Group (name, members) | Create, Update, Delete | Deleting a group removes it permanently along with member relationships |

## Key Things to Know

> [!NOTE]
>
> Once you enable SCIM sync, your identity provider becomes the single source of truth for user and group management. To learn about API limitations, check out the [Admin APIs](https://enterprise-docs.dify.ai/en/3.13.x/administer/admin-apis.md) documentation.

### What Changes When SCIM is Active

**With SCIM enabled:**

* All user and group management happens through your identity provider
* Admin APIs become read-only
* Self-registration is disabled

**With SCIM disabled:**

* Full Admin API access returns
* All user management features work normally

### If You Need to Make Manual Changes

Sometimes you might need to use Admin APIs directly:

1. Temporarily turn off SCIM
2. Make your API changes
3. Turn SCIM back on and check sync status

> [!WARNING]
>
> This can cause sync conflicts. Use with caution.

For more details about Admin APIs, please check the [Admin APIs](https://enterprise-docs.dify.ai/en/3.13.x/administer/admin-apis.md) documentation.


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