Minimize spurious changes, so that we match debian more closely.
[hcoop/debian/courier-authlib.git] / README.ldap
CommitLineData
d9898ee8 1LDAP support based on a patch by:
2Luc Saillard <luc.saillard@alcove.fr> Thu, 30 Dec 1999 20:33:08 +0100
3
4Adapted as a generic authlib authentication module - SV 12/31/99.
5
6Configuration 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
20Schema
21------
22
23OpenLDAP 2.0 defaults to schema checking on all directories. The file
24authldap.schema contains a definition of a LDAP objects
25CourierMailAccount, CourierMailAlias, and CourierDomainAlias.
26
27Only CourierMailAccount is used for mailbox authentication (i.e. IMAP,
28webmail). The other two objects are used by LDAP-based mail routing
29in the Courier Mail Server.
30
31Here are some sample LDAP objects that use this schema:
32
33dn: o=example, c=com
34ObjectClass: organization
35o: example
36c: com
37
38dn: mail=xyz123@example.com, o=example, c=com
39ObjectClass: CourierMailAccount
40mail: xyz123@example.com
41mail: xyz123
42clearPassword: tux
43userPassword: {MD5}WrbkuYvH+3FvwH7Zj+34Ag==
44homeDirectory: /home/xyz123
45uidNumber: 1001
46gidNumber: 1001
47
48dn: mail=mailalias@example.com, o=example, c=com
49ObjectClass: CourierMailAlias
50mail: mailalias
51maildrop: xyz123
52
53dn: virtualdomain=domain.com, o=example, c=com
54ObjectClass: CourierDomainAlias
55virtualdomain: domain.com
56virtualdomainuser: wxyz456
57
58
59Notice 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