← Back to branch summary

~ubuntu-branches/ubuntu/utopic/dovecot/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/wiki/PasswordDatabase.ExtraFields.Proxy.txt

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2014-01-08 09:35:49 UTC
  • mfrom: (4.1.35 sid)
  • Revision ID: package-import@ubuntu.com-20140108093549-i72o93pux8p0dlaf
Tags: 1:2.2.9-1ubuntu1
* Merge from Debian unstable, remaining changes:
  + Add mail-stack-delivery package:
    - Update d/rules
    - d/control: convert existing dovecot-postfix package to a dummy
      package and add new mail-stack-delivery package.
    - Update maintainer scripts.
    - Rename d/dovecot-postfix.* to debian/mail-stack-delivery.*
    - d/mail-stack-delivery.preinst: Move previously installed backups and
      config files to a new package namespace.
    - d/mail-stack-delivery.prerm: Added to handle downgrades.
  + Use Snakeoil SSL certificates by default:
    - d/control: Depend on ssl-cert.
    - d/dovecot-core.postinst: Relax grep for SSL_* a bit.
  + Add autopkgtest to debian/tests/*.
  + Add ufw integration:
    - d/dovecot-core.ufw.profile: new ufw profile.
    - d/rules: install profile in dovecot-core.
    - d/control: dovecot-core - suggest ufw.
  + d/dovecot-core.dirs: Added usr/share/doc/dovecot-core
  + Add apport hook:
    - d/rules, d/source_dovecot.py
  + Add upstart job:
    - d/rules, d/dovecot-core.dovecot.upstart, d/control,
      d/dovecot-core.dirs, dovecot-imapd.{postrm, postinst, prerm},
      d/dovecot-pop3d.{postinst, postrm, prerm}.
      d/mail-stack-deliver.postinst: Convert init script to upstart.
  + Use the autotools-dev dh addon to update config.guess/config.sub for
    arm64.
* Dropped changes, included in Debian:
  - Update Dovecot name to reflect distribution in login greeting.
  - Update Drac plugin for >= 2.0.0 support.
* d/control: Drop dovecot-postfix package as its no longer required.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/wiki/PasswordDatabase.ExtraFields.Proxy.txt
29
29
      proxying to specified remote host (host isn't self) or to let director
30
30
      assign a backend host (host is self). So basically this setting just
31
31
      always sends the 'proxy' extra field to login process, but not
32
 
      necessarily the 'host'.
 
32
      necessarily the 'host'. Useful when dividing users across multiple
 
33
      director clusters.
33
34
 * 'host=s': The destination server's *IP address*. This field is required.
34
35
 * 'port=s': The destination server's port. The default is 143 with IMAP and
35
36
   110 with POP3.
38
39
 
39
40
You can use SSL/TLS connection to destination server by returning:
40
41
 
41
 
 * ssl=yes: Use SSL and require a valid verified remote certificate. *WARNING:
42
 
   Unless used carefully, this is an insecure setting!* Before
 
42
 * 'ssl=yes': Use SSL and require a valid verified remote certificate.
 
43
   *WARNING: Unless used carefully, this is an insecure setting!* Before
43
44
   v2.0.16/v2.1.beta1 the host name isn't checked in any way against the
44
45
   certificate's CN. The only way to use this securely is to only use and allow
45
46
   your own private CA's certs, anything else is exploitable by a
46
47
   man-in-the-middle attack.
47
 
 * ssl=any-cert: Use SSL, but don't require a valid remote certificate.
48
 
 * starttls: Use STARTTLS command instead of doing SSL handshake immediately
 
48
 * 'ssl=any-cert': Use SSL, but don't require a valid remote certificate.
 
49
 * 'starttls': Use STARTTLS command instead of doing SSL handshake immediately
49
50
   after connected.
50
 
 * starttls=any-cert: Combine starttls and ssl=any-cert.
 
51
 * 'starttls=any-cert': Combine starttls and ssl=any-cert.
51
52
 * Additionally you can also tell Dovecot to send SSL client certificate to the
52
53
   remote server using 'ssl_client_cert' and 'ssl_client_key' settings in
53
54
   'dovecot.conf' (v2.0.17+).
54
55
 
 
56
Set 'login_trusted_networks' to point to the proxies in the backends. This way
 
57
you'll get the clients' actual IP addresses logged instead of the proxy's.
 
58
 
55
59
The destination servers don't need to be running Dovecot, but you should make
56
60
sure that the Dovecot proxy doesn't advertise more capabilities than the
57
61
destination server can handle. For IMAP you can do this by changing
196
200
see: <PasswordDatabase.ExtraFields.txt> for more information, and a worked out
197
201
example
198
202
 
199
 
(This file was created from the wiki on 2012-04-23 04:42)
 
203
(This file was created from the wiki on 2013-11-24 04:42)