了解组织联系人

使用Control Hub将您的组织联系人迁移或同步到Webex。对于本地部署，组织联系人在 LDAP 服务器中配置为联系人对象，或在 Cisco Unified Communications Manager最终用户。您可以在 Control Hub 中配置规则，将 Unified CM 数据库中的用户分类为最终用户和联系人。

此工具执行以下操作：

  • 将用户和联系人从Unified CM或LDAP服务器同步到Webex。

  • 自动检测基于Unified CM的用户和联系人中的更新，并将更改更新到Webex。

  • 您可以为定期同步设置日程安排，以便将用户和联系人从LDAP服务器同步到Webex。

  • 可以配置定期审核，以确保Unified CM用户和联系人数据与Webex不同步进行。

您仅可以从 Unified CM 或 LDAP 服务器中选择一个来源的用户。如果配置 Directory Connector，将无法通过该工具同步用户。
您必须管理使用UCM或LDAP源工具同步的用户和联系人。请勿从Webex中删除联系人及用户，因为这会导致该工具异步。

如果您没有 Cisco Cloud 连接，则通过 Control Hub 使用 CSV 文件导入组织联系人。

前提条件 ，配置 LDAP 服务器搜索 和设置首选项是强制性的章节，这些部分将引导您完成初始设置，从而将组织联系人导入并同步到 Webex。

前提条件

  • 熟悉 Control Hub。Control Hub是Webex平台的管理界面。有关更多信息，请参阅开始使用Control Hub。

  • 使用完全管理员权限访问 Control Hub。如果拥有完全管理员权限，您可以将一个或多个角色分配给组织中的任何用户。确保分配具有管理员权限的用户，以便您可以迁移其余 Jabber 自定义联系人。有关详细信息，请参阅在Control Hub中分配组织帐户角色。

  • 将 Unified CM 集群载入Webex Cloud-Connected UC。有关详细信息，请参阅为内部设备设置Webex云连接UC。

  • 在已载入 Cloud-Connected UC 的集群或Webex，启用部署洞察服务。有关详细信息，请参阅在Control Hub中启用或禁用Webex云连接UC服务。

  • 配置 LDAP 服务器搜索。LDAP 凭证从用于联系人同步的 Unified CM LDAP 搜索配置页面中检索。有关详细信息，请参阅配置 LDAP 服务器搜索。
    如果您不验证 LDAP 的内部署配置，则 LDAP 联系人同步不会启动。
配置 LDAP 服务器搜索

轻量级目录访问协议 （LDAP） 同步可帮助您设置和配置系统的最终用户。

如果要使用 Unified CM 配置，请执行下列操作：

1

在 Unified CM 上将 LDAP 服务器目录类型设置为 Microsoft AD 或 Open LDAP 服务器。

2

提供 LDAP 搜索配置：

  • LDAP 服务器用户名

  • LDAP 服务器密码

  • LDAP 服务器搜索库

  • LDAP 服务器搜索筛选器

  • UC 目录档案被标记为主要

缺省情况下，实体类型为联系人。
有关更多信息，请参阅配置LDAP同步

如果要在Control Hub中自定义配置，请执行以下操作：

1

在 Unified CM 上配置 LDAP 服务器搜索页面并提供以下内容：

  • LDAP 服务器用户名

  • LDAP 服务器密码

2

添加一个或多个 UC Directory 档案。

3

在 Control Hub 用户界面中明确指定 LDAP 服务器目录类型。

4

在 Control Hub 用户界面中将 LDAP 服务器实体类型指定为用户或联系人。

5

将 UC 服务配置文件指定为第 2 步中创建的目录配置文件之一。

6

指定 LDAP 服务器搜索库。

7

指定 LDAP 服务器搜索过滤器。

有关更多信息，请参阅配置LDAP同步
设置您的首选项
1

在Control Hub控制板中，转至更新和迁移。

2

选择用户 /联系人同步 磁贴，然后单击 “前提条件”下的 “转至设置”。

将显示“设置”页面。

3

