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

# Azure

> 通过 SCIM 标准自动同步组织成员。版本号 ≥ v2.7.0

本篇文档将以 Azure Entra ID 为例，演示如何与 Dify 企业版内的 SCIM 服务建立连接，启用成员自动同步机制。

### 1. 在 Azure 中创建新的应用程序

访问 Azure 管理员后台页，导航到 Applications 页，轻点 New application。

![](https://assets-docs.dify.ai/2024/11/4f52715ff661e6c9430af09b4b2a4736.png)

选择 **Create your own application**，输入应用名称例如 dify，选择 **Integrate any other application you don't find in the gallery (Non-gallery)**，点击 Create。

![](https://assets-docs.dify.ai/2024/11/b823ecfaa94d18ba0ac794cc0290dc7f.png)

### 2. 配置自动同步机制

1. 在应用程序的左侧导航菜单中，选择 **Provision → Get started → Connect your application**。

![](https://assets-docs.dify.ai/2025/05/f890065efeb5390dcb43e7e7d1c1f5b8.png)

2. 在 Admin credentials 下，输入以下详细信息：

* Tenant URL：SCIM 端点 URL
* Secret token：SCIM 认证令牌

> 请参考[同步成员](/zh/3.7.x/administer/members/synchronization/sync-team-members)获取以上信息。

![](https://assets-docs.dify.ai/2025/05/03f1e586bc428538d80b6f5316a293df.png)

3. 点击 **Test Connection** 验证凭据。

> 测试连接前，请确保已在企业版管理后台内开启自动同步，详细说明请参考[启用自动同步](/zh/3.7.x/administer/members/synchronization/sync-team-members#3-启用自动同步)。

4. 如果连接测试成功，点击"保存"。

### 3. 配置属性映射

1. 在 Provision 页，点击 "Mappings"，你将看到两个默认映射值：

* `Provision Microsoft Entra ID Users` - 用于用户同步
* `Provision Microsoft Entra ID Groups` - 用于组同步

2. 对映射条目进行如下修改：

**Provision Microsoft Entra ID Users**

仅保留以下参数：

| customappsso 属性 | Microsoft Entra ID 属性                                        |
| --------------- | ------------------------------------------------------------ |
| userName        | userPrincipalName                                            |
| active          | Switch(\[IsSoftDeleted], , "False", "True", "True", "False") |
| displayName     | displayName                                                  |

**Provision Microsoft Entra ID Groups**

仅保留以下参数：

| customappsso 属性 | Microsoft Entra ID 属性 |
| --------------- | --------------------- |
| displayName     | displayName           |
| members         | members               |

### 4. 添加应用成员

将 Azure 组织内的成员与分组添加该应用程序内。选择应用程序左侧的 **Users and groups**，点击 **Add user/group**。

![](https://assets-docs.dify.ai/2024/11/ed3c6f5de21c75e2261bf05d055ffb9e.png)

### 5. 设置自动同步范围

1. 前往应用的 **Provisioning** 页。

2. 在 **Settings** 页，调整 **Scope** 以确定将同步哪些用户：

   * "仅同步已分配的用户和组"（推荐用于更小范围的成员列表）
   * "同步所有用户和组"（用于全组织部署）

![](https://assets-docs.dify.ai/2025/05/489e8b8f4091d53ab699ec33199d57a4.png)

3. 点击**保存**应用设置。
4. 点击**开始配置**开始同步过程。

<Note>
  开启后，自动同步并非实时进行。初始同步可能需要 20 分钟到几小时不等，取决于应用目录中的用户数量。你可以在应用程序的设置页查看自动同步历史记录。

  自动同步不会覆盖 Dify 企业版管理后台内已存在用户和分组数据。
</Note>