Webex Cloud-Connected UC 目录服务支持

您可以将用户从云 Active Directory（例如 Microsoft Entra ID）同步并管理到本地或云托管的 UC 基础结构，例如具有 Cisco Unified Communications Manager（Unified Communications Manager）和 Cisco Unity Connection（Unity Connection）与 WebexCloud-Connected UC 目录服务。 在同步期间，系统会从同步到 Webex 通用标识服务的 Entra ID（或类似的云目录服务）导入用户和关联用户数据的列表。 您必须从 Control Hub 中选择需要同步的 Unified CM 群集，选择相应的 Unified CM 用户 ID 字段映射，然后选择所需的同步协议以执行同步。

激活目录服务

您必须为云连接 UC 中的每个群集激活目录服务 Webex 以允许将用户从云同步和管理到 Unified Communications Manager。

默认情况下，不会为所有已载入的集群启用目录服务。
1

从 Control Hub 中的客户视图，转至 服务 > Connected UC。 在 UC 管理卡上，单击 清单。

将显示集群组的列表，其中包含说明、状态、集群和节点。

2

单击 节点所属集群组旁边的详细信息 。

将显示清单页面，其中列出了属于所选集群组的集群的列表。

3

单击 特定产品节点所属的集群旁边的详细信息 。

将显示节点名称以及版本、产品和状态。

4

单击事件历史记录旁边的省略号 ⋮ 图标，然后选择 服务管理。

出现“服务管理”页面，其中包含服务列表。

5

使用切换按钮启用 目录服务。

6

单击提交。

目錄服務

目錄服務

使用目录服务卡将用户从基于云的目录同步到 Unified Communications Manager。

1

从 Control Hub 中的客户视图，转至 服务>连接的 UC。

2

在目录服务卡上，单击 查看群集。 此时将显示“目录服务”页面。

您可以在该页面上查看集群详情列表。

查看群集详细信息

查看群集详细信息

从目录服务的集群选择页面中，选择要将用户数据同步到的集群。

集群选择页面还提供集群详细信息、预配置状态、上次同步状态、关联的产品以及失败原因（如果有）。 您可以选择本地时区；缺省情况下，选择浏览器时区。

群集详细信息

说明

群集名称

群集的名称。

状态

同步状态。

上次同步时间

上次同步的日期。

产品

产品的详细信息。
设置目录服务同步

Webex Cloud-Connected UC 目录服务同步允许您将最终用户数据从通用标识服务导入 Unified Communications Manager 数据库 Webex 以便在最终用户配置窗口中显示。

确保在计划的 Webex Cloud-Connected UC 模块升级期间不执行任何预配置作。

如果在模块升级期间执行预配置，步骤 1、2 或 3 可能会在特定时间段后显示错误状态，并在一段时间后显示重试按钮。 您可以通过选择“ 重试 ”按钮重新启动预配。 在重试预配置之前，请确保验证群集状态是否升级完成。

1

从目录服务的“集群选择”页面中，选择要预配置以启用同步的集群。

2

单击 开始预配置。

3

在字段映射配置窗口中，确保为 Unified CM 用户 ID 字段选择的映射在您开始预配置后唯一标识集群中的用户。

4

选择适当的 Unified CM 用户 ID 字段映射，以便从 Webex 同步用户。

  • Unified CM 中的用户 ID 字段映射到 Webex 中用户的电子邮件 ID。

  • Unified CM 中的邮件标识字段映射到 Webex 中用户的电子邮件标识。

  • Unified CM 中的用户 ID 字段映射到 Webex 中没有域部分用户的电子邮件 ID。

    如果无法为 Unified CM 中的现有用户帐户成功执行映射，将创建新用户帐户。用户的电子邮件 ID（或电子邮件 ID 的 ID 部分）将用作新创建的用户帐户的唯一标识符。

5

单击下一步。

6

从下拉列表中选择协议以创建新的同步协议。

创建新的同步协议后，指向本地目录的所有现有同步协议都将被删除。 您可以在新的同步协议创建后对其进行更改。

]
7

在“协议预览”部分，开始同步前先查看协议详细信息（Unified Communications Manager 中有空的现有外部 LDAP 目录详细信息）。

