chiark / gitweb /
base.m4: Be extra persistent when trying to deliver mail to the relay.
[exim-config] / base.m4
CommitLineData
185b5456
MW
1### -*-m4-*-
2###
3### Basic settings for distorted.org.uk Exim configuration
4###
5### (c) 2012 Mark Wooding
6###
7
8###----- Licensing notice ---------------------------------------------------
9###
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.
14###
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.
19###
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.
23
24###--------------------------------------------------------------------------
25### Global settings.
26
27SECTION(global, priv)m4_dnl
b1d083dd 28admin_groups = CONF_admin_groups
e8fc7835 29trusted_groups = CONF_trusted_groups
185b5456
MW
30prod_requires_admin = false
31
32SECTION(global, logging)m4_dnl
33log_file_path = : syslog
34log_selector = \
35 +smtp_confirmation \
36 +tls_peerdn
37log_timezone = true
38syslog_duplication = false
39syslog_timestamp = false
40
41SECTION(global, daemon)m4_dnl
42local_interfaces = <; CONF_interfaces
ad4e4191 43extra_local_interfaces = <; 0.0.0.0 ; ::0
185b5456
MW
44
45SECTION(global, resource)m4_dnl
46deliver_queue_load_max = 8
47queue_only_load = 12
48smtp_accept_max = 16
49smtp_accept_queue = 32
50smtp_accept_reserve = 4
51smtp_load_reserve = 10
52smtp_reserve_hosts = +trusted
53
54SECTION(global, policy)m4_dnl
55host_lookup = *
56
57SECTION(global, users)m4_dnl
58gecos_name = $1
59gecos_pattern = ([^,:]*)
60
61SECTION(global, incoming)m4_dnl
ceb81bc4
MW
62rfc1413_hosts = *
63rfc1413_query_timeout = 10s
185b5456 64received_header_text = Received: \
2cf9db84 65 ${if def:sender_rcvhost \
9384ef4f 66 {from $sender_rcvhost\n\t} \
2cf9db84
MW
67 {${if def:sender_ident \
68 {from ${quote_local_part:$sender_ident} }}}}\
185b5456 69 by $primary_hostname \
b92689d6
MW
70 (Exim $version_number)\
71 ${if def:tls_cipher {\n\t} { }}\
185b5456
MW
72 ${if def:received_protocol \
73 {with $received_protocol \
b92689d6 74 ${if def:tls_cipher {(cipher=$tls_cipher)}}}}\n\t\
185b5456 75 ${if def:sender_address \
43e6fc69 76 {(envelope-from $sender_address\
185b5456 77 ${if def:authenticated_id \
8fa6a843
MW
78 {; auth=${quote_local_part:$authenticated_id}} \
79 {${if and {{def:authenticated_sender} \
80 {match_address{$authenticated_sender} \
81 {*@CONF_master_domain}}} \
82 {; auth=${quote_local_part:\
83 ${local_part:\
84 $authenticated_sender}}}}}})\n\t}}\
185b5456
MW
85 id $message_exim_id\
86 ${if def:received_for {\n\tfor $received_for}}
87
88SECTION(global, smtp)m4_dnl
89smtp_return_error_details = true
90accept_8bitmime = true
e3c9c427 91chunking_advertise_hosts =
185b5456 92
5918499b
MW
93SECTION(global, env)m4_dnl
94keep_environment =
95
185b5456
MW
96SECTION(global, process)m4_dnl
97extract_addresses_remove_arguments = false
98headers_charset = utf-8
99qualify_domain = CONF_master_domain
12d3b444 100untrusted_set_sender = *
75c86bd1
MW
101local_from_check = false
102local_sender_retain = true
185b5456
MW
103
104SECTION(global, bounce)m4_dnl
105delay_warning = 1h : 24h : 2d
106
6aae076f 107SECTION(global, tls)m4_dnl
1dda4df9 108tls_certificate = CONF_certlist
6aae076f
MW
109tls_privatekey = CONF_sysconf_dir/server.key
110tls_advertise_hosts = ${if exists {CONF_sysconf_dir/server.key} {*}{}}
111tls_dhparam = CONF_ca_dir/dh-param-2048.pem
112tls_require_ciphers = ${if or {{={$received_port}{CONF_submission_port}} \
113 {match_ip {$sender_host_address}{+trusted}}} \
114 {CONF_good_ciphers} \
115 {CONF_acceptable_ciphers}}
116tls_verify_certificates = CONF_ca_dir/ca.cert
117tls_verify_hosts = ${if eq{$acl_c_mode}{submission} {} {+allnets}}
118
185b5456
MW
119DIVERT(null)
120###--------------------------------------------------------------------------
121### Access control lists.
122
123SECTION(global, acl-after)
124SECTION(global, acl)m4_dnl
125acl_smtp_helo = helo
126SECTION(acl, misc)m4_dnl
127helo:
a891f462
MW
128 ## Don't worry if this is local submission. MUAs won't necessarily
129 ## have a clear idea of their hostnames. (For some reason.)
130 accept condition = ${if !eq{$acl_c_mode}{submission}}
131
fe8f2338
MW
132 ## Check that the caller's claimed identity is actually plausible.
133 ## This seems like it's a fairly effective filter on spamminess, but
134 ## it's too blunt a tool. Rather than reject, add a warning header.
135 ## Only we can't do this the easy way, so save it up for use in MAIL.
136 ## Also, we're liable to get a subsequent HELO (e.g., after STARTTLS)
137 ## and we should only care about the most recent one.
138 warn set acl_c_helo_warning = false
4ff4ad42
MW
139 !condition = \
140 ${if and {{match_ip {$sender_host_address} \
141 {<; 127.0.0.0/8 ; ::1}} \
142 {match_domain {$sender_helo_name} \
143 {localhost : +thishost}}}}
fe8f2338
MW
144 !condition = \
145 ${if exists {CONF_sysconf_dir/helo.conf} \
146 {${lookup {$sender_helo_name} \
147 partial0-lsearch \
148 {CONF_sysconf_dir/helo.conf} \
149 {${if match_ip \
150 {$sender_host_address} \
4587a704 151 {<; $value}}}}}}
fe8f2338
MW
152 !verify = helo
153 set acl_c_helo_warning = true
185b5456
MW
154
155 accept
156
284c9d7e
MW
157SECTION(global, acl)m4_dnl
158acl_not_smtp_start = not_smtp_start
159SECTION(acl, misc)m4_dnl
160not_smtp_start:
161 ## Record the user's name.
162 warn set acl_c_user = $sender_ident
e9015968 163 set acl_m_user = $sender_ident
284c9d7e
MW
164
165 ## Done.
166 accept
167
185b5456
MW
168SECTION(global, acl)m4_dnl
169acl_smtp_mail = mail
170SECTION(acl, mail)m4_dnl
171mail:
172
fe8f2338 173 ## If we stashed a warning header about HELO from earlier, we should
2f0841ce
MW
174 ## add it now. Only don't bother if the client has authenticated
175 ## successfully for submission (because we can't expect mobile
176 ## clients to be properly set up knowing their names), or it's one of
177 ## our own satellites (because they're either properly set up anyway,
178 ## or satellites using us as a smarthost).
fe8f2338 179 warn condition = $acl_c_helo_warning
2f0841ce
MW
180 !condition = ${if eq{$acl_c_mode}{submission}}
181 !hosts = +allnets
61295d9c
MW
182 WARNING_HEADER(BADHELO,
183 <:Client's HELO doesn't match its IP address.\n\t\
184 helo-name=$sender_helo_name \
185 address=$sender_host_address:>)
fe8f2338 186
185b5456
MW
187 ## Always allow the empty sender, so that we can receive bounces.
188 accept senders = :
189
5051a30f
MW
190 ## Ensure that the sender looks valid.
191 require acl = mail_check_sender
185b5456
MW
192
193 ## If this is directly from a client then hack on it for a while.
194 warn condition = ${if eq{$acl_c_mode}{submission}}
12d3b444 195 control = submission/sender_retain
185b5456 196
284c9d7e
MW
197 ## Insist that a local client connect through TLS.
198 deny message = Hosts within CONF_master_domain must use TLS
199 !condition = ${if eq{$acl_c_mode}{submission}}
200 hosts = +allnets
201 !encrypted = *
202
203 ## Check that a submitted message's sender address is allowable.
204 require acl = mail_check_auth
205
185b5456
MW
206SECTION(acl, mail-tail)m4_dnl
207 ## And we're done.
208 accept
209
5051a30f
MW
210SECTION(acl, misc)m4_dnl
211mail_check_sender:
212
213 ## See whether there's a special exception for this sender domain.
214 accept senders = ${LOOKUP_DOMAIN($sender_address_domain,
215 {KV(senders, {$value}{})},
216 {})}
217
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)
222 verify = sender
223
224 ## We're good, then.
225 accept
226
185b5456
MW
227SECTION(global, acl)m4_dnl
228acl_smtp_connect = connect
229SECTION(acl, connect)m4_dnl
230connect:
231SECTION(acl, connect-tail)m4_dnl
e12c9586 232 ## Configure variables according to the submission mode.
185b5456 233 warn acl = check_submission
e12c9586
MW
234
235 ## Done.
185b5456
MW
236 accept
237
238check_submission:
239 ## See whether this message needs hacking on.
4ff4ad42 240 accept !hosts = +thishost
185b5456
MW
241 !condition = ${if ={$received_port}{CONF_submission_port}}
242 set acl_c_mode = relay
243
244 ## Remember to apply submission controls.
245 warn set acl_c_mode = submission
54341a70 246 control = no_enforce_sync
185b5456
MW
247
248 ## Done.
249 accept
250
251SECTION(global, acl)m4_dnl
252acl_smtp_rcpt = rcpt
253SECTION(acl, rcpt)m4_dnl
254rcpt:
255
256 ## Reject if the client isn't allowed to relay and the recipient
257 ## isn't in one of our known domains.
e4666f2d
MW
258 require message = Relaying not permitted
259 acl = check_relay
185b5456
MW
260
261 ## Ensure that the recipient is routable.
262 require message = Invalid recipient \
263 ($recipient_verify_failure; $acl_verify_message)
264 verify = recipient
265
e4666f2d
MW
266SECTION(acl, misc)m4_dnl
267check_relay:
268 ## Accept either if the client is allowed to relay through us, or if
269 ## we're the correct place to send this mail.
270
271 ## Known clients and authenticated users are OK.
a0375fd9
MW
272 accept hosts = CONF_relay_clients
273 accept authenticated = *
e4666f2d
MW
274
275 ## Known domains are OK.
a0375fd9 276 accept domains = +public
e4666f2d
MW
277
278 ## Finally, domains in our table are OK, unless they say they aren't.
a0375fd9
MW
279 accept domains = \
280 ${if exists{CONF_sysconf_dir/domains.conf} \
e4666f2d 281 {partial0-lsearch; CONF_sysconf_dir/domains.conf}}
a0375fd9 282 condition = DOMKV(service, {$value}{true})
e4666f2d
MW
283
284 ## Nope, that's not allowed.
285 deny
286
185b5456
MW
287SECTION(acl, rcpt-tail)m4_dnl
288 ## Everything checks out OK: let this one go through.
289 accept
290
291SECTION(global, acl)m4_dnl
292acl_smtp_data = data
293SECTION(acl, data)m4_dnl
294data:
5d2f8b65
MW
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}}
185b5456
MW
299
300SECTION(acl, data-tail)m4_dnl
301 accept
302
303SECTION(global, acl)m4_dnl
304acl_smtp_expn = expn_vrfy
305acl_smtp_vrfy = expn_vrfy
e4fe8925 306SECTION(acl, misc)m4_dnl
185b5456
MW
307expn_vrfy:
308 accept hosts = +trusted
309 deny message = Suck it and see
310
311DIVERT(null)
312###--------------------------------------------------------------------------
284c9d7e
MW
313### Verification of sender address.
314
315SECTION(acl, misc)m4_dnl
316mail_check_auth:
317
318 ## If this isn't a submission then it doesn't need checking.
319 accept condition = ${if !eq{$acl_c_mode}{submission}}
320
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
4ff4ad42 325 hosts = +thishost
284c9d7e 326 !authenticated = *
ff4c943d 327 condition = ${if def:sender_ident}
284c9d7e
MW
328 set acl_c_user = $sender_ident
329
ff4c943d 330 ## User must be authenticated by now.
284c9d7e 331 deny message = Sender not authenticated
ff4c943d 332 condition = ${if !def:acl_c_user}
284c9d7e 333
e9015968
MW
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
337
284c9d7e
MW
338 ## All done.
339 accept
340
341DIVERT(null)
342###--------------------------------------------------------------------------
185b5456
MW
343### Common options for forwarding routers.
344
345## We're pretty permissive here.
346m4_define(<:FILTER_BASE:>,
347 <:driver = redirect
348 modemask = 002
349 check_owner = false
350 check_group = false
351 allow_filter = true
352 allow_defer = true
353 allow_fail = true
354 forbid_blackhole = false
355 check_ancestor = true:>)
356
357## Common options for forwarding routers at verification time.
358m4_define(<:FILTER_VERIFY:>,
359 <:verify_only = true
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:>)
370
371## Transports for redirection filters.
372m4_define(<:FILTER_TRANSPORTS:>,
7ab75d6f 373 <:file_transport = mailbox
185b5456
MW
374 directory_transport = maildir
375 pipe_transport = pipe
376 reply_transport = reply:>)
377
7ab75d6f
MW
378m4_define(<:FILTER_ROUTER:>,
379<:$1_vrf:
380 $2
381 FILTER_VERIFY<::>$3
382$1:
383 $2
384 verify = no
385 FILTER_TRANSPORTS<::>$4:>)
386
185b5456
MW
387DIVERT(null)
388###--------------------------------------------------------------------------
3e031e77
MW
389### Common routers.
390
391SECTION(routers, alias)m4_dnl
392## Look up the local part in the address map.
393alias:
394 driver = redirect
395 allow_fail = true
396 allow_defer = true
397 user = CONF_filter_user
398 FILTER_TRANSPORTS
399 local_parts = nwildlsearch; CONF_alias_file
400 data = ${expand:$local_part_data}
401SECTION(routers, alias-opts)m4_dnl
402
403DIVERT(null)
404###--------------------------------------------------------------------------
185b5456
MW
405### Some standard transports.
406
407m4_define(<:USER_DELIVERY:>,
408 <:delivery_date_add = true
409 envelope_to_add = true
410 return_path_add = true:>)
411
1e5ccd7c
MW
412m4_define(<:APPLY_HEADER_CHANGES:>,
413 <:headers_add = m4_ifelse(<:$1:>, <::>,
414 <:$acl_m_hdradd:>,
415 <:${if def:acl_m_hdradd{$acl_m_hdradd\n}}\
416 $1:>)
417 headers_remove = m4_ifelse(<:$2:>, <::>,
418 <:$acl_m_hdrrm:>,
419 <:${if def:acl_m_hdrrm{$acl_m_hdrrm:}}\
420 $2:>):>)
421
5d2f8b65
MW
422m4_define(<:SMTP_DELIVERY:>,
423 <:## Prevent sending messages with overly long lines. The use of
424 ## `message_size_limit' here is somewhat misleading.
425 message_size_limit = ${if >{$max_received_linelength}{998}{1}{0}}:>)
426
185b5456 427SECTION(transports)m4_dnl
fa5a92c6
MW
428## A standard transport for remote delivery. By default, try to do TLS, and
429## don't worry too much if it's not very secure: the alternative is sending
430## in plaintext anyway. But all of this can be overridden from the
beb15dae
MW
431## `domains.conf' file. Annoyingly, the `tls_dh_min_bits' setting isn't
432## expanded before use, so we can't set it the obvious way. Instead, encode
433## it into the transport name. This is very unpleasant, of course.
534d411b
MW
434smtp:
435 driver = smtp
1e5ccd7c 436 APPLY_HEADER_CHANGES
534d411b 437 tls_require_ciphers = CONF_acceptable_ciphers
7b50997d 438 tls_dh_min_bits = 508
534d411b
MW
439 tls_tempfail_tryclear = true
440
beb15dae
MW
441m4_define(<:SMTP_TRANS_DHBITS:>,
442 <:driver = smtp
5d2f8b65 443 SMTP_DELIVERY
1e5ccd7c 444 APPLY_HEADER_CHANGES
ae9744ce 445 hosts_try_auth = *
fa5a92c6 446 hosts_require_tls = DOMKV(tls-peer-ca, {*}{})
ae9744ce
MW
447 hosts_require_auth = \
448 ${if bool {DOMKV(require-auth, {$value}{false})} {*}{}}
fa5a92c6
MW
449 tls_certificate = DOMKV(tls-certificate, {${expand:$value}}fail)
450 tls_privatekey = DOMKV(tls-private-key, {${expand:$value}}fail)
451 tls_verify_certificates = DOMKV(tls-peer-ca, {${expand:$value}}fail)
452 tls_require_ciphers = \
453 DOMKV(tls-ciphers,
454 {${extract {${expand:$value}} \
455 { good = CONF_good_ciphers \
456 any = CONF_acceptable_ciphers } \
457 {$value} \
458 {${expand:$value}}}} \
459 {CONF_acceptable_ciphers})
beb15dae
MW
460 tls_dh_min_bits = $1
461 tls_tempfail_tryclear = true:>)m4_dnl
7b50997d
MW
462smtp_dhbits_512:
463 SMTP_TRANS_DHBITS(508)
464smtp_dhbits_768:
465 SMTP_TRANS_DHBITS(764)
beb15dae
MW
466smtp_dhbits_1024:
467 SMTP_TRANS_DHBITS(1020)
468smtp_dhbits_2048:
7b50997d 469 SMTP_TRANS_DHBITS(2044)
185b5456
MW
470
471## Transport to a local SMTP server; use TLS and perform client
472## authentication.
473smtp_local:
474 driver = smtp
5d2f8b65 475 SMTP_DELIVERY
1e5ccd7c 476 APPLY_HEADER_CHANGES
185b5456 477 hosts_require_tls = *
163774f0 478 tls_certificate = CONF_sysconf_dir/client.certlist
185b5456
MW
479 tls_privatekey = CONF_sysconf_dir/client.key
480 tls_verify_certificates = CONF_ca_dir/ca.cert
481 tls_require_ciphers = CONF_good_ciphers
b6d74252 482 tls_dh_min_bits = 2046
185b5456 483 tls_tempfail_tryclear = false
10c331d7
MW
484 authenticated_sender_force = true
485 authenticated_sender = \
486 ${if def:acl_m_user {$acl_m_user@CONF_master_domain} \
487 {${if def:authenticated_sender {$authenticated_sender} \
488 fail}}}
185b5456
MW
489
490## A standard transport for local delivery.
491deliver:
492 driver = appendfile
1e5ccd7c 493 APPLY_HEADER_CHANGES
185b5456 494 file = /var/mail/$local_part
8f6af4ae
MW
495 group = mail
496 mode = 0600
497 mode_fail_narrower = false
185b5456
MW
498 USER_DELIVERY
499
500## Transports for user filters.
501mailbox:
502 driver = appendfile
1e5ccd7c 503 APPLY_HEADER_CHANGES
8f6af4ae 504 initgroups = true
185b5456
MW
505 USER_DELIVERY
506
507maildir:
508 driver = appendfile
1e5ccd7c 509 APPLY_HEADER_CHANGES
185b5456 510 maildir_format = true
8f6af4ae 511 initgroups = true
185b5456
MW
512 USER_DELIVERY
513
514pipe:
515 driver = pipe
1e5ccd7c 516 APPLY_HEADER_CHANGES
8f6af4ae
MW
517 path = ${if and {{def:home} {exists{$home/bin}}} {$home/bin:} {}}\
518 /usr/local/bin:/usr/local/sbin:\
519 /usr/bin:/usr/sbin:/bin:/sbin
520 initgroups = true
521 umask = 002
522 return_fail_output = true
523 log_output = true
185b5456
MW
524
525## A special dummy transport for use during address verification.
526dummy:
527 driver = appendfile
528 file = /dev/null
529
530DIVERT(null)
531###--------------------------------------------------------------------------
532### Retry configuration.
533
534SECTION(retry, default)m4_dnl
af4b4ca8
MW
535## Be persistent when sending to the site relay. It ought to work, but
536## particularly satellites such as laptops often encounter annoying temporary
537## failures due to network unavailability, and the usual gradual policy can
538## leave mail building up for no good reason.
539CONF_smarthost * \
540 F,4d,15m
541
185b5456
MW
542## Default.
543* * \
544 F,2h,15m; G,16h,2h,1.5; F,4d,6h
545
546DIVERT(null)
547###----- That's all, folks --------------------------------------------------