{{tag>Advanced_Tasks LDAP Contacts Directory}}
====== LDAP Contacts Directory Reference Guide ======

The following guides explain how to connect to the SureVoIP LDAP Directory from various types of software.

Note: Please be aware that these instructions are generic, and your particular phone/software maybe slightly different than is described below. Please see your software manual for more information.

===== Basic information =====

The following information will be needed for any software to connect to your Contacts.

==== LDAP server address ====
  ldap.surevoip.co.uk

==== Base DN ====
  dc=surevoip,dc=co,dc=uk
  
==== User DN ====
  uid=your_portal_username,ou=Users,dc=surevoip,dc=co,dc=uk
  
==== Password ====
  your_portal_password
  
==== Security ====
  StartTLS
  
==== Protocol ====
  Version 3
  
As a minimum your **LDAP Filter** should be the following for numbers:

  (|(telephoneNumber=*)(mobile=*)(homePhone=*))
  
and the following for names:

  (|(cn=*)(sn=*))

we will add further screenshots for major software clients soon.

===== Yealink Handset Example =====

If for some reason you have not bought your Yealink phones from us, you can reference the following configuration for manual setup. If you have bought your phones from us, we will provision these settings for you automatically:

{{:howtos:setup:yealink_ldap.jpg?200|Yealink T29G LDAP Configuration screenshot}}

==== Configuration file syntax ====

<code>
LDAP Name Filter:   (|(cn=%)(sn=%))
LDAP Number Filter:  (|(telephoneNumber=%)(mobile=%)(homePhone=%))
LDAP TLS Mode: LDAP TLS
Server Address:  ldap.surevoip.co.uk
Port:  389
Base:  dc=surevoip,dc=co,dc=uk
UserName:  uid=username,ou=Users,dc=surevoip,dc=co,dc=uk
Password:  password
Max. Hits(1~32000):  50
LDAP Name Attributes:  cn sn
LDAP Number Attributes:  telephoneNumber mobile homePhone
LDAP Display Name:  %cn
Protocol: Version 3
LDAP Lookup For Incoming Call: Enabled
LDAP Lookup For Callout: Enabled
LDAP Sorting Results: Enabled
</code>