README.ldap

   1 LDAP support based on a patch by:
   2 Luc Saillard <luc.saillard@alcove.fr>  Thu, 30 Dec 1999 20:33:08 +0100
   3
   4 Adapted as a generic authlib authentication module - SV 12/31/99.
   5
   6 Configuration File
   7 ------------------
   8
   9      LDAP configuration is placed in the file authldaprc, which is installed,
  10      by default, as /usr/lib/courier-imap/etc/authldaprc.
  11      Use --with-authldaprc=pathname to override the location.
  12
  13      This file must be owned by root and have the permissions set to 0400
  14      because the LDAP administrator password is stored in this file.
  15
  16      See the default authldaprc for more information.
  17
  18      CC both me and Luc Saillard for questions on authldap.
  19
  20 Schema
  21 ------
  22
  23 OpenLDAP 2.0 defaults to schema checking on all directories.  The file
  24 authldap.schema contains a definition of a LDAP objects
  25 CourierMailAccount, CourierMailAlias, and CourierDomainAlias.
  26
  27 Only CourierMailAccount is used for mailbox authentication (i.e. IMAP,
  28 webmail).  The other two objects are used by LDAP-based mail routing
  29 in the Courier Mail Server.
  30
  31 The file authldap.ldif contains an ldif format definition of the same objects.
  32 This is the same schema definition as in authldap.schema, except in the ldif
  33 format.
  34
  35 Here are some sample LDAP objects that use this schema:
  36
  37 dn: o=example, c=com
  38 ObjectClass: organization
  39 o: example
  40 c: com
  41
  42 dn: mail=xyz123@example.com, o=example, c=com
  43 ObjectClass: CourierMailAccount
  44 ObjectClass: person
  45 cn: Xavier Y Zimmerman
  46 sn: Zimmerman
  47 mail: xyz123@example.com
  48 clearPassword: tux
  49 userPassword: {MD5}WrbkuYvH+3FvwH7Zj+34Ag==
  50 homeDirectory: /home/xyz123
  51 uidNumber: 1001
  52 gidNumber: 1001
  53
  54 dn: mail=mailalias@example.com, o=example, c=com
  55 ObjectClass: CourierMailAlias
  56 ObjectClass: nisMailAlias
  57 cn: mailalias
  58 mail: mailalias
  59 maildrop: xyz123
  60
  61 dn: virtualdomain=domain.com, o=example, c=com
  62 ObjectClass: nisMailAlias
  63 ObjectClass: CourierDomainAlias
  64 cn: domain.com
  65 virtualdomain: domain.com
  66 virtualdomainuser: wxyz456
  67
  68
  69 Notice on Luc's original patch:
  70 -------------------------------
  71
  72   Copyright (C) 1999 Luc Saillard
  73
  74   This program is free software; you can redistribute it and/or modify
  75   it under the terms of the GNU General Public License as published by
  76   the Free Software Foundation; either version 2 of the License, or
  77   (at your option) any later version.
  78
  79   This program is distributed in the hope that it will be useful,
  80   but WITHOUT ANY WARRANTY; without even the implied warranty of
  81   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  82   GNU General Public License for more details.
  83
  84   You should have received a copy of the GNU General Public License
  85   along with this program; if not, write to the Free Software
  86   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  87