H3C

Size: px

Start display at page:

Download "H3C"

欣诸葛
5 years ago
Views:

1 LDAP 同步配置举例关键词 :LDAP 同步 VCX 摘要 :LDAP 同步特性允许管理员将 LDAP Server 中的用户及其名下的话机号码批量导入到 VCX 中, 在 VCX 中创建这些用户及电话的同时也为话机指定一个缺省的 Phone Profile 本文主要介绍如何配置同步参数来实现 LDAP 同步功能缩略语 : 缩略语英文全名中文解释 LDAP Lightweight Directory Access Protocol 轻量级目录访问协议 VCX Voice Core exchange 语音核心交换系统

2 目录 1 特性简介应用场合注意事项配置举例组网需求配置思路使用版本配置步骤 LDAP Server(Domino Server on Microsoft Windows server 2003) 的配置 VCX 的配置验证结果相关资料 i

3 1 特性简介 LDAP 目录中可以存储各种类型的数据 : 电子邮件地址邮件路由信息人力资源数据公用密匙联系人列表等等 LDAP 同步特性允许管理员将 LDAP Server 中的用户信息及其名下的话机号码批量导入到 VCX 中, 在 VCX 中创建这些用户及电话并为话机指定一个缺省的 Phone Profile 2 应用场合在拥有众多员工的大企业中使用 VCX, 使用之初手动的添加大量用户及号码是一件耗时又耗力的事情, 因此可以使用 LDAP 同步功能将 LDAP Server 中的员工信息及其对应的电话自动同步到 VCX 中, 这样不仅节省时间和人力, 还能避免人为疏忽造成的输入错误 3 注意事项在配置过程中, 请注意以下几点 : VCX 支持与以下 LDAP Server 之间的同步 : 1. IBM Domino Server on system I 2. IBM Directory Server on iseries 3. IBM Domino Server on Power Systems 4. IBM Domino Server on Microsoft Windows server 2003 & Microsoft Active Directory on Microsoft Windows Server 2003 & OpenLDAP on Linux VCX LDAP 同步支持 Domino, OpenLdap, IBM Directory 上 inetorgperson 类型用户到 VCX 的同步, 而对 Active Directory, VCX LDAP 同步不仅支持 inetorgperson 类型用户到 VCX 的同步, 还支持 user 类型用户到 VCX 的同步其它类型 ( 如 person, organizationalperson 等 ) 用户不能同步到 VCX 中因为 VCX 中将 LDAP 服务器中用户的 UID 字段作为该用户在 VCX 的登陆名, 所以在 LDAP 服务器中用户的 UID 字段要唯一 VCX LDAP 同步采用如下电话号码处理策略 : (1)LDAP Server 中用户的电话号码中如果包含 "-", "+", "(", ")", 或空格时, 去除这些字符, 形成调整后的电话号码 (2) 如果包含其它非数字字符, 则在同步中认为是无效电话号码, 不同步到 VCX 中在电话号码的长度上, 限制在 3-10 这个范围 ( 最短 3 位, 最长 10 位 ), 否则认为是无效电话号码, 不同步到 VCX 中 1

(3) 因为 VCX 不允许以 0 开头的电话号码, 因此在同步中, 以 0 开头的电话号码也认为是无效电话号码, 不同步到 VCX 中关于 LDAP 服务器中用户的 street 相关字段的处理, 按如下优先级和规则进行同步 : (1) 如果 street 字段不为空, 将该值同步到 VCX 的 street1 字段中 ; 否则, 按 (2) 处理 ; (2) 如果

同步过来的用户及电话号码后, 等待一个周期后 LDAP 同步会再次将该用户和电话号码加入到 VCX 中如使用 LDAP Server 为 Domino Server, 由于 Domino Server 自身原因在 VCX 进行 Ldap 同步操作过程中会出现新用户同步不过来的现象在初始安装 branch 的时候如果启用 ldap 同步的功能, 装完 branch 之后 branch 上通过

4 (3) 因为 VCX 不允许以 0 开头的电话号码, 因此在同步中, 以 0 开头的电话号码也认为是无效电话号码, 不同步到 VCX 中关于 LDAP 服务器中用户的 street 相关字段的处理, 按如下优先级和规则进行同步 : (1) 如果 street 字段不为空, 将该值同步到 VCX 的 street1 字段中 ; 否则, 按 (2) 处理 ; (2) 如果 streetaddress 字段不为空, 将该值同步到 VCX 的 street1 字段中 ; 否则, 按 (3) 处理 ; (3) 如果 officestreetaddress 字段不为空, 将该值同步到 VCX 的 street1 字段中 ; 否则, 按 (4) 处理 ; (4) 将 VCX 的 street1 字段设置为 Unknown 在 Web 上删除 LDAP 同步过来的用户及电话号码后, 等待一个周期后 LDAP 同步会再次将该用户和电话号码加入到 VCX 中如使用 LDAP Server 为 Domino Server, 由于 Domino Server 自身原因在 VCX 进行 Ldap 同步操作过程中会出现新用户同步不过来的现象在初始安装 branch 的时候如果启用 ldap 同步的功能, 装完 branch 之后 branch 上通过 ldap 同步导入的数据不能同步到 region 上该问题已经作为需求转 B02 开发 4 配置举例 4.1 组网需求 VCX Ldap Server 图 1 配置组网图 4.2 配置思路组网可以实现 VCX 能够访问 LDAP Server 即可 VCX LDAP 同步将从 LDAP 服务器中获得类型为 inetorgperson 或 user 类型用户的一些字段, 如表的 LDAP Attribute Name 列所示在 VCX 的 Web 管理界面 Central Management Console 上,VCX 上显示的字段与 LDAP 同步所取的 LDAP 字段信息对应关系如下表所示 : 2