为用户同步功能配置 Unified CM 或 LDAP 服务器。从以下部分选择详细信息：

  • Unified CM 最终用户列表 - 配置 Control Hub 的规则，以将 Unified CM 数据库中的用户标识为最终用户和联系人

    字段名

    描述

    识别联系人和用户的规则

    选中以下任意复选框以标识 Unified CM 中的组织联系人。该选项允许将联系人与用户分开，因为 Unified CM 用户可能同时包含用户和联系人。您可以设置规则以将联系人与用户区别于：

    • 以联系人同步所有记录。

    • 以用户同步所有记录。

    • 自定义

    如果选中的选项为自定义，该工具会提供将 Unified CM 最终用户记录分类为联系人的选项。其他身份会被视为用户。

    请选择至少一个标识规则以继续操作。

    • 未从 LDAP 服务器同步到 Unified CM 数据库。

    • 缺少经理用户标识。

    • 无设备关联。

    • 缺少部门标识。

    • 部门标识包含一个字符串。

    • 用户标识包含一个字符串。

    导入

    选择切换开关以启用或禁用从 Unified CM 到 Webex 联系人或用户的同步。

    • 导入用户 - 这包括从 Unified CM 最终用户列表中标识为用户的所有记录。其基于卡上设置的规则。

      启用目录连接器时，导入 用户 切换开关将被禁用。因此，您无法执行用户同步。

      只能同步来自一个来源的 Unified CM 或 LDAP 的用户，并且选择为最终选择。

    • 导入联系人 - 这包括从 Unified CM 最终用户列表中标识为联系人的所有记录。这些联系人包括会议大厅电话、寻线组以及管理员配置的组织联系人。该设置基于卡上设置的规则。

    选择集群

    选择一个集群来迁移联系人或用户。

    定期审计

    允许定期审核 Unified CM 最终用户列表Webex数据以确保每 7 天同步一次。

    设置时间 - 使用此字段可更改缺省审核间隔

    Unified CM 上用户和/或联系人的任何更改，在数小时内更新 Webex。

  • LDAP 服务器 - 选择这些设置将用户和联系人从 LDAP 服务器同步到Webex。您可以同时从 Unified CM 和 LDAP 服务器同步联系人，但用户可以从一个源 （ Unified CM 或 LDAP 服务器）同步。一旦选择了此源，就无法更改此组织。

    只能同步来自一个来源的 Unified CM 或 LDAP 的用户，并且选择为最终选择。

    字段名

    描述

    LDAP 定期同步

    启用或禁用从 LDAP 服务器同步。

    定期同步

    允许定期将 LDAP 服务器中的所有用户和/或联系人同步到Webex。

    添加配置

    选择集群过滤器来同步联系人和/或用户。Control Hub LDAP 服务器支持多个集群的多种配置。单击 添加配置 以配置 LDAP 服务器相关配置。Control Hub LDAP 服务器使用 Unified CM LDAP 搜索凭证连接到 LDAP 服务器。

    • 集群名称 — 选择集群名称。

    • 配置—从两种模式中选择-使用统一的CM LDAP搜索和自定义过滤器。

      1. 使用统一CM LDAP搜索-允许工具接收CM LDAP搜索配置以同步联系人。
      2. Custome Filter -允许工具同步用户和联系人。它还允许用户定义同步设置。

      • LDAP 系统 - 选择 OpenLDAP 或 Microsoft AD 作为源 LDAP 服务器。

        在使用等元目录时打开 LDAP。

      • 同步类型 - 选择用户或联系人的同步类型。

        如果已经从 Unified CM 设置选择了用户同步，或者已经配置了通过 Directory Connector 进行用户同步，则用户同步选项将在此处不可用。

      • 自定义过滤器 - 用户或联系人同步的自定义过滤器。

      • LDAP 搜索库 - 用于用户或联系人同步的 LDAP 服务器搜索库。

        管理员可以添加最多三个搜索库，以“&&”分隔。

      • UC 目录服务配置文件 - 选择类型目录的 Unified CM 配置 UC 服务之一。

4

单击保存并继续。将显示“待同步”部分。

导入组织联系人

同步组织联系人现在是一个自动化流程。Webex云连接 UC 可以将联系人从 Unified CM 或 LDAP 服务器同步到 Webex。此功能不需要手动上传 CSV 文件，该文件非常繁琐和错误。

您可以选择从单个集群或所有集群同步数据。同步数据的规则取决于“设置”页面中设置的配置。如有必要，您可以更改规则，并且从下一个同步任务中应用。

在同步组织联系人数据时，将显示以下内容：

身份

描述

要同步的联系人

已做好同步到“已同步”的联系人Webex。

联系人已在Webex

已同步到“已同步”的联系人Webex。

要同步的用户

准备同步到云的用户总数Webex。

用户存在于Webex

已同步到云的用户Webex。

从 Unified CM 同步用户和/或联系人时，您可以检查记录并使用内联编辑选项更改导入的数据。单击 查看 Unified CM 记录。

同步前审核用户和联系人数据
此选项无法用于 LDAP 同步，仅可用于基于 Unified CM 的用户和/或联系人同步。
在开始同步前检查用户数据。使用此屏幕修复任何标识错误。此表仅显示活动用户。

当启用 Directory Connector 时，以下过程不适用，因为用户同步无法完成。

1

在同步前审核用户 页面中，查看有关问题的详细信息，并修复它们（如果有）。

