LDAP Configuration on Yealink Phones

When Cloud Voice acts as an LDAP server (Lightweight Directory Access Protocol, the standard way phones and apps look up a shared contact list), your Yealink IP phones can query the contacts stored on the PBX and dial them straight from the handset. This page walks through the phone-side setup using a Yealink SIP-T53W (firmware 93.85.0.5) as the example; other Yealink models follow the same flow, though menu labels may differ slightly.

Note

Complete Set up the PBX as an LDAP server first. The address, port, credentials, and Base DN you configure below all come from that setup.

Connect the phone to the LDAP server

The values shown below match the default configuration of the Cloud Voice LDAP server. Treat them as a starting point, then tune the filters and display attributes to fit your directory.

1. Sign in to the Yealink phone’s web interface and open Directory > LDAP.

2. Enable the LDAP Enable switch, then fill in the fields as described in the table.

   

   Setting	What it does	Example
   LDAP Label	Name shown for the LDAP phonebook.	PBX_Contacts
   LDAP Name Filter	Attributes used to match a contact by name.	(|(displayName=%)(givenName=%)(sn=%)(mail=%)(company=%))
   LDAP Number Filter	Attributes used to match a contact by number.	(|(telephoneNumber=%)(mobile=%)(homePhone=%)(facsimileTelephoneNumber=%))
   LDAP TLS Mode	How the phone secures its connection to the LDAP server. LDAPS is LDAP carried over TLS, an encrypted connection.	LDAPS
   LDAP Server Address	The Cloud Voice LDAP server address from your PBX.	example.proxy1.voice.example.com
   Port	The LDAP server port.	15019
   LDAP Username	The account used to sign in to the LDAP server. Find it on the PBX under Contacts > LDAP Server > LDAP Credentials > LDAP Account Username.	cn=5566,ou=users,dc=example,dc=proxy1,dc=voice,dc=example,dc=com
   LDAP Password	The sign-in password, which is the user extension’s registration password.	Regpwd123
   LDAP Base	The Base DN (Distinguished Name) from your PBX. It marks the point in the directory tree where each search begins.	dc=example,dc=proxy1,dc=voice,dc=example,dc=com
   Max Hits (1~1000)	Maximum number of results the server returns per search.	50
   LDAP Name Attributes	Name attributes returned for each record. Separate multiple values with a space.	displayName
   LDAP Number Attributes	Number attributes returned for each record. Multiple values are allowed.	telephoneNumber mobile homePhone
   LDAP Display Name	How the contact’s name appears on the phone screen. Must begin with %.	%displayName
   Protocol	LDAP protocol version. Cloud Voice uses Version 3.	Version 3
   LDAP Lookup for Incoming Call	Search the directory when a call comes in.	Enabled
   LDAP Lookup for Callout	Search the directory when you place a call.	Enabled
   LDAP Sorting Results	Sort search results alphabetically and numerically.	Enabled

   Note

   In the filter fields, * matches any character and % represents the text you type, used as the prefix of the search condition.

   Caution

   The LDAP Server Address, Port, and LDAP TLS Mode must match how the LDAP server is set up on the PBX. If any of them differ, the phone cannot reach the directory and no contacts appear.

3. Click Confirm to save.

Contacts stored on the PBX are now reachable from the phone.

Look up contacts from the Directory

Add LDAP to the phone directory

1. In the phone’s web interface, open Directory > Settings.

2. Under Directory, move LDAP from the Disabled box to the Enabled box.

   

3. Optional: under Search Source List In Dialing, move LDAP from Disabled to Enabled so the directory is searched while you dial.

   

4. Click Confirm.

Search and call

1. On the phone, press Directory and open the LDAP phonebook.

   

2. Type a name or number on the keypad. Contacts matching your input appear on screen.

   

3. Use the navigation keys to highlight the contact you want.

4. Press Send to place the call.

Look up contacts with an LDAP key

Assign an LDAP line key

1. In the phone’s web interface, open DssKey > Line Key (DssKey is Yealink’s menu for the phone’s programmable keys) and choose a key to configure.

2. Set Type to LDAP.

   

3. Click Confirm.

Search and call

1. Press the LDAP key to open the LDAP phonebook.

   

2. Type a name or number on the keypad. Contacts matching your input appear on screen.

   

3. Use the navigation keys to highlight the contact you want.

4. Press Send to place the call.