您可以查看以下详细信息：

  • 组信息

  • 已应用包含通用线路和设备模板的功能组模板

  • 所插入用户同步电话号码的线路和掩码详细信息

  • 新预配的用户及其扩展

  • “要同步的标准用户字段”部分。 以下用户字段从 Common Identity Service 同步 Webex Unified Communications Manager：

    已同步统一通信用户字段已同步 Webex 通用标识服务用户字段

    用户 ID

    如果选择“Unified CM 中的用户 ID 字段映射到 Webex 中的用户电子邮件 ID”选项，则会同步用户名。

    如果选择了“Unified CM 中的邮件 ID 字段映射到 Webex 中用户的电子邮件 ID”选项，Unified Communications Manager 数据库中的现有用户 ID（Unified CM 中的邮件 ID）Webex 与通用标识服务中的邮件 ID 匹配。

    不含域部分的邮件标识（如果选择了“Unified CM 中的用户标识字段映射到 Webex 中没有域部分的用户的电子邮件标识”选项。

    名字

    name.givenName

    姓氏

    姓名.姓氏

    显示名称

    displayName

    电话号码

    phoneNumbers.work

    移动电话号码

    phoneNumbers.mobile

    邮件 ID

    电子邮件

    Title

    title

  • 目录服务器的主机名或 IP 地址

单击 下一步 以选择组筛选器。

8

从选择组 下拉列表中，选择要同步的特定组。 如果要选择所有用户组，请单击选择所有组 复选框。

缺省情况下，将同步所有用户。 如果您不选择任何组，所有用户和关联的用户数据将自动同步。

对于目录中的嵌套组，用户必须在预配置期间专门选择子集用户组，因为缺省情况下，父级组不包含该组。 您需要验证任何重复嵌套（如果有），以确保在预配期间仅包含所需的用户。

对同步协议的任何修改（例如，删除目标用户或组）不会在定期同步期间传播。 您应该从 Control Hub 禁用该集群的目录服务，然后使用新的或修改后的同步协议再次重新预配置该集群。

9

单击下一步 以准备同步过程。

10

在“启用同步”窗口中，当系统成功将用户数据复制到 Unified CM 中的临时存储空间并创建新的同步协议后（如以下屏幕截图所示，在步骤 1 和 2 之后），启用同步。

11

通过下载报告 下载 选项，您可以查看一部分结果。 要获取 Unified CM 群集的完整报告，请执行以下 CLI 命令： file get activelog /cm/trace/CIService/log4j/DryRunResults.csv。 在这里，Unified CM 的试运行结果如下所示：

  • 新用户 - 存在于身份服务 Webex 但未存在于数据库中 Unified CM 用户

  • 匹配用户 - 身份服务以及 Unified CM 数据库中 Webex 用户

  • 不匹配的用户 - 数据库中存在的用户 Unified CM 但不存在于身份服务 Webex

您可以检查报告，并决定是否保留相同的用户列表并添加或删除用户。 根据此决定，您可以停止该过程并还原预配更改。

在目录同步之后对云目录中的用户数据所做的任何更新都将在下一个同步周期内更新。 这是因为云目录每天定期同步一次。

12

在同步协议验证后，单击 预览 Unified CM 登录到本地部署基础结构，然后对新建的同步协议进行更改。

需要 VPN 访问权限。

您只能编辑 Unified CM 的组信息。您不能重命名协议或修改任何详细信息。

13

选中该复选框以同意在 Unified CM 中审核和验证同步协议的条款。

14

单击 启用同步 以继续进行同步。

在同步期间，您将无法执行任何作，直到完成。 当特定群集完成同步后，“目录服务”页面将列出该群集为“预配置”状态。 至此，您已成功授权 Entra ID 以预配置 Webex 用户并将其同步到 UC 基础结构中，并已完成设置同步的步骤。

15

初始预配置完成后，每 24 小时进行一次定期同步。 在此期间，在云目录中所做的任何更改都将传播到集群。

您必须在从创建新协议时起的 20 小时内启用同步。 LDAP 同步的用户在不活动 24 小时后将变为非活动状态并被删除。 用户将无法登录并使用 Unified CM 服务。

