eudc: LDAP Configuration

 
 2.1 LDAP Configuration
 ======================
 
 LDAP support is added by means of ‘ldap.el’, which is part of Emacs.
 ‘ldap.el’ needs an external program called ‘ldapsearch’, available as
 part of OpenLDAP (<http://www.openldap.org/>).  The configurations in
 this section were tested with OpenLDAP 2.4.23.
 
    Most servers use LDAP-over-SSL these days; the examples here reflect
 that.  The other possibilities are:
 
    • Servers that do not require authentication or that do not encrypt
      authentication traffic.
 
      Include ‘auth simple’ in ‘ldap-host-parameters-alist’, which causes
      the ‘-x’ option to be passed to ‘ldapsearch’.
 
    • Servers that require SASL authentication.
 
      Pass any required extra options to ‘ldapsearch’ using
      ‘ldap-ldapsearch-args’.
 
    The following examples use a base of ‘ou=people,dc=gnu,dc=org’ and
 the host name ‘ldap.gnu.org’, a server that supports LDAP-over-SSL (the
 ‘ldaps’ protocol, with default port ‘636’) and which requires
 authentication by the user ‘emacsuser’ with password ‘s3cr3t’.
 
    These configurations are meant to be self-contained; that is, each
 provides everything required for sensible TAB-completion of email
 fields.  BBDB lookups are attempted first; if a matching BBDB entry is
 found then EUDC will not attempt any LDAP lookups.
 
    Wildcard LDAP lookups are supported using the ‘*’ character.  For
 example, attempting to TAB-complete the following:
 
      To: * Smith
 
 will return all LDAP entries with surnames that begin with ‘Smith’.  In
 every LDAP query it makes, EUDC implicitly appends the wildcard
 character to the end of the last word.
 

Menu