Update to 4.01.
[profile/ivi/quota.git] / README.ldap-support
1 LDAP support for warnquota by James Bourne <jbourne@hardrock.org>
2
3 The LDAP support added to warnquota allows you to retreive mail routing
4 information from an LDAP server so that you can send mail to the correct
5 addresses.  So for example if usera has the email address usera@foo.bar.com
6 and userb has userb@baz.bar.com you can have the attributes as follows
7 (obvious things missing here):
8
9 dn: uid=usera,ou=People,dc=bar,dc=com
10 uid: usera
11 mail: usera@foo.bar.com
12
13 dn: uid=userb,ou=People,dc=bar,dc=com
14 uid: userb
15 mail: userb@baz.bar.com
16
17 warnquota.conf should be set like this (if you allow anonymous binds and
18 reads of the mail attribute:
19
20 LDAP_MAIL = true
21 LDAP_HOST = ldap.bar.com
22 LDAP_PORT = 389
23 LDAP_BASEDN = ou=People,dc=bar,dc=com
24 LDAP_SEARCH_ATTRIBUTE = uid
25 LDAP_MAIL_ATTRIBUTE = mail
26 LDAP_DEFAULT_MAIL_DOMAIN = bar.com
27
28 If not, just add:
29
30 LDAP_BINDDN = uid=readonly,dc=bar,dc=com
31 LDAP_BINDPW = it'sapasswd
32
33 and you will bind as the user readonly and search that way.
34
35 If you need to do lookups using a different attribute (Novell eDir for
36 example uses cn=username) change the LDAP_SEARCH_ATTRIBUTE to cn.  
37
38 Same with LDAP_MAIL_ATTRIBUTE.  If you use mail routing in LDAP (roughly
39 following the Laser Draft) you can set this to mailLocalAddress and
40 warnquota will send to that address.  This will guarentee that your quota
41 mail will be delivered to the correct address.
42