默认设置：True

默认情况下，到 LDAP 服务器的连接通过 LDAPS 协议使用 SSL。

将此参数设置为 False 会使用纯文本 LDAP 协议。如果 LDAP 端口是 389 或 3268，并且未设置 UseSSL 配置参数，也会选择纯文本 LDAP 协议。

注	设置后的配置参数会覆盖任何自动确定的协议。

默认设置（所有客户端）：True

执行预测性搜索查询时，启用/禁用模糊名称解析 (ANR) 的使用。

设置为 True 时，Jabber 将使用 ANR 构建 LDAP 查询以进行预测性搜索。

如果设置为 False，Jabber 将构建一个用于预测性搜索的复杂查询。

如果 Jabber 正在连接到 OpenLDAP 服务器，则会禁用 ANR。只有在连接到 Active Directory 服务器时，才会启用此功能。

非 ANR 服务器使用的查询格式设置为使用 "PredictiveSearchFilter" 参数。

示例：<UseANR>false</UseANR>

适用于所有客户端。

指定使用 LDAP 服务器进行身份验证的顺序。

下面指定的各项机制必须受联系服务和 LDAP 服务器的支持。

使用空格分隔多个身份验证机制。

• GSSAPI（默认值）— Kerberos v5。仅受桌面客户端支持。

• EXTERNAL— 外部。

• PLAIN — 简单的 LDAP 绑定（匿名绑定是简单绑定的子集）。如果存在 ConnectionUsername 和 ConnectionPassword 参数或 LDAP_UseCredentialsFrom 参数，则使用默认值

示例 1：<LdapSupportedMechanisms>GSSAPI EXTERNAL PLAIN</ LdapSupportedMechanisms>

在此示例中，Jabber 会先检查 GSSAPI 是否受支持，然后尝试进行身份验证。如果 GSSAPI 不受支持，则 Jabber 会检查 EXTERNAL 是否受支持，然后尝试进行身份验证。如果两个参数都不受支持，则 Jabber 将尝试 PLAIN 身份验证。

示例 2：<LdapSupportedMechanisms>PLAIN</LdapSupportedMechanisms>

在此示例中，Jabber 仅使用 PLAIN 身份验证。

适用于 Cisco Jabber Windows 版本。

当用户使用 Jabber 搜索时，从 LDAP 服务器提取员工编号。

示例：<EnableEmployeeNumber>0</EnableEmployeeNumber>

适用于 Cisco Jabber Windows 版本和 Cisco Jabber Android 版本。

指定在尝试解析联系人时客户端是否使用 LDAP 引用。

示例：<UseLdapReferral>1</UseLdapReferral>

适用于内部部署的所有 Cisco Jabber 客户端。

指定 Cisco Jabber 在连接到目录服务器时使用哪些凭证。

• Voicemail — 在连接到目录服务器时使用语音邮件凭证。

• Exchange — 使用 Cisco Jabber 在连接到目录服务器时用于连接到 Microsoft Exchange 的凭证。

• CUCM — 在连接到目录服务器时使用 Cisco Unified Communications Manager 凭证。

示例：<LDAP_UseCredentialsFrom>CUCM</LDAP_UseCredentialsFrom>

设置此参数后，不会为用户提供在“选项”窗口中手动输入其目录凭证的选项。您可以使用 Cisco Unified Communications Manager 服务配置文件或使用在 jabber-config.xml 文件中定义的 CDI 目录集成参数设置目录凭证。建议不要同时使用同步的凭证和管理员定义的凭证。

请记住，您可能需要使用 LdapUserDomain 参数定义要对 LDAP 服务器进行身份验证的域（如果适用）。例如，身份验证 ID 将为 <CUCM Username>@<LdapUserDomain>。

注	不要将 LDAP_UseCredentialsFrom 参数与以下任何参数一起使用，因为它们可能导致冲突配置： LdapAnonymousBinding ConnectionUsername 和 ConnectionPassword UseWindowsCredentials

适用于内部部署的所有 Cisco Jabber 客户端。

指定连接到 LDAP 服务器时要附加到用户名的域。当 LDAP 服务器需要 UPN 或基于电子邮件的帐户进行身份验证时，此参数非常有用。此参数与 LDAP_UseCredentialsFrom 参数一起使用。

用户名附加了 @ 符号，后跟 LdapUserDomain 指定的值。然后，此值将用于连接到 LDAP 服务器。例如，名为 Adam McKenzie 的用户具有用户 ID amckenzie，LdapUserDomain 为 example.com，而向 LDAP 服务器进行身份验证的用户名为 amckenzie@example.com。

