| 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 | Here are some sample LDAP objects that use this schema: |
| 32 | |
| 33 | dn: o=example, c=com |
| 34 | ObjectClass: organization |
| 35 | o: example |
| 36 | c: com |
| 37 | |
| 38 | dn: mail=xyz123@example.com, o=example, c=com |
| 39 | ObjectClass: CourierMailAccount |
| 40 | mail: xyz123@example.com |
| 41 | mail: xyz123 |
| 42 | clearPassword: tux |
| 43 | userPassword: {MD5}WrbkuYvH+3FvwH7Zj+34Ag== |
| 44 | homeDirectory: /home/xyz123 |
| 45 | uidNumber: 1001 |
| 46 | gidNumber: 1001 |
| 47 | |
| 48 | dn: mail=mailalias@example.com, o=example, c=com |
| 49 | ObjectClass: CourierMailAlias |
| 50 | mail: mailalias |
| 51 | maildrop: xyz123 |
| 52 | |
| 53 | dn: virtualdomain=domain.com, o=example, c=com |
| 54 | ObjectClass: CourierDomainAlias |
| 55 | virtualdomain: domain.com |
| 56 | virtualdomainuser: wxyz456 |
| 57 | |
| 58 | |
| 59 | Notice on Luc's original patch: |
| 60 | ------------------------------- |
| 61 | |
| 62 | Copyright (C) 1999 Luc Saillard |
| 63 | |
| 64 | This program is free software; you can redistribute it and/or modify |
| 65 | it under the terms of the GNU General Public License as published by |
| 66 | the Free Software Foundation; either version 2 of the License, or |
| 67 | (at your option) any later version. |
| 68 | |
| 69 | This program is distributed in the hope that it will be useful, |
| 70 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 71 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 72 | GNU General Public License for more details. |
| 73 | |
| 74 | You should have received a copy of the GNU General Public License |
| 75 | along with this program; if not, write to the Free Software |
| 76 | Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
| 77 | |