对接 Yeastar P 系列软件版 和活动目录 (AD)

本文介绍如何通过轻量级目录访问协议 (LDAP) 对接 Yeastar P 系列软件版 和活动目录 (AD) 。

使用要求

  • 操作系统:Windows Server 2008 / 2008 R2 / 2012 / 2012 R2 / 2016 / 2019
  • PBX 服务器

前提条件

  • 确保 PBX 服务器和活动目录 (AD) 能够通过 LDAP 协议进行通信。

    如果 PBX 和活动目录在相同网络中,PBX 可直接通过默认的 LDAP 端口 389 或 LDAPS 端口 636 向活动目录发送 LDAP(S) 请求,执行 LDAP 查询。否则,需确保满足以下网络要求:

    • 如果活动目录在防火墙后,你需要在防火墙上为活动目录 (AD) 转发以下 LDAP(S) 端口,以允许将来自 PBX 的 LDAP(S) 请求传送到活动目录 (AD)。
      • TCP/UDP 389 – LDAP
      • TCP/UDP 636 – LDAPS (建议转发此端口)
    • 如果 PBX 在防火墙后,需确保 PBX 能够访问到活动目录 (AD) 。
      提示: 可以在 PBX 中的 维护 > 故障诊断 > IP Ping 测试 PBX 是否可以访问到活动目录 (AD) 所在网络的 IP 地址。

  • 在活动目录 (AD) 中收集以下信息:
    • 活动目录 (AD) 所在网络的 IP 地址。
    • 要查询的目录节点的唯一标识名(DN)。
      提示: 如果你已在 “Active Directory 用户和计算机” 中启用了 查看 > 高级功能,可右键点击目录节点,进入 属性 > 属性编辑器 > distinguishedName 查看目录节点的 DN。
    • AD 域账户的用户名和密码,用户名格式应为唯一标识名 (DN) 或用户主体名称(UPN)。

      此账户需要能访问整个指定的目录节点,用于在同步中读取目录信息。

      提示: 如果你已在 “Active Directory 用户和计算机” 中启用了 查看 > 高级功能,可右键点击 AD 域账户,进入 属性 > 属性编辑器 > distinguishedName / userPrincipalName 查看 DN 或 UPN。

操作步骤

  1. 登录 PBX 管理网页,进入 应用对接 > 协同办公平台集成
  2. 点击 活动目录 (AD) 旁边的 集成
  3. 连接 AD 域 栏,填写以下信息。
    1.
    设置 描述
    主机 IP 填写活动目录 (AD) 所在网络的 IP 地址。
    传输协议 指定传输协议。
    • LDAP:未加密的 LDAP 通信。
    • LDAPS:使用 SSL/TLS 协议加密的 LDAP 通信。
    注:
    • 如果你的操作系统是 Windows Server 2016 及以上版,需确保已安装 AD CS 证书服务,才可使用 LDAPS 协议。
    • 后续使用中仍可以更改协议。
    端口 指定用于访问活动目录 (AD) 的端口。

    默认端口为 LDAP 389 和 LDAPS 636。如果你有自定义端口,在此处填写自定义的端口号。

    目录节点 填写起始目录节点的唯一标识名 (DN),指定在活动目录 (AD) 中进行搜索的起始点。

    例如,要从 AD 域 localdirectory.com 中的 yeastardocs 组织单元开始搜索,则填写 OU=yeastardocs,dc=localdirectory,dc=com

  4. 管理员账户授权 栏,输入 AD 域账户凭据。
    2.
    设置 描述
    管理员登录名称 输入 AD 域账户的用户名。格式可以为完整的唯一标识名 (DN) 或用户主体名称(UPN)。
    示例
    • DN:cn=Administrator,cn=Users,dc=localdirectory,dc=com
    • UPN:Administrator@localdirectory.com
    管理员密码 输入与用户名关联的密码。
  5. 点击 保存

    页面跳出一个对话框,提示对接成功。

  6. 点击 ,关闭对话框。

执行结果

集成页面中的 状态 显示为 “已连接”,表示 PBX 已成功连接到活动目录 (AD)。

后续步骤

设置同步规则,从而将指定的 AD 用户、组织单元和组同步到 PBX。更多信息,请参见以下文章: