注	所有 Jabber 客户端都支持用于目录集成的 LDAPv3 标准。支持此标准的任何目录服务器都与这些客户端兼容。

您可以将以下联系人源服务器与 Cisco Jabber 配合使用：

• Active Directory Domain Services，Windows Server 2012 R2

• Active Directory Domain Services，Windows Server 2008 R2

• Cisco Unified Communications Manager用户数据服务器 (UDS)。Cisco Jabber 支持使用 Cisco Unified Communications Manager 10.5 或更高版本的 UDS。

• OpenLDAP

• Active Directory 轻量级目录服务 (AD LDS) 或 Active Directory 应用程序模式 (ADAM)

CDI 使用服务发现来确定 LDAP 服务器。

下面是具有 CDI 的内部部署的默认设置：

• Cisco Jabber 与 Active Directory 集成为联系人来源。

• Cisco Jabber 会自动发现并连接到全局目录。

我们建议您使用服务发现，以通过全局目录 (GC) 服务器或 LDAP 服务器自动进行连接和身份验证。如果要自定义您的部署，请查看用于提供 LDAP 服务器信息的选项和可用的验证选项。Jabber 先将 DNS 查询发送到 GC 域以发现 GC 服务器。如果它没有发现 GC 服务器，Jabber 然后将 DNS 查询发送到 LDAP 域以发现 LDAP 服务器。

如果有 GC 可用，客户端会执行以下操作：

1. 从工作站获取 DNS 域，并查找 GC 的 SRV 记录。

2. 从 SRV 记录中检索 GC 的地址。

3. 使用已登录用户的凭证连接到 GC。

使用全局目录域的发现

Jabber 尝试使用 DNS SRV 查询发现 GC 服务器。首先，Jabber 获取 GC 域：

1. 如果可用，Jabber 将 DNSFORESTNAME 环境变量用作 GC 域。

2. 如果 DNSFORESTNAME 不可用，Jabber 将检查 GC 域的以下各项：

   • 在 Windows 上，Jabber 将呼叫 Windows DsGetDcName API 以获取 DnsForestName。

   • 在非 Windows 平台上，Jabber 从 jabber-config.xml 读取 LdapDNSForestDomain。

Jabber 获取 GC 域后，它将发送 DNS SRV 查询以获取 GC 服务器地址：

• 在 Windows 上，Jabber 通过 Windows DsGetSiteName API 检查 SiteName 是否可用：

  • 如果 SiteName 存在，Jabber 会发出 DNS SRV 查询 _gc._tcp.SiteName._sites.GCDomain，以获取 GC 服务器地址。

  • 如果 SiteName 不存在或没有返回针对 _gc._tcp.SiteName._sites.GCDomain 的 SRV 记录，Jabber 将发出 DNS SRV 查询 _gc._tcp.GCDomain，以获取 GC 服务器地址。

• 在非 Windows 平台上，Jabber 会发出 DNS SRV 查询 _gc._tcp.GCDomain，以获取 GC 服务器地址。

使用 LDAP 域的发现

如果 Jabber 无法发现 GC 服务器，它将尝试发现 LDAP 域：

1. 如果可用，Jabber 将 USERDNSDOMAIN 环境变量用作 LDAP 域。

2. 如果 USERDNSDOMAIN 不可用，Jabber 将从 jabber-config.xml 读取 LdapUserDomain 。

3. 如果 LdapUserDomain 不可用，Jabber 将使用用户作为 LDAP 域登录的电子邮件域。

Jabber 获取 LDAP 域后，它将发送 DNS SRV 查询以获取 LDAP 服务器地址：

• 在 Windows 上，Jabber 通过 Windows DsGetSiteName API 检查 SiteName 是否可用。

  • 如果 SiteName 存在，Jabber 会发出 DNS SRV 查询 _ldap._tcp.SiteName.sites.LdapDomain，以获取 LDAP 服务器地址。

  • 如果 SiteName 不存在或没有返回针对 _ldap._tcp.SiteName.sites.LdapDomain 的 SRV 记录，Jabber 将发出 DNS SRV 查询 _ldap._tcp.LdapDomain，以获取 LDAP 服务器地址。

