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

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

访问 Azure 管理员后台页，导航到 Applications 页，轻点 New application。 选择 Create your own application，输入应用名称例如 dify，选择 Integrate any other application you don’t find in the gallery (Non-gallery)，点击 Create。

​
2. 配置自动同步机制

  1. 在应用程序的左侧导航菜单中，选择 Provision → Get started → Connect your application。
  1. 在 Admin credentials 下，输入以下详细信息：
  • Tenant URL：SCIM 端点 URL
  • Secret token：SCIM 认证令牌
请参考同步成员获取以上信息。
  1. 点击 Test Connection 验证凭据。
测试连接前，请确保已在企业版管理后台内开启自动同步，详细说明请参考启用自动同步。
  1. 如果连接测试成功，点击”保存”。

​
3. 配置属性映射

  1. 在 Provision 页，点击 “Mappings”，你将看到两个默认映射值：
  • Provision Microsoft Entra ID Users - 用于用户同步
  • Provision Microsoft Entra ID Groups - 用于组同步
  1. 对映射条目进行如下修改：
Provision Microsoft Entra ID Users 仅保留以下参数：
customappsso 属性Microsoft Entra ID 属性
userNameuserPrincipalName
activeSwitch([IsSoftDeleted], , “False”, “True”, “True”, “False”)
displayNamedisplayName
Provision Microsoft Entra ID Groups 仅保留以下参数：
customappsso 属性Microsoft Entra ID 属性
displayNamedisplayName
membersmembers

​
4. 添加应用成员

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

​
5. 设置自动同步范围

  1. 前往应用的 Provisioning 页。
  2. 在 Settings 页，调整 Scope 以确定将同步哪些用户：
    • “仅同步已分配的用户和组”（推荐用于更小范围的成员列表）
    • “同步所有用户和组”（用于全组织部署）
  1. 点击保存应用设置。
  2. 点击开始配置开始同步过程。
开启后，自动同步并非实时进行。初始同步可能需要 20 分钟到几小时不等，取决于应用目录中的用户数量。你可以在应用程序的设置页查看自动同步历史记录。自动同步不会覆盖 Dify 企业版管理后台内已存在用户和分组数据。