and include it
[mirror/userdir-ldap-cgi.git] / html / doc-mail-handling.wml
1 #use wml::db.d.o title="User Settable Mail Configuration"
2 #use wml::vbar
3
4 <dsatoc/>
5
6 <p>
7 Debian developers have a wide variety of loud and conflicting opinions
8 about what constitutes correct handling of their mail, making it impossible for
9 an admin to choose a single setup that fits all use cases.
10 </p>
11
12 <p>
13 Instead, we invite you to configure your own spam handling.
14 </p>
15
16 <p>
17 Some options available to you are:
18 </p>
19 <ul>
20   <li><b>bATVToken</b> (to be enabled before 1/1/2010, with any luck) BATV
21   private token for address rewriting.  Useful in combatting bounce forgery, but
22   requires configuration on your own mail relay(s).
23   <li><b>emailForward</b> Address to forward your mail to.  Setting this and
24   then rejecting mail from d.o machines is less than helpful.
25   <li><b>mailCallout</b> Whether or not to use Sender Address Verification.
26   <li><b>mailContentInspectionAction</b> One of reject, markup, or blackhole.
27   Applies to checks done on the content of message bodies, such as spam and
28   virus checks.  Reject is default, and will reject the mail if a match occurs.
29   Markup will add a header and then forward the mail to you anyway.  Blackhole
30   will accept the mail and silently discard it.
31   <li><b>mailDefaultOptions</b> (to be enabled before 1/1/2010, with any
32   luck) Whether to enable the 'normal' set of (fairly
33   minimal) SMTP time checks that DSA decide are appropriate.  Defaults to true.
34   <li><b>mailGreylisting</b> Whether to enable greylisting.
35   <li><b>mailRBL</b> Set of RBLs to use.
36   <li><b>mailRHSBL</b> Set of RHSBLs to use.
37   <li><b>mailWhitelist</b> Sender envelopes to whitelist.
38   <li><b>mailDisableMessage</b> Absolute last resort measure - will disable
39   incoming mail from all machines not part of the Debian host list (see
40   /var/lib/misc/thishost/debianhosts on any d.o machine).  This makes it very
41   difficult for things like automated pings and mass mailings to all concerned
42   DDs about changes to happen, and is strongly discouraged.
43 </ul>