• 在非 Windows 平台上，Jabber 会发出 DNS SRV 查询 _ldap._tcp.LdapDomain，以获取 LDAP 服务器地址。

一旦 Jabber 连接到 LDAP 服务器，它将读取 LDAP 服务器的指定要使用的验证机制列表和顺序的 SupportedSaslMechanisms 属性。

LDAP 服务的手动配置

1. 您可以配置 PrimaryServerName 参数以定义 Jabber 要连接到的特定 LDAP 服务器。

2. 您可以在 jabber-config.xml 文件中配置 LdapSupportedMechanisms 参数，以覆盖 supportedSaslMechanisms 属性中的列表。

   联系人服务和 LDAP 服务器必须支持所有这些机制。使用空格分隔多个值。

   • GSSAPI — Kerberos v5

   • EXTERNAL — SASL external

   •PLAIN（默认）— 简单 LDAP 绑定，匿名是简单绑定的子集。

   示例：

   <LdapSupportedMechanisms>GSSAPI EXTERNAL PLAIN</LdapSupportedMechanisms>

3. 如有必要，配置 LdapUserDomain 参数以设置 Jabber 用于通过 LDAP 服务器进行验证的域。例如：

   CUCMUsername@LdapUserDomain

Cisco 目录集成 (CDI) 取代基本目录集成 (BDI) 和增强型目录集成 (EDI) 参数。CDI 参数适用于所有客户端。

Cisco Jabber 部署方案

方案 1：如果您不熟悉 11.8 中的 Jabber

我们建议您使用服务发现，以通过 LDAP 服务器自动进行连接和身份验证。如果要自定义您的部署，请查看用于提供 LDAP 服务器信息的选项和可用的验证选项。

方案 2：如果您从 EDI 配置升级到 11.8

如果您的配置只使用 EDI 参数，则 Jabber 将读取 EDI 参数并将其用于您的目录来源集成。我们仍建议您升级 EDI 参数，并将其替换为等效的 CDI 参数。

方案 3：如果您从 BDI 配置升级到 11.8

如果您的配置只使用 BDI 参数，则必须将 BDI 参数更新为等效的 CDI 参数。例如，对于 BDIPrimaryServerName，您需要将参数替换为 PrimaryServerName。BDIEnableTLS 被替换为 UseSSL 参数。

方案 4：如果您从混合 EDI/BDI 配置升级到 11.8

如果您的配置同时使用 EDI 和 BDI，则必须检查 BDI 的配置，因为 Jabber 在连接到 LDAP 服务器时将使用 EDI 参数。

在 Unified Communications Manager 12.5(1) SU2 版中，Unified CM 添加了对在服务配置文件中安全传递加密的 LDAP 凭证的支持。此更新通过确保始终以加密格式存储和发送密码来保护对目录的访问。此更改包括在以下过程中的加密：

• 目录访问验证

• 客户端配置文件下载

• BAT 导入/导出

• 升级

有关详细信息，请参阅《Cisco Unified Communications Manager 和 IM and Presence Service 12.5(1) SU2 版发行说明》。

在搭配此 Unified CM 发行版或更高版本的 Jabber 12.8 中，我们会在最终用户验证后将 LDAP 凭证下载为用户配置文件的一部分，以充分利用这一功能。

要将 Jabber 连接到 LDAP 服务器，需定义 LDAP 验证 Jabber 用户的方式：

• 默认选项是 Jabber 使用 Kerberos 或客户端证书 (SASL External) 自动连接到联系人来源服务器。我们建议使用此选项，因为它是最安全的。

• 如果您在服务配置文件或 jabber-config.xml 文件中定义凭证，它们始终优先于默认选项。

• 如果您为 LdapSupportedMechanisms 参数配置 PLAIN 值，但未配置目录配置文件用户名或密码，则用户可以直接在客户端中输入其目录凭证。