5 LDAP Attribute Name title givenname sn cn street streetaddress officestreetaddress l (lowercase of "L") st postalcode telephonenumber uid mail description VCX display name Job Title First Name Last Name N/A Street-1 Street-1 Street-1 City State/Province ZIP Code Phone Extension Web Login User Name N/A 表 1 字段信息对应关系表 4.3 使用版本本举例是在 VCX 版本上进行配置和验证的 4.4 配置步骤以下配置均是在实验室环境下进行的配置和验证, 配置前设备的所有参数均采用出厂时的缺省配置如果您已经对设备进行了配置, 为了保证配置效果, 请确认现有配置和以下配置不冲突 LDAP Server(Domino Server on Microsoft Windows server 2003) 的配置 1. 配置步骤 1 在 Domino Server 中, 点击 Add Person, 添加一个新用户 ( 例如属于 h3c 域 ), 如下图其中 First name 与 Last name 分别对应 VCX 中的 First name 与 Last name;user name 是 Domino Server 中用户的标识, 是必须字段, 但不会同步到 VCX 中, /h3c 表示该用户属于 h3c 域 ;Short name/userid 对应 VCX 中的 Web Login User Name;Internet address 对应 3

VCX 中的 E-mail 在这 5 个字段中,Last name User name Short name/userid 为必填字段 ;First name 为空时, 同步到 VCX 中的 First name

分别对应 VCX 中 Job Title 与 Phone 的值在 Company 子页签下,Street address city State/Province Zip/postal code 分别对应 VCX

6 VCX 中的在这 5 个字段中,Last name User name Short name/userid 为必填字段 ;First name 为空时, 同步到 VCX 中的 First name 默认为 Short name/userid 的值图 2 Domino Server 中添加新用户点击 Work/Home 页签, 如下图在下面的 Work 子页签下, 添加 Title Office Phone 分别对应 VCX 中 Job Title 与 Phone 的值在 Company 子页签下,Street address city State/Province Zip/postal code 分别对应 VCX 中用户 address 下的相同字段其中 Office Phone 是必填字段图 3 Domino Server 中添加用户信息各个字段的值填好之后, 点击左上角的 Save & Close, 保存配置 4

b. 点击 Orgaizational Unit 打开下图 : 图 4 创建新的 Organizational Unit 图 5 设置 Server 及 certifier ID 设置所用的

7 2 若 h3c 下有多个部门组织, 分别管理不同的用户, 则添加用户之前需要在 Domino 中创建新的 Organizational Unit 具体操作步骤如下: a. 在 Domino Administrator 中, 打开 Configuration, 点击 Tools -> Registration 中的 Orgaizational Unit, 如下图所示 : b. 点击 Orgaizational Unit 打开下图 : 图 4 创建新的 Organizational Unit 图 5 设置 Server 及 certifier ID 设置所用的 Server, 然后提供 certifier ID 及密码, 该 ID 文件 cert.id 位于 Domino 的数据文件目录中 c. 点击 OK 输入安装 Domino 时设置的 organization 密码, 打开如下界面 : 5

8 图 6 设置密码 d. 在 Organizational Unit 下输入一个部门名 ( 如 uc), 在 Certifier 下输入这个部门的密码 e. 点击 Register. 在原有的域 ( 示例中是 h3c) 下将出现部门 uc. 在 Domino 中加入一个用户 test, 在 User name 中输入 test/uc/h3c, 则该用户 test 位于 uc 部门中 3 用户添加成功后,Domino 主页面显示如下图所示 : 图 7 用户添加成功 6

