Professional Documents
Culture Documents
LDAP+Phonebook+on+Yealink+IP+Phones V80 60
LDAP+Phonebook+on+Yealink+IP+Phones V80 60
for accessing a directory service. LDAP is a directory service protocol that runs over
TCP/IP. The nitty-gritty details of LDAP are defined in RFC 1777 "Lightweight Directory
Access Protocol".
1
Introduction
LDAP enables you to locate organizations, individuals, and other resources such as files
and devices in a network, whether on the Internet or on a corporate intranet, and
whether or not you know the domain name, IP address, or geographic whereabouts. An
LDAP directory can be distributed among many servers on a network, then replicated
and synchronized regularly. LDAP is particularly useful for storing information that you
wish to read from many locations, but update infrequently.
This guide provides configurations on the LDAP server and IP phones, and applies to the
following Yealink IP phones:
2
Installing and Configuring the LDAP Server
An LDAP server is essentially a bit like an SQL server, which is mainly used for
storing/retrieving information about people (such as contacts). The configuration
settings on the phone will be altered depending on how the LDAP server is configured.
Before using LDAP feature on IP phones, you must make sure the LDAP server is
prepared properly, otherwise you need to install and configure an LDAP server. This
chapter shows you how to install and configure an LDAP server. We recommend you to
use the OpenLDAP, Microsoft Active Directory, Microsoft Active Directory Application
Mode (ADAM) or Sun One Directory Server on Windows system.
This section shows you how to install an OpenLDAP server on Microsoft Windows 2007
system. The OpenLDAP server software is available for free. You can download it from
http://www.userbooster.de/en/download/openldap-for-windows.aspx?l=en.
1. Double click the OpenLDAP application to start the installation. You will be
prompted for the installation.
3. Follow the default settings and click Next until the Destination Folder screen
appears.
3
Installing and Configuring the LDAP Server
4. Click Change to locate the installation path from local computer system and then
click Next.
You need to remember the installation path (e.g., D:\OpenLDAP) located here.
The screenshot for reference is shown as below:
5. Follow the default settings and click Next until the Ready to install OpenLDAP for
Windows screen appears.
For more information on how to install the OpenLDAP server for windows, refer to the
website online:
http://www.userbooster.de/en/support/feature-articles/openldap-for-windows-installatio
n.aspx.
4
Installing and Configuring the LDAP Server
Access the OpenLDAP installation path. Edit the manager information for LDAP.
1. Open and edit the slapd.conf file using your favorite text editor.
Rootdn "cn=Manager,dc=maxcrc,dc=com"
Rootdn defines the manager as a management user for accessing the LDAP server.
For example:
Suffix "dc=yealink,dc=com"
The suffix line means that the domain name of the LDAP directory is yealink.com.
The Rootdn line defines a management user named as Manager.
Suffix "dc=yealink,dc=com,dc=cn"
Rootdn "cn=Manager,dc=yealink,dc=com,dc=cn"
2. Double click slappasswd.exe to modify the user password for the management user.
Type the new password twice.
1. Click Start->Run.
2. Enter cmd in the pop-up dialogue box and click OK to enter the command line
interface.
5
Installing and Configuring the LDAP Server
3. Access the server installation path. For example, execute the following commands
to access the server installation path at D:\OpenLDAP.
If the service runs successfully, you can find the prompt “slapd starting”.
Please do not close this window to make sure the LDAP server keeps running.
You can add the initial entry to the LDAP directory by using the LDIF file. Create a new
text document, then modify the filename extension as ldif and place the document to
the OpenLDAP installation path. For example, create a text document named as test.txt,
right click the test.txt document and then select to rename it, modify the filename
extension as ldif. Open the LDIF file with your favorite text editor and input the
corresponding content. The following shows an example of the content of the LDIF file:
dn: dc=yealink,dc=com
objectClass: top
objectClass: dcObject
objectClass: domain
dc: yealink
6
Installing and Configuring the LDAP Server
dn: ou=roles,dc=yealink,dc=com
objectClass: top
objectClass: organizationalUnit
ou: roles
dn: ou=people,dc=yealink,dc=com
objectClass: top
objectClass: organizationalUnit
ou: people
objectClass: groupOfUniqueNames
uniqueMember:
uid=sspecial,ou=people,dc=yealink,dc=com
uniqueMember:
uid=jbloggs,ou=people,dc=yealink,dc=com
dn: cn=Special
Users,ou=roles,dc=yealink,dc=com
objectClass: groupOfUniqueNames
uniqueMember:
uid=sspecial,ou=people,dc=yealink,dc=com
objectClass: groupOfUniqueNames
uniqueMember:
uid=admin,ou=people,dc=yealink,dc=com
dn: uid=admin,ou=people,dc=yealink,dc=com
objectClass: person
objectClass: inetOrgPerson
givenName: App
7
Installing and Configuring the LDAP Server
mail: admin@fake.org
sn: Admin
uid: admin
userPassword: adminpassword
dn: uid=jbloggs,ou=people,dc=yealink,dc=com
objectClass: person
objectClass: inetOrgPerson
givenName: Joe
mail: jbloggs@fake.org
sn: Bloggs
uid: jbloggs
userPassword: password
dn: uid=sspecial,ou=people,dc=yealink,dc=com
objectClass: person
objectClass: inetOrgPerson
givenName: Super
mail: sspecial@fake.org
sn: Special
uid: sspecial
userPassword: password</span>
1. Click Start->Run.
2. Execute cmd in the pop-up dialogue box and click OK to enter the command line
interface.
3. Access the server installation path. For example, execute the following commands
to access the server installation path at D:\OpenLDAP.
8
Installing and Configuring the LDAP Server
To create a configuration:
2. Click File->Configurations.
9
Installing and Configuring the LDAP Server
4. Enter a name in the Configuration name field under the Configuration tab.
5. Enter the domain name or IP address of the LDAP server in the Server name or IP
field under the Server tab. Check the checkbox of Use default port for the Server
port and Server SSL port.
6. Enter the user DN and password in the User DN and Password field under the
Connection tab.
The user DN and password correspond with the Rootdn and Rootpw defined in the
slapd.conf file.
For example, according to the manager information defined in the slapd.conf file:
Rootdn "cn=Manager,dc=yealink,dc=com"
Rootpw secret
10
Installing and Configuring the LDAP Server
8. Click Test connection to test the connection to the LDAP server. If you encounter an
error or warning during the test, you need to resolve the error or warning first
according to the prompt, and then retry to test the connection.
To add entries:
1. Click File->Configurations, select the configuration created above, and then click
Open.
11
Installing and Configuring the LDAP Server
2. Right click the root entry, and then select Add to add a new entry.
Entry RDN: The format is cn=XXX. This is a unique identifier for each entry.
Object Class (from schema): Select the structure class which the entry belongs to.
Each structure class has its own must attributes and may attributes. For example,
we select person from the pull-down list of Object class (from schema).
Must attributes: Double click attributes to add them to the entry node. All attributes
listed in the Must attributes field must be added and each value of the attribute
must be set.
May attributes: Double click the desired attributes to add them to the entry node.
The attributes listed in the May attributes field are optional.
12
Installing and Configuring the LDAP Server
5. Right click the selected attribute and then select Add value.
You can find the added entries at the left of the LDAP catalogue.
This section shows you how to install an active directory on Microsoft Windows Server
2008 R2 Enterprise 64-bit system.
13
Installing and Configuring the LDAP Server
1. Click Start->Run.
3. The Active Directory Domain Services Installation Wizard will appear after a short
while, click Next.
14
Installing and Configuring the LDAP Server
5. Mark the Create a new domain in a new forest radio box and click Next.
15
Installing and Configuring the LDAP Server
6. Enter an appropriate domain name for the forest root domain and click Next.
The wizard will check if the domain name is in use on the local network.
7. Select the desired forest functional level from the pull-down list of Forest functional
level, and click Next.
16
Installing and Configuring the LDAP Server
8. Select the desired domain functional level from the pull-down list of Domain
functional level, and click Next.
If you select Windows Server 2008 R2 for the forest functional level, you will not be
prompted to select a domain functional level.
17
Installing and Configuring the LDAP Server
The wizard will check if the DNS is properly configured on the local network.
9. Select additional options for this domain controller if required, and click Next.
You may get a warning telling you that the server has one or more dynamic IP
addresses. We recommend assigning a static IP address to the server.
18
Installing and Configuring the LDAP Server
10. The wizard will prompt a warning about DNS delegation. Since no DNS has been
configured yet, you can ignore the message and click Yes.
11. Specify the desired paths for the database, log files and SYSVOL folders, and click
Next.
For more information, click placing Active Directory Domain Services files.
19
Installing and Configuring the LDAP Server
12. Configure the password for the active directory recovery mode, and click Next.
20
Installing and Configuring the LDAP Server
The wizard will prompt that the system begins to create the Active Directory Domain
Services.
14. Click Finish to complete the installation and exit the wizard.
You should also install the Active Directory Lightweight Directory Services role on
Windows Server 2008 system.
21
Installing and Configuring the LDAP Server
4. Check the Active Directory Lightweight Directory Services checkbox and click Next.
22
Installing and Configuring the LDAP Server
After the installation succeeds, you will find the Active Directory Lightweight
Directory Services role listed in roles of the server manager.
You can add entries to the active directory one by one in this way.
3. Right click the domain name created above (e.g., ldap.yealink.com), and then
select New->Organizational Unit.
23
Installing and Configuring the LDAP Server
6. Right click the organizational unit created above, and then select New->Contact.
24
Installing and Configuring the LDAP Server
25
Installing and Configuring the LDAP Server
You can use a LDIF file to perform a batch import of all entries to the active directory.
Create a new text document and then modify the filename extension as ldif. For
example, create a text document named as test.txt, right click the test.txt document and
then select to rename it, modify the filename extension as ldif. Open the LDIF file with
your favorite text editor and input the corresponding content. The following shows an
example of the content of the LDIF file:
dn: OU=yealink,DC=ldap,DC=yealink,DC=com
changetype: add
objectClass: top
objectClass: organizationalUnit
ou: yealink
name: yealink
changetype: add
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: contact
sn: zhang
givenName: san
initials: zs
ipPhone: 2336
mobile: 15557107369
1. Click Start->Run.
2. Enter cmd in the pop-up dialogue box and click OK to enter the command line
interface.
26
Installing and Configuring the LDAP Server
3. Execute the command cd to access the path of the test.ldif file. For example,
execute cd c:\Windows to access the path of the test.ldif file at c:\Windows.
If the entries are added successfully, you can find the prompt “n entries modified
successfully” ("n" indicates the number of the added entries).
You can also export the existing entries on the active directory into a *.ldif file first,
modify the file, and then import the modified file into the active directory. For more
information, refer to the network resource.
27
Installing and Configuring the LDAP Server
You can also use a CSV file to perform a batch import of all entries to the active directory.
Create a new document using a spreadsheet application (e.g., Microsoft Excel) and
then save the document to your local computer using “Save as” in the format “*.csv”.
For example, create a document named as test.xls, click “Save as” to save the
document as test.csv. Open the CSV file with the spreadsheet application and input the
corresponding content. The following shows an example of the CSV file content:
The second line lists the values of an organizational unit in the corresponding attribute
columns.
The other lines list the values of contacts in the corresponding attribute columns.
1. Click Start->Run.
2. Enter cmd in the pop-up dialogue box and click OK to enter the command line
interface.
3. Execute the command cd to access the path of the test.csv file. For example,
execute cd c:\Windows to access the path of the test.csv file at c:\Windows.
28
Installing and Configuring the LDAP Server
If the entries are added successfully, you can find the prompt “n entries modified
successfully” ("n" indicates the number of the added entries).
The csvde tool cannot edit or delete the existing entries on the active directory.
You can also export the existing entries on the active directory into a *.csv file first,
modify the file, and then import the modified file into the active directory. For more
information, refer to the network resource.
You can create user accounts to allow access to resources on the active directory. User
accounts are very important and useful.
29
Installing and Configuring the LDAP Server
6. Enter the password for the user, select the appropriate options and click Next.
The password should be a combination of upper case letters, lower case letters,
numbers and special characters.
30
Installing and Configuring the LDAP Server
31
Installing and Configuring the LDAP Server
Microsoft Active Directory Application Mode (ADAM) is a new mode of Active Directory
that is designed specifically for directory-enabled applications. ADAM is a Lightweight
Directory Access Protocol (LDAP) directory service that runs as a user service, rather
than as a system service. You can run ADAM on servers and domain controllers running
operating systems in the Windows Server 2003 family. This section shows you how to
install Active Directory Application Mode (ADAM) on Microsoft Windows Server 2003
SP2 Enterprise 32-bit system. You can download Active Directory Application Mode
(ADAM) online:
http://www.microsoft.com/en-us/download/confirmation.aspx?id=4201.
2. The Active Directory Application Mode Service Park 1 Installation Wizard will
appear after a short while, click Next.
32
Installing and Configuring the LDAP Server
3. Read the software license agreement and mark I Agree radio box. And then click
Next.
33
Installing and Configuring the LDAP Server
34
Installing and Configuring the LDAP Server
3. Enter the desired name in the Instance name field and click Next.
35
Installing and Configuring the LDAP Server
5. Mark the Yes, create an application directory partition radio box and enter the
desired name (e.g., o=Yealink,c=CN) in the Partition name field, and then click
Next.
36
Installing and Configuring the LDAP Server
6. Specify the desired paths for the data and data recovery files, and click Next.
7. Mark the Network service account radio box and click Next.
It will pop up the following prompt box. Read the provided information and click
Yes.
37
Installing and Configuring the LDAP Server
8. Mark the first radio box to assign the administrative permissions for ADAM to the
currently logged on user (e.g., USER-E5F3EA4782) and click Next.
9. Mark the Import the selected LDIF files for this instance of ADAM radio box.
10. In the Available files box, select the desired LDF files and then click Add->, and
then click Next.
38
Installing and Configuring the LDAP Server
39
Installing and Configuring the LDAP Server
12. Click Finish to complete the installation and exit the wizard.
3. Enter the desired name (e.g., ADAM1) in the Connection name field.
4. Mark the Distinguished name (DN) or naming context radio box and enter the
desired value (e.g., o=Yealink,c=CN) in the following field.
40
Installing and Configuring the LDAP Server
5. Click OK.
When the ADAM ADSI Edit connects an application directory partition (e.g.,
o=Yealink,c=CN) successfully, it will show as below:
41
Installing and Configuring the LDAP Server
42
Installing and Configuring the LDAP Server
3. Enter the desired value (e.g., ou1) in the Value field and click Next.
You can also click More Attributes to set more attributes for this object.
43
Installing and Configuring the LDAP Server
7. Enter the desired value (e.g., user1001) in the Value field and click Next.
44
Installing and Configuring the LDAP Server
9. In the popup dialog of Attributes, select the telephoneNumber from the pull-down
list of Select a property to view. Enter the desired telephone number (e.g., 1003) in
the Edit Attribute field and click Set. The entered telephone number will be shown
in the Value(s) field.
10. Click OK to close the Attributes dialog, and click Finish to complete the creation of
this user.
11. Select and right click the user created above, and then select Reset Password.
45
Installing and Configuring the LDAP Server
12. Enter the password for the user created above in the New password field and
Confirm password field respectively.
If you want to use the user created above to manage and search information of LDAP,
you need to add the user to the administrator group in advance.
46
Installing and Configuring the LDAP Server
3. Select the member attribute in the Attributes box and click Edit.
4. In the popup dialog of the member attribute, click Add ADAM Account.
47
Installing and Configuring the LDAP Server
5. In the popup dialog of adding ADAM account, enter the desired dinstinguished
name (e.g., CN=user1001,OU=ou1,o=Yealink,c=CN) in the field.
6. Click OK to accept the change and close the dialog of adding ADAM account.
7. Click OK to accept the change and close the dialog of the member attribute.
8. Click OK to accept the change and close the Administrators Properties interface.
48
Installing and Configuring the LDAP Server
Sun One Directory Server, also known as Sun Java System Directory Server, is a
component of the Java Enterprise System. Sun One Directory Server can be installed on
multiple platforms, such as Windows, Linux, Solaris and so on. This section shows you
how to install Sun One Directory Server version 5.2 on Microsoft Windows Server 2003
SP2 Enterprise 32-bit system. You can download it online:
http://download.csdn.net/download/wbsoso/6439291.
2. Open and edit the hosts.dz file using your favorite text editor.
3. Add FQCN (Fully Qualified Computer Name) of your computer to the file. For
example, the FQCN of your computer is ldapsun.yealinktest.com. Add the
following mapping:
127.0.0.1 ldapsun.yealinktest.com
The following shows you how to install Java Development Kit (JDK) 6 on your computer.
You can download it online:
http://www.oracle.com/technetwork/java/javase/downloads/index.html.
49
Installing and Configuring the LDAP Server
2. The Java (TM) SE Development Kit 6 Update 22 Installation Wizard will appear
after a short while, click Next.
3. Click Change to locate the installation path from local computer system and then
click Next.
50
Installing and Configuring the LDAP Server
51
Installing and Configuring the LDAP Server
7. Click OK.
The dot “.” stands for the current path and it can’t be deleted.
52
Installing and Configuring the LDAP Server
9. Under System Variables, select the Path variable and click Edit.
10. In the Variable value field, append the Java bin directory (e.g., C:\Program
Files\Java\jdk1.6.0_22\bin) to the end of the existing path
(e.g., %SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;).
If the end of the existing path has no semicolon, you should add a semicolon to the
end of the existing path and then append the Java bin directory.
1. Click Start->Run.
2. Enter cmd in the pop-up dialogue box and click OK to enter the command line
interface.
53
Installing and Configuring the LDAP Server
5. Execute the command javac to compile java files into class files.
54
Installing and Configuring the LDAP Server
3. The Sun Java(TM) System Directory Distribution Version 5.2 Install Wizard will
appear after a short while, click Next.
55
Installing and Configuring the LDAP Server
4. Read the software license agreement and click Yes (Accept License).
5. Enter the fully qualified name of the computer (e.g., ldapsun.yealinktest.com) in the
Fully Qualified Computer Name field and click Next.
The fully qualified name of the computer was planned before. For more information,
refer to modify the hosts file of your computer.
56
Installing and Configuring the LDAP Server
6. Mark the Sun Java (TM) System Servers radio box and click Next.
57
Installing and Configuring the LDAP Server
It prompts the following window. And you can click Create Directory to create the
directory or click Choose New to select another path.
58
Installing and Configuring the LDAP Server
10. Mark The new instance will be the configuration Directory Server radio box and
click Next.
11. Mark the Store data in the new Directory Server radio box and click Next.
59
Installing and Configuring the LDAP Server
12. Enter the value “ldapsun” in the Server Identifier field and keep the default values
in other two fields. And then click Next.
13. Configure the password for the Directory Server Administrator and click Next.
60
Installing and Configuring the LDAP Server
15. Configure the password for the Directory Manager and click Next.
61
Installing and Configuring the LDAP Server
16. Check the Create Sample Organizational Structure check box and click Next.
17. Mark the Populate with sample date radio box and click Next.
62
Installing and Configuring the LDAP Server
18. Follow the default settings and click Next for the following two steps.
63
Installing and Configuring the LDAP Server
64
Installing and Configuring the LDAP Server
20. After the configuration, click Next to enter the installation summary screen. You can
view the directory sever installation status and click Details for more information.
You can also click Close to close the Sun Java(TM) System Directory Distribution
Version 5.2 Install Wizard.
You can add entries to the Directory Server one by one in this way.
65
Installing and Configuring the LDAP Server
It will enter the login screen. You should enter the administrator user name and its
password in the User ID field and Password field respectively.
The system default administrator is cn=Directory Manager and its password which
must be at least 8 characters long has already been set during the installation process.
66
Installing and Configuring the LDAP Server
4. Select and right click the dc=yealinktest,dc=com (6 acis), and then select
New->Organizational Unit.
67
Installing and Configuring the LDAP Server
7. Select and right click the organizational unit created above, and then select
New->User.
68
Installing and Configuring the LDAP Server
You can view the user (User ID is ulin) created above under the organizational unit
named ou2.
69
Installing and Configuring the LDAP Server
You can use a LDIF file to perform a batch import of all entries to the Directory Server.
For more information, refer to create the LDIF file. The following shows an example of
the content of the LDIF file for the Directory Server:
dn: ou=ou3,dc=yealinktest,dc=com
ou: ou3
objectClass: top
objectClass: organizationalunit
parentid: 1
entryid: 15
entrydn: ou=ou3,dc=yealinktest,dc=com
dn: uid=utest,ou=ou3,dc=yealinktest,dc=com
uid: utest
facsimileTelephoneNumber: 11002
givenName: user4
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetorgperson
sn: test
userPassword: 123456789
ipPhone: 2336
mobile: 15557107369
70
Installing and Configuring the LDAP Server
1. In the home page of Sun Java(TM) System Server Console, double click
ldapsun.yealinktest.com->Server Group->Directory Server(ldapsun).
3. Click Browse to locate the test.ldif file from your local system, and then click OK.
71
Installing and Configuring the LDAP Server
After importing the test.ldif file, it will show the status of importing. If the entries are
added successfully, you can view the information “n objects imported, 0 objects
rejected”. You can click Close to close it.
You can view the imported the organizational unit (e.g., ou3) and user (e.g., uid=utest)
under the path: Directory-> dc=yealinktest,dc=com (6 acis).
72
Configuring Yealink IP Phones
LDAP is disabled on IP phones by default. You can configure LDAP via web user
interface or using configuration files. The followings take configurations of a SIP-T29G IP
phone running firmware version 80 as examples.
Enable LDAP
Parameter ldap.enable
0-Disabled (Default)
1-Enabled
Parameter ldap.name_filter
Description This parameter specifies the search criteria for names look up. The
format of the search criteria is compliant to the standard string
representations of LDAP search filters (RFC 2254). The “*” symbol in
the filter stands for any character. The “%” symbol in the filter stands
for the name prefix entered by the user.
Example (|(cn=%)(sn=%)(telephoneNumber=%))
(&(cn=*)(sn=%))
When the cn of the LDAP contact is set and the sn of the LDAP
contact start with the entered prefix, the records will be
displayed on the phone LCD screen.
(!(cn=%))
When the cn of the LDAP contact does not start with the entered
prefix, the records will be displayed on the phone LCD screen.
Parameter ldap.number_filter
Description This parameter specifies the search criteria for numbers look up. The
format of the search criteria is compliant to the standard string
representations of LDAP search filters (RFC 2254). The “*” symbol in
the filter stands for any number. The “%” symbol in the filter stands
for the number prefix entered by the user.
73
Configuring Yealink IP Phones
Examples (|(telephoneNumber=%)(mobile=%)(ipPhone=%))
(&(telephoneNumber=*)(mobile=%))
Parameter ldap.tls_mode
Description This parameter specifies the connection mode between the LDAP
server and the IP phone.
Server Address
Parameter ldap.host
Description This parameter specifies the domain name or IP address of the LDAP
server.
Example 10.3.6.128
ldap.company.com
Port
Parameter ldap.port
Base
Parameter ldap.base
Description This parameter specifies the LDAP search base which corresponds
to the location in the LDAP directory. The search base narrows the
search scope and decreases directory search time.
74
Configuring Yealink IP Phones
Example dc=yealink,dc=com
Username
Parameter ldap.user
Description This parameter specifies the user name to login the LDAP server. If
the LDAP server allows anonymous to login, this parameter can be
left blank. Otherwise you need to provide the user name to access
the LDAP server.
Password
Parameter ldap.password
Description This parameter specifies the password to login the LDAP server. If
the LDAP server allows anonymous to login, this parameter can be
left blank. Otherwise you need to provide the password to access
the LDAP server.
Parameter ldap.max_hits
Description This parameter specifies the maximum number of the search results
to be returned by the LDAP server. If the value of the “Max.Hits” is
blank, the LDAP server will return all searched results. Please note
that a very large value of the “Max. Hits” will slow down the LDAP
search speed, therefore the parameter should be configured
according to the available bandwidth.
Default Value 50
Parameter ldap.name_attr
Example cn sn displayName
givenName
75
Configuring Yealink IP Phones
Parameter ldap.numb_attr
Parameter ldap.display_name
Description This parameter specifies the display name of the contact record
displayed on the LCD screen. This parameter value must start with
“%” symbol.
Example %cn
Protocol
Parameter ldap.version
Description This parameter specifies the LDAP protocol version supported on the
phone. Make sure the protocol value corresponds with the version
assigned on the LDAP server.
2-Version 2
3-Version 3 (Default)
Parameter ldap.call_in_lookup
0-Disabled (Default)
1-Enabled
Note: If the caller number contains the special characters (e.g., “+”,
“.” or the space), the phone will match the search criteria in the
parameter “LDAP Name Filter (ldap.name_filter)”. If not, the phone
will match the search criteria in the parameter “LDAP Number Filter
(ldap.number_filter)”.
76
Configuring Yealink IP Phones
Parameter ldap.call_out_lookup
0-Disabled (Default)
1-Enabled
Parameter ldap.ldap_sort
Description This parameter enables or disables the phone to sort the search
results in alphabetical order or numerical order.
0-Disabled (Default)
1-Enabled
1. Press the OK key on the phone when it is idle to obtain the IP address.
The default login user name is admin (case-sensitive) and the password is admin
(case-sensitive).
4. Click on Directory->LDAP.
77
Configuring Yealink IP Phones
You can use the following settings as a starting point and adjust the filter and display
attributes according to your requirements. The following shows example of OpenLDAP
phone configurations.
Port: 389
Base: dc=yealink,dc=com
Username: cn=Manager,dc=yealink,dc=com
Password: secret
Protocol: Version 3
78
Configuring Yealink IP Phones
To use LDAP feature, you need to configure a DSS key as an LDAP key.
3. In the desired DSS key field, select LDAP from the pull-down list of Type.
Contacts->LDAP->Enable
ldap.enable
LDAP
Directory->LDAP->Server
ldap.host
Address
79
Configuring Yealink IP Phones
ldap.port Directory->LDAP->Port
ldap.base Directory->LDAP->Base
ldap.user Directory->LDAP->Username
ldap.password Directory->LDAP->Password
Directory->LDAP->Max Hits
ldap.max_hits
(1~32000)
Directory->LDAP->LDAP
ldap.name_attr
Name Attributes
Directory->LDAP->LDAP
ldap.numb_attr
Number Attributes
Directory->LDAP->LDAP
ldap.display_name
Display Name
ldap.version Directory->LDAP->Protocol
Directory->LDAP->LDAP
ldap.call_in_lookup
Lookup For Incoming Call
Directory->LDAP->LDAP
ldap.call_out_lookup
Lookup For Callout
Directory->LDAP->LDAP
ldap.ldap_sort
Sorting Results
2. Upload configuration files to the root directory of the provisioning server and trigger
IP phones to perform an auto provisioning for configuration update.
80
Configuring Yealink IP Phones
You can use the following settings as a starting point and adjust the filter and display
attributes according to your requirements. The following shows example of OpenLDAP
phone configurations.
ldap.enable=1
ldap.name_filter= (|(cn=%)(sn=%))
ldap.number_filter= (|(telephoneNumber=%)(mobile=%)(ipPhone=%))
ldap.tls_mode=0
ldap.host= 10.3.6.128
ldap.port= 389
ldap.base= dc=yealink,dc=com
ldap.user= cn=Manager,dc=yealink,dc=com
ldap.password= secret
ldap.max_hits= 50
ldap.name_attr= cn sn
ldap.display_name= %cn
ldap.version= 3
ldap.call_in_lookup= 1
ldap.call_out_lookup= 1
ldap.ldap_sort= 1
To use LDAP feature, you need to configure a DSS key as an LDAP key.
You can configure a memory key, a line key or a programmable key as an LDAP
key. The following table shows the information of parameters:
memorykey.X.type
from 1 to 10)
linekey.X.type
Configures a line key as
(SIP-T48G: X ranges from 1 to
an LDAP key on the IP 38
29
phone.
SIP-T46G/T29G: X ranges
81
Configuring Yealink IP Phones
from 1 to 27
SIP-T22P/T26P/T23P/T23G: X
ranges from 1 to 3.
programablekey.X.type
(SIP-T48G/T46G: X=1-10,
12-14 Configures a
SIP-T42G/T41P: X=1-10, 13 programmable key as an
38
SIP-T29G/T27P/T28P/T26P: LDAP key on the IP
X=1-14 phone.
SIP-T23P/T23G/T22P/T21(P)
E2: X=1-10, 14.)
2. Upload configuration files to the root directory of the provisioning server and trigger
IP phones to perform an auto provisioning for configuration update.
82
Using LDAP Directory on Yealink IP Phones
You can press the LDAP key to access the LDAP directory. Enter the desired numbers to
match the search criteria for searching a contact from LDAP directory, add local
contacts from LDAP directory, and dial a contact from LDAP directory. You can also
enable the phone to perform an LDAP search when receiving an incoming call or dialing
an outgoing call.
2. Enter a few continuous characters of the contact name or continuous digits of the
contact phone number using the keypad.
The contacts which match the search criteria will appear on the LCD screen.
- Press the Option soft key and then select Detail to view the detail information
of the contact.
- Press the Option soft key and then select Add to Contacts to add the contact to
local.
83
Using LDAP Directory on Yealink IP Phones
If the LDAP Lookup For Incoming Call parameter is enabled on the phone, the phone will
perform an LDAP search when receiving an incoming call. If there is a contact record
which matches the caller ID, the contact name will be displayed on the phone LCD
screen as the calling line identification.
The Search Source List In Dialing feature enables the phone to perform an LDAP search
when you enter the digits using the keypad in the dialing interface. For more
information on the configuration of the Search Source List In Dialing feature, refer to
Yealink phone-specific user guide.
If there are contact records matching the search criteria, the contact records will be
listed on the phone LCD screen. You can select the desired contact record to dial out.
The contact name will be displayed on the phone LCD screen during the call.
84
Using LDAP Directory on Yealink IP Phones
If the LDAP Lookup For Callout parameter is enabled on the phone, the phone will
perform an LDAP search when dialing an outgoing call. If there is a contact record which
matches the called ID, the contact name will be displayed on the phone LCD screen as
the called line identification.
85
Using LDAP Directory on Yealink IP Phones
We are striving to improve our documentation quality and we appreciate your feedback. Email
your opinions and comments to DocsFeedback@yealink.com.
86