3 ### Basic settings for distorted.org.uk Exim configuration
5 ### (c) 2012 Mark Wooding
8 ###----- Licensing notice ---------------------------------------------------
10 ### This program is free software; you can redistribute it and/or modify
11 ### it under the terms of the GNU General Public License as published by
12 ### the Free Software Foundation; either version 2 of the License, or
13 ### (at your option) any later version.
15 ### This program is distributed in the hope that it will be useful,
16 ### but WITHOUT ANY WARRANTY; without even the implied warranty of
17 ### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 ### GNU General Public License for more details.
20 ### You should have received a copy of the GNU General Public License
21 ### along with this program; if not, write to the Free Software Foundation,
22 ### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
24 ###--------------------------------------------------------------------------
27 SECTION(global, priv)m4_dnl
28 admin_groups = CONF_admin_groups
29 trusted_groups = CONF_trusted_groups
30 prod_requires_admin = false
32 SECTION(global, logging)m4_dnl
33 log_file_path = : syslog
38 syslog_duplication = false
39 syslog_timestamp = false
41 SECTION(global, daemon)m4_dnl
42 local_interfaces = <; CONF_interfaces
43 extra_local_interfaces = <; 0.0.0.0 ; ::0
45 SECTION(global, resource)m4_dnl
46 deliver_queue_load_max = 8
47 message_size_limit = 500M
50 smtp_accept_queue = 32
51 smtp_accept_reserve = 4
52 smtp_load_reserve = 10
53 smtp_reserve_hosts = +trusted
55 SECTION(global, policy)m4_dnl
58 SECTION(global, users)m4_dnl
60 gecos_pattern = ([^,:]*)
62 SECTION(global, incoming)m4_dnl
64 rfc1413_query_timeout = 10s
65 received_header_text = Received: \
66 ${if def:sender_rcvhost \
67 {from $sender_rcvhost\n\t} \
68 {${if def:sender_ident \
69 {from ${quote_local_part:$sender_ident} }}}}\
70 by $primary_hostname \
71 (Exim $version_number)\
72 ${if def:tls_cipher {\n\t} { }}\
73 ${if def:received_protocol \
74 {with $received_protocol \
75 ${if def:tls_cipher {(cipher=$tls_cipher)}}}}\n\t\
76 ${if def:sender_address \
77 {(envelope-from $sender_address\
78 ${if def:authenticated_id \
79 {; auth=${quote_local_part:$authenticated_id}} \
80 {${if and {{def:authenticated_sender} \
81 {match_address{$authenticated_sender} \
82 {*@CONF_master_domain}}} \
83 {; auth=${quote_local_part:\
85 $authenticated_sender}}}}}})\n\t}}\
87 ${if def:received_for {\n\tfor $received_for}}
89 SECTION(global, smtp)m4_dnl
90 smtp_return_error_details = true
91 accept_8bitmime = true
92 chunking_advertise_hosts =
94 SECTION(global, env)m4_dnl
97 SECTION(global, process)m4_dnl
98 extract_addresses_remove_arguments = false
99 headers_charset = utf-8
100 qualify_domain = CONF_master_domain
101 untrusted_set_sender = *
102 local_from_check = false
103 local_sender_retain = true
105 SECTION(global, bounce)m4_dnl
106 delay_warning = 1h : 24h : 2d
108 SECTION(global, tls)m4_dnl
109 tls_certificate = CONF_certlist
110 tls_privatekey = CONF_sysconf_dir/server.key
111 tls_advertise_hosts = ${if exists {CONF_sysconf_dir/server.key} {*}{}}
112 tls_dhparam = CONF_ca_dir/dh-param-2048.pem
113 tls_require_ciphers = ${if or {{={$received_port}{CONF_submission_port}} \
114 {match_ip {$sender_host_address}{+trusted}}} \
115 {CONF_good_ciphers} \
116 {CONF_acceptable_ciphers}}
117 tls_verify_certificates = CONF_ca_dir/ca.cert
118 tls_verify_hosts = ${if eq{$acl_c_mode}{submission} {} {+allnets}}
121 ###--------------------------------------------------------------------------
122 ### Access control lists.
124 SECTION(global, acl-after)
125 SECTION(global, acl)m4_dnl
127 SECTION(acl, misc)m4_dnl
129 ## Don't worry if this is local submission. MUAs won't necessarily
130 ## have a clear idea of their hostnames. (For some reason.)
131 accept condition = ${if eq{$acl_c_mode}{submission}}
133 ## Check that the caller's claimed identity is actually plausible.
134 ## This seems like it's a fairly effective filter on spamminess, but
135 ## it's too blunt a tool. Rather than reject, add a warning header.
136 ## Only we can't do this the easy way, so save it up for use in MAIL.
137 ## Also, we're liable to get a subsequent HELO (e.g., after STARTTLS)
138 ## and we should only care about the most recent one.
139 warn set acl_c_helo_warning = false
141 ${if and {{match_ip {$sender_host_address} \
142 {<; 127.0.0.0/8 ; ::1}} \
143 {match_domain {$sender_helo_name} \
144 {localhost : +thishost}}}}
146 ${if exists {CONF_sysconf_dir/helo.conf} \
147 {${lookup {$sender_helo_name} \
149 {CONF_sysconf_dir/helo.conf} \
151 {$sender_host_address} \
154 set acl_c_helo_warning = true
158 SECTION(global, acl)m4_dnl
159 acl_not_smtp_start = not_smtp_start
160 SECTION(acl, misc)m4_dnl
162 ## Record the user's name.
163 warn set acl_c_user = $sender_ident
164 set acl_m_user = $sender_ident
169 SECTION(global, acl)m4_dnl
171 SECTION(acl, mail)m4_dnl
174 ## If we stashed a warning header about HELO from earlier, we should
175 ## add it now. Only don't bother if the client has authenticated
176 ## successfully for submission (because we can't expect mobile
177 ## clients to be properly set up knowing their names), or it's one of
178 ## our own satellites (because they're either properly set up anyway,
179 ## or satellites using us as a smarthost).
180 warn condition = $acl_c_helo_warning
181 !condition = ${if eq{$acl_c_mode}{submission}}
183 WARNING_HEADER(BADHELO,
184 <:Client's HELO doesn't match its IP address.\n\t\
185 helo-name=$sender_helo_name \
186 address=$sender_host_address:>)
188 ## Always allow the empty sender, so that we can receive bounces.
191 ## Ensure that the sender looks valid.
192 require acl = mail_check_sender
194 ## If this is directly from a client then hack on it for a while.
195 warn condition = ${if eq{$acl_c_mode}{submission}}
196 control = submission/sender_retain
198 ## Insist that a local client connect through TLS.
199 deny message = Hosts within CONF_master_domain must use TLS
200 !condition = ${if eq{$acl_c_mode}{submission}}
204 ## Check that a submitted message's sender address is allowable.
205 require acl = mail_check_auth
207 SECTION(acl, mail-tail)m4_dnl
211 SECTION(acl, misc)m4_dnl
214 ## See whether there's a special exception for this sender domain.
215 accept senders = ${LOOKUP_DOMAIN($sender_address_domain,
218 ## Ensure that the sender is routable. This is important to prevent
219 ## undeliverable bounces.
220 require message = Invalid sender; \
221 ($sender_verify_failure; $acl_verify_message)
227 SECTION(global, acl)m4_dnl
228 acl_smtp_connect = connect
229 SECTION(acl, connect)m4_dnl
231 SECTION(acl, connect-tail)m4_dnl
232 ## Configure variables according to the submission mode.
233 warn acl = check_submission
239 ## See whether this message needs hacking on.
240 accept !hosts = +thishost
241 !condition = ${if ={$received_port}{CONF_submission_port}}
242 set acl_c_mode = relay
244 ## Remember to apply submission controls.
245 warn set acl_c_mode = submission
246 control = no_enforce_sync
251 SECTION(global, acl)m4_dnl
253 SECTION(acl, rcpt)m4_dnl
256 ## Reject if the client isn't allowed to relay and the recipient
257 ## isn't in one of our known domains.
258 require message = Relaying not permitted
261 ## Ensure that the recipient is routable.
262 require message = Invalid recipient \
263 ($recipient_verify_failure; $acl_verify_message)
266 SECTION(acl, misc)m4_dnl
268 ## Accept either if the client is allowed to relay through us, or if
269 ## we're the correct place to send this mail.
271 ## Known clients and authenticated users are OK.
272 accept hosts = CONF_relay_clients
273 accept authenticated = *
275 ## Known domains are OK.
276 accept domains = +public
278 ## Finally, domains in our table are OK, unless they say they aren't.
280 ${if exists{CONF_sysconf_dir/domains.conf} \
281 {partial0-lsearch; CONF_sysconf_dir/domains.conf}}
282 condition = DOMKV(service, {$value}{true})
284 ## Nope, that's not allowed.
287 SECTION(acl, rcpt-tail)m4_dnl
288 ## Everything checks out OK: let this one go through.
291 SECTION(global, acl)m4_dnl
293 SECTION(acl, data)m4_dnl
295 ## Don't accept messages with overly-long lines.
296 deny message = line length exceeds SMTP permitted maximum: \
297 $max_received_linelength > 998
298 condition = ${if >{$max_received_linelength}{998}}
300 SECTION(acl, data-tail)m4_dnl
303 SECTION(global, acl)m4_dnl
304 acl_smtp_expn = expn_vrfy
305 acl_smtp_vrfy = expn_vrfy
306 SECTION(acl, misc)m4_dnl
308 accept hosts = +trusted
309 deny message = Suck it and see
312 ###--------------------------------------------------------------------------
313 ### Verification of sender address.
315 SECTION(acl, misc)m4_dnl
318 ## If this isn't a submission then it doesn't need checking.
319 accept condition = ${if !eq{$acl_c_mode}{submission}}
321 ## If the caller hasn't formally authenticated, but this is a
322 ## loopback connection, then we can trust identd to tell us the right
323 ## answer. So we should stash the right name somewhere consistent.
324 warn set acl_c_user = $authenticated_id
327 condition = ${if def:sender_ident}
328 set acl_c_user = $sender_ident
330 ## User must be authenticated by now.
331 deny message = Sender not authenticated
332 condition = ${if !def:acl_c_user}
334 ## Set the per-message authentication flag, since we now know that
335 ## there's a sensible value.
336 warn set acl_m_user = $acl_c_user
342 ###--------------------------------------------------------------------------
343 ### Common options for forwarding routers.
345 ## We're pretty permissive here.
346 m4_define(<:FILTER_BASE:>,
354 forbid_blackhole = false
355 check_ancestor = true:>)
357 ## Common options for forwarding routers at verification time.
358 m4_define(<:FILTER_VERIFY:>,
360 user = CONF_filter_user
361 forbid_filter_dlfunc = true
362 forbid_filter_logwrite = true
363 forbid_filter_perl = true
364 forbid_filter_readsocket = true
365 forbid_filter_run = true
366 file_transport = dummy
367 directory_transport = dummy
368 pipe_transport = dummy
369 reply_transport = dummy:>)
371 ## Transports for redirection filters.
372 m4_define(<:FILTER_TRANSPORTS:>,
373 <:file_transport = mailbox
374 directory_transport = maildir
375 pipe_transport = pipe
376 reply_transport = reply:>)
378 m4_define(<:FILTER_ROUTER:>,
385 FILTER_TRANSPORTS<::>$4:>)
388 ###--------------------------------------------------------------------------
391 SECTION(routers, alias)m4_dnl
392 ## Look up the local part in the address map.
397 user = CONF_filter_user
399 local_parts = nwildlsearch; CONF_alias_file
400 data = ${expand:$local_part_data}
401 SECTION(routers, alias-opts)m4_dnl
404 ###--------------------------------------------------------------------------
405 ### Some standard transports.
407 m4_define(<:USER_DELIVERY:>,
408 <:delivery_date_add = true
409 envelope_to_add = true
410 return_path_add = true:>)
412 m4_define(<:APPLY_HEADER_CHANGES:>,
413 <:headers_add = m4_ifelse(<:$1:>, <::>,
415 <:${if def:acl_m_hdradd{$acl_m_hdradd\n}}\
417 headers_remove = m4_ifelse(<:$2:>, <::>,
419 <:${if def:acl_m_hdrrm{$acl_m_hdrrm:}}\
422 m4_define(<:DKIM_SIGN_P:>,
423 <:and {{exists{CONF_sysconf_dir/dkim-sign.conf}} \
424 {!def:h_DKIM-Signature:} \
426 {or {{def:authenticated_id} \
427 {def:authenticated_sender}}} \
428 {bool {DKIM_KEYS_INSTANCE(<:{true}:>, <:{false}:>)}}}:>)
430 m4_define(<:DKIM_KEYS_INSTANCE:>,
431 <:${lookup {${domain:$h_From:}} partial0-lsearch \
432 {CONF_sysconf_dir/dkim-sign.conf} \
433 _LOOKUP_ARGS(<:$1:>, <:$2:>)}:>)
434 m4_define(<:DKIM_KEYS_STATE:>, <:${lookup {$1} lsearch \
435 {DKIM_KEYS_INSTANCE(<:{CONF_dkim_keys_dir/$value/active/dkim-keys.state}:>)} \
436 _LOOKUP_ARGS(<:$2:>, <:$3:>, <:fail:>)}:>)
437 m4_define(<:DKIM_KEYS_INFO:>, <:DKIM_KEYS_STATE(<:params:>,
438 <:{${if and {{>={$tod_epoch}{KV(t0)}} \
439 {<{$tod_epoch}{${eval:KV(t0) + KV(n)*KV(step)}}}} \
440 {DKIM_KEYS_STATE(<:info.${eval:($tod_epoch - KV(t0))/KV(step)}:>,
442 m4_ifelse(<:$2:>, <::>, <:fail:>, <:$2:>)}}:>,
443 m4_ifelse(<:$2:>, <::>, <:fail:>, <:$2:>)):>)
445 m4_define(<:DKIM_SIGN:>,
448 {DKIM_KEYS_INSTANCE({${domain:$h_From:}})}}
449 dkim_selector = DKIM_KEYS_INFO(<:{KV(k)}:>)
451 DKIM_KEYS_INSTANCE(<:m4_dnl
452 {CONF_dkim_keys_dir/$value/active/$dkim_selector.priv}:>)
455 ## The following ridiculous stunt does two important jobs. Firstly,
456 ## and more obviously, it arranges to include one more copy of each
457 ## header name than the message actually contains, thereby causing
458 ## the signature to fail if another header with the same name is
459 ## added. And secondly, and far more subtly, it also trims the
460 ## spaces from the header names so that they're in the format that
461 ## the signing machinery secretly wants.
462 dkim_sign_headers = \
463 ${sg {${map {CONF_dkim_headers : \
464 X-CONF_header_token-DKIM-Key-Publication} \
465 {$item${sg {${expand:\$h_$item:}\n} \
466 {((?:[^\n]+|\n\\s+)*)\n} \
471 {DKIM_KEYS_INFO(<:m4_dnl
472 {X-CONF_header_token-DKIM-Key-Publication: \
473 DKIM signature not suitable \
474 as evidence after delivery;\n\t\
475 DKIM private key KV(k) will be \
478 on or before KV(tpub)}:>)}}:>)
481 m4_define(<:SMTP_DELIVERY:>,
482 <:## Prevent sending messages with overly long lines. The use of
483 ## `message_size_limit' here is somewhat misleading.
484 message_size_limit = ${if >{$max_received_linelength}{998}{1}{0}}:>)
486 SECTION(transports)m4_dnl
487 ## A standard transport for remote delivery. By default, try to do TLS, and
488 ## don't worry too much if it's not very secure: the alternative is sending
489 ## in plaintext anyway. But all of this can be overridden from the
490 ## `domains.conf' file. Annoyingly, the `tls_dh_min_bits' setting isn't
491 ## expanded before use, so we can't set it the obvious way. Instead, encode
492 ## it into the transport name. This is very unpleasant, of course.
498 tls_require_ciphers = CONF_acceptable_ciphers
499 tls_dh_min_bits = 508
500 tls_tempfail_tryclear = true
502 m4_define(<:SMTP_TRANS_DHBITS:>,
508 hosts_require_tls = DOMKV(tls-peer-ca, {*}{})
509 hosts_require_auth = \
510 ${if bool {DOMKV(require-auth, {$value}{false})} {*}{}}
511 tls_certificate = DOMKV(tls-certificate, {${expand:$value}}fail)
512 tls_privatekey = DOMKV(tls-private-key, {${expand:$value}}fail)
513 tls_verify_certificates = DOMKV(tls-peer-ca, {${expand:$value}}fail)
514 tls_require_ciphers = \
516 {${extract {${expand:$value}} \
517 { good = CONF_good_ciphers \
518 any = CONF_acceptable_ciphers } \
520 {${expand:$value}}}} \
521 {CONF_acceptable_ciphers})
523 tls_tempfail_tryclear = true:>)m4_dnl
525 SMTP_TRANS_DHBITS(508)
527 SMTP_TRANS_DHBITS(764)
529 SMTP_TRANS_DHBITS(1020)
531 SMTP_TRANS_DHBITS(2044)
533 ## Transport to a local SMTP server; use TLS and perform client
539 hosts_require_tls = *
540 tls_certificate = CONF_sysconf_dir/client.certlist
541 tls_privatekey = CONF_sysconf_dir/client.key
542 tls_verify_certificates = CONF_ca_dir/ca.cert
543 tls_require_ciphers = CONF_good_ciphers
544 tls_dh_min_bits = 2046
545 tls_tempfail_tryclear = false
546 authenticated_sender_force = true
547 authenticated_sender = \
548 ${if def:acl_m_user {$acl_m_user@CONF_master_domain} \
549 {${if def:authenticated_sender {$authenticated_sender} \
552 ## A standard transport for local delivery.
556 file = /var/mail/$local_part
559 mode_fail_narrower = false
562 ## Transports for user filters.
572 maildir_format = true
579 path = ${if and {{def:home} {exists{$home/bin}}} {$home/bin:} {}}\
580 /usr/local/bin:/usr/local/sbin:\
581 /usr/bin:/usr/sbin:/bin:/sbin
584 return_fail_output = true
587 ## A special dummy transport for use during address verification.
593 ###--------------------------------------------------------------------------
594 ### Retry configuration.
596 SECTION(retry, default)m4_dnl
597 ## Be persistent when sending to the site relay. It ought to work, but
598 ## particularly satellites such as laptops often encounter annoying temporary
599 ## failures due to network unavailability, and the usual gradual policy can
600 ## leave mail building up for no good reason.
606 F,2h,15m; G,16h,2h,1.5; F,4d,6h
609 ###----- That's all, folks --------------------------------------------------