Better error message on die
[exim-website.git] / templates / web / howto / rbl.xsl
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
4         
5         <!-- WRAPPER -->
6                 <xsl:import href="../../wrapper.xsl"/>
7                 <xsl:template match="/"> <xsl:apply-imports/> </xsl:template>
8                 
9                 <xsl:variable name="docroot" select="'..'"/>
10
11         <!-- Title -->
12                 <xsl:variable name="html.head.title" select="'HOWTO - Using DNS Block Lists (DNSBLs)'"/>
13
14         <!-- Canonical -->
15                 <xsl:variable name="html.head.append">
16                         <link rel="canonical" href="http://www.exim.org/howto/rbl.html"/>
17                 </xsl:variable>
18  
19         <!-- CONTENT -->
20                 <xsl:template name="content">
21
22                         <h2>
23                                 <xsl:value-of select="$html.head.title"/>
24                         </h2>
25
26                         <p>The MAPS (Mail Abuse Protection System) RBL (Realtime Blackhole List) was the first application of a way of using a DNS list as a means of identifying hosts that have been associated with the sending of spam mail. A full description of the service and the technology and ethics behind it can be found at <a href="http://www.mail-abuse.org/rbl/">http://www.mail-abuse.org/rbl/</a> along with more general mail policy information at <a href="http://www.mail-abuse.org/">http://www.mail-abuse.org/</a>.</p>
27
28                         <p>In the few years since MAPS started operating, other similar services although with different aims, procedures and reliabilities have been introduced - MAPS itself has a number of these (ie MAPS/DUL which maintains lists of dial up modems). At this point in time there are many 10s of services with varying charters - lists of these can be found at <a href="http://relays.osirusoft.com/">http://relays.osirusoft.com/</a> and <a href="http://spamblock.outblaze.com/spamchk.html">http://spamblock.outblaze.com/spamchk.html</a>. The services are now normally referred to as a DNS Block List (DNSBL), rather than RBLs, however you will find that earlier Exim documentation (ie for version 3.x) will use the older term.</p>
29
30                         <h3>Exim DNSBL Support</h3>
31
32                         <p>Exim has supported RBL from version 1.80, although the flexibility was increased (with a related change configuration options) on the release of Exim 3.00.  With the release of Exim 4.00 the whole basis of policy checks on incoming mail changed to be based on a set of Access Control Lists (ACLs) applied at various during the incoming mail transaction.  For this reason the configuration of Exim 4.x and later to use DNSBLs is complete different to that used for earlier versions.</p>
33
34                         <h3>Exim 4.x DNSBL Usage</h3>
35
36                         <p>In Exim 4.x a DNSBL lookup can be used in any of the incoming SMTP ACLs.  However it is typical for the lookups to be used in the ACL handling RCPT TO - this allows policies to accept mail for postmaster or other special local parts (for example so a blocked sender can talk to the local postmaster about getting blocks lifted or excluded)</p>
37
38                         <p>The use of DNSBLs is substantially documented in the main exim specification or the 4.x versions, so will not be covered in detail here.  However a couple of examples can be given</p>
39
40                         <pre># Add a warning header if the sending host is in these
41 # DNSBLs but acccept the message (or rather leave it for
42 # later ACLs to accept/deny
43 warn message = X-blacklisted-at: $dnslist_domain
44      dnslists = blackholes.mail-abuse.org : \
45                 dialup.mail-abuse.org
46
47 # Reject messages from senders listed in these DNSBLs
48 deny dnslists = blackholes.mail-abuse.org</pre>
49
50                         <p>Documentation on these features can be found in the specification section on <a href="../exim-html-current/doc/html/spec_html/ch40.html">Access Control Lists</a>.</p>
51
52                         <p>A typical configuration would be a mail system which rejects mail from machines that appear within either the MAPS RBL list or the MAPS DUL (Dial-Up List), and also checks hosts in the RSS lists but only marking each message has coming via an RBLed host rather than rejecting them.  Additionally all mail to the local postmaster always gets through, even if the host is in the MAPS RBL list.  You also have a local private set of IPs which relay out through this mail server on net 192.168.0.0/24 - these cannot be contacted from outside your organisation so RBL is not an issue.</p>
53
54                         <p>The information to do more complicated manipulations can be found in the specification document and is outside the scope of this note.</p>
55                 </xsl:template>
56
57 </xsl:stylesheet>