~ubuntu-dev/ubuntu/lucid/dovecot/lucid-201002101901

« back to all changes in this revision

Viewing changes to doc/wiki/AuthDatabase.VPopMail.txt

  • Committer: Chuck Short
  • Date: 2010-01-21 20:21:25 UTC
  • mfrom: (4.1.11 squeeze)
  • Revision ID: zulcss@ubuntu.com-20100121202125-pme73o491kfwj5nc
* 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 restriction
    - 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 config
    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.
    - 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.
   + Add SMTP-AUTH support for Outlook (login auth mechanism)
* New upstream release.
* debian/patches/gold-fix.patch: Removed. Fixed upstream.
* Moved libexec to lib corrections in dovecot-managesieve.patch and
  dovecot-managesieve-dist.patch to dovecot-example.patch
* debian/patches/dovecot-mboxlocking.patch: Regenerated to avoid FTBFS
  when quilt isn't installed.
* debian/patches/quota-mountpoint.patch: Removed. Not needed anymore.
* debian/patches/dovecot-quota.patch: Removed. Quotas aren't properly
  enabled unless mail_plugins = quota imap_quota.
* debian/patches/gold-fix.patch: Fixed configure script to build even
  with binutils-gold or --no-add-needed linker flag (Closes: #554306)
* debian/dovecot-common.init: fixed LSB headers. Thanks to Pascal Volk.
  (Closes: #558040)
* debian/changelog: added CVE references to previous changelog entry.
* debian/rules: checked up the build system. It's not fragile anymore.
  (Closes: 493803)
* debian/dovecot-common.postinst: Now invoking dpkg-reconfigure
  on dovecot-common is enough to generate new certificates
  if the previous ones were removed. (Closes: #545582)
* debian/rules: No longer install convert-tool in /usr/bin.
  It isn't an user utility and it should stay in /usr/lib/dovecot
  like all other similar tool.
* New upstream release. (Closes: #557601)
* [SECURITY] Fixes local information disclosure and denial of service.
  (see: http://www.dovecot.org/list/dovecot-news/2009-November/000143.html
  and CVE-2009-3897)
* Added myself to uploaders.
* Switched to the new source format "3.0 (quilt)":
  - removed dpatch from build-depends
  - removed debian/README.source because now we use only standard
    dpkg features
  - regenerated all patches
* Prepared to switch to multi-origin source:
  - recreated dovecot-libsieve.patch and dovecot-managesieve-dist.patch
    starting from the upstream tarball
  - removed all autotools related build-depends and build-conflict
  - renamed dovecot-libsieve and dovecot-managesieve directories
    to libsieve and managesieve.
* debian/rules: Moved the configuration of libsieve and managesieve from
  the build phase to the configuration phase
* Added dovecot-dbg package  with debugging symbols.  Thanks Stephan Bosch.
  (Closes: #554710)
* Fixed some stray libexec'isms in the default configuration.
* New upstream release.
* debian/dovecot-common.init:
  - use $CONF when starting the daemon. (Closes: #549944)
  - always output start/stop messages. (Closes: #523810)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
VPopMail
2
2
========
3
3
 
4
 
This is an external software intended to make handling virtual domains easier.
5
 
Supports Qmail and Postfix. See http://inter7.com/vpopmail.html
 
4
Dovecot supports authenticating against external VPopMail
 
5
[http://inter7.com/vpopmail.html] virtual domain manager. Dovecot must have
 
6
been configured with '--with-vpopmail' to enable this. You can check this with
 
7
'dovecot --build-options'. See also <VMailMgr> [HowTo.VMailMgr.txt] for another
 
8
similar virtual domain manager.
6
9
 
7
10
If the vpopmail database contains plaintext passwords, it can be used for
8
11
non-plaintext authentication as well.
12
15
 * cache_key: If set, you can use 'auth_cache' with VPopMail. See <PAM>
13
16
   [PasswordDatabase.PAM.txt] for more information about it.
14
17
 * webmail=IP: If IP address is specified, connections from it are assumed to
15
 
   come from webmail and VPopMail's webmail usage restrictions apply.
 
18
   come from webmail and VPopMail's webmail usage restrictions apply. (v1.2+)
 
19
 
 
20
userdb parameters:
 
21
 
 
22
 * cache_key: Like in passdb.
 
23
 * quota_template=TEMPLATE: Template to specify quota rule, %q in value expands
 
24
   to Maildir++ quota. (v1.1+)
 
25
 
 
26
Example
 
27
-------
 
28
 
 
29
---%<-------------------------------------------------------------------------
 
30
auth default {
 
31
  passdb vpopmail {
 
32
    args = webmail=127.0.0.1
 
33
  }
 
34
  userdb vpopmail {
 
35
    args = quota_template=quota_rule=*:backend=%q
 
36
  }
 
37
}
 
38
---%<-------------------------------------------------------------------------
 
39
 
 
40
Using vpopmail quota's instead of dovecot
 
41
=========================================
 
42
 
 
43
You can use vpopmail quota's, rather than dovecot's by doing using the maildir
 
44
quota plugin, and configuring as below:
 
45
 
 
46
---%<-------------------------------------------------------------------------
 
47
plugin {
 
48
  quota = maildir
 
49
  quota_rule = ?:storage=0
 
50
}
 
51
---%<-------------------------------------------------------------------------
 
52
 
 
53
This works as follows: ? means, use an existing "maildirsize" file if present
 
54
(ie from Dovecot's quota), otherwise storage is unlimited.Vpopmail will
 
55
recreate the file if it doesn't exist when delivering new mail with its quota
 
56
setting.
16
57
 
17
58
vpopmail + mysql
18
59
================
37
78
 
38
79
Most vpopmail installations use 89 as the uid/gid, not 64020. 
39
80
 
40
 
(This file was created from the wiki on 2009-07-10 04:42)
 
81
(This file was created from the wiki on 2009-10-16 04:42)