在某个群集的 Entra ID 预配置完成后，除了组设置，您无法创建任何新的同步协议或修改同一群集的任何配置设置。 如果要为同一集群创建新的同步协议，应转至“服务管理”页面并禁用目录服务。 然后，您可以创建用于预配置的新协议。

如果同步因任何原因失败，最新的设置更改将反映在第二天的下一个同步周期中。

  • 如果预配置成功后 SSO 身份验证期间使用 Entra ID IdP，请确保在 Entra ID IdP 中配置了正确的声明。 例如，在预配置期间，如果为用户标识映射选择了选项 1，请确保 在“其他声明”部分中将 user.userprincipalname 设置为 UID。

  • 以下属性将从 Webex Common Identity Service 同步到 Unified Communications Manager：

    已同步统一通信用户字段已同步 Webex 通用标识服务用户字段

    用户 ID

    如果选择“Unified CM 中的用户 ID 字段映射到 Webex 中的用户电子邮件 ID”选项，则会同步用户名。

    如果选择了“Unified CM 中的邮件 ID 字段映射到 Webex 中用户的电子邮件 ID”选项，Unified Communications Manager 数据库中的现有用户 ID（Unified CM 中的邮件 ID）Webex 与通用标识服务中的邮件 ID 匹配。

    不含域部分的邮件标识（如果选择了“Unified CM 中的用户标识字段映射到 Webex 中没有域部分的用户的电子邮件标识”选项。

    名字

    name.givenName

    姓氏

    姓名.姓氏

    显示名称

    displayName

    电话号码

    phoneNumbers.work

    移动电话号码

    phoneNumbers.mobile

    邮件 ID

    电子邮件

    Title

    title

  • 在目录同步之后对云目录中的用户数据所做的任何更新都将在下一个同步周期内更新。 这是因为云目录每天定期同步一次。

  • 登录必须使用单点登录（SSO）。 本文档仅介绍单点登录（SSO）集成。

  • 在从 Control Hub 重新预配置任何集群之前，我们建议您从 Cisco Unified Serviceability GUI 手动停止 Dirsync 服务。

  • 重新预配置后，如果您发现标记为不匹配的用户与新用户（共享相同邮件标识的用户）相同，我们建议您最多等待 48 小时同步更改生效。 如果要立即查看更新的更改，请确保在重新预配之前执行以下作：

    1. 从 Control Hub 的“服务管理”页面禁用 目录服务 。

    2. 从 Unified CM 中删除 Webex 通用标识服务同步协议。

    3. 禁用用户界面中“LDAP 系统配置”页中的“ 启用从 LDAP 服务器 同步 Cisco Unified CM Administration 复选框。

    4. 从最终用户窗口中删除最终用户。

    5. 从 Control Hub 的“服务管理”页面启用目录服务 。

预配状态

预配状态

在目录服务控制板上，您可以查看和跟踪集群的状态并查看错误。

下表列出了预配置状态、说明和相应的作。

表 1. 预配置状态

预配置状态

说明

正在处理

预配置正在进行中。

所需作

如果特定群集需要任何人工干预，请采取必要措施。 例如，

  • 如果要在测试后继续或放弃同步。

  • 创建新协议后，请检查是否有任何通知，并根据需要采取必要的措施。

错误

如果“启用同步”向导中需要任何作，请检查这些作，如果需要，请采取必要的措施。

如果在设置的任何阶段出现错误，管理员应审核 service： Directory Service Cisco Webex Control Hub 中的“事件历史记录”页。 这有助于您隔离、调试和排查可能出现的问题。 要访问活动，请参阅 访问混合服务的活动历史记录。

有关各种事件类型及其详细信息的详细信息，请参阅下面的“事件和可能的解决方案”表。

供应

群集预配置已完成。

未预配置

群集预配置尚未开始。
表 2. 活动和决议

事件

所需作

定期同步失败

确保您等待第二天的定期同步完成。 验证同步是否已成功完成。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

数据复制失败

单击“重试 ” 按钮继续数据传输。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

同步协议失败

