XSwitch用户手册
LDAP
LDAP（Lightweight Directory Access Protocol，轻量目录访问协议），是一种 C/S（即“客户端/服务器”）模式的协议，基于此协议可实现“客户端访问服务器目录”的功能。
LDAP服务器方便用户集中管理电话簿。支持LDAP功能的IP话机通过设置LDAP服务器，可实现在话机上快速查找LDAP上的联系人信息，而不需要在本地维护电话簿。
启动LDAP服务器
LDAP服务为新的镜像服务，服务取系统中分机和联系人信息。该功能默认不启动，默认端口为3893。如需LDAP服务，请提前联系相关负责人。
LDAP客户端配置示例
配置Grandstream话机的LDAP功能
适用于话机: Grandstream GXP1625
登录话机网页，进入【电话本】 ⇨ 【LDAP】，配置LDAP客户端，参数设置如下图所示：
- 服务器地址: 填写系统的IP地址
192.168.3.70； - 端口: 填写LDAP服务器地址的端口，如
3893； - 根节点: 填写LDAP服务器的目录节点，
dc=xswitch,dc=cn； - 用户名: 填写LDAP服务器的用户名，
cn=admin,dc=xswitch,dc=cn； - 密码: 填写LDAP服务器的密码，password；
- 号码过滤值: 设置话机通过“号码”搜索联系人信息。“
*”代表任意字母，“%”代表输入的字符串，用于筛选条件的前缀(|(cn=%))； - 姓名过滤值: 设置话机通过“姓氏”搜索联系人信息。“
*”代表任意字母，“%”代表输入的字符串，用于筛选条件的前缀(|(cidName=%))； - 版本号: LDAP服务器协议的版本，默认即可；
- 名字属性: 设置要获取的名字属性，
cidName； - 号码属性: 设置要获取的号码属性，
cn； - 显示名称: 设置LDAP服务器搜索结果的显示名称。显示名称格式必须以“%”开头，如：
%cidName； - 最大返回数: 设置LDAP服务器搜索结果的最大条目。有效值范围
1至3000。默认为50条； - 搜索超时值: 设置LDAP服务器执行搜索联系人的请求时间，单位为秒，有效值范围
0至180，默认即可； - 对结果排序: 设置IP话机是否对搜索结果进行排序，默认为“否”；
- LDAP查号: 当有“来电”或“拨打电话时”，是否在LDAP电话簿中搜索号码；
- LDAP查号显示名: 设置LDAP查找呼入呼出电话的显示名称，
%cidName。
适用于话机：
Grandstream GXP1610
Grandstream GXV3350
登录话机网页，进入【联系人信息】 ⇨ 【LDAP】，配置LDAP客户端，参数设置如下：
- 服务器地址:
192.168.3.70； - 端口:
3893； - 根节点:
dc=xswitch,dc=cn； - 用户名:
cn=admin,ou=0,dc=xswitch,dc=cn； - 密码:
password； - 号码过滤值:
(cn=%)； - 姓名过滤值:
(cidName=%))； - 版本号: LDAP服务器协议的版本，默认即可；
- 名字属性: 设置要获取的名字属性，
cn cidName； - 号码属性: 设置要获取的号码属性，
cn cidName； - 显示名称: 设置LDAP服务器搜索结果的显示名称。显示名称格式必须以“%”开头，如：
%cn； - LDAP查号: 当有“来电”或“拨打电话时”，是否在LDAP电话簿中搜索号码；
- LDAP查号显示名: 设置LDAP查找呼入呼出电话的显示名称，
%cn；
配置方位话机的LDAP功能
登录方位话机网页，在页面点击【电话薄】⇨【LDAP】，配置LDAP客户端，参数设置如下图所示：
- 服务器地址: 填写系统的IP地址
192.168.3.70，端口对应3893； - 基础: 填写LDAP服务器的目录节点，
dc=xswitch,dc=cn； - 用户名称: 填写LDAP服务器的用户名，
cn=admin,dc=xswitch,dc=cn； - 密码: 填写LDAP服务器的密码，password；
- LDAP名称过滤: 设置话机通过“号码”搜索联系人信息。“
*”代表任意字母，“%”代表输入的字符串，用于筛选条件的前缀（|(cn=%)）； - LDAP号码过滤: 设置话机通过“姓氏”搜索联系人信息。“
*”代表任意字母，“%”代表输入的字符串，用于筛选条件的前缀（|(cidName=%)）； - 最大查询结果: 设置LDAP服务器搜索结果的最大条目。有效值范围
1至32000。默认为50条； - LDAP名字属性: 设置要获取的名字属性，
cidName； - LDAP号码属性: 设置要获取的号码属性，
cn； - 协议版本: LDAP服务器协议的版本，默认即可；
- LDAP搜索排序: 启用；
- LDAP匹配来电: 启用；
- 拨号/预拨号查询: 启用；
适用于Fanvil V67话机：
登录方位话机网页，在页面点击【电话本】⇨【云电话本】，配置LDAP客户端，参数设置如下图所示：
注意： 在设置分机域的时候需要小写，否则会提示user not found。
配置Zoiper软电话的LDAP功能
- 运行
Zopier Biz软电话； - 进入
Settings > Preferences > Contacts > LDAP Options； - 勾选
Use this server to search for contacts； - 配置
LDAP客户端；
| 参数设置 | 说明 | 值 |
|---|---|---|
| LDAP server | 系统IP地址 | 192.168.3.x |
| Password | 管理员的密码 | password |
| CN | LDAP服务器的用户名 | cn=admin,dc=xswitch,dc=cn |
| DN | LDAP服务器的目录节点 | dc=xswitch,dc=cn |
| Result limit | 设置LDAP服务器搜索结果的最大条目 | 0 |
| Min Chars to Search | 设置LDAP服务器搜索条件的最少字符 | 1 |
| Fields to Search | 设置要获取的名字属性 | cn, cidName |
| XMPP presence | LDAP中此栏的名称指向XMPP联系人的状态名称 | Do not use |
配置
登录话机网页，进入【联系人信息】 ⇨ 【LDAP】，配置LDAP客户端，参数设置如下：
- 服务器地址:
192.168.3.70； - 端口:
3893； - 根节点:
dc=xswitch,dc=cn； - 用户名:
cn=admin,ou=0,dc=xswitch,dc=cn； - 密码:
password； - 号码过滤值:
(cn=%)； - 姓名过滤值:
(cidName=%))； - 版本号: LDAP服务器协议的版本，默认即可；
- 名字属性: 设置要获取的名字属性，
cn cidName； - 号码属性: 设置要获取的号码属性，
cn cidName； - 显示名称: 设置LDAP服务器搜索结果的显示名称。显示名称格式必须以“%”开头，如：
%cn； - LDAP查号: 当有“来电”或“拨打电话时”，是否在LDAP电话簿中搜索号码；
- LDAP查号显示名: 设置LDAP查找呼入呼出电话的显示名称，
%cn。
配置
适用于HUAWEI IP PHONE 7920话机：
登录方位话机网页，在页面点击【高级】⇨【服务器】⇨【通讯录服务器】，配置LDAP客户端，参数设置如下图所示：
注意：LDAP功能需要在XSwitch端额外配置并启用LDAP服务器组件。