对接 Yeastar P 系列软件版 与 LDAP 服务器

对接 Yeastar P 系列软件版 和 LDAP 服务器后，PBX 收到来电时，会自动查询 LDAP 服务器中的联系人，并在匹配到联系人时显示来电者姓名。

使用要求

项目 要求
Yeastar PBX
  • 订阅服务：通讯录专业版
  • 固件版本：83.18.0.102 或更高版本
第三方 LDAP 服务器 无要求

步骤一、启用 LDAP 集成

  1. 访问 LDAP 配置页面。
    1. 登录 PBX 管理网页，进入 通讯录 > 企业联系人。
    2. 在页面顶部，点击 同步联系人。

    3. 点击 LDAP 页签。

  2. 开启 启用LDAP集成，然后完成以下配置。

    项目 说明
    服务器地址

    填写 LDAP 服务器的地址。
    端口 填写 LDAP 服务器的端口号。
    传输协议 选择 LDAP 协议。
    • LDAP：明文传输数据。
    • LDAPS：使用 SSL (安全套接字层) 或者 TLS (传输层安全) 加密并验证 LDAP 服务器和 LDAP 客户端之间传输的数据。
    目录节点

    指定 DN (Distinguished Name, 专有名称) 作为联系人搜索的起点，以进行来电显示匹配和联系人同步。

    该目录节点必须包含 DC (Domain Component, 域名组件) 属性，用于定义 LDAP 树的根节点，格式为 dc={domain_prefix},dc=domain_suffix。可输入一个或多个 RDN (Relative Distinguished Name, 相对专有名称) 来缩小搜索范围。

    • 示例 1：dc=yeastar,dc=com

      在本例中，PBX 会从 yeastar.com (LDAP 树的根节点) 开始搜索联系人。

    • 示例 2：ou=support,dc=yeastar,dc=com

      在本例中，PBX 会从 yeastar.com (LDAP 树的根节点) 中的 support (组织单元) 中开始搜索联系人。
    用户 填写用于连接 LDAP 服务器的用户名。
    注： 此账号必须有读取 schema 中属性和对象类的权限。
    密码 填写与用户名关联的密码。
    自动匹配联系人过滤条件

    填写用于匹配联系人来显的过滤语句。

    该过滤语句必须包含 ${NUMBER} 变量 (代表主叫号码)，并至少指定一个号码属性用于联系人查找。

    示例： (|(telephoneNumber=${NUMBER})(mobile=${NUMBER}))

    在此示例中，PBX 收到来电后，会在 telephoneNumber 或 mobile 属性中查找条目，并将其与 ${NUMBER} (主叫号码) 进行匹配。如果匹配成功，系统将获取对应的联系人信息，并显示主叫姓名。

步骤二、映射 Yeastar P 系列软件版 和 LDAP 服务器的联系人字段

  1. 滚动到 字段匹配 栏。
  2. 映射来显字段。

    1. 在 联系人 ID、名字、办公号码 和 手机号码 对应的字段中，填写 LDAP 属性名。
      注： 本例将 办公号码 和 手机号码 作为 号码匹配条件，因此映射这两个号码字段。你需要根据实际情况映射号码字段。

      当来电与 LDAP 服务器中的联系人相匹配时，将会显示联系人的名字。

    2. 可选： 如果要同时显示联系人姓氏，勾选 姓氏，然后在 LDAP 字段中填写相应的属性名。
  3. 如果你想要将 LDAP 联系人同步到 PBX，勾选并映射你想要同步的字段。

  4. 点击 保存。

执行结果

  • Yeastar P 系列软件版 已连接 LDAP 服务器。

  • 当来电与 LDAP 服务器中的联系人相匹配时，将会显示联系人的名字。

后续操作

如果你要允许分机用户通过 Linkus 客户端呼叫 LDAP 联系人，你需要同步 LDAP 服务器的联系人到 PBX。

更多信息，请参见 设置同步 LDAP 联系人。