跳转到主要内容
SCIM 预配适用于 Enterprise 计划。目录集成（Microsoft Graph）适用于 Teams 和 Enterprise 计划。两者均为组织级功能，由管理员配置。
将 Microsoft Entra ID（原 Azure Active Directory）连接到 Wave Connect 有两种方式。两者都会根据您的目录创建并更新 Wave Connect 用户，区别在于同步哪些用户、离职处理方式以及连接依赖什么来保持有效。

我应该选择哪一种？

SCIM 预配是 Microsoft 推荐的让应用与 Entra ID 保持同步的方式。仅在使用 Teams 计划或只需一次性导入时选择 Graph 集成。

设置 SCIM 预配

1

在 Wave Connect 中创建 SCIM 令牌

前往 设置 → 安全，找到 目录同步 卡片。点击 配置 打开 配置SCIM 弹窗。复制 SCIM端点（https://app.wavecnct.com/api/scim），然后点击 创建令牌。为令牌命名并点击 创建。请立即复制令牌，它只会显示一次。
2

创建企业应用程序

在 Microsoft Entra 管理中心，前往 企业应用程序 → 新建应用程序 → 创建你自己的应用程序。输入名称（例如 “Wave Connect”），选择 集成库中找不到的任何其他应用程序（非库），然后点击 创建。
3

输入 SCIM 凭据

打开新建的应用程序，前往 预配 → 开始使用。将 预配模式 设置为 自动。在 管理员凭据 下，将 SCIM 端点粘贴到 租户 URL，将令牌粘贴到 密码令牌。点击 测试连接，然后点击 保存。
4

检查属性映射

在 映射 下，打开 Provision Microsoft Entra ID Users 并与下表对照。Entra 的默认值已覆盖大多数行，您只需编辑主邮箱、locale 和 externalId 三行。如果希望 Entra 组成为 Wave Connect 团队，请保持 Provision Microsoft Entra ID Groups 启用。
5

分配用户和组

前往 用户和组，分配需要拥有 Wave Connect 账户的人员和组。只有已分配的用户才会被预配。
6

开始预配

回到 预配，将 预配状态 设置为 开并点击 保存，或点击 开始预配。Entra 会先运行一次初始周期，之后约每 40 分钟运行一次增量周期。如需立即检查单个用户而不等待，请使用 按需预配。

属性映射

Wave Connect 读取以下 SCIM 属性。Wave Connect 字段 列显示每个值的落点。
Entra 的默认映射已经覆盖 userName、name.givenName、name.familyName、title、电话号码、addresses[type eq "work"].locality 和 active。只有三行需要编辑：确保工作邮箱映射将 primary 设为 True，将 preferredLanguage 的目标从 preferredLanguage 改为 locale，并将 externalId 的来源从 mailNickname 改为 objectId。
关于映射的其他说明：
  • 电话号码会经过验证并以国际格式存储。占位符和仅含分机号的值会被丢弃，而不会导致同步失败。
  • 将 roles[].value 设为 USER、ADMIN 或 OWNER（大写）可设置组织角色。Entra 默认不发送角色，因此新用户会以普通用户身份创建。
  • 企业扩展属性 department 不会存储在个人资料中。基于部门的团队分配可由 Wave Connect 支持团队启用。
  • locale 的值必须是 Wave Connect 支持的语言之一，否则用户将使用英语。

组成为团队

启用组预配后，分配给该应用程序的每个 Entra 组都会成为一个 Wave Connect 团队。组的 displayName 成为团队名称，组的 objectId 存储为团队的外部 ID。如果 Wave Connect 中已存在同名团队，该组会合并到其中。 一个 Wave Connect 用户只属于一个团队。如果用户属于多个已分配的组，以 Entra 最后预配的组为准。一个组织最多可拥有 75 个团队。在 Entra 中删除组会删除 Wave Connect 中的对应团队，其用户会被保留，其联系人会转移到组织。 每个团队可以使用不同的模板，因此不同组的用户会自动获得正确的名片布局、品牌设计和锁定字段。请参阅模板。

离职处理

当用户在 Entra 中被取消分配、禁用或软删除时，预配服务会发送 active = false。Wave Connect 会停用该用户：
  • 用户无法再登录，其会话会被撤销。
  • 用户会在 用户 中显示 SUSPENDED 标记。
  • 其 NFC 名片、个人资料和联系人会被保留。
  • 仍然占用一个席位。
Entra 会将软删除的用户保留 30 天，然后发送删除请求。此时 Wave Connect 会永久移除该用户，删除其个人资料和联系人，并解除其 NFC 名片的关联，以便分配给其他人。 如果您不需要 30 天宽限期，请打开 设置 → 安全 → 目录同步 → 配置 并启用 立即删除用户而不是暂停。此后，停用会立即永久删除该用户。 要恢复已停用的用户，请在 Entra 中将其重新分配给该应用程序。下一个预配周期会发送 active = true 并重新激活该账户。
您可以在同一个企业应用程序上启用单点登录。请参阅单点登录（SAML）。