9 2. 配置文件无 VCX 的配置 1. 配置步骤 VCX 中对 LDAP 同步参数的配置有两种方式 : 一 VCX Configuration: 安装 VCX 过程中, 在 vcx-setup 时使能 LDAP Synchronization 功能, 然后按照提示逐一配置 LDAP 同步参数配置过程如下 : The LdapSync application can be configured as follows during initial VCX configuration or VCX re-configuration. The LDAP Synchronization feature automatically synchronizes user accounts on the VCX IP Telephony system with users retrieved from an LDAP server. To enable LDAP Synchronization on this system, say 'Y' here. Enable LDAP Synchronization : Y LDAP Synchronization requires the host name or IP address of the LDAP Server with which to synchronize. LDAP Server : What port number is used by the LDAP service on the LDAP Server? Note that the default will be correct in most cases. LDAP Server Port Number : 389 What username should be used when accessing the LDAP server? LDAP Server Username :SYSTEM What is the password for the LDAP server username provided previously? LDAP Server Password : LDAP Server Password (confirm) :

10 Input the Base Distinguished Name (DN) for retrieving users from the LDAP server. LDAP Base DN : o=h3c Synchronization of information between the LDAP server and the VCX IP Telephony system is done on a periodic basis. Enter the interval between synchronizations (in seconds). LDAP Synchronization Interval (seconds) : 300 The Non-VCX User Identifier is used to identify users which should not be automatically added to the VCX IP Telephony system. LDAP Server Non-VCX User Identifier : non-vcx user The LDAP Synchronization Filter is used for retrieving the appropriate records for this site. LDAP Synchronization Filter : # 默认没有过滤条件 # 二 Custom Configuration: 若在安装 VCX 时没有使能 LDAP Synchronization 功能, 则待安装完成后, 进入 /opt/3com/vcx/vcxdata/vcx-bin 目录下, 运行 configldapsync 命令后会出现如下提示 : 1) Set LDAPEnableStatus 2) Get LDAPEnableStatus 3) Set LDAPServer 4) Get LDAPServer 5) Set LDAPBaseDN 6) Get LDAPBaseDN 7) Set LDAPUsername 8) Get LDAPUsername 9) Set LDAPPassword a) Get LDAPPassword 8

b) Set LDAPSyncInterval c) Get LDAPSyncInterval d) Set LDAPNonVCXUserID e) Get LDAPNonVCXUserID f) Set LDAPPortNumber g) Get LDAPPortNumber h) Set LDAPFilter i) Get LDAPFilter q)

11 b) Set LDAPSyncInterval c) Get LDAPSyncInterval d) Set LDAPNonVCXUserID e) Get LDAPNonVCXUserID f) Set LDAPPortNumber g) Get LDAPPortNumber h) Set LDAPFilter i) Get LDAPFilter q) Exit Please enter an operation: 之后可以选择任意参数进行配置或者查看参数的配置参数配置完之后选择 q) Exit 时将自动执行 LDAP 同步程序 2. 配置文件无验证结果可通过以下方式验证上述配置 : 1 执行 LDAP 同步之后, 登录 VCX 中央管理控制台页面, 可看到从 LDAP Server 中同步过来的用户 9

12 图 8 用户同步成功点击用户名 yang liu, 可看到配置的该用户的各种信息点击 yangliu 对应的地址, 可以看到同步过来的该用户的地址信息点击 yangliu 对应的电话机, 可以看到同步过来的电话号码图 9 同步用户信息图 10 同步的用户地址信息 10

图 11 同步的电话号码如果在进行 LDAP 同步参数的配置时设置了过滤条件, 例如 :(l=beijing), 则只有满足 city 字段的值为 beijing 的用户才能够同步到 VCX 中由于设置了同步周期为 300s, 因此每隔 300sVCX 都会向 LDAP Server 发送同步请求, 在 Domino Server 中添加新用户后隔 300s 就会同步到 VCX 中 2 VCX

13 图 11 同步的电话号码如果在进行 LDAP 同步参数的配置时设置了过滤条件, 例如 :(l=beijing), 则只有满足 city 字段的值为 beijing 的用户才能够同步到 VCX 中由于设置了同步周期为 300s, 因此每隔 300sVCX 都会向 LDAP Server 发送同步请求, 在 Domino Server 中添加新用户后隔 300s 就会同步到 VCX 中 2 VCX LDAP 同步程序的启动与停止 : /opt/3com/vcx/vcxdata/ldapsync/bin/vcxldapsync start /opt/3com/vcx/vcxdata/ldapsync/bin/vcxldapsync stop 3. 清除 LDAP 同步中间状态文件与 VCX 中 LDAP 服务器上同步过来的用户 : 先进入目录 :/opt/3com/vcx/vcxdata/ldapsync/bin/ 再运行命令 :./removeallldapusers 4. LDAP 同步日志文件目录 : /var/log/messages 5 相关资料 VCX LDAP Synchronization 11

WebSphere Studio Application Developer IBM Portal Toolkit... 2/21 1. WebSphere Portal Portal WebSphere Application Server stopserver.bat -configfile..

WebSphere Studio Application Developer IBM Portal Toolkit... 1/21 WebSphere Studio Application Developer IBM Portal Toolkit Portlet Doug Phillips (dougep@us.ibm.com),, IBM Developer Technical Support Center