~ubuntu-dev/ubuntu/lucid/dovecot/lucid-201002110912

« back to all changes in this revision

Viewing changes to doc/wiki/AuthDatabase.LDAP.Userdb.txt

  • Committer: Bazaar Package Importer
  • Author(s): CHuck Short, Chuck Short
  • Date: 2009-11-06 00:47:29 UTC
  • mfrom: (4.1.9 squeeze)
  • Revision ID: james.westby@ubuntu.com-20091106004729-i39n7v9e7d4h51f6
Tags: 1:1.2.6-1ubuntu1
* Merge from debian testing, remaining changes:
  Add new binary pkg dovecot-postfix that integrates postfix and dovecot
  automatically: (LP: #164837)
  + debian/control:
    - add new binary with short description
    - set Architecture all for dovecot-postfix (LP: #329878)
  + debian/dovecot-postfix.postinst:
    - create initial certificate symlinks to snakeoil.
    - set up postfix with postconf to:
      - use Maildir/ as the default mailbox.
      - use dovecot as the sasl authentication server.
      - use dovecot LDA (deliver).
      - use tls for smtp{d} services.
    - fix certificates paths in postfix' main.cf
    - add reject_unauth_destination to postfix' recipient restrictions
    - add reject_unknown_sender_domain to postfix' sender restrictions
    - rename configuration name on remove, delete on purge
    - restart dovecot after linking certificates
    - handle use case when postfix is unconfigurated
   + debian/dovecot-postfix.dirs: create backup directory for postfix's configuration
   + restart postfix and dovecot.
   + debian/dovecot-postfix.postrm:
     - remove all dovecot related configuration from postfix.
     - restart postfix and dovecot.
   + debian/dovecot-common.init:
     - check if /etc/dovecot/dovecot-postfix.conf exists and use it
       as the configuration file if so.
   + debian/patches/warning-ubuntu-postfix.dpatch
     - add warning about dovecot-postfix.conf in dovecot default 
       configuration file
   + debian/patches/dovecot-postfix.conf.diff:
     - Ubuntu server custom changes to the default dovecot configuration for
       better interfation with postfix
     - enable sieve plugin
   + debian/patches/dovecot-postfix.conf.diff:
     + Ubuntu server custom changes to the default dovecot configuration for
       better integration with postfix:
       - enable imap, pop3, imaps, pop3s and managesieve by default.
       - enable dovecot LDA (deliver).
       - enable SASL auth socket in postfix private directory.
   + debian/rules:
     - copy, patch and install dovecot-postfix.conf in /etc/dovecot/.
     - build architecure independent packages too
   + Use Snakeoil SSL certificates by default.
     - debian/control: Depend on ssl-cert.
     - debian/patches/ssl-cert-snakeoil.dpatch: Change default SSL cert
       paths to snakeoil.
     - debian/dovecot-common.postinst: Relax grep for SSL_* a bit.
   + Add autopkgtest to debian/tests/*.
   + Fast TearDown: Update the lsb init header to not stop in level 6.
   + Add ufw integration:
     - Created debian/dovecot-common.ufw.profile.
     - debian/rules:
       + install profile
     - debian/control:
       + Suggest ufw
   + debian/{control,rules}: enable PIE hardening.
   + dovecot-imapd, dovecot-pop3: Replaces dovecot-common (<< 1:1.1). LP: #254721
   + debian/control:
     - Update Vcs-* headers.
   + debian/rules:
     - Create emtpy stamp.h.in files in dovecot-sieve/ and dovecot-managesieve/
       if they're not there since empty files are not included in the diff.gz 
       file.
   + Add SMTP-AUTH support for Outlook (login auth mechanism)
   + Dropped:
     - debian/patches/security-CVE-2009-3235: Applied upstream.
     - debian/patches/fix-pop3-assertion.dpatch: Applied upstream.
     - dovecot-sieve and dovecot-managesieve: Use the debian patches instead.

  [Chuck Short]
  - Updated dovecot-sieve to 0.1.13.
  - Updated dovecot-managesieve to 0.11.9.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Userdb LDAP
 
2
===========
 
3
 
 
4
Usually your LDAP database contains also the <userdb information>
 
5
[UserDatabase.txt]. If your home directory can be specified with a template and
 
6
you're using only a single<UID and GID> [UserIds.txt], you should use <static
 
7
userdb> [UserDatabase.Static.txt] instead to avoid an unnecessary LDAP lookup.
 
8
You can also use<prefetch userdb> [UserDatabase.Prefetch.txt] to avoid the
 
9
userdb LDAP lookup.
 
10
 
 
11
Userdb lookups are always done using the default DN ('dn' setting) bind. It's
 
12
not possible to do the lookup using the user's DN (remember that e.g.<deliver>
 
13
[LDA.txt] needs to do userdb lookups without knowing the user's password).
 
14
 
 
15
The userdb lookups are configured in very much the same way as <LDAP password
 
16
lookups> [AuthDatabase.LDAP.PasswordLookups.txt]. Instead of 'pass_attrs' and
 
17
'pass_filter', the userdb uses 'user_attrs' and 'user_filter'. Typically
 
18
'pass_filter' and 'user_filter' are equivalent.
 
19
 
 
20
If you're using a single UID and GID for all the users, you can specify them
 
21
globally instead of returning them from LDAP:
 
22
 
 
23
 * v1.0: 'user_global_uid' and 'user_global_gid' settings in
 
24
   'dovecot-ldap.conf'
 
25
 * v1.1+: 'mail_uid' and 'mail_gid' settings in 'dovecot.conf'
 
26
 
 
27
Example:
 
28
 
 
29
---%<-------------------------------------------------------------------------
 
30
user_attrs = homeDirectory=home, uidNumber=uid, gidNumber=gid
 
31
user_filter = (&(objectClass=posixAccount)(uid=%u))
 
32
---%<-------------------------------------------------------------------------
 
33
 
 
34
Attribute templates (v1.1+)
 
35
---------------------------
 
36
 
 
37
You can mix static text with the value returned from LDAP by using %$ in the
 
38
value. Some examples:
 
39
 
 
40
Create a "quota_rule" field with value "*:bytes=<n>" where <n> comes from
 
41
"quotaBytes" LDAP attribute:
 
42
 
 
43
---%<-------------------------------------------------------------------------
 
44
user_attrs = quotaBytes=quota_rule=*:bytes=%$
 
45
---%<-------------------------------------------------------------------------
 
46
 
 
47
Create a "mail" field with value "maildir:/var/mail/<dir>" where <dir> comes
 
48
from "sAMAccountName" LDAP attribute:
 
49
 
 
50
---%<-------------------------------------------------------------------------
 
51
user_attrs = sAMAccountName=mail=maildir:/var/spool/vmail/%$
 
52
---%<-------------------------------------------------------------------------
 
53
 
 
54
You can add static fields that aren't looked up from LDAP (v1.1.rc5+). For
 
55
example create a "mail" field with value "/var/vmail/%d/%n":
 
56
 
 
57
---%<-------------------------------------------------------------------------
 
58
user_attrs = \
 
59
  quotaBytes=quota_rule=*:bytes=%$, \
 
60
  =mail=/var/vmail/%d/%n
 
61
---%<-------------------------------------------------------------------------
 
62
 
 
63
(This file was created from the wiki on 2009-07-10 04:42)