示例：<LdapUserDomain>example.com</LdapUserDomain>

适用于所有 Cisco Jabber 客户端。

限制	仅在非 Windows 环境的 jabber-config 文件中使用此参数。

Jabber 通过先读取 DNSFORESTNAME 环境变量来使用 DNS SRV 查询发现全局目录。如果该环境变量不存在，Jabber 接下来将使用 Windows API 检索 DNS 林名称。如果您想要 Jabber 在非 Windows 环境下的行为也与此类似，请将 DNS 林名称置于 jabber-config 文件中的 LdapDNSForestDomain 中。

指定用户搜索电话号码时使用的掩码。

例如，用户收到来自 +14085550100 的呼叫。在目录中，此号码为 +(1) 408 555 0100。以下掩码会解析该号码：+1408|+(#) ### ### #### 掩码字符串的长度不能超过注册表子项名称的大小限制。

在客户端搜索目录之前，电话掩码适用于电话号码。如果您正确配置电话掩码，目录搜索会在查询完全匹配后成功完成，并避免对您的目录服务器性能产生任何影响。

下表说明您可以在电话掩码中包括的元素：

此参数的唯一值是掩码字符串。

示例：<PhoneNumberMasks>+1408|+(#) ### ### ####</PhoneNumberMasks>

适用于所有客户端。

先决条件：Jabber 组消息模式已启用。

指定在运行 Jabber 组消息模式的环境中，Jabber 搜索应使用的来源。通过搜索结果，您将看到个人的档案照片，并能呼叫他们。

如果您使用 CI 将 ContactProfileSearch 参数配置为该值，此参数将被忽略。

• CI（默认值）— Jabber 用户可以搜索位于团队目录中处于 Common Identity (CI) 的联系人。

• CI-UDS-LDAP — Jabber 用户可以搜索公司目录 (UDS/LDAP) 的联系人以及 CI。

  注	如果使用此值，您可能还需要使用 DirectoryServerType。

示例：<ContactSearchSource>CI-UDS-LDAP</ContactSearchSource>

适用于所有客户端。

先决条件：Jabber 组消息模式已启用。

为运行 Jabber 组消息模式的环境定义用户联系人的档案来源。通过搜索结果，您将看到个人的档案照片，并能呼叫他们。

• CI — “团队”目录的 Common Identity (CI) 中的配置文件信息。如果您设置此值，则会忽略 ContactSearchSource 参数，而预测性搜索仅在 CI 中。

• CI-UDS-LDAP（默认值）— Jabber 将从 UDS 或 LDAP 获取配置文件信息。如果任何用户详细信息发生冲突（例如其照片或显示名称），则来自 CI 的配置文件信息的优先级较高，而不是 UDS/LDAP。

  注	如果使用此值，您可能还需要使用 DirectoryServerType。

示例：<ContactProfileSource>CI-UDS-LDAP</ContactProfileSource>

适用于所有客户端。

指定要用于联系人解析的目录服务器的类型。当您将 ContactSearchSource 或 ContactProfileSource 设置为 CI-UDS-LDAP 时，Jabber 会参照此参数。

如果对 MRA 使用 Expressway，Jabber 将忽略此参数并使用 UDS。

适用于此参数的值包括：

• LDAP—连接到 LDAP 服务器。

• UDS—连接到 UDS（Cisco Unified Communications Manager 服务器）。此值用于所有 Cisco Jabber 客户端，适用于 Expressway Mobile and Remote Access。

示例：<DirectoryServerType>LDAP</DirectoryServerType>

您必须在 LDAP 目录服务器上为客户端索引属性。这可让客户端解析联系人。

要使用默认的属性映射，请确保索引以下属性：

• sAMAccountName

• displayName

• sn

• name

• proxyAddresses

• mail

• department

• givenName

• telephoneNumber

  此外，您必须索引用于辅助号码查询的以下属性：

  • otherTelephone

  • mobile

  • homePhone

  注	默认情况下，在 Cisco Jabber Windows 版本中启用辅助号码查询。您可以使用 DisableSecondaryNumberLookups 参数禁用辅助号码查询。

• msRTCSIP-PrimaryUserAddress

由于 Cisco Jabber Windows 版本在默认情况下连接到全局目录服务器，因此您必须确保所有属性都驻留在全局目录服务器上。您可以使用适当的工具（例如 Microsoft Active Directory Schema Snap-in）将属性复制到全局目录服务器。您可以选择是将属性复制到全局目录服务器，还是不复制：

• 如果您将属性复制到全局目录服务器，它会在域内的 Active Directory 服务器之间生成流量。因此，您应该在网络流量可以处理额外负荷时，将属性复制到全局目录服务器。

• 如果您不想将属性复制到全局目录服务器，可以配置 Cisco Jabber 以连接到域控制器。在这种情况下，客户端仅在连接到域控制器时才查询单个域。

适用于所有 Cisco Jabber 客户端。

指定用户数据服务 (UDS) 中的哪个属性是电子邮件地址。使用值 mail 配置此参数。

示例：

<EmailAddress>mail</EmailAddress>

注	在最新的 Jabber 版本，此参数支持 LDAP 和 UDS 查询。

适用于所有 Cisco Jabber 客户端。

指定仅当数据来自 LDAP 时才从 DirectoryUri 值中删除的前缀。

例如，如果您的目录 URI 是 sip:amckenzie@example.com，请设置以下各项：

<DirectoryUriPrefix>sip:</DirectoryUriPrefix>

适用于所有 Cisco Jabber 客户端。

此参数适用于 UDS 目录集成，并指定用户的名字在预测性搜索中可以有的最多字数。用户名字的默认值是 2 个字，没有最多字数限制。

示例：<MaxWordsOfFirstName>2</MaxWordsOfFirstName>

适用于所有 Cisco Jabber 客户端。

此参数适用于 UDS 目录集成，并指定用户的姓氏在预测性搜索中可以有的最多字数。用户姓氏的默认值是 2 个字，没有最多字数限制。

示例：<MaxWordsOfLastName>2</MaxWordsOfLastName>

要连接到域控制器，请设置以下参数：

<Directory>
<ConnectionType>1</ConnectionType></Directory>

适用于 Cisco Jabber 桌面版本

您可以在 jabber-config.xml 文件中添加 KerberosConfiguration 参数。参数值将作为 MIT-Kerberos 配置文件写入磁盘中。

如果不配置此参数，Jabber 只能连接到客户端机器加入的 Active Directory 域执行目录搜索。要连接到非客户端计算机所属的其他 Active Directory 域，请配置 domain_realm 映射。

例如，在多林环境中，假设您在 AD 基础设施中部署了两个林。用户帐户在林 1 中，资源在林 2 中。在这种情况下，将 domain1.com 配置为用户域，domain2.com 和 child.domain2.com 配置为资源域。您将在林 1 和林 2 之间建立起信任关系。

如果用户从 domain1.com 登录并且想要访问资源域，在 jabber-config.xml 中将 KerberosConfiguration 配置为合适的值。

注	如果单行输入时 Kerberos 配置不起作用，请按此示例尝试多行输入。

示例：

<Directory> 
  <KerberosConfiguration> 
    [domain_realm] 
      .domain1.com = DOMAIN1.COM 
      .child.domain1.com = CHILD.DOMAIN1.COM 
  </KerberosConfiguration> 
</Directory>

要手动连接目录服务器，请设置以下参数：

<Directory>

<PrimaryServerName>primary-server-name.domain.com</PrimaryServerName>
<ServerPort1>1234</ServerPort1>
<SecondaryServerName>secondary-server-name.domain.com</SecondaryServerName>
<ServerPort2>5678</ServerPort2>
</Directory>

要与 UDS 集成，请设置以下参数。

注	仅当您想要对所有联系人解析使用 UDS 时（即公司防火墙内外），将 DirectoryServerType 参数配置为 UDS。

以下是示例配置：

<Directory>
		<DirectoryServerType>UDS</DirectoryServerType>
  <UdsServer>11.22.33.444</UdsServer>
		<UdsPhotoUriWithToken>http://server-name/%%uid%%.jpg</UdsPhotoUriWithToken>
</Directory>

在使用 LDAP 目录集成部署 Expressway for Mobile and Remote Access 时，客户端使用：

• LDAP，在公司防火墙之内时

• 在公司防火墙之外时的 UDS

注	LDAP 是默认配置，所以不需要在您的客户端配置文件中包括 DirectoryServerType 参数。

要确保客户端从公司防火墙内外都可以解析联系人照片，请设置以下参数。

以下是示例配置：

<Directory>
  <PhotoUriWithToken>http://photo.example.com/sAMAccountName.jpg</PhotoUriWithToken>
  <UdsPhotoUriWithToken>http://server-name/%%uid%%.jpg</UdsPhotoUriWithToken>
</Directory>

简单身份验证可让您使用简单绑定连接到目录服务器，如下例所示配置：

<ConnectionUsername>username</ConnectionUsername>
<ConnectionPassword> password</ConnectionPassword>