问题列表如下：

  • 无效电子邮件：这是错误。无效的电子邮件标识表示标识不完整或标识重复。您无法将用户与无效的电子邮件 ID 同步。请修复电子邮件标识中的错误，或者删除联系人详细信息。您可以在摘要页面中修复无效的电子邮件标识。

  • 缺少电话号码/分机号：这是警告。您可以同步没有电话号码或分机的用户，也并非必须修复此错误。您无法从 Control Hub 中添加缺少的电话号码或 分机详细信息。

  • Webex中存在用户：您无法同步已在共享中的Webex。如果用户存在于 Webex，该工具会更新用户详细信息。

使用搜索字段搜索身份，然后根据过滤器对它们排序。

2

单击 更改用户/联系人规则 以在“设置”页面中更改 规则 。

3

从列表中选择用户或联系人以对标识进行更改。您可以移动用户或联系人，也可以从联系人同步列表中删除。

4

您可以将列表导出为 CSV 文件以手动编辑任何信息，然后导入更新的文件。单击 操作 可执行以下任务：

  • 导出这些行：选择此选项以导出所有可用记录。
  • 导入更新文件：如果您要查看更新的文件详细信息，请选择此选项。
  • 重置用户列表：如果您想清除现有用户列表详细信息，然后在摘要 页面上再次更新，请选择此选项。
5

单击下一步。显示同步前查看联系人页面。

6

在同步前查看联系人页面中，您可以执行同一组任务，例如搜索、排序、编辑设置和更改用户/联系人规则。复查有关问题的详细信息并修复（如果有）。

问题列表如下：

  • 显示名称无效：这是错误。显示名称不应为空。

  • 没有信息的联系人：这是警告。要允许同步，不能强制修复没有联系人信息的记录，但无信息的联系人将不会同步到Webex。导出并编辑所有受影响的联系人，然后重新上传以修复警告。

  • 已在Webex中：您无法同步已在联系人列表中的Webex。如果已 同步的联系人的显示名称和电子邮件标识和电话号码与现有的 Webex 联系人相同，则联系人信息将在 Webex 中更新，否则将在 Webex 中创建新的联系人。

使用搜索字段搜索身份，然后根据过滤器对它们排序。

7

单击下一步。

将显示摘要页面。

审查摘要数据

摘要页面列出所选用户和联系人提供的错误和警告消息。它还为您提供所需的建议和解决方案来解决这些问题。请解决错误，然后继续。但是，您可以忽略警告。

  • 您还可以删除有错误的身份（用户或联系人），然后继续。删除的身份会重新添加到未同步的列表。

  • 可以下载错误和警告。

要解决用户错误，请单击 查看用户 并选择 从同步列表中删除。

要解决联系人错误， 请单击查看联系人 并选择 从同步列表中删除。

当您使用从同步列表中删除 选项来删除摘要 页面中的用户时，Control Hub上的用户同步计数不会更新。

您可以查看这些无效身份的数量：

  • 具有无效电子邮件ID的用户。

  • 显示名称不正确的联系人。

  • 用户已在Webex中存在，无法同步。

  • 缺少电话号码/分机号码的用户。

  • 缺少电话号码/分机号码的联系人。

更新设置页面时，审核向导中的用户和联系人详细信息将重置。

导出更新记录-建议更新Unified CM联系人列表，了解对记录进行的任何更改。单击 导出列表，下载更新的记录，在 Unified CM 中手动更新记录。

审查同步日志

同步标签页列出了迄今为止完成的所有同步操作。您可以查看以下列：

  • Status

  • 上次更新时间

  • 联系人总数

  • 失败的联系人

  • 用户总数

  • 失败的用户

  • 发起者

  • 输入

在日志页面中，查看系统故障列中的消息并修复错误。下表列出了不同的错误方案以及如何解决这些问题。

错误情境

在用户界面上发送消息

分辨率

无法连接到 LDAP 服务器。

LDAP 通信错误

检查 UNIFIED CM 上的目录档案中是否正确配置了 IP 地址和端口，并且从发布者访问。

无法建立 TLS 连接

LDAP 证书错误

检查 LDAP 证书是否由证书颁发机构 （CA） 签名。

凭证错误，无法连接到 LDAP。

LDAP 身份验证错误

检查 Unified CM LDAP 配置页面上是否提供了正确的凭证。

由于 LDAP 搜索库错误，无法获取数据。

LDAP 搜索基本错误

检查 Control Hub 或 Unified CM 配置页面中是否提供正确的 LDAP 搜索库，具体取决于模式。

由于超时，无法获取数据。

LDAP 超时错误

检查 Unified CM 发布者的 LDAP （DirSync） 服务参数中配置的超时。

CSV 数据中缺少 Distinguished Names （NS）。

LDAP 不匹配错误

检查客户在 Control Hub UI 中配置了正确的 LDAP 类型。

其他任何错误。

LDAP 内部错误

联系 Cisco TAC 支持人员。