]> git.openstreetmap.org Git - chef.git/blob - cookbooks/exim/templates/default/exim4.conf.erb
Minor wordsmithing
[chef.git] / cookbooks / exim / templates / default / exim4.conf.erb
1 # DO NOT EDIT - This file is being maintained by Chef
2
3 ######################################################################
4 #                  Runtime configuration file for Exim               #
5 ######################################################################
6
7
8 # This is a default configuration file which will operate correctly in
9 # uncomplicated installations. Please see the manual for a complete list
10 # of all the runtime configuration options that can be included in a
11 # configuration file. There are many more than are mentioned here. The
12 # manual is in the file doc/spec.txt in the Exim distribution as a plain
13 # ASCII file. Other formats (PostScript, Texinfo, HTML, PDF) are available
14 # from the Exim ftp sites. The manual is also online at the Exim web sites.
15
16
17 # This file is divided into several parts, all but the first of which are
18 # headed by a line starting with the word "begin". Only those parts that
19 # are required need to be present. Blank lines, and lines starting with #
20 # are ignored.
21
22
23 ########### IMPORTANT ########## IMPORTANT ########### IMPORTANT ###########
24 #                                                                          #
25 # Whenever you change Exim's configuration file, you *must* remember to    #
26 # HUP the Exim daemon, because it will not pick up the new configuration   #
27 # until you do. However, any other Exim processes that are started, for    #
28 # example, a process started by an MUA in order to send a message, will    #
29 # see the new configuration as soon as it is in place.                     #
30 #                                                                          #
31 # You do not need to HUP the daemon for changes in auxiliary files that    #
32 # are referenced from this file. They are read every time they are used.   #
33 #                                                                          #
34 # It is usually a good idea to test a new configuration for syntactic      #
35 # correctness before installing it (for example, by running the command    #
36 # "exim -C /config/file.new -bV").                                         #
37 #                                                                          #
38 ########### IMPORTANT ########## IMPORTANT ########### IMPORTANT ###########
39
40
41
42 ######################################################################
43 #                    MAIN CONFIGURATION SETTINGS                     #
44 ######################################################################
45 #
46
47 # Specify your host's canonical name here. This should normally be the fully
48 # qualified "official" name of your host. If this option is not set, the
49 # uname() function is called to obtain the name. In many cases this does
50 # the right thing and you need not set anything explicitly.
51
52 primary_hostname = <%= node[:fqdn] %>
53
54
55 # The next three settings create two lists of domains and one list of hosts.
56 # These lists are referred to later in this configuration using the syntax
57 # +local_domains, +relay_to_domains, and +relay_from_hosts, respectively. They
58 # are all colon-separated lists:
59
60 domainlist local_domains = <%= node[:exim][:local_domains].join(" : ") %>
61 domainlist relay_to_domains = <%= @relay_to_domains.join(" : ") %>
62 hostlist   relay_from_hosts = <; <%= @relay_from_hosts.join(" ; ") %>
63
64 # Most straightforward access control requirements can be obtained by
65 # appropriate settings of the above options. In more complicated situations,
66 # you may need to modify the Access Control Lists (ACLs) which appear later in
67 # this file.
68
69 # The first setting specifies your local domains, for example:
70 #
71 #   domainlist local_domains = my.first.domain : my.second.domain
72 #
73 # You can use "@" to mean "the name of the local host", as in the default
74 # setting above. This is the name that is specified by primary_hostname,
75 # as specified above (or defaulted). If you do not want to do any local
76 # deliveries, remove the "@" from the setting above. If you want to accept mail
77 # addressed to your host's literal IP address, for example, mail addressed to
78 # "user@[192.168.23.44]", you can add "@[]" as an item in the local domains
79 # list. You also need to uncomment "allow_domain_literals" below. This is not
80 # recommended for today's Internet.
81
82 # The second setting specifies domains for which your host is an incoming relay.
83 # If you are not doing any relaying, you should leave the list empty. However,
84 # if your host is an MX backup or gateway of some kind for some domains, you
85 # must set relay_to_domains to match those domains. For example:
86 #
87 # domainlist relay_to_domains = *.myco.com : my.friend.org
88 #
89 # This will allow any host to relay through your host to those domains.
90 # See the section of the manual entitled "Control of relaying" for more
91 # information.
92
93 # The third setting specifies hosts that can use your host as an outgoing relay
94 # to any other host on the Internet. Such a setting commonly refers to a
95 # complete local network as well as the localhost. For example:
96 #
97 # hostlist relay_from_hosts = <; 127.0.0.1 ; ::1 ; 192.168.0.0/16
98 #
99 # The "/16" is a bit mask (CIDR notation), not a number of hosts. Note that you
100 # have to include 127.0.0.1 if you want to allow processes on your host to send
101 # SMTP mail by using the loopback address. A number of MUAs use this method of
102 # sending mail.  Often, connections are made to "localhost", which might be ::1
103 # on IPv6-enabled hosts.  Do not forget CIDR for your IPv6 networks.
104
105 # All three of these lists may contain many different kinds of item, including
106 # wildcarded names, regular expressions, and file lookups. See the reference
107 # manual for details. The lists above are used in the access control lists for
108 # checking incoming messages. The names of these ACLs are defined here:
109
110 acl_smtp_rcpt = acl_check_rcpt
111 acl_smtp_data = acl_check_data
112
113 # You should not change those settings until you understand how ACLs work.
114
115
116 <% if File.exist?("/var/run/clamav/clamd.ctl") -%>
117 # If you are running a version of Exim that was compiled with the content-
118 # scanning extension, you can cause incoming messages to be automatically
119 # scanned for viruses. You have to modify the configuration in two places to
120 # set this up. The first of them is here, where you define the interface to
121 # your scanner. This example is typical for ClamAV; see the manual for details
122 # of what to set for other virus scanners. The second modification is in the
123 # acl_check_data access control list (see below).
124
125 av_scanner = clamd:/var/run/clamav/clamd.ctl
126
127
128 <% end -%>
129 <% if File.exist?("/var/run/spamd.pid") -%>
130 # For spam scanning, there is a similar option that defines the interface to
131 # SpamAssassin. You do not need to set this if you are using the default, which
132 # is shown in this commented example. As for virus scanning, you must also
133 # modify the acl_check_data access control list to enable spam scanning.
134
135 spamd_address = 127.0.0.1 783
136
137
138 <% end -%>
139 # If Exim is compiled with support for TLS, you may want to enable the
140 # following options so that Exim allows clients to make encrypted
141 # connections. In the authenticators section below, there are template
142 # configurations for plaintext username/password authentication. This kind
143 # of authentication is only safe when used within a TLS connection, so the
144 # authenticators will only work if the following TLS settings are turned on
145 # as well.
146
147 # Allow any client to use TLS.
148
149 tls_advertise_hosts = *
150
151 # Specify the location of the Exim server's TLS certificate and private key.
152 # The private key must not be encrypted (password protected). You can put
153 # the certificate and private key in the same file, in which case you only
154 # need the first setting, or in separate files, in which case you need both
155 # options.
156
157 <% if node[:exim][:certificate_names] -%>
158 tls_certificate = /etc/ssl/certs/<%= node[:exim][:certificate_names].first %>.pem
159 tls_privatekey = /etc/ssl/private/<%= node[:exim][:certificate_names].first %>.key
160 <% else -%>
161 tls_certificate = /etc/ssl/certs/exim.pem
162 tls_privatekey = /etc/ssl/private/exim.key
163 <% end -%>
164
165 # Configure TLS cipher selection.
166
167 tls_require_ciphers = <%= node[:ssl][:gnutls_ciphers] %>:%SERVER_PRECEDENCE
168
169 # In order to support roaming users who wish to send email from anywhere,
170 # you may want to make Exim listen on other ports as well as port 25, in
171 # case these users need to send email from a network that blocks port 25.
172 # The standard port for this purpose is port 587, the "message submission"
173 # port. See RFC 4409 for details. Microsoft MUAs cannot be configured to
174 # talk the message submission protocol correctly, so if you need to support
175 # them you should also allow TLS-on-connect on the traditional but
176 # non-standard port 465.
177
178 daemon_smtp_ports = <%= node[:exim][:daemon_smtp_ports].join(" : ") %>
179 # tls_on_connect_ports = 465
180
181
182 # Specify the domain you want to be added to all unqualified addresses
183 # here. An unqualified address is one that does not contain an "@" character
184 # followed by a domain. For example, "caesar@rome.example" is a fully qualified
185 # address, but the string "caesar" (i.e. just a login name) is an unqualified
186 # email address. Unqualified addresses are accepted only from local callers by
187 # default. See the recipient_unqualified_hosts option if you want to permit
188 # unqualified addresses from remote sources. If this option is not set, the
189 # primary_hostname value is used for qualification.
190
191 qualify_domain = openstreetmap.org
192
193
194 # If you want unqualified recipient addresses to be qualified with a different
195 # domain to unqualified sender addresses, specify the recipient domain here.
196 # If this option is not set, the qualify_domain value is used.
197
198 qualify_recipient = <%= node[:fqdn] %>
199
200
201 # The following line must be uncommented if you want Exim to recognize
202 # addresses of the form "user@[10.11.12.13]" that is, with a "domain literal"
203 # (an IP address) instead of a named domain. The RFCs still require this form,
204 # but it makes little sense to permit mail to be sent to specific hosts by
205 # their IP address in the modern Internet. This ancient format has been used
206 # by those seeking to abuse hosts by using them for unwanted relaying. If you
207 # really do want to support domain literals, uncomment the following line, and
208 # see also the "domain_literal" router below.
209
210 # allow_domain_literals
211
212
213 # No deliveries will ever be run under the uids of users specified by
214 # never_users (a colon-separated list). An attempt to do so causes a panic
215 # error to be logged, and the delivery to be deferred. This is a paranoic
216 # safety catch. There is an even stronger safety catch in the form of the
217 # FIXED_NEVER_USERS setting in the configuration for building Exim. The list of
218 # users that it specifies is built into the binary, and cannot be changed. The
219 # option below just adds additional users to the list. The default for
220 # FIXED_NEVER_USERS is "root", but just to be absolutely sure, the default here
221 # is also "root".
222
223 # Note that the default setting means you cannot deliver mail addressed to root
224 # as if it were a normal user. This isn't usually a problem, as most sites have
225 # an alias for root that redirects such mail to a human administrator.
226
227 never_users = root
228
229
230 # The setting below causes Exim to do a reverse DNS lookup on all incoming
231 # IP calls, in order to get the true host name. If you feel this is too
232 # expensive, you can specify the networks for which a lookup is done, or
233 # remove the setting entirely.
234
235 host_lookup = *
236
237
238 # The settings below cause Exim to make RFC 1413 (ident) callbacks
239 # for all incoming SMTP calls. You can limit the hosts to which these
240 # calls are made, and/or change the timeout that is used. If you set
241 # the timeout to zero, all RFC 1413 calls are disabled. RFC 1413 calls
242 # are cheap and can provide useful information for tracing problem
243 # messages, but some hosts and firewalls have problems with them.
244 # This can result in a timeout instead of an immediate refused
245 # connection, leading to delays on starting up SMTP sessions.
246 # (The default was reduced from 30s to 5s for release 4.61. and to
247 # disabled for release 4.86)
248 #
249 #rfc1413_hosts = *
250 #rfc1413_query_timeout = 5s
251
252
253 # Enable an efficiency feature.  We advertise the feature; clients
254 # may request to use it.  For multi-recipient mails we then can
255 # reject or accept per-user after the message is received.
256 #
257 prdr_enable = true
258
259
260 # By default, Exim expects all envelope addresses to be fully qualified, that
261 # is, they must contain both a local part and a domain. If you want to accept
262 # unqualified addresses (just a local part) from certain hosts, you can specify
263 # these hosts by setting one or both of
264 #
265 # sender_unqualified_hosts =
266 # recipient_unqualified_hosts =
267 #
268 # to control sender and recipient addresses, respectively. When this is done,
269 # unqualified addresses are qualified using the settings of qualify_domain
270 # and/or qualify_recipient (see above).
271
272
273 # Unless you run a high-volume site you probably want more logging
274 # detail than the default.  Adjust to suit.
275
276 log_selector = +all -skip_delivery
277
278
279 # If you want Exim to support the "percent hack" for certain domains,
280 # uncomment the following line and provide a list of domains. The "percent
281 # hack" is the feature by which mail addressed to x%y@z (where z is one of
282 # the domains listed) is locally rerouted to x@y and sent on. If z is not one
283 # of the "percent hack" domains, x%y is treated as an ordinary local part. This
284 # hack is rarely needed nowadays; you should not enable it unless you are sure
285 # that you really need it.
286 #
287 # percent_hack_domains =
288 #
289 # As well as setting this option you will also need to remove the test
290 # for local parts containing % in the ACL definition below.
291
292
293 # When Exim can neither deliver a message nor return it to sender, it "freezes"
294 # the delivery error message (aka "bounce message"). There are also other
295 # circumstances in which messages get frozen. They will stay on the queue for
296 # ever unless one of the following options is set.
297
298 # This option unfreezes frozen bounce messages after two days, tries
299 # once more to deliver them, and ignores any delivery failures.
300
301 ignore_bounce_errors_after = 2d
302
303 # This option cancels (removes) frozen messages that are older than a week.
304
305 timeout_frozen_after = 7d
306
307
308 # By default, messages that are waiting on Exim's queue are all held in a
309 # single directory called "input" which it itself within Exim's spool
310 # directory. (The default spool directory is specified when Exim is built, and
311 # is often /var/spool/exim/.) Exim works best when its queue is kept short, but
312 # there are circumstances where this is not always possible. If you uncomment
313 # the setting below, messages on the queue are held in 62 subdirectories of
314 # "input" instead of all in the same directory. The subdirectories are called
315 # 0, 1, ... A, B, ... a, b, ... z. This has two benefits: (1) If your file
316 # system degrades with many files in one directory, this is less likely to
317 # happen; (2) Exim can process the queue one subdirectory at a time instead of
318 # all at once, which can give better performance with large queues.
319
320 # split_spool_directory = true
321
322
323 # If you're in a part of the world where ASCII is not sufficient for most
324 # text, then you're probably familiar with RFC2047 message header extensions.
325 # By default, Exim adheres to the specification, including a limit of 76
326 # characters to a line, with encoded words fitting within a line.
327 # If you wish to use decoded headers in message filters in such a way
328 # that successful decoding of malformed messages matters, you may wish to
329 # configure Exim to be more lenient.
330 #
331 # check_rfc2047_length = false
332 #
333 # In particular, the Exim maintainers have had multiple reports of problems
334 # from Russian administrators of issues until they disable this check,
335 # because of some popular, yet buggy, mail composition software.
336
337
338 # If you wish to be strictly RFC compliant, or if you know you'll be
339 # exchanging email with systems that are not 8-bit clean, then you may
340 # wish to disable advertising 8BITMIME.  Uncomment this option to do so.
341
342 # accept_8bitmime = false
343
344
345 # Exim does not make use of environment variables itself. However,
346 # libraries that Exim uses (e.g. LDAP) depend on specific environment settings.
347 # There are two lists: keep_environment for the variables we trust, and
348 # add_environment for variables we want to set to a specific value.
349 # Note that TZ is handled separately by the timezone runtime option
350 # and TIMEZONE_DEFAULT buildtime option.
351
352 # keep_environment = ^LDAP
353 # add_environment = PATH=/usr/bin::/bin
354
355
356 # Define trusted users.
357
358 trusted_users = <%= node[:exim][:trusted_users].join(" : ") %>
359
360
361 # Do all deliveries via a limited set of queues.
362
363 queue_only = true
364 queue_run_max = <%= node[:exim][:queue_run_max] %>
365
366
367 # Maximum number of simultaneous SMTP connections
368
369 smtp_accept_max = <%= node[:exim][:smtp_accept_max] %>
370
371
372
373 ######################################################################
374 #                       ACL CONFIGURATION                            #
375 #         Specifies access control lists for incoming SMTP mail      #
376 ######################################################################
377
378 begin acl
379
380 # This access control list is used for every RCPT command in an incoming
381 # SMTP message. The tests are run in order until the address is either
382 # accepted or denied.
383
384 acl_check_rcpt:
385
386   # Accept if the source is local SMTP (i.e. not over TCP/IP). We do this by
387   # testing for an empty sending host field.
388
389   accept  hosts = :
390           control = dkim_disable_verify
391
392   #############################################################################
393   # The following section of the ACL is concerned with local parts that contain
394   # @ or % or ! or / or | or dots in unusual places.
395   #
396   # The characters other than dots are rarely found in genuine local parts, but
397   # are often tried by people looking to circumvent relaying restrictions.
398   # Therefore, although they are valid in local parts, these rules lock them
399   # out, as a precaution.
400   #
401   # Empty components (two dots in a row) are not valid in RFC 2822, but Exim
402   # allows them because they have been encountered. (Consider local parts
403   # constructed as "firstinitial.secondinitial.familyname" when applied to
404   # someone like me, who has no second initial.) However, a local part starting
405   # with a dot or containing /../ can cause trouble if it is used as part of a
406   # file name (e.g. for a mailing list). This is also true for local parts that
407   # contain slashes. A pipe symbol can also be troublesome if the local part is
408   # incorporated unthinkingly into a shell command line.
409   #
410   # Two different rules are used. The first one is stricter, and is applied to
411   # messages that are addressed to one of the local domains handled by this
412   # host. The line "domains = +local_domains" restricts it to domains that are
413   # defined by the "domainlist local_domains" setting above. The rule  blocks
414   # local parts that begin with a dot or contain @ % ! / or |. If you have
415   # local accounts that include these characters, you will have to modify this
416   # rule.
417
418   deny    message       = Restricted characters in address
419           domains       = +local_domains
420           local_parts   = ^[.] : ^.*[@%!/|]
421
422   # The second rule applies to all other domains, and is less strict. The line
423   # "domains = !+local_domains" restricts it to domains that are NOT defined by
424   # the "domainlist local_domains" setting above. The exclamation mark is a
425   # negating operator. This rule allows your own users to send outgoing
426   # messages to sites that use slashes and vertical bars in their local parts.
427   # It blocks local parts that begin with a dot, slash, or vertical bar, but
428   # allows these characters within the local part. However, the sequence /../
429   # is barred. The use of @ % and ! is blocked, as before. The motivation here
430   # is to prevent your users (or your users' viruses) from mounting certain
431   # kinds of attack on remote sites.
432
433   deny    message       = Restricted characters in address
434           domains       = !+local_domains
435           local_parts   = ^[./|] : ^.*[@%!] : ^.*/\\.\\./
436   #############################################################################
437
438   # Block bounces to selected addresses
439
440   deny    local_parts   = root:postmaster:webmaster:abuse:support
441           senders       = :
442
443   # Block blacklisted senders
444
445   deny    senders       = lsearch*@;/etc/exim4/blocked-senders
446           message       = Rejected because $sender_address is blacklisted\nQueries to postmaster@$qualify_domain
447           !hosts        = +relay_from_hosts
448
449   deny    sender_domains= partial-lsearch;/etc/exim4/blocked-sender-domains
450           message       = Rejected because $sender_address is blacklisted\nQueries to postmaster@$qualify_domain
451           !hosts        = +relay_from_hosts
452
453   # Accept mail to postmaster in any local domain, regardless of the source,
454   # and without verifying the sender.
455
456   accept  local_parts   = postmaster
457           domains       = +local_domains
458
459   # Deny incoming mail unless the sender address can be verified.
460
461   deny   !hosts         = +relay_from_hosts
462          !verify        = sender
463
464   # Accept if the message comes from one of the hosts for which we are an
465   # outgoing relay. It is assumed that such hosts are most likely to be MUAs,
466   # so we set control=submission to make Exim treat the message as a
467   # submission. It will fix up various errors in the message, for example, the
468   # lack of a Date: header line. If you are actually relaying out out from
469   # MTAs, you may want to disable this. If you are handling both relaying from
470   # MTAs and submissions from MUAs you should probably split them into two
471   # lists, and handle them differently.
472
473   # Recipient verification is omitted here, because in many cases the clients
474   # are dumb MUAs that don't cope well with SMTP error responses. If you are
475   # actually relaying out from MTAs, you should probably add recipient
476   # verification here.
477
478   # Note that, by putting this test before any DNS black list checks, you will
479   # always accept from these hosts, even if they end up on a black list. The
480   # assumption is that they are your friends, and if they get onto a black
481   # list, it is a mistake.
482
483   accept  hosts         = +relay_from_hosts
484           control       = submission
485           control       = dkim_disable_verify
486
487   # Accept if the message arrived over an authenticated connection, from
488   # any host. Again, these messages are usually from MUAs, so recipient
489   # verification is omitted, and submission mode is set. And again, we do this
490   # check before any black list tests.
491
492   accept  authenticated = *
493           control       = submission
494           control       = dkim_disable_verify
495
496   # Insist that any other recipient address that we accept is either in one of
497   # our local domains, or is in a domain for which we explicitly allow
498   # relaying. Any other domain is rejected as being unacceptable for relaying.
499
500   require message = relay not permitted
501           domains = +local_domains : +relay_to_domains
502
503   # We also require all accepted addresses to be verifiable. This check will
504   # do local part verification for local domains, but only check the domain
505   # for remote domains. The only way to check local parts for the remote
506   # relay domains is to use a callout (add /callout), but please read the
507   # documentation about callouts before doing this.
508
509   deny    domains = +relay_to_domains
510          !verify  = recipient/callout=use_sender
511
512   deny    domains = !+relay_to_domains
513          !verify  = recipient
514
515 <% if node[:exim][:dns_blacklists] -%>
516   # Deny any messages from hosts in certain blacklists.
517
518   deny    message       = Rejected because $sender_host_address is in a black list at $dnslist_domain\n$dnslist_text
519           dnslists      = <%= node[:exim][:dns_blacklists].join(" : ") %>
520
521 <% end -%>
522   #############################################################################
523   # This check is commented out because it is recognized that not every
524   # sysadmin will want to do it. If you enable it, the check performs
525   # Client SMTP Authorization (csa) checks on the sending host. These checks
526   # do DNS lookups for SRV records. The CSA proposal is currently (May 2005)
527   # an Internet draft. You can, of course, add additional conditions to this
528   # ACL statement to restrict the CSA checks to certain hosts only.
529   #
530   # require verify = csa
531   #############################################################################
532
533   # At this point, the address has passed all the checks that have been
534   # configured, so we accept it unconditionally.
535
536   accept
537
538
539 # This ACL is used after the contents of a message have been received. This
540 # is the ACL in which you can test a message's headers or body, and in
541 # particular, this is where you can invoke external virus or spam scanners.
542 # Some suggested ways of configuring these tests are shown below, commented
543 # out. Without any tests, this ACL accepts all messages. If you want to use
544 # such tests, you must ensure that Exim is compiled with the content-scanning
545 # extension (WITH_CONTENT_SCAN=yes in Local/Makefile).
546
547 acl_check_data:
548
549 <% if File.exist?("/var/run/clamav/clamd.ctl") -%>
550   # Deny if the message contains a virus. Before enabling this check, you
551   # must install a virus scanner and set the av_scanner option above.
552   #
553   deny    malware    = *
554           message    = This message was detected as possible malware ($malware_name).
555
556 <% end -%>
557 <% if File.exist?("/var/run/spamd.pid") -%>
558   # Deny if the message looks like spam. Before enabling this check, you
559   # must install spamassassin and set the spamd_address option above.
560   #
561   deny    spam       = nobody/deferok
562           message    = This message scored $spam_score SpamAssassin points.
563
564 <% end -%>
565   # Deny spammy messages with headers of the form:
566   #   X-PHP-Originating-Script: <digits>:<name>.php
567   #   X-PHP-Originating-Script: <digits>:<name>.class.php
568   deny    condition  = ${if match {$h_X-PHP-Originating-Script:}{^[0-9]+:[A-Za-z]+(\\.class)?\\.php\$}}
569          !hosts      = +relay_from_hosts
570           message    = This message failed local spam checks.
571
572   # Accept messages from relay hosts without modification.
573
574   accept  hosts      = +relay_from_hosts
575
576   # Accept messages from external hosts and add authentication results.
577
578   accept  add_header = :at_start:${authresults {$primary_hostname}}
579
580
581
582 ######################################################################
583 #                      ROUTERS CONFIGURATION                         #
584 #               Specifies how addresses are handled                  #
585 ######################################################################
586 #     THE ORDER IN WHICH THE ROUTERS ARE DEFINED IS IMPORTANT!       #
587 # An address is passed to each router in turn until it is accepted.  #
588 ######################################################################
589
590 begin routers
591
592 # This router handles aliasing using a linearly searched alias file with the
593 # name /etc/aliases. When this configuration is installed automatically,
594 # the name gets inserted into this file from whatever is set in Exim's
595 # build-time configuration. The default path is the traditional /etc/aliases.
596 # If you install this configuration by hand, you need to specify the correct
597 # path in the "data" setting below.
598 #
599 ##### NB  You must ensure that the alias file exists. It used to be the case
600 ##### NB  that every Unix had that file, because it was the Sendmail default.
601 ##### NB  These days, there are systems that don't have it. Your aliases
602 ##### NB  file should at least contain an alias for "postmaster".
603 #
604 # If any of your aliases expand to pipes or files, you will need to set
605 # up a user and a group for these deliveries to run under. You can do
606 # this by uncommenting the "user" option below (changing the user name
607 # as appropriate) and adding a "group" option if necessary. Alternatively, you
608 # can specify "user" on the transports that are used. Note that the transports
609 # listed below are the same as are used for .forward files; you might want
610 # to set up different ones for pipe and file deliveries from aliases.
611
612 system_aliases:
613   driver = redirect
614   domains = !noreply.openstreetmap.org : +local_domains
615   allow_fail
616   allow_defer
617   data = ${lookup{$local_part}lsearch{/etc/aliases}}
618 # user = exim
619   file_transport = address_file
620   pipe_transport = address_pipe
621
622 <% if File.directory?("/var/lib/mailman") -%>
623 # This router handles mail for mailman mailing lists.
624
625 mailman:
626   driver = accept
627   domains = +local_domains
628   condition = ${lookup{$local_part@$domain}lsearch{/var/lib/mailman/data/virtual-mailman}{1}{0}}
629   require_files = /var/lib/mailman/lists/$local_part/config.pck
630   local_part_suffix = -bounces : -bounces+* : \
631                       -confirm+* : -join : -leave : \
632                       -subscribe : -unsubscribe : \
633                       -owner : -request : -admin 
634   local_part_suffix_optional
635   transport = mailman
636
637 <% end -%>
638 # This router handles mail for noreply.openstreetmap.org
639
640 noreply:
641   driver = accept
642   domains = noreply.openstreetmap.org
643   require_files = /etc/exim4/noreply/$local_part
644   transport = noreply
645
646 <% node[:exim][:routes].each do |name,details| -%>
647 # This router handles mail for <%= details[:comment] -%>.
648
649 <%= name -%>:
650 <% if details[:host] -%>
651   driver = manualroute
652 <% else -%>
653   driver = accept
654 <% end -%>
655 <% if details[:domains] -%>
656   domains = <%= details[:domains].join(" : ") %>
657 <% end -%>
658 <% if details[:local_parts] -%>
659   local_parts = <%= details[:local_parts].join(" : ") %>
660   local_part_suffix = +*
661   local_part_suffix_optional
662 <% end -%>
663 <% if details[:host] -%>
664 <% if details[:host].kind_of?(Array) -%>
665   route_data = <%= details[:host].join(":") %> byname
666 <% else -%>
667   route_data = <%= details[:host] %> byname
668 <% end -%>
669   transport = remote_smtp
670 <% else -%>
671   transport = <%= name %>
672 <% end -%>
673
674 <% end -%>
675
676 <% if node[:exim][:smarthost_via] -%>
677 # This router routes addresses that are not in local domains by
678 # forwarding them to a smarthost.
679
680 smarthost:
681   driver = manualroute
682   domains = ! +local_domains
683   transport = remote_smtp
684   route_data = <%= node[:exim][:smarthost_via].gsub(":", "::") -%> byname
685   same_domain_copy_routing = yes
686   no_more
687 <% else -%>
688 # This router routes addresses that are not in local domains by doing a DNS
689 # lookup on the domain name. The exclamation mark that appears in "domains = !
690 # +local_domains" is a negating operator, that is, it can be read as "not". The
691 # recipient's domain must not be one of those defined by "domainlist
692 # local_domains" above for this router to be used.
693 #
694 # If the router is used, any domain that resolves to 0.0.0.0 or to a loopback
695 # interface address (127.0.0.0/8) is treated as if it had no DNS entry. Note
696 # that 0.0.0.0 is the same as 0.0.0.0/32, which is commonly treated as the
697 # local host inside the network stack. It is not 0.0.0.0/0, the default route.
698 # If the DNS lookup fails, no further routers are tried because of the no_more
699 # setting, and consequently the address is unrouteable.
700
701 dnslookup:
702   driver = dnslookup
703   domains = ! +local_domains
704   transport = signed_smtp
705   same_domain_copy_routing = yes
706   ignore_target_hosts = 0.0.0.0 : 127.0.0.0/8
707   no_more
708 <% end -%>
709
710
711 ######################################################################
712 #                      TRANSPORTS CONFIGURATION                      #
713 ######################################################################
714 #                       ORDER DOES NOT MATTER                        #
715 #     Only one appropriate transport is called for each delivery.    #
716 ######################################################################
717
718 # A transport is used only when referenced from a router that successfully
719 # handles an address.
720
721 begin transports
722
723
724 # This transport is used for delivering messages over SMTP connections.
725
726 remote_smtp:
727   driver = smtp
728   multi_domain = false
729   tls_require_ciphers = <%= node[:ssl][:gnutls_ciphers] %>:%LATEST_RECORD_VERSION
730
731
732 # This transport is used for delivering DKIM signed messages over SMTP connections.
733
734 signed_smtp:
735   driver = smtp
736   connect_timeout = 1m
737   dkim_domain = ${lookup{${domain:$h_from:}}partial-lsearch{/etc/exim4/dkim-domains}{$value}}
738   dkim_selector = ${lookup{$dkim_domain}lsearch{/etc/exim4/dkim-selectors}{$value}}
739   dkim_private_key = /etc/exim4/dkim-keys/${dkim_domain}
740   dkim_identity = ${lc:${address:$h_from:}}
741   dkim_timestamps = 1209600
742   multi_domain = false
743   hosts_try_dane =
744   tls_require_ciphers = <%= node[:ssl][:gnutls_ciphers] %>:%LATEST_RECORD_VERSION
745
746
747 # This transport is used for handling pipe deliveries generated by alias or
748 # .forward files. If the pipe generates any standard output, it is returned
749 # to the sender of the message as a delivery error. Set return_fail_output
750 # instead of return_output if you want this to happen only when the pipe fails
751 # to complete normally. You can set different transports for aliases and
752 # forwards if you want to - see the references to address_pipe in the routers
753 # section above.
754
755 address_pipe:
756   driver = pipe
757   return_output
758
759
760 # This transport is used for handling deliveries directly to files that are
761 # generated by aliasing or forwarding.
762
763 address_file:
764   driver = appendfile
765   delivery_date_add
766   envelope_to_add
767   return_path_add
768
769
770 <% if File.directory?("/var/lib/mailman") -%>
771 # This transport is used for handling deliveries to mailman mailing lists.
772
773 mailman:
774   driver = pipe
775   command = /var/lib/mailman/mail/mailman \
776             '${if def:local_part_suffix \
777                   {${sg{$local_part_suffix}{-(\\w+)(\\+.*)?}{\$1}}} \
778                   {post}}' \
779             $local_part
780   current_directory = /var/lib/mailman
781   home_directory = /var/lib/mailman
782   user = list
783   group = daemon
784   freeze_exec_fail = true
785
786
787 <% end -%>
788 # This transport handles mail for noreply.openstreetmap.org
789
790 noreply:
791   driver = autoreply
792   from = OpenStreetMap <noreply@openstreetmap.org>
793   to = $sender_address
794   subject = Re: $header_subject:
795   headers = MIME-Version: 1.0\nContent-Type: text/plain; charset=utf-8
796   file = ${lookup{$local_part}dsearch,filter=file,ret=full{/etc/exim4/noreply}}
797   user = Debian-exim
798   group = Debian-exim
799
800 <% node[:exim][:routes].each do |name,details| -%>
801 <% if details[:command] or details[:file] or details[:maildir] -%>
802 # This transport handles mail for <%= details[:comment] -%>.
803
804 <%= name -%>:
805 <% if details[:command] -%>
806   driver = pipe
807   command = <%= details[:command] %>
808   home_directory = <%= details[:home_directory] %>
809   path = <%= details[:path] || "/bin:/usr/bin" %>
810 <% if details[:environment] -%>
811   environment = <%= details[:environment].map { |k,v| "#{k}=#{v}" }.join(":") %>
812 <% end -%>
813   return_fail_output
814 <% else -%>
815   driver = appendfile
816 <% if details[:file] -%>
817   file = <%= details[:file] %>
818 <% elsif details[:maildir] -%>
819   directory = <%= details[:maildir] %>
820   maildir_format
821 <% end -%>
822   envelope_to_add
823   return_path_add
824   mode = 0660
825 <% end -%>
826   user = <%= details[:user] %>
827 <% if details[:group] -%>
828   group = <%= details[:group] %>
829 <% end -%>
830
831 <% end -%>
832 <% end -%>
833
834 ######################################################################
835 #                      RETRY CONFIGURATION                           #
836 ######################################################################
837
838 begin retry
839
840 # This single retry rule applies to all domains and all errors. It specifies
841 # retries every 15 minutes for 2 hours, then increasing retry intervals,
842 # starting at 1 hour and increasing each time by a factor of 1.5, up to 16
843 # hours, then retries every 6 hours until 4 days have passed since the first
844 # failed delivery.
845
846 # WARNING: If you do not have any retry rules at all (this section of the
847 # configuration is non-existent or empty), Exim will not do any retries of
848 # messages that fail to get delivered at the first attempt. The effect will
849 # be to treat temporary errors as permanent. Therefore, DO NOT remove this
850 # retry rule unless you really don't want any retries.
851
852 # Address or Domain    Error       Retries
853 # -----------------    -----       -------
854
855 *                      *           F,2h,15m; G,16h,1h,1.5; F,4d,6h
856
857
858
859 ######################################################################
860 #                      REWRITE CONFIGURATION                         #
861 ######################################################################
862
863 # There are no rewriting specifications in this default configuration file.
864
865 begin rewrite
866 *@<%= node[:fqdn] %> "${if !match {${lookup{$1}lsearch{/etc/aliases}{$value}}}{@} {$1@openstreetmap.org}fail}" Eh
867 <% node[:exim][:rewrites].each do |rewrite| -%>
868 <%= rewrite[:pattern] %> <%= rewrite[:replacement] %> <%= rewrite[:flags] %>
869 <% end -%>
870
871
872
873 ######################################################################
874 #                   AUTHENTICATION CONFIGURATION                     #
875 ######################################################################
876
877 # The following authenticators support plaintext username/password
878 # authentication using the standard PLAIN mechanism and the traditional
879 # but non-standard LOGIN mechanism, with Exim acting as the server.
880 # PLAIN and LOGIN are enough to support most MUA software.
881 #
882 # These authenticators are not complete: you need to change the
883 # server_condition settings to specify how passwords are verified.
884 # They are set up to offer authentication to the client only if the
885 # connection is encrypted with TLS, so you also need to add support
886 # for TLS. See the global configuration options section at the start
887 # of this file for more about TLS.
888 #
889 # The default RCPT ACL checks for successful authentication, and will accept
890 # messages from authenticated users from anywhere on the Internet.
891
892 begin authenticators
893
894 # PLAIN authentication has no server prompts. The client sends its
895 # credentials in one lump, containing an authorization ID (which we do not
896 # use), an authentication ID, and a password. The latter two appear as
897 # $auth2 and $auth3 in the configuration and should be checked against a
898 # valid username and password. In a real configuration you would typically
899 # use $auth2 as a lookup key, and compare $auth3 against the result of the
900 # lookup, perhaps using the crypteq{}{} condition.
901
902 #PLAIN:
903 #  driver                     = plaintext
904 #  server_set_id              = $auth2
905 #  server_prompts             = :
906 #  server_condition           = Authentication is not yet configured
907 #  server_advertise_condition = ${if def:tls_cipher }
908
909 # LOGIN authentication has traditional prompts and responses. There is no
910 # authorization ID in this mechanism, so unlike PLAIN the username and
911 # password are $auth1 and $auth2. Apart from that you can use the same
912 # server_condition setting for both authenticators.
913
914 #LOGIN:
915 #  driver                     = plaintext
916 #  server_set_id              = $auth1
917 #  server_prompts             = <| Username: | Password:
918 #  server_condition           = Authentication is not yet configured
919 #  server_advertise_condition = ${if def:tls_cipher }
920
921
922 ######################################################################
923 #                   CONFIGURATION FOR local_scan()                   #
924 ######################################################################
925
926 # If you have built Exim to include a local_scan() function that contains
927 # tables for private options, you can define those options here. Remember to
928 # uncomment the "begin" line. It is commented by default because it provokes
929 # an error with Exim binaries that are not built with LOCAL_SCAN_HAS_OPTIONS
930 # set in the Local/Makefile.
931
932 # begin local_scan
933
934
935 # End of Exim configuration file