• 否则，如果连接到服务配置文件中的安全端口，可以定义 Jabber 如何连接到联系人来源服务器。您还可以通过以下方式定义：在 jabber-config.xml 文件的 LDAP_UseCredentialsFrom 参数中指定 Cisco Unified Communications Manager 凭证。

• 如果上述选项不可用，则使用服务配置文件或 jabber-config.xml 文件提供的一组众所周知的凭证。该选项的安全系数最低。Jabber 使用帐户通过联系人来源服务器进行验证。我们建议此帐户对目录拥有只读访问权限，并且是通常已知的公共凭证集。在此情况下，所有 Jabber 用户都使用这些凭证进行搜索。

注	自 Cisco Unified Communications Manager 12.0 版本起，您无法在服务配置文件中配置用户名和密码。Jabber 用户将获得自行进行验证以使用目录服务的选项。用户第一次登录到 Jabber 时会收到通知。如果用户第一次没有自行进行验证，则当他们尝试访问联系人列表时，他们会收到警报。

Cisco Jabber 使用 Jabber ID 搜索目录中的联系人信息。有几个选项可用于优化目录中的搜索：

• 搜索库 — 默认情况下，客户端在目录树的根目录处开始搜索。您可以使用搜索库指定不同的搜索开始，或者将搜索限制为特定的组。例如，只能您的用户子集具有即时消息功能。包括 OU 中的那些用户，然后将这指定为搜索库。

• 基本过滤器 — 在查询目录时，仅指定目录子项名称，以检索除用户对象以外的对象。

• 预测性搜索过滤器 — 您可以定义多个用逗号分隔的值以过滤搜索查询。默认值为 ANR（不明确的名称解析。）

有关这些选项的详细信息，请参阅《Cisco Jabber 的参数参考指南》中有关目录集成的章节。

对于云部署，可在 Cisco Webex Messenger 管理工具中或通过用户更新配置联系人数据。联系信息可使用 Cisco Webex Messenger 管理工具导入。有关详细信息，请参阅 Cisco Webex Messenger管理指南的用户管理部分。

对于您的目录中的联系人照片， Cisco Jabber 支持以下格式：

• JPG

• PNG

• BMP

重要	对于 GIF 格式的联系人照片， Cisco Jabber 不会应用任何修改以增强呈现效果。因此，GIF 格式的联系人照片可能不正确地呈现，或者质量欠佳。为获得最佳质量，将 PNG 格式用于您的联系人照片。

提示	联系人照片的最佳尺寸为 128 x 128 像素，且高宽比 1:1。 128 像素 x 128 像素是 Microsoft Outlook 中本地联系人照片的最大尺寸。

下表列出了 Cisco Jabber 中联系人照片的不同尺寸。

• 调整大小 — 如果目录中的联系人照片小于或大于 128 像素 x 128 像素， 会自动重新调整照片大小。例如，目录中的联系人照片为 64 像素 x 64 像素。当 Cisco Jabber 从目录中检索联系人照片时，它会将照片大小向 128 像素 x 128 像素重新调整。

  提示	重新调整联系人照片大小会导致低于最佳分辨率。因此，使用 128 像素 x 128 像素的联系人照片，这样客户端就不会自动重新调整其大小。

• 裁剪 — Cisco Jabber 会将非正方形联系人照片自动裁剪成正方形宽高比，或宽度与高度相同的 1:1 宽高比。

• 纵向方向 — 如果目录中的联系人照片为纵向方向，客户端会从顶部裁剪 30%，从底部裁剪 70%。

  例如，如果目录中的联系人照片宽度为 100 像素，高度为 200 像素，Cisco Jabber 需要从高度上裁剪 100 像素，以实现 1:1 的宽高比。在此情况下，客户端会从照片顶部裁剪 30 像素，从照片底部裁剪 70 像素。

• 横向方向 — 如果目录中的联系人照片为横向方向，客户端会从每侧裁剪 50%。

  例如，如果目录中的联系人照片宽度为 200 像素，高度为 100 像素，Cisco Jabber 需要从宽度上裁剪 100 像素，以实现 1:1 的宽高比。在此情况下，客户端会从照片右侧裁剪 50 像素，从照片左侧裁剪 50 像素。