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

# 目录同步（SCIM）

> 通过身份提供商自动化用户预配和取消预配

<Info>
  适用于 **Enterprise** 计划。
</Info>

## 概述

SCIM（跨域身份管理系统）2.0 将 Wave 连接到您的身份提供商，使用户账户能够自动管理。当您在 IdP 中添加、更新或删除用户时，Wave 中的变更无需任何手动操作即可同步。

## 设置

<Steps>
  <Step title="前往 设置 → 安全 → SCIM">
    在您的 Wave 管理员仪表板中打开 SCIM 配置面板。
  </Step>

  <Step title="复制 SCIM 端点">
    页面会显示您的 SCIM 端点 URL，请复制，您将在身份提供商中用到它。
  </Step>

  <Step title="创建 SCIM 令牌">
    点击 **创建令牌** 生成具有 SCIM 访问权限的 Bearer 令牌。立即复制，该令牌仅显示一次。
  </Step>

  <Step title="配置您的身份提供商">
    在您的 IdP 中，使用 SCIM 端点和您创建的令牌设置自动预配。将用户属性映射到 Wave 的架构（详见下方）。
  </Step>

  <Step title="测试预配">
    在 IdP 中分配一个测试用户，验证其 Wave 账户是否正确创建。
  </Step>
</Steps>

## 属性映射

在您的身份提供商中映射以下属性以填充 Wave 用户资料：

| SCIM 属性     | Wave 字段 |
| ----------- | ------- |
| givenName   | 名字      |
| familyName  | 姓氏      |
| email       | 账户邮箱    |
| title       | 职位      |
| department  | 部门      |
| phoneNumber | 电话      |

## 团队映射

启用 SCIM 后，身份提供商中的群组会作为团队同步到 Wave。例如，在 Microsoft Entra ID 中分配给 Wave 应用的群组会自动在 Wave 中创建为团队，分配给群组的成员也会被添加到对应的团队中。

这样您就可以直接从 IdP 管理您的 Wave 团队结构，无需在 Wave 中手动设置团队。

每个 Wave 团队可以分配不同的模板，因此不同群组的用户会自动获得适合其部门或角色的正确名片布局、品牌设计和锁定字段。详情请参阅[模板](/templates/overview)。

## 取消预配

当用户从 IdP 中的 Wave 应用中移除时，其 Wave 账户将被**停用**（而非永久删除）。其 NFC 名片将解除关联，个人资料将不再可访问，但联系人和数据会被保留。如有需要，账户可以重新激活。

<Info>
  某些身份提供商（如 Microsoft Entra ID）会在永久删除前将用户账户暂停 30 天。默认情况下，Wave 遵循此行为，在此期间停用账户。您可以在 **设置 → 安全 → SCIM** 中启用 **立即删除用户而非暂停** 来更改此设置。
</Info>