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

# 同步成员

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

## 概述

Dify 企业版支持通过 [SCIM](https://scim.cloud/)（System for Cross-domain Identity Management）标准协议自动同步现有的部门/人员结构，帮助企业管理员高效管理大规模组织人员。

* 支持标准 SCIM 2.0 协议
* 自动同步用户信息和组织结构
* 支持多种主流身份提供商集成
* 在线自动更新成员变动

## 配置前准备

启用自动同步机制前，你需要进行以下准备：

1. 获取系统管理员权限
2. 了解组织正在使用的身份提供商类型，并拥有后台管理权限

## 配置步骤

### 1. 获取 SCIM 配置信息

<Steps>
  <Step title="进入同步设置页面">
    导航至企业管理后台，点击左侧菜单栏 **成员** → **同步设置**。

    <img src="https://assets-docs.dify.ai/2025/05/764e71213cadcaa45c62c56a2dc38cbf.png" alt="同步设置界面" />
  </Step>

  <Step title="获取 SCIM 端点 URL">
    复制页面中显示的 `SCIM 2.0 Base URL`，此 URL 将用于身份提供商的配置。
  </Step>

  <Step title="生成认证令牌">
    * 点击"获取令牌"按钮
    * 系统将生成 OAuth Bearer Token

    <Warning>
      认证令牌仅显示一次，请立即复制并妥善保存。如果遗失，需要重新生成新的令牌。
    </Warning>
  </Step>

  <Step title="保存配置信息">
    将以下信息妥善保存，用于后续配置：

    * SCIM Base URL
    * OAuth Bearer Token
  </Step>
</Steps>

### 2. 配置身份提供商

根据你组织使用的身份提供商，选择相应的配置指南：

<CardGroup cols={2}>
  <Card title="Azure Active Directory" icon="microsoft" href="./azure">
    配置 Azure AD 与 Dify 的成员同步
  </Card>

  <Card title="Okta" icon="key" href="./okta">
    配置 Okta 与 Dify 的成员同步
  </Card>
</CardGroup>

**属性对应关系**

Dify 功能与身份供应商内 SCIM 字段的属性对应关系：

| SCIM 资源类型 | Dify 功能            | 支持的操作                   | 额外说明                                                  |
| --------- | ------------------ | ----------------------- | ----------------------------------------------------- |
| User      | 成员（用户邮箱、用户名称、用户状态） | 创建 / 更新 / 停用            | 停用操作不会真实删除用户数据，成员在 Dify 企业版内的状态从 `激活` 改为 `禁用`，用户数据仍保留 |
| Group     | 分组（名称、成员）          | 创建 / 更新分组名称 / 更新成员 / 删除 | 删除操作会永久移除群组及其成员关系                                     |

### 3. 启用自动同步

前往管理后台，点击**成员** → **右侧菜单按钮** → **自动同步** → **启用**按钮。

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

自动同步并非实时进行，取决于身份供应商内应用程序的自动执行日期，你可以前往应用程序设置页查看自动同步历史记录。

## 重要提示

<Info>
  启用 SCIM 同步后，为确保数据一致性，身份提供商 (IdP) 将成为用户和群组管理的唯一数据来源。系统管理员无法手动添加用户、企业级 APIs 的部分功能也将受到限制。
</Info>

### 功能限制

**启用 SCIM 时：**

* 请始终通过身份提供商 (IdP) 的管理界面来管理用户和组的生命周期（创建、更新、激活/停用、删除以及组成员关系）。
* 用户和群组管理必须通过身份提供商完成
* 企业级 APIs 仅支持只读操作，例如读取用户和组信息（GET 请求）
* 不支持成员自行注册

**禁用 SCIM 时：**

* 恢复企业级 APIs 完整操作范围

### 临时操作指南

如需通过企业级 APIs 进行临时修改，建议进行以下操作：

1. 暂时禁用 SCIM
2. 执行必要的 API 操作
3. 重新启用 SCIM 并验证同步状态

<Warning>
  此操作可能导致数据同步冲突，请谨慎执行。
</Warning>

如需查看完整的企业级 API 文档，请阅读[企业级 APIs](/zh/3.4.x/administer/admin-apis)文档。