Polycom Corporate Directory

Transcription

1 Polycom Corporate Directory About Polycom offers configuration of a "corporate directory", which fetches entries from an LDAP-Server. This page describes how to set up a minimal OpenLDAP-based contacts directory on Debian, aimed at LDAP noobs like me. This documentation is based on UC Admin Guide 3.3.4, Corporate Directory Best Practices and Polycom UC Software Version obviously. Click to expand Table of Contents slapd Server On Debian Squeeze Basic installation and configuration Install slapd and ldap-utils # apt-get install slapd ldap-utils Reconfigure slapd # dpkg-reconfigure -plow slapd The package configuration will ask you a few questions: Omit OpenLDAP server configuration? No DNS domain name: my_domain Organization name: my_organization Adminstrator password: my_secret Database backend to use: HDB Do you want the database to be removed when slapd is purged?: Yes(I actually had to purge once, so this makes for a clean start) Move old database: Yes (If you reconfigure a second time, it will complain that there's already a backup-file in /var/backups/*.ldapd and reconfiguration will fail - it's safe to delete this file, then restart reconfiguration) Allow LDAPv2 protocol?: No Add caseignoreorderingmatch to core.schema We now have to add "ORDERING caseignoreorderingmatch" to the surname- and givenname-attributes, because Polycom uses simple search expressions like '>=' and '<=' when querying the LDAP-addressbook. root@uunet # /etc/init.d/slapd stop root@uunet # vim /etc/ldap/slapd.d/cn\=config/cn\=schema/cn\=\{0\}core.ldif In this file, substitute surname original olcattributetypes: {1}( NAME ( 'sn' 'surname' ) DESC 'RFC2256: last (family) name(s) for which the entity is known by' SUP name ) with

2 surname ORDERING olcattributetypes: {1}( NAME ( 'sn' 'surname' ) DESC 'RFC2256: last (family) name(s) by which the entity is known' SUP name ORDERING caseignoreorderingmatch) Replace givenname original olcattributetypes: {35}( NAME ( 'givenname' 'gn' ) DESC 'RFC2256: first name(s) for which the entity is known by' SUP name ) with givenname ORDERING olcattributetypes: {35}( NAME ( 'givenname' 'gn' ) DESC 'RFC2256: first name(s) by which the entity is known' SUP name ORDERING caseignoreorderingmatch) Start slapd start slapd root@uunet # /etc/init.d/slapd start Add contact information to the directory Go to your home-directory and create a some ldif-files with the content we want to add to LDAP: Create Directories root@uunet # cd root@uunet # mkdir directory_files root@uunet # cd directory_files Create a file for the organizationunit "people" that holds a user-account we need for the phones to login:

3 people.ldif # vim people.ldif dn: ou=people,dc=my_domain ou: people description: holds users of the directory objectclass: organizationalunit Create a file for the polycom-user which we use for the phone-login: polycom_user.ldif # vim polycom_user.ldif dn: uid=polycom,ou=people,dc=my_domain changetype: add displayname: polycom cn: polycom givenname: polycom objectclass: top objectclass: person objectclass: organizationalperson objectclass: inetorgperson uid: polycom sn: polycom userpassword: supersecret #Change the password! Create a file for the organizationalunit "contacts", that holds the contact-information: phonebook.ldif # vim phonebook.ldif dn: ou=contacts,dc=my_domain ou: contacts description: lists all contacts objectclass: organizationalunit Create a file for the contaction-information of contact "John Doe" of "ACME Corporation". The Polycom phones don't seem to understand parenthesis (perhaps other special characters also) so they won't show a contact if any attribute-value has a parenthesis in it.

4 phonebook.ldif # vim phonebook.ldif dn: cn=john Doe,ou=contacts,dc=my_domain changetype: add givenname: John sn: Doe cn: John Doe o: ACME Corporation telephonenumber: objectclass: inetorgperson objectclass: top Parse files with ldapadd to add their content to the database Change " my_domain" to your server. Password is the one you entered during reconfiguration. ldapadd root@uunet # ldapadd -x -D "cn=admin,dc=my_domain" -W -v -f people.ldif ldap_initialize( <DEFAULT> ) Enter LDAP Password: add ou: contacts add description: lists all contacts add objectclass: organizationalunit adding new entry "ou=contacts,dc=my_domain" modify complete Repeat with all the files you've created, in order. Configure the phone Assuming you are already using the excellent file-based Polycom Configuration, add these entries to your sip.cfg (or custom-config):

5 sip.cfg <dir> <dir.corp dir.corp.address="$server_ip" dir.corp.port="389" dir.corp.transport="tcp" dir.corp.basedn="ou=contacts,dc=my_domain" dir.corp.scope="sub" dir.corp.filterprefix="" dir.corp.user="uid=polycom,ou=people,dc=my_domain" dir.corp.pagesize="32" dir.corp.password="supersecret" dir.corp.cachesize="128" dir.corp.leg.pagesize="8" dir.corp.leg.cachesize="32" dir.corp.autoquerysubmittimeout="1" dir.corp.viewpersistence="0"> dir.corp.leg.viewpersistence="0"> dir.corp.sortcontrol="0" <dir.corp.attribute dir.corp.attribute.1.name="sn" dir.corp.attribute.1.label="last name" dir.corp.attribute.1.type="last_name" dir.corp.attribute.1.searchable="1" dir.corp.attribute.1.filter="" dir.corp.attribute.1.sticky="0" dir.corp.attribute.2.name="givenname" dir.corp.attribute.2.label="first name" dir.corp.attribute.2.type="first_name" dir.corp.attribute.2.filter="" dir.corp.attribute.2.sticky="0" dir.corp.attribute.2.searchable="1" dir.corp.attribute.3.name="telephonenumber" dir.corp.attribute.3.label="phone number" dir.corp.attribute.3.type="phone_number" dir.corp.attribute.3.filter="" dir.corp.attribute.3.sticky="0" dir.corp.attribute.3.searchable="0" dir.corp.attribute.4.name="o" dir.corp.attribute.4.label="company name" dir.corp.attribute.4.type="other" dir.corp.attribute.4.filter="" dir.corp.attribute.4.sticky="0" dir.corp.attribute.4.searchable="1" </dir.corp.attribute> <dir.corp.backgroundsync dir.corp.backgroundsync.period="3600"> </dir.corp.backgroundsync> <dir.corp.vlv dir.corp.vlv.allow="1" dir.corp.vlv.sortorder="sn givenname telephonenumber"> </dir.corp.vlv> </dir.corp> </dir>

6 <feature feature.corporatedirectory.enabled="1"/> <softkey softkey.feature.directories="1" /> Adapt these values according to your personal settings and preferences. Use the password of the user "polycom", not "admin". All parameters are documented in detail in the UC Admin Guide YMMV if you use version 4 of the UC-software. Reboot your phone to fetch the configuration. Press the new softkey "Dir" (Or the "Directories" button if you have one and you should see a menu item "Corporate Directory...". Enter it and you can use the search function to search for firstname, lastname and companyname. Unfortunately the companyname is only displayed in the contact details. Of course, you can add additional attributes such as , address, hair color, etc. to be able to search for them. Debugging Search the directory: ldapsearch -D "uid=polycom,ou=people,dc=my_domain" -b "ou=contacts,dc=my_domain" -w supersecret -h "(sn=*)"