单击重试 按钮重新尝试创建同步协议。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

跳过定期同步

不需要操作。

数据传输失败

单击“重试 ” 按钮继续数据传输。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

用户同步不匹配

检查 Unified CM 中的目录同步日志中是否存在用户同步中的错误，或联系 Cisco TAC 支持以获取进一步帮助。

已成功预配置用户

不需要操作。

定期同步数据传输成功

不需要操作。

无法从“通用标识”中获取某些选定组 Webex 用户详细信息。

导航到 仪表板 并选择群集，通过单击提供的下载链接来获取失败组的详细信息。 验证用户是否存在于“通用标识”中 Webex 然后单击 重试。 请联系 Cisco TAC 支持人员获取进一步协助。

无法从通用标识获取 Webex 所选组的用户详细信息。

单击“重试 ” 按钮继续数据传输。 如果问题仍然存在，请联系 Cisco TAC 支持以获取进一步帮助。
同步问题疑难解答

本节提供了必要的信息和解决方案，以解决在将用户从 Control Hub 同步到 Unified Communications Manager 数据库的各个阶段可能面对的一些常见问题。

不匹配的用户

如果发现不匹配的用户，请在创建新协议后的 20 小时内启用同步。 现有用户被标记为非活动状态，在不活动 24 小时后将从 Unified CM 中删除。

错误 - 数据复制失败。 请重试

  • Cloud-Connected UC 和 Cloud 之间的通信中断 Webex 或无法从云 Webex 获取用户数据。

    解决方案： 要确认您是否成功连接到 Cisco Cloud，请访问： https://status.webex.com/检查这些服务的状态。 单击重试 。

  • Cloud-Connected UC 和 Unified CM 之间的通信中断，或无法将用户数据推送到 Unified CM 数据库。

    解决方案： 检查 Cloud-Connected UC 与 Unified CM 之间的网络连接并单击“重试 ”。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

错误 - 无法创建同步协议。 请重试

  • Cloud-Connected UC 和 Unified CM 之间的通信中断，或无法将同步协议数据推送到 Unified CM 数据库中。

    解决方案： 检查 Cloud-Connected UC 与 Unified CM 之间的网络连接并单击“重试 ”。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

  • 同步协议创建失败。

错误–启用目录同步失败。 请重试

  • Cloud-Connected UC 和 Unified CM 之间的通信中断，并且 Cisco DirSync 服务未触发。

    解决方案： 检查 Cloud-Connected UC 与 Unified CM 之间的网络连接并单击“重试 ”。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

无法获取同步协议详细信息。 请稍后再试。

Cloud-Connected UC 和 Unified CM 之间的通信中断。

解决方案： 检查 Cloud-Connected UC 与 Unified CM 之间的网络连接并单击“重试 ”。 如果问题仍然存在，请联系 Cisco TAC 支持人员。

获取所选组的用户数据失败

首次预配置期间，从已选择进行同步的任何特定组下载用户数据时可能会遇到问题。 在错误消息中，单击下载链接以查看失败组信息的详细信息。

您还可以从 Cisco Webex Control Hub 中的“ 事件历史记录 ”页面下载已预配置的集群的失败组信息。 导航到 仪表板 并选择群集，通过单击提供的下载链接来获取失败组的详细信息。 验证用户是否存在于“通用标识”中 Webex 然后单击 重试。 请联系 Cisco TAC 支持人员获取进一步协助。

Webex Cloud-Connected UC 目录服务同步的已知问题和限制

Webex Cloud-Connected UC 目录服务同步的已知问题和限制

如果您遇到有关此功能的问题，请检查该问题是否属于我们已了解并已推荐变通方法的问题。

  • 您可以从 Control Hub 禁用集群的目录服务，然后再次重新启用该集群。 我们建议您至少等待 60 秒，然后激活目录服务以进行同步。

  • 删除后，如果要再次将同一 Unified CM 群集载入组织，您必须先禁用目录服务，然后再重新预配置同一集群。

  • 在预配置期间，由于通用标识服务的同步问题 Webex 组详细信息列表不会填充。 建议用户放弃预配置并在一段时间后重试。