适用于 Enterprise 计划。只有组织所有者可以配置目录同步。
概述
SCIM(跨域身份管理系统)2.0 将 Wave Connect 连接到您的身份提供商,使用户账户能够自动管理。当您在 IdP 中添加、更新或移除用户时,变更会自动反映到 Wave Connect 中,无需任何手动操作。 Wave Connect 提供 SCIM 的Users 和 Groups 资源,支持 GET、POST、PUT、PATCH 和 DELETE。过滤器支持单个顶层 eq 比较,这正是身份提供商通过 userName 或 externalId 查找用户时所使用的方式。
设置
1
打开目录同步
前往 设置 → 安全。在 目录同步 卡片上,点击 配置 打开 配置SCIM 弹窗。
2
复制 SCIM 端点
SCIM端点 为
https://app.wavecnct.com/api/scim。请复制它。您的身份提供商称之为租户 URL 或基础 URL。3
创建 SCIM 令牌
点击 创建令牌,为令牌命名并点击 创建。请立即复制令牌,它只会显示一次。您的 IdP 会以 Bearer 令牌的形式发送该令牌。
4
配置您的身份提供商
在您的 IdP 中,使用该端点和令牌为 Wave Connect 设置自动预配。将您的用户属性映射到下方的 SCIM 属性。
5
测试预配
在 IdP 中分配一个测试用户,验证其 Wave Connect 账户是否出现在 用户 中,且姓名、邮箱和团队均正确。
SCIM 令牌也会显示在 设置 → 安全 的 令牌 卡片上,具有 管理SCIM 范围。您可以在那里删除令牌以切断 IdP 的访问。当组织退出 Enterprise 计划时,令牌会被自动删除。
身份提供商指南
Microsoft Entra ID
企业应用程序设置、属性映射和离职处理的分步指南。
Okta 和 Google Workspace
按照本页的通用步骤操作。将端点用作基础 URL,将令牌用作 Bearer 令牌。
属性映射
Wave Connect 从 SCIMUser 资源中读取以下属性:
电话号码会经过验证并以国际格式存储。无效值和仅含分机号的占位符会被丢弃,而不会导致请求失败。Wave Connect 不支持的
locale 会回退为英语。
企业扩展属性 department 不会存储在个人资料中。基于部门的团队分配可由 Wave Connect 支持团队启用。
创建用户时,如果该邮箱已属于您组织的某个成员,则会更新该现有成员。如果该邮箱属于您的已验证域名之一上的个人 Wave Connect 账户,该账户会被移入您的组织并保留,包括其名片和联系人。
团队映射
启用 SCIM 后,身份提供商中的组会作为团队同步到 Wave Connect。例如,在 Microsoft Entra ID 中分配给 Wave Connect 应用程序的组会自动在 Wave Connect 中创建为团队。分配给组的成员会被添加到对应的团队中。 组的displayName 成为团队名称,组的 externalId 存储在团队上。如果已存在同名团队,该组会合并到其中。一个用户只属于一个团队,因此如果用户属于多个组,以最后预配的组为准。一个组织最多可拥有 75 个团队。删除组会删除团队,其用户会被保留,其联系人会转移到组织。
这样您就可以直接从 IdP 管理您的 Wave Connect 团队结构,无需在 Wave Connect 中手动设置团队。
每个 Wave Connect 团队可以分配不同的模板,因此不同组的用户会自动获得适合其部门或角色的正确名片布局、品牌设计和锁定字段。详情请参阅模板。
取消预配
当用户在 IdP 中被从 Wave Connect 应用程序取消分配时,IdP 会将active 设为 false。Wave Connect 会停用该账户:
- 用户无法再登录,其会话会被撤销。
- 用户会在 用户 中显示
SUSPENDED标记。 - 其 NFC 名片保持关联,个人资料和联系人会被保留。
- 在被删除之前仍然占用一个席位。
active 重新设为 true(例如重新分配该用户)会重新激活该账户。
当您的 IdP 发送 DELETE 请求时,Wave Connect 会永久删除该用户:其个人资料和联系人会被移除,其 NFC 名片会解除关联,以便分配给其他人。
某些身份提供商(如 Microsoft Entra ID)会在永久删除前将用户账户暂停 30 天作为宽限期。默认情况下,Wave Connect 遵循此行为,在此期间停用账户。要跳过宽限期,请打开 设置 → 安全 → 目录同步 → 配置 并启用 立即删除用户而不是暂停。此后,停用会立即永久删除该用户。