目录集成（Microsoft Graph）

目录集成使用管理员账户，通过 Microsoft Graph API 将 Wave Connect 连接到您的租户。它比 SCIM 更容易设置，但会同步整个租户，并且依赖于建立连接的那个账户。

连接方式

有两个入口。它们创建的是同一个集成，但 用户同步（自动应用目录变更的开关）的默认值不同。
  1. 前往 集成 → Microsoft Entra ID 并点击 安装应用。
  2. 保持 自动从Microsoft Entra ID导入新用户 开启；如果只需要手动导入，可将其关闭。点击 继续。
  3. 使用能够在租户上授予管理员同意的 Microsoft 账户登录，并接受同意提示。
开启该开关后，随着变更通知的到达，租户中的每个用户都会在 Wave Connect 中创建，后续变更也会自动应用。该开关在集成的 设置 中显示为 用户同步。
开启 用户同步 后，此集成会为租户中的每个用户（包括来宾）添加一个 Wave Connect 用户和一个席位。无法将其限制在某个组内。

权限

Wave Connect 在建立连接的管理员账户上请求委托范围 openid、offline_access、profile、User.Read.All 和 Directory.Read.All。Wave Connect 只读取目录，绝不会向 Entra 写入。 该集成使用该管理员的刷新令牌运行。如果令牌被撤销（例如该管理员离职、其密码被重置并撤销会话，或条件访问策略阻止了刷新），Wave Connect 会删除该集成，需要管理员重新连接。

同步内容

同步方向：Entra ID → Wave Connect（仅入站）。 个人头像仅在手动导入或预览时获取，并以副本形式存储在 Wave Connect 中。由 用户同步 创建的用户不会获得头像。

用户同步与停用

连接后，Wave Connect 会订阅 Microsoft Graph 的用户变更通知（创建、更新、删除）。订阅有效期为三天，并会根据 Graph 生命周期通知自动续订。用户同步 关闭时，通知会被忽略。 当用户在 Entra 中被删除，或其账户被禁用（accountEnabled = false）时，Wave Connect 会将其停用：登录被阻止，用户在 用户 中显示 SUSPENDED 标记，其名片、个人资料和联系人会被保留。该用户仍然占用一个席位。在 Entra 中重新启用账户不会在 Wave Connect 中重新激活该用户。请联系 support@wavecnct.com 重新激活用户，或在 用户 中将其删除。

限制

  • 同步整个租户，包括来宾。不支持按分配范围限定。
  • 不同步 Entra 组和部门。团队必须在 Wave Connect 中管理。
  • 由 用户同步 创建的用户没有头像。
  • 连接依赖于单个管理员账户，当该账户的令牌被撤销时连接会被移除。
  • 该集成绝不会删除用户，只会停用。

断开连接

前往 集成 → Microsoft Entra ID → 设置 并点击 断开连接。这会删除 Wave Connect 中存储的连接。Microsoft 端不会撤销任何内容，Graph 订阅会在三天内自行过期。现有 Wave Connect 用户会被保留，但不再更新。要在 Microsoft 端移除 Wave Connect 的访问权限，请在 Entra 管理中心撤销该企业应用程序的同意。

同时使用两者

SCIM 和 Graph 集成可以同时启用。在这种情况下，通过 SCIM 预配的用户会从 Graph 连接获取个人头像，按邮箱匹配。 使用 SCIM 时，请保持 Graph 集成的 用户同步 关闭。开启后，Graph 集成会创建租户中的每个用户，从而绕过您在企业应用程序中设置的分配范围。

故障排除

请检查 租户 URL 是否精确为 https://app.wavecnct.com/api/scim（末尾不带斜杠），以及 密码令牌 是否为 配置SCIM 弹窗中的完整令牌。令牌只能在创建时复制，如果丢失，请创建一个新令牌。当组织退出 Enterprise 计划时，令牌会被删除。
Entra 以约 40 分钟为周期进行预配。对该用户使用 按需预配 可立即推送，并在 预配日志 中查看结果。请求失败通常意味着缺少必填属性：name.givenName、name.familyName，或更新时缺少主邮箱。
使用 SCIM 时，用户必须分配给该应用程序。如果用户已被取消分配，请重新分配，Entra 会发送 active = true。使用 Graph 集成时，重新启用绝不会重新激活用户。请联系 support@wavecnct.com 重新激活。
当 SCIM 创建的用户邮箱已属于某个个人（非组织）Wave Connect 账户，且该邮箱域名是您的已验证域名之一时，该账户会被移入您的组织并更新，而不会创建新账户。其现有名片和联系人会被保留。请在预配之前验证域名，这样这些账户会被迁移而不是重复创建。
使用 SCIM 时，登录邮箱是主邮箱，推荐的映射从 mail 获取。使用 Graph 集成时，登录邮箱是 userPrincipalName（来宾为 mail）。如果用户的 mail 和 UPN 不同，请改为在 Entra 中将 userPrincipalName 映射到主邮箱，使两种方式保持一致。