1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2017 */
6 /* See the file NOTICE for conditions of use and distribution. */
8 /* Code for handling Access Control Lists (ACLs) */
13 /* Default callout timeout */
15 #define CALLOUT_TIMEOUT_DEFAULT 30
17 /* ACL verb codes - keep in step with the table of verbs that follows */
19 enum { ACL_ACCEPT, ACL_DEFER, ACL_DENY, ACL_DISCARD, ACL_DROP, ACL_REQUIRE,
24 static uschar *verbs[] = {
25 [ACL_ACCEPT] = US"accept",
26 [ACL_DEFER] = US"defer",
27 [ACL_DENY] = US"deny",
28 [ACL_DISCARD] = US"discard",
29 [ACL_DROP] = US"drop",
30 [ACL_REQUIRE] = US"require",
34 /* For each verb, the conditions for which "message" or "log_message" are used
35 are held as a bitmap. This is to avoid expanding the strings unnecessarily. For
36 "accept", the FAIL case is used only after "endpass", but that is selected in
39 static int msgcond[] = {
40 [ACL_ACCEPT] = (1<<OK) | (1<<FAIL) | (1<<FAIL_DROP),
41 [ACL_DEFER] = (1<<OK),
43 [ACL_DISCARD] = (1<<OK) | (1<<FAIL) | (1<<FAIL_DROP),
45 [ACL_REQUIRE] = (1<<FAIL) | (1<<FAIL_DROP),
49 /* ACL condition and modifier codes - keep in step with the table that
56 #ifdef EXPERIMENTAL_BRIGHTMAIL
62 #ifdef EXPERIMENTAL_DCC
65 #ifdef WITH_CONTENT_SCAN
73 #ifdef EXPERIMENTAL_DMARC
83 ACLC_LOG_REJECT_TARGET,
85 #ifdef WITH_CONTENT_SCAN
89 #ifdef WITH_CONTENT_SCAN
95 #ifdef WITH_CONTENT_SCAN
102 #ifdef WITH_CONTENT_SCAN
105 #ifdef EXPERIMENTAL_SPF
112 /* ACL conditions/modifiers: "delay", "control", "continue", "endpass",
113 "message", "log_message", "log_reject_target", "logwrite", "queue" and "set" are
114 modifiers that look like conditions but always return TRUE. They are used for
115 their side effects. */
117 typedef struct condition_def {
120 /* Flag to indicate the condition/modifier has a string expansion done
121 at the outer level. In the other cases, expansion already occurs in the
122 checking functions. */
123 BOOL expand_at_top:1;
127 /* Bit map vector of which conditions and modifiers are not allowed at certain
128 times. For each condition and modifier, there's a bitmap of dis-allowed times.
129 For some, it is easier to specify the negation of a small number of allowed
135 static condition_def conditions[] = {
136 [ACLC_ACL] = { US"acl", FALSE, FALSE, 0 },
138 [ACLC_ADD_HEADER] = { US"add_header", TRUE, TRUE,
140 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
141 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
145 (1<<ACL_WHERE_MIME)|(1<<ACL_WHERE_NOTSMTP)|
147 (1<<ACL_WHERE_NOTSMTP_START)),
150 [ACLC_AUTHENTICATED] = { US"authenticated", FALSE, FALSE,
151 (1<<ACL_WHERE_NOTSMTP)|
152 (1<<ACL_WHERE_NOTSMTP_START)|
153 (1<<ACL_WHERE_CONNECT)|(1<<ACL_WHERE_HELO),
155 #ifdef EXPERIMENTAL_BRIGHTMAIL
156 [ACLC_BMI_OPTIN] = { US"bmi_optin", TRUE, TRUE,
158 (1<<ACL_WHERE_CONNECT)|(1<<ACL_WHERE_HELO)|
159 (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_MIME)|
160 # ifndef DISABLE_PRDR
163 (1<<ACL_WHERE_ETRN)|(1<<ACL_WHERE_EXPN)|
164 (1<<ACL_WHERE_MAILAUTH)|
165 (1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_STARTTLS)|
166 (1<<ACL_WHERE_VRFY)|(1<<ACL_WHERE_PREDATA)|
167 (1<<ACL_WHERE_NOTSMTP_START),
170 [ACLC_CONDITION] = { US"condition", TRUE, FALSE, 0 },
171 [ACLC_CONTINUE] = { US"continue", TRUE, TRUE, 0 },
173 /* Certain types of control are always allowed, so we let it through
174 always and check in the control processing itself. */
175 [ACLC_CONTROL] = { US"control", TRUE, TRUE, 0 },
177 #ifdef EXPERIMENTAL_DCC
178 [ACLC_DCC] = { US"dcc", TRUE, FALSE,
180 ~((1<<ACL_WHERE_DATA)|
181 # ifndef DISABLE_PRDR
184 (1<<ACL_WHERE_NOTSMTP)),
187 #ifdef WITH_CONTENT_SCAN
188 [ACLC_DECODE] = { US"decode", TRUE, FALSE, (unsigned int) ~(1<<ACL_WHERE_MIME) },
191 [ACLC_DELAY] = { US"delay", TRUE, TRUE, (1<<ACL_WHERE_NOTQUIT) },
193 [ACLC_DKIM_SIGNER] = { US"dkim_signers", TRUE, FALSE, (unsigned int) ~(1<<ACL_WHERE_DKIM) },
194 [ACLC_DKIM_STATUS] = { US"dkim_status", TRUE, FALSE, (unsigned int) ~(1<<ACL_WHERE_DKIM) },
196 #ifdef EXPERIMENTAL_DMARC
197 [ACLC_DMARC_STATUS] = { US"dmarc_status", TRUE, FALSE, (unsigned int) ~(1<<ACL_WHERE_DATA) },
200 /* Explicit key lookups can be made in non-smtp ACLs so pass
201 always and check in the verify processing itself. */
202 [ACLC_DNSLISTS] = { US"dnslists", TRUE, FALSE, 0 },
204 [ACLC_DOMAINS] = { US"domains", FALSE, FALSE,
206 ~((1<<ACL_WHERE_RCPT)
213 [ACLC_ENCRYPTED] = { US"encrypted", FALSE, FALSE,
214 (1<<ACL_WHERE_NOTSMTP)|
215 (1<<ACL_WHERE_CONNECT)|
216 (1<<ACL_WHERE_NOTSMTP_START)|
220 [ACLC_ENDPASS] = { US"endpass", TRUE, TRUE, 0 },
222 [ACLC_HOSTS] = { US"hosts", FALSE, FALSE,
223 (1<<ACL_WHERE_NOTSMTP)|
224 (1<<ACL_WHERE_NOTSMTP_START),
226 [ACLC_LOCAL_PARTS] = { US"local_parts", FALSE, FALSE,
228 ~((1<<ACL_WHERE_RCPT)
236 [ACLC_LOG_MESSAGE] = { US"log_message", TRUE, TRUE, 0 },
237 [ACLC_LOG_REJECT_TARGET] = { US"log_reject_target", TRUE, TRUE, 0 },
238 [ACLC_LOGWRITE] = { US"logwrite", TRUE, TRUE, 0 },
240 #ifdef WITH_CONTENT_SCAN
241 [ACLC_MALWARE] = { US"malware", TRUE, FALSE,
243 ~((1<<ACL_WHERE_DATA)|
244 # ifndef DISABLE_PRDR
247 (1<<ACL_WHERE_NOTSMTP)),
251 [ACLC_MESSAGE] = { US"message", TRUE, TRUE, 0 },
252 #ifdef WITH_CONTENT_SCAN
253 [ACLC_MIME_REGEX] = { US"mime_regex", TRUE, FALSE, (unsigned int) ~(1<<ACL_WHERE_MIME) },
256 [ACLC_QUEUE] = { US"queue", TRUE, TRUE,
257 (1<<ACL_WHERE_NOTSMTP)|
264 [ACLC_RATELIMIT] = { US"ratelimit", TRUE, FALSE, 0 },
265 [ACLC_RECIPIENTS] = { US"recipients", FALSE, FALSE, (unsigned int) ~(1<<ACL_WHERE_RCPT) },
267 #ifdef WITH_CONTENT_SCAN
268 [ACLC_REGEX] = { US"regex", TRUE, FALSE,
270 ~((1<<ACL_WHERE_DATA)|
271 # ifndef DISABLE_PRDR
274 (1<<ACL_WHERE_NOTSMTP)|
275 (1<<ACL_WHERE_MIME)),
279 [ACLC_REMOVE_HEADER] = { US"remove_header", TRUE, TRUE,
281 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
282 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
286 (1<<ACL_WHERE_MIME)|(1<<ACL_WHERE_NOTSMTP)|
287 (1<<ACL_WHERE_NOTSMTP_START)),
289 [ACLC_SENDER_DOMAINS] = { US"sender_domains", FALSE, FALSE,
290 (1<<ACL_WHERE_AUTH)|(1<<ACL_WHERE_CONNECT)|
292 (1<<ACL_WHERE_MAILAUTH)|(1<<ACL_WHERE_QUIT)|
293 (1<<ACL_WHERE_ETRN)|(1<<ACL_WHERE_EXPN)|
294 (1<<ACL_WHERE_STARTTLS)|(1<<ACL_WHERE_VRFY),
296 [ACLC_SENDERS] = { US"senders", FALSE, FALSE,
297 (1<<ACL_WHERE_AUTH)|(1<<ACL_WHERE_CONNECT)|
299 (1<<ACL_WHERE_MAILAUTH)|(1<<ACL_WHERE_QUIT)|
300 (1<<ACL_WHERE_ETRN)|(1<<ACL_WHERE_EXPN)|
301 (1<<ACL_WHERE_STARTTLS)|(1<<ACL_WHERE_VRFY),
304 [ACLC_SET] = { US"set", TRUE, TRUE, 0 },
306 #ifdef WITH_CONTENT_SCAN
307 [ACLC_SPAM] = { US"spam", TRUE, FALSE,
308 (unsigned int) ~((1<<ACL_WHERE_DATA)|
309 # ifndef DISABLE_PRDR
312 (1<<ACL_WHERE_NOTSMTP)),
315 #ifdef EXPERIMENTAL_SPF
316 [ACLC_SPF] = { US"spf", TRUE, FALSE,
317 (1<<ACL_WHERE_AUTH)|(1<<ACL_WHERE_CONNECT)|
319 (1<<ACL_WHERE_MAILAUTH)|
320 (1<<ACL_WHERE_ETRN)|(1<<ACL_WHERE_EXPN)|
321 (1<<ACL_WHERE_STARTTLS)|(1<<ACL_WHERE_VRFY)|
322 (1<<ACL_WHERE_NOTSMTP)|
323 (1<<ACL_WHERE_NOTSMTP_START),
325 [ACLC_SPF_GUESS] = { US"spf_guess", TRUE, FALSE,
326 (1<<ACL_WHERE_AUTH)|(1<<ACL_WHERE_CONNECT)|
328 (1<<ACL_WHERE_MAILAUTH)|
329 (1<<ACL_WHERE_ETRN)|(1<<ACL_WHERE_EXPN)|
330 (1<<ACL_WHERE_STARTTLS)|(1<<ACL_WHERE_VRFY)|
331 (1<<ACL_WHERE_NOTSMTP)|
332 (1<<ACL_WHERE_NOTSMTP_START),
335 [ACLC_UDPSEND] = { US"udpsend", TRUE, TRUE, 0 },
337 /* Certain types of verify are always allowed, so we let it through
338 always and check in the verify function itself */
339 [ACLC_VERIFY] = { US"verify", TRUE, FALSE, 0 },
344 /* Return values from decode_control(); used as index so keep in step
345 with the controls_list table that follows! */
348 CONTROL_AUTH_UNADVERTISED,
349 #ifdef EXPERIMENTAL_BRIGHTMAIL
352 CONTROL_CASEFUL_LOCAL_PART,
353 CONTROL_CASELOWER_LOCAL_PART,
354 CONTROL_CUTTHROUGH_DELIVERY,
359 #ifdef EXPERIMENTAL_DMARC
360 CONTROL_DMARC_VERIFY,
361 CONTROL_DMARC_FORENSIC,
364 CONTROL_ENFORCE_SYNC,
365 CONTROL_ERROR, /* pseudo-value for decode errors */
370 CONTROL_NO_CALLOUT_FLUSH,
371 CONTROL_NO_DELAY_FLUSH,
372 CONTROL_NO_ENFORCE_SYNC,
373 #ifdef WITH_CONTENT_SCAN
374 CONTROL_NO_MBOX_UNSPOOL,
376 CONTROL_NO_MULTILINE,
377 CONTROL_NO_PIPELINING,
381 CONTROL_SUPPRESS_LOCAL_FIXUPS,
383 CONTROL_UTF8_DOWNCONVERT,
389 /* Structure listing various control arguments, with their characteristics.
390 For each control, there's a bitmap of dis-allowed times. For some, it is easier
391 to specify the negation of a small number of allowed times. */
393 typedef struct control_def {
395 BOOL has_option; /* Has /option(s) following */
396 unsigned forbids; /* bitmap of dis-allowed times */
399 static control_def controls_list[] = {
400 /* name has_option forbids */
401 [CONTROL_AUTH_UNADVERTISED] =
402 { US"allow_auth_unadvertised", FALSE,
404 ~((1<<ACL_WHERE_CONNECT)|(1<<ACL_WHERE_HELO))
406 #ifdef EXPERIMENTAL_BRIGHTMAIL
408 { US"bmi_run", FALSE, 0 },
410 [CONTROL_CASEFUL_LOCAL_PART] =
411 { US"caseful_local_part", FALSE, (unsigned) ~(1<<ACL_WHERE_RCPT) },
412 [CONTROL_CASELOWER_LOCAL_PART] =
413 { US"caselower_local_part", FALSE, (unsigned) ~(1<<ACL_WHERE_RCPT) },
414 [CONTROL_CUTTHROUGH_DELIVERY] =
415 { US"cutthrough_delivery", TRUE, 0 },
417 { US"debug", TRUE, 0 },
420 [CONTROL_DKIM_VERIFY] =
421 { US"dkim_disable_verify", FALSE,
422 (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP)|
423 # ifndef DISABLE_PRDR
426 (1<<ACL_WHERE_NOTSMTP_START)
430 #ifdef EXPERIMENTAL_DMARC
431 [CONTROL_DMARC_VERIFY] =
432 { US"dmarc_disable_verify", FALSE,
433 (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
435 [CONTROL_DMARC_FORENSIC] =
436 { US"dmarc_enable_forensic", FALSE,
437 (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
443 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)|(1<<ACL_WHERE_NOTQUIT)
445 [CONTROL_ENFORCE_SYNC] =
446 { US"enforce_sync", FALSE,
447 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
450 /* Pseudo-value for decode errors */
452 { US"error", FALSE, 0 },
454 [CONTROL_FAKEDEFER] =
455 { US"fakedefer", TRUE,
457 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
458 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
464 [CONTROL_FAKEREJECT] =
465 { US"fakereject", TRUE,
467 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
468 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
477 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
478 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
479 // (1<<ACL_WHERE_PRDR)| /* Not allow one user to freeze for all */
480 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_MIME))
483 [CONTROL_NO_CALLOUT_FLUSH] =
484 { US"no_callout_flush", FALSE,
485 (1<<ACL_WHERE_NOTSMTP)| (1<<ACL_WHERE_NOTSMTP_START)
487 [CONTROL_NO_DELAY_FLUSH] =
488 { US"no_delay_flush", FALSE,
489 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
492 [CONTROL_NO_ENFORCE_SYNC] =
493 { US"no_enforce_sync", FALSE,
494 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
496 #ifdef WITH_CONTENT_SCAN
497 [CONTROL_NO_MBOX_UNSPOOL] =
498 { US"no_mbox_unspool", FALSE,
500 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
501 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
502 // (1<<ACL_WHERE_PRDR)| /* Not allow one user to freeze for all */
506 [CONTROL_NO_MULTILINE] =
507 { US"no_multiline_responses", FALSE,
508 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
510 [CONTROL_NO_PIPELINING] =
511 { US"no_pipelining", FALSE,
512 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_NOTSMTP_START)
515 [CONTROL_QUEUE_ONLY] =
516 { US"queue_only", FALSE,
518 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|
519 (1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|
520 // (1<<ACL_WHERE_PRDR)| /* Not allow one user to freeze for all */
521 (1<<ACL_WHERE_NOTSMTP)|(1<<ACL_WHERE_MIME))
523 [CONTROL_SUBMISSION] =
524 { US"submission", TRUE,
526 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|(1<<ACL_WHERE_PREDATA))
528 [CONTROL_SUPPRESS_LOCAL_FIXUPS] =
529 { US"suppress_local_fixups", FALSE,
531 ~((1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)|(1<<ACL_WHERE_PREDATA)|
532 (1<<ACL_WHERE_NOTSMTP_START))
535 [CONTROL_UTF8_DOWNCONVERT] =
536 { US"utf8_downconvert", TRUE, 0 }
540 /* Support data structures for Client SMTP Authorization. acl_verify_csa()
541 caches its result in a tree to avoid repeated DNS queries. The result is an
542 integer code which is used as an index into the following tables of
543 explanatory strings and verification return codes. */
545 static tree_node *csa_cache = NULL;
547 enum { CSA_UNKNOWN, CSA_OK, CSA_DEFER_SRV, CSA_DEFER_ADDR,
548 CSA_FAIL_EXPLICIT, CSA_FAIL_DOMAIN, CSA_FAIL_NOADDR, CSA_FAIL_MISMATCH };
550 /* The acl_verify_csa() return code is translated into an acl_verify() return
551 code using the following table. It is OK unless the client is definitely not
552 authorized. This is because CSA is supposed to be optional for sending sites,
553 so recipients should not be too strict about checking it - especially because
554 DNS problems are quite likely to occur. It's possible to use $csa_status in
555 further ACL conditions to distinguish ok, unknown, and defer if required, but
556 the aim is to make the usual configuration simple. */
558 static int csa_return_code[] = {
561 [CSA_DEFER_SRV] = OK,
562 [CSA_DEFER_ADDR] = OK,
563 [CSA_FAIL_EXPLICIT] = FAIL,
564 [CSA_FAIL_DOMAIN] = FAIL,
565 [CSA_FAIL_NOADDR] = FAIL,
566 [CSA_FAIL_MISMATCH] = FAIL
569 static uschar *csa_status_string[] = {
570 [CSA_UNKNOWN] = US"unknown",
572 [CSA_DEFER_SRV] = US"defer",
573 [CSA_DEFER_ADDR] = US"defer",
574 [CSA_FAIL_EXPLICIT] = US"fail",
575 [CSA_FAIL_DOMAIN] = US"fail",
576 [CSA_FAIL_NOADDR] = US"fail",
577 [CSA_FAIL_MISMATCH] = US"fail"
580 static uschar *csa_reason_string[] = {
581 [CSA_UNKNOWN] = US"unknown",
583 [CSA_DEFER_SRV] = US"deferred (SRV lookup failed)",
584 [CSA_DEFER_ADDR] = US"deferred (target address lookup failed)",
585 [CSA_FAIL_EXPLICIT] = US"failed (explicit authorization required)",
586 [CSA_FAIL_DOMAIN] = US"failed (host name not authorized)",
587 [CSA_FAIL_NOADDR] = US"failed (no authorized addresses)",
588 [CSA_FAIL_MISMATCH] = US"failed (client address mismatch)"
591 /* Options for the ratelimit condition. Note that there are two variants of
592 the per_rcpt option, depending on the ACL that is used to measure the rate.
593 However any ACL must be able to look up per_rcpt rates in /noupdate mode,
594 so the two variants must have the same internal representation as well as
595 the same configuration string. */
598 RATE_PER_WHAT, RATE_PER_CLASH, RATE_PER_ADDR, RATE_PER_BYTE, RATE_PER_CMD,
599 RATE_PER_CONN, RATE_PER_MAIL, RATE_PER_RCPT, RATE_PER_ALLRCPTS
602 #define RATE_SET(var,new) \
603 (((var) == RATE_PER_WHAT) ? ((var) = RATE_##new) : ((var) = RATE_PER_CLASH))
605 static uschar *ratelimit_option_string[] = {
606 [RATE_PER_WHAT] = US"?",
607 [RATE_PER_CLASH] = US"!",
608 [RATE_PER_ADDR] = US"per_addr",
609 [RATE_PER_BYTE] = US"per_byte",
610 [RATE_PER_CMD] = US"per_cmd",
611 [RATE_PER_CONN] = US"per_conn",
612 [RATE_PER_MAIL] = US"per_mail",
613 [RATE_PER_RCPT] = US"per_rcpt",
614 [RATE_PER_ALLRCPTS] = US"per_rcpt"
617 /* Enable recursion between acl_check_internal() and acl_check_condition() */
619 static int acl_check_wargs(int, address_item *, const uschar *, uschar **,
623 /*************************************************
624 * Find control in list *
625 *************************************************/
627 /* The lists are always in order, so binary chop can be used.
630 name the control name to search for
631 ol the first entry in the control list
632 last one more than the offset of the last entry in the control list
634 Returns: index of a control entry, or -1 if not found
638 find_control(const uschar * name, control_def * ol, int last)
643 int middle = (first + last)/2;
644 uschar * s = ol[middle].name;
645 int c = Ustrncmp(name, s, Ustrlen(s));
646 if (c == 0) return middle;
647 else if (c > 0) first = middle + 1;
655 /*************************************************
656 * Pick out condition from list *
657 *************************************************/
659 /* Use a binary chop method
663 list list of conditions
666 Returns: offset in list, or -1 if not found
670 acl_checkcondition(uschar * name, condition_def * list, int end)
675 int mid = (start + end)/2;
676 int c = Ustrcmp(name, list[mid].name);
677 if (c == 0) return mid;
678 if (c < 0) end = mid;
679 else start = mid + 1;
685 /*************************************************
686 * Pick out name from list *
687 *************************************************/
689 /* Use a binary chop method
696 Returns: offset in list, or -1 if not found
700 acl_checkname(uschar *name, uschar **list, int end)
706 int mid = (start + end)/2;
707 int c = Ustrcmp(name, list[mid]);
708 if (c == 0) return mid;
709 if (c < 0) end = mid; else start = mid + 1;
716 /*************************************************
717 * Read and parse one ACL *
718 *************************************************/
720 /* This function is called both from readconf in order to parse the ACLs in the
721 configuration file, and also when an ACL is encountered dynamically (e.g. as
722 the result of an expansion). It is given a function to call in order to
723 retrieve the lines of the ACL. This function handles skipping comments and
724 blank lines (where relevant).
727 func function to get next line of ACL
728 error where to put an error message
730 Returns: pointer to ACL, or NULL
731 NULL can be legal (empty ACL); in this case error will be NULL
735 acl_read(uschar *(*func)(void), uschar **error)
737 acl_block *yield = NULL;
738 acl_block **lastp = &yield;
739 acl_block *this = NULL;
740 acl_condition_block *cond;
741 acl_condition_block **condp = NULL;
746 while ((s = (*func)()) != NULL)
749 BOOL negated = FALSE;
750 uschar *saveline = s;
753 /* Conditions (but not verbs) are allowed to be negated by an initial
756 while (isspace(*s)) s++;
763 /* Read the name of a verb or a condition, or the start of a new ACL, which
764 can be started by a name, or by a macro definition. */
766 s = readconf_readname(name, sizeof(name), s);
767 if (*s == ':' || (isupper(name[0]) && *s == '=')) return yield;
769 /* If a verb is unrecognized, it may be another condition or modifier that
770 continues the previous verb. */
772 if ((v = acl_checkname(name, verbs, nelem(verbs))) < 0)
776 *error = string_sprintf("unknown ACL verb \"%s\" in \"%s\"", name,
788 *error = string_sprintf("malformed ACL line \"%s\"", saveline);
791 this = store_get(sizeof(acl_block));
793 lastp = &(this->next);
796 this->condition = NULL;
797 condp = &(this->condition);
798 if (*s == 0) continue; /* No condition on this line */
804 s = readconf_readname(name, sizeof(name), s); /* Condition name */
807 /* Handle a condition or modifier. */
809 if ((c = acl_checkcondition(name, conditions, nelem(conditions))) < 0)
811 *error = string_sprintf("unknown ACL condition/modifier in \"%s\"",
816 /* The modifiers may not be negated */
818 if (negated && conditions[c].is_modifier)
820 *error = string_sprintf("ACL error: negation is not allowed with "
821 "\"%s\"", conditions[c].name);
825 /* ENDPASS may occur only with ACCEPT or DISCARD. */
827 if (c == ACLC_ENDPASS &&
828 this->verb != ACL_ACCEPT &&
829 this->verb != ACL_DISCARD)
831 *error = string_sprintf("ACL error: \"%s\" is not allowed with \"%s\"",
832 conditions[c].name, verbs[this->verb]);
836 cond = store_get(sizeof(acl_condition_block));
839 cond->u.negated = negated;
842 condp = &(cond->next);
844 /* The "set" modifier is different in that its argument is "name=value"
845 rather than just a value, and we can check the validity of the name, which
846 gives us a variable name to insert into the data block. The original ACL
847 variable names were acl_c0 ... acl_c9 and acl_m0 ... acl_m9. This was
848 extended to 20 of each type, but after that people successfully argued for
849 arbitrary names. In the new scheme, the names must start with acl_c or acl_m.
850 After that, we allow alphanumerics and underscores, but the first character
851 after c or m must be a digit or an underscore. This retains backwards
856 if ( Ustrncmp(s, "dkim_verify_status", 18) == 0
857 || Ustrncmp(s, "dkim_verify_reason", 18) == 0)
859 uschar * endptr = s+18;
861 if (isalnum(*endptr))
863 *error = string_sprintf("invalid variable name after \"set\" in ACL "
864 "modifier \"set %s\" "
865 "(only \"dkim_verify_status\" or \"dkim_verify_reason\" permitted)",
869 cond->u.varname = string_copyn(s, 18);
871 while (isspace(*s)) s++;
878 if (Ustrncmp(s, "acl_c", 5) != 0 &&
879 Ustrncmp(s, "acl_m", 5) != 0)
881 *error = string_sprintf("invalid variable name after \"set\" in ACL "
882 "modifier \"set %s\" (must start \"acl_c\" or \"acl_m\")", s);
887 if (!isdigit(*endptr) && *endptr != '_')
889 *error = string_sprintf("invalid variable name after \"set\" in ACL "
890 "modifier \"set %s\" (digit or underscore must follow acl_c or acl_m)",
895 while (*endptr != 0 && *endptr != '=' && !isspace(*endptr))
897 if (!isalnum(*endptr) && *endptr != '_')
899 *error = string_sprintf("invalid character \"%c\" in variable name "
900 "in ACL modifier \"set %s\"", *endptr, s);
906 cond->u.varname = string_copyn(s + 4, endptr - s - 4);
908 while (isspace(*s)) s++;
911 /* For "set", we are now positioned for the data. For the others, only
912 "endpass" has no data */
914 if (c != ACLC_ENDPASS)
918 *error = string_sprintf("\"=\" missing after ACL \"%s\" %s", name,
919 conditions[c].is_modifier ? US"modifier" : US"condition");
922 while (isspace(*s)) s++;
923 cond->arg = string_copy(s);
932 /*************************************************
933 * Set up added header line(s) *
934 *************************************************/
936 /* This function is called by the add_header modifier, and also from acl_warn()
937 to implement the now-deprecated way of adding header lines using "message" on a
938 "warn" verb. The argument is treated as a sequence of header lines which are
939 added to a chain, provided there isn't an identical one already there.
941 Argument: string of header lines
946 setup_header(const uschar *hstring)
949 int hlen = Ustrlen(hstring);
951 /* Ignore any leading newlines */
952 while (*hstring == '\n') hstring++, hlen--;
954 /* An empty string does nothing; ensure exactly one final newline. */
955 if (hlen <= 0) return;
956 if (hstring[--hlen] != '\n') /* no newline */
957 q = string_sprintf("%s\n", hstring);
958 else if (hstring[hlen-1] == '\n') /* double newline */
960 uschar * s = string_copy(hstring);
961 while(s[--hlen] == '\n')
968 /* Loop for multiple header lines, taking care about continuations */
970 for (p = q; *p != 0; )
974 int newtype = htype_add_bot;
975 header_line **hptr = &acl_added_headers;
977 /* Find next header line within the string */
981 q = Ustrchr(q, '\n'); /* we know there was a newline */
982 if (*(++q) != ' ' && *q != '\t') break;
985 /* If the line starts with a colon, interpret the instruction for where to
986 add it. This temporarily sets up a new type. */
990 if (strncmpic(p, US":after_received:", 16) == 0)
992 newtype = htype_add_rec;
995 else if (strncmpic(p, US":at_start_rfc:", 14) == 0)
997 newtype = htype_add_rfc;
1000 else if (strncmpic(p, US":at_start:", 10) == 0)
1002 newtype = htype_add_top;
1005 else if (strncmpic(p, US":at_end:", 8) == 0)
1007 newtype = htype_add_bot;
1010 while (*p == ' ' || *p == '\t') p++;
1013 /* See if this line starts with a header name, and if not, add X-ACL-Warn:
1014 to the front of it. */
1016 for (s = p; s < q - 1; s++)
1018 if (*s == ':' || !isgraph(*s)) break;
1021 hdr = string_sprintf("%s%.*s", (*s == ':')? "" : "X-ACL-Warn: ", (int) (q - p), p);
1022 hlen = Ustrlen(hdr);
1024 /* See if this line has already been added */
1026 while (*hptr != NULL)
1028 if (Ustrncmp((*hptr)->text, hdr, hlen) == 0) break;
1029 hptr = &((*hptr)->next);
1032 /* Add if not previously present */
1036 header_line *h = store_get(sizeof(header_line));
1045 /* Advance for next header line within the string */
1053 /*************************************************
1054 * List the added header lines *
1055 *************************************************/
1060 header_line * h = acl_added_headers;
1064 if (!h) return NULL;
1069 while ((cp = Ustrchr(s, '\n')) != NULL)
1071 if (cp[1] == '\0') break;
1073 /* contains embedded newline; needs doubling */
1074 g = string_catn(g, s, cp-s+1);
1075 g = string_catn(g, US"\n", 1);
1078 /* last bit of header */
1080 /*XXX could we use add_listele? */
1081 g = string_catn(g, s, cp-s+1); /* newline-sep list */
1083 while((h = h->next));
1085 g->s[g->ptr - 1] = '\0'; /* overwrite last newline */
1090 /*************************************************
1091 * Set up removed header line(s) *
1092 *************************************************/
1094 /* This function is called by the remove_header modifier. The argument is
1095 treated as a sequence of header names which are added to a colon separated
1096 list, provided there isn't an identical one already there.
1098 Argument: string of header names
1103 setup_remove_header(const uschar *hnames)
1106 acl_removed_headers = acl_removed_headers
1107 ? string_sprintf("%s : %s", acl_removed_headers, hnames)
1108 : string_copy(hnames);
1113 /*************************************************
1115 *************************************************/
1117 /* This function is called when a WARN verb's conditions are true. It adds to
1118 the message's headers, and/or writes information to the log. In each case, this
1119 only happens once (per message for headers, per connection for log).
1121 ** NOTE: The header adding action using the "message" setting is historic, and
1122 its use is now deprecated. The new add_header modifier should be used instead.
1125 where ACL_WHERE_xxxx indicating which ACL this is
1126 user_message message for adding to headers
1127 log_message message for logging, if different
1133 acl_warn(int where, uschar *user_message, uschar *log_message)
1135 if (log_message != NULL && log_message != user_message)
1138 string_item *logged;
1140 text = string_sprintf("%s Warning: %s", host_and_ident(TRUE),
1141 string_printing(log_message));
1143 /* If a sender verification has failed, and the log message is "sender verify
1144 failed", add the failure message. */
1146 if (sender_verified_failed != NULL &&
1147 sender_verified_failed->message != NULL &&
1148 strcmpic(log_message, US"sender verify failed") == 0)
1149 text = string_sprintf("%s: %s", text, sender_verified_failed->message);
1151 /* Search previously logged warnings. They are kept in malloc
1152 store so they can be freed at the start of a new message. */
1154 for (logged = acl_warn_logged; logged != NULL; logged = logged->next)
1155 if (Ustrcmp(logged->text, text) == 0) break;
1159 int length = Ustrlen(text) + 1;
1160 log_write(0, LOG_MAIN, "%s", text);
1161 logged = store_malloc(sizeof(string_item) + length);
1162 logged->text = US logged + sizeof(string_item);
1163 memcpy(logged->text, text, length);
1164 logged->next = acl_warn_logged;
1165 acl_warn_logged = logged;
1169 /* If there's no user message, we are done. */
1171 if (user_message == NULL) return;
1173 /* If this isn't a message ACL, we can't do anything with a user message.
1176 if (where > ACL_WHERE_NOTSMTP)
1178 log_write(0, LOG_MAIN|LOG_PANIC, "ACL \"warn\" with \"message\" setting "
1179 "found in a non-message (%s) ACL: cannot specify header lines here: "
1180 "message ignored", acl_wherenames[where]);
1184 /* The code for setting up header lines is now abstracted into a separate
1185 function so that it can be used for the add_header modifier as well. */
1187 setup_header(user_message);
1192 /*************************************************
1193 * Verify and check reverse DNS *
1194 *************************************************/
1196 /* Called from acl_verify() below. We look up the host name(s) of the client IP
1197 address if this has not yet been done. The host_name_lookup() function checks
1198 that one of these names resolves to an address list that contains the client IP
1199 address, so we don't actually have to do the check here.
1202 user_msgptr pointer for user message
1203 log_msgptr pointer for log message
1205 Returns: OK verification condition succeeded
1206 FAIL verification failed
1207 DEFER there was a problem verifying
1211 acl_verify_reverse(uschar **user_msgptr, uschar **log_msgptr)
1215 user_msgptr = user_msgptr; /* stop compiler warning */
1217 /* Previous success */
1219 if (sender_host_name != NULL) return OK;
1221 /* Previous failure */
1223 if (host_lookup_failed)
1225 *log_msgptr = string_sprintf("host lookup failed%s", host_lookup_msg);
1229 /* Need to do a lookup */
1232 debug_printf_indent("looking up host name to force name/address consistency check\n");
1234 if ((rc = host_name_lookup()) != OK)
1236 *log_msgptr = (rc == DEFER)?
1237 US"host lookup deferred for reverse lookup check"
1239 string_sprintf("host lookup failed for reverse lookup check%s",
1241 return rc; /* DEFER or FAIL */
1244 host_build_sender_fullhost();
1250 /*************************************************
1251 * Check client IP address matches CSA target *
1252 *************************************************/
1254 /* Called from acl_verify_csa() below. This routine scans a section of a DNS
1255 response for address records belonging to the CSA target hostname. The section
1256 is specified by the reset argument, either RESET_ADDITIONAL or RESET_ANSWERS.
1257 If one of the addresses matches the client's IP address, then the client is
1258 authorized by CSA. If there are target IP addresses but none of them match
1259 then the client is using an unauthorized IP address. If there are no target IP
1260 addresses then the client cannot be using an authorized IP address. (This is
1261 an odd configuration - why didn't the SRV record have a weight of 1 instead?)
1264 dnsa the DNS answer block
1265 dnss a DNS scan block for us to use
1266 reset option specifying what portion to scan, as described above
1267 target the target hostname to use for matching RR names
1269 Returns: CSA_OK successfully authorized
1270 CSA_FAIL_MISMATCH addresses found but none matched
1271 CSA_FAIL_NOADDR no target addresses found
1275 acl_verify_csa_address(dns_answer *dnsa, dns_scan *dnss, int reset,
1281 BOOL target_found = FALSE;
1283 for (rr = dns_next_rr(dnsa, dnss, reset);
1285 rr = dns_next_rr(dnsa, dnss, RESET_NEXT))
1287 /* Check this is an address RR for the target hostname. */
1291 && rr->type != T_AAAA
1295 if (strcmpic(target, rr->name) != 0) continue;
1297 target_found = TRUE;
1299 /* Turn the target address RR into a list of textual IP addresses and scan
1300 the list. There may be more than one if it is an A6 RR. */
1302 for (da = dns_address_from_rr(dnsa, rr); da != NULL; da = da->next)
1304 /* If the client IP address matches the target IP address, it's good! */
1306 DEBUG(D_acl) debug_printf_indent("CSA target address is %s\n", da->address);
1308 if (strcmpic(sender_host_address, da->address) == 0) return CSA_OK;
1312 /* If we found some target addresses but none of them matched, the client is
1313 using an unauthorized IP address, otherwise the target has no authorized IP
1316 if (target_found) return CSA_FAIL_MISMATCH;
1317 else return CSA_FAIL_NOADDR;
1322 /*************************************************
1323 * Verify Client SMTP Authorization *
1324 *************************************************/
1326 /* Called from acl_verify() below. This routine calls dns_lookup_special()
1327 to find the CSA SRV record corresponding to the domain argument, or
1328 $sender_helo_name if no argument is provided. It then checks that the
1329 client is authorized, and that its IP address corresponds to the SRV
1330 target's address by calling acl_verify_csa_address() above. The address
1331 should have been returned in the DNS response's ADDITIONAL section, but if
1332 not we perform another DNS lookup to get it.
1335 domain pointer to optional parameter following verify = csa
1337 Returns: CSA_UNKNOWN no valid CSA record found
1338 CSA_OK successfully authorized
1339 CSA_FAIL_* client is definitely not authorized
1340 CSA_DEFER_* there was a DNS problem
1344 acl_verify_csa(const uschar *domain)
1347 const uschar *found;
1348 int priority, weight, port;
1355 /* Work out the domain we are using for the CSA lookup. The default is the
1356 client's HELO domain. If the client has not said HELO, use its IP address
1357 instead. If it's a local client (exim -bs), CSA isn't applicable. */
1359 while (isspace(*domain) && *domain != '\0') ++domain;
1360 if (*domain == '\0') domain = sender_helo_name;
1361 if (domain == NULL) domain = sender_host_address;
1362 if (sender_host_address == NULL) return CSA_UNKNOWN;
1364 /* If we have an address literal, strip off the framing ready for turning it
1365 into a domain. The framing consists of matched square brackets possibly
1366 containing a keyword and a colon before the actual IP address. */
1368 if (domain[0] == '[')
1370 const uschar *start = Ustrchr(domain, ':');
1371 if (start == NULL) start = domain;
1372 domain = string_copyn(start + 1, Ustrlen(start) - 2);
1375 /* Turn domains that look like bare IP addresses into domains in the reverse
1376 DNS. This code also deals with address literals and $sender_host_address. It's
1377 not quite kosher to treat bare domains such as EHLO 192.0.2.57 the same as
1378 address literals, but it's probably the most friendly thing to do. This is an
1379 extension to CSA, so we allow it to be turned off for proper conformance. */
1381 if (string_is_ip_address(domain, NULL) != 0)
1383 if (!dns_csa_use_reverse) return CSA_UNKNOWN;
1384 dns_build_reverse(domain, target);
1388 /* Find out if we've already done the CSA check for this domain. If we have,
1389 return the same result again. Otherwise build a new cached result structure
1390 for this domain. The name is filled in now, and the value is filled in when
1391 we return from this function. */
1393 t = tree_search(csa_cache, domain);
1394 if (t != NULL) return t->data.val;
1396 t = store_get_perm(sizeof(tree_node) + Ustrlen(domain));
1397 Ustrcpy(t->name, domain);
1398 (void)tree_insertnode(&csa_cache, t);
1400 /* Now we are ready to do the actual DNS lookup(s). */
1403 switch (dns_special_lookup(&dnsa, domain, T_CSA, &found))
1405 /* If something bad happened (most commonly DNS_AGAIN), defer. */
1408 return t->data.val = CSA_DEFER_SRV;
1410 /* If we found nothing, the client's authorization is unknown. */
1414 return t->data.val = CSA_UNKNOWN;
1416 /* We got something! Go on to look at the reply in more detail. */
1422 /* Scan the reply for well-formed CSA SRV records. */
1424 for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
1426 rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT)) if (rr->type == T_SRV)
1428 const uschar * p = rr->data;
1430 /* Extract the numerical SRV fields (p is incremented) */
1432 GETSHORT(priority, p);
1433 GETSHORT(weight, p);
1437 debug_printf_indent("CSA priority=%d weight=%d port=%d\n", priority, weight, port);
1439 /* Check the CSA version number */
1441 if (priority != 1) continue;
1443 /* If the domain does not have a CSA SRV record of its own (i.e. the domain
1444 found by dns_special_lookup() is a parent of the one we asked for), we check
1445 the subdomain assertions in the port field. At the moment there's only one
1446 assertion: legitimate SMTP clients are all explicitly authorized with CSA
1447 SRV records of their own. */
1449 if (Ustrcmp(found, domain) != 0)
1450 return t->data.val = port & 1 ? CSA_FAIL_EXPLICIT : CSA_UNKNOWN;
1452 /* This CSA SRV record refers directly to our domain, so we check the value
1453 in the weight field to work out the domain's authorization. 0 and 1 are
1454 unauthorized; 3 means the client is authorized but we can't check the IP
1455 address in order to authenticate it, so we treat it as unknown; values
1456 greater than 3 are undefined. */
1458 if (weight < 2) return t->data.val = CSA_FAIL_DOMAIN;
1460 if (weight > 2) continue;
1462 /* Weight == 2, which means the domain is authorized. We must check that the
1463 client's IP address is listed as one of the SRV target addresses. Save the
1464 target hostname then break to scan the additional data for its addresses. */
1466 (void)dn_expand(dnsa.answer, dnsa.answer + dnsa.answerlen, p,
1467 (DN_EXPAND_ARG4_TYPE)target, sizeof(target));
1469 DEBUG(D_acl) debug_printf_indent("CSA target is %s\n", target);
1474 /* If we didn't break the loop then no appropriate records were found. */
1476 if (rr == NULL) return t->data.val = CSA_UNKNOWN;
1478 /* Do not check addresses if the target is ".", in accordance with RFC 2782.
1479 A target of "." indicates there are no valid addresses, so the client cannot
1480 be authorized. (This is an odd configuration because weight=2 target=. is
1481 equivalent to weight=1, but we check for it in order to keep load off the
1482 root name servers.) Note that dn_expand() turns "." into "". */
1484 if (Ustrcmp(target, "") == 0) return t->data.val = CSA_FAIL_NOADDR;
1486 /* Scan the additional section of the CSA SRV reply for addresses belonging
1487 to the target. If the name server didn't return any additional data (e.g.
1488 because it does not fully support SRV records), we need to do another lookup
1489 to obtain the target addresses; otherwise we have a definitive result. */
1491 rc = acl_verify_csa_address(&dnsa, &dnss, RESET_ADDITIONAL, target);
1492 if (rc != CSA_FAIL_NOADDR) return t->data.val = rc;
1494 /* The DNS lookup type corresponds to the IP version used by the client. */
1497 if (Ustrchr(sender_host_address, ':') != NULL)
1500 #endif /* HAVE_IPV6 */
1504 lookup_dnssec_authenticated = NULL;
1505 switch (dns_lookup(&dnsa, target, type, NULL))
1507 /* If something bad happened (most commonly DNS_AGAIN), defer. */
1510 return t->data.val = CSA_DEFER_ADDR;
1512 /* If the query succeeded, scan the addresses and return the result. */
1515 rc = acl_verify_csa_address(&dnsa, &dnss, RESET_ANSWERS, target);
1516 if (rc != CSA_FAIL_NOADDR) return t->data.val = rc;
1517 /* else fall through */
1519 /* If the target has no IP addresses, the client cannot have an authorized
1520 IP address. However, if the target site uses A6 records (not AAAA records)
1521 we have to do yet another lookup in order to check them. */
1525 return t->data.val = CSA_FAIL_NOADDR;
1531 /*************************************************
1532 * Handle verification (address & other) *
1533 *************************************************/
1535 enum { VERIFY_REV_HOST_LKUP, VERIFY_CERT, VERIFY_HELO, VERIFY_CSA, VERIFY_HDR_SYNTAX,
1536 VERIFY_NOT_BLIND, VERIFY_HDR_SNDR, VERIFY_SNDR, VERIFY_RCPT,
1537 VERIFY_HDR_NAMES_ASCII
1542 unsigned where_allowed; /* bitmap */
1543 BOOL no_options; /* Never has /option(s) following */
1544 unsigned alt_opt_sep; /* >0 Non-/ option separator (custom parser) */
1546 static verify_type_t verify_type_list[] = {
1547 /* name value where no-opt opt-sep */
1548 { US"reverse_host_lookup", VERIFY_REV_HOST_LKUP, ~0, FALSE, 0 },
1549 { US"certificate", VERIFY_CERT, ~0, TRUE, 0 },
1550 { US"helo", VERIFY_HELO, ~0, TRUE, 0 },
1551 { US"csa", VERIFY_CSA, ~0, FALSE, 0 },
1552 { US"header_syntax", VERIFY_HDR_SYNTAX, (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP), TRUE, 0 },
1553 { US"not_blind", VERIFY_NOT_BLIND, (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP), TRUE, 0 },
1554 { US"header_sender", VERIFY_HDR_SNDR, (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP), FALSE, 0 },
1555 { US"sender", VERIFY_SNDR, (1<<ACL_WHERE_MAIL)|(1<<ACL_WHERE_RCPT)
1556 |(1<<ACL_WHERE_PREDATA)|(1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP),
1558 { US"recipient", VERIFY_RCPT, (1<<ACL_WHERE_RCPT), FALSE, 0 },
1559 { US"header_names_ascii", VERIFY_HDR_NAMES_ASCII, (1<<ACL_WHERE_DATA)|(1<<ACL_WHERE_NOTSMTP), TRUE, 0 }
1563 enum { CALLOUT_DEFER_OK, CALLOUT_NOCACHE, CALLOUT_RANDOM, CALLOUT_USE_SENDER,
1564 CALLOUT_USE_POSTMASTER, CALLOUT_POSTMASTER, CALLOUT_FULLPOSTMASTER,
1565 CALLOUT_MAILFROM, CALLOUT_POSTMASTER_MAILFROM, CALLOUT_MAXWAIT, CALLOUT_CONNECT,
1566 CALLOUT_HOLD, CALLOUT_TIME /* TIME must be last */
1572 BOOL has_option; /* Has =option(s) following */
1573 BOOL timeval; /* Has a time value */
1575 static callout_opt_t callout_opt_list[] = {
1576 /* name value flag has-opt has-time */
1577 { US"defer_ok", CALLOUT_DEFER_OK, 0, FALSE, FALSE },
1578 { US"no_cache", CALLOUT_NOCACHE, vopt_callout_no_cache, FALSE, FALSE },
1579 { US"random", CALLOUT_RANDOM, vopt_callout_random, FALSE, FALSE },
1580 { US"use_sender", CALLOUT_USE_SENDER, vopt_callout_recipsender, FALSE, FALSE },
1581 { US"use_postmaster", CALLOUT_USE_POSTMASTER,vopt_callout_recippmaster, FALSE, FALSE },
1582 { US"postmaster_mailfrom",CALLOUT_POSTMASTER_MAILFROM,0, TRUE, FALSE },
1583 { US"postmaster", CALLOUT_POSTMASTER, 0, FALSE, FALSE },
1584 { US"fullpostmaster", CALLOUT_FULLPOSTMASTER,vopt_callout_fullpm, FALSE, FALSE },
1585 { US"mailfrom", CALLOUT_MAILFROM, 0, TRUE, FALSE },
1586 { US"maxwait", CALLOUT_MAXWAIT, 0, TRUE, TRUE },
1587 { US"connect", CALLOUT_CONNECT, 0, TRUE, TRUE },
1588 { US"hold", CALLOUT_HOLD, vopt_callout_hold, FALSE, FALSE },
1589 { NULL, CALLOUT_TIME, 0, FALSE, TRUE }
1594 /* This function implements the "verify" condition. It is called when
1595 encountered in any ACL, because some tests are almost always permitted. Some
1596 just don't make sense, and always fail (for example, an attempt to test a host
1597 lookup for a non-TCP/IP message). Others are restricted to certain ACLs.
1600 where where called from
1601 addr the recipient address that the ACL is handling, or NULL
1602 arg the argument of "verify"
1603 user_msgptr pointer for user message
1604 log_msgptr pointer for log message
1605 basic_errno where to put verify errno
1607 Returns: OK verification condition succeeded
1608 FAIL verification failed
1609 DEFER there was a problem verifying
1614 acl_verify(int where, address_item *addr, const uschar *arg,
1615 uschar **user_msgptr, uschar **log_msgptr, int *basic_errno)
1619 int callout_overall = -1;
1620 int callout_connect = -1;
1621 int verify_options = 0;
1623 BOOL verify_header_sender = FALSE;
1624 BOOL defer_ok = FALSE;
1625 BOOL callout_defer_ok = FALSE;
1626 BOOL no_details = FALSE;
1627 BOOL success_on_redirect = FALSE;
1628 address_item *sender_vaddr = NULL;
1629 uschar *verify_sender_address = NULL;
1630 uschar *pm_mailfrom = NULL;
1631 uschar *se_mailfrom = NULL;
1633 /* Some of the verify items have slash-separated options; some do not. Diagnose
1634 an error if options are given for items that don't expect them.
1637 uschar *slash = Ustrchr(arg, '/');
1638 const uschar *list = arg;
1639 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
1642 if (ss == NULL) goto BAD_VERIFY;
1644 /* Handle name/address consistency verification in a separate function. */
1646 for (vp= verify_type_list;
1647 CS vp < CS verify_type_list + sizeof(verify_type_list);
1650 if (vp->alt_opt_sep ? strncmpic(ss, vp->name, vp->alt_opt_sep) == 0
1651 : strcmpic (ss, vp->name) == 0)
1653 if (CS vp >= CS verify_type_list + sizeof(verify_type_list))
1656 if (vp->no_options && slash != NULL)
1658 *log_msgptr = string_sprintf("unexpected '/' found in \"%s\" "
1659 "(this verify item has no options)", arg);
1662 if (!(vp->where_allowed & (1<<where)))
1664 *log_msgptr = string_sprintf("cannot verify %s in ACL for %s", vp->name, acl_wherenames[where]);
1669 case VERIFY_REV_HOST_LKUP:
1670 if (sender_host_address == NULL) return OK;
1671 if ((rc = acl_verify_reverse(user_msgptr, log_msgptr)) == DEFER)
1672 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size)))
1673 if (strcmpic(ss, US"defer_ok") == 0)
1678 /* TLS certificate verification is done at STARTTLS time; here we just
1679 test whether it was successful or not. (This is for optional verification; for
1680 mandatory verification, the connection doesn't last this long.) */
1682 if (tls_in.certificate_verified) return OK;
1683 *user_msgptr = US"no verified certificate";
1687 /* We can test the result of optional HELO verification that might have
1688 occurred earlier. If not, we can attempt the verification now. */
1690 if (!helo_verified && !helo_verify_failed) smtp_verify_helo();
1691 return helo_verified? OK : FAIL;
1694 /* Do Client SMTP Authorization checks in a separate function, and turn the
1695 result code into user-friendly strings. */
1697 rc = acl_verify_csa(list);
1698 *log_msgptr = *user_msgptr = string_sprintf("client SMTP authorization %s",
1699 csa_reason_string[rc]);
1700 csa_status = csa_status_string[rc];
1701 DEBUG(D_acl) debug_printf_indent("CSA result %s\n", csa_status);
1702 return csa_return_code[rc];
1704 case VERIFY_HDR_SYNTAX:
1705 /* Check that all relevant header lines have the correct 5322-syntax. If there is
1706 a syntax error, we return details of the error to the sender if configured to
1707 send out full details. (But a "message" setting on the ACL can override, as
1710 rc = verify_check_headers(log_msgptr);
1711 if (rc != OK && *log_msgptr)
1712 if (smtp_return_error_details)
1713 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1715 acl_verify_message = *log_msgptr;
1718 case VERIFY_HDR_NAMES_ASCII:
1719 /* Check that all header names are true 7 bit strings
1720 See RFC 5322, 2.2. and RFC 6532, 3. */
1722 rc = verify_check_header_names_ascii(log_msgptr);
1723 if (rc != OK && smtp_return_error_details && *log_msgptr != NULL)
1724 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1727 case VERIFY_NOT_BLIND:
1728 /* Check that no recipient of this message is "blind", that is, every envelope
1729 recipient must be mentioned in either To: or Cc:. */
1731 rc = verify_check_notblind();
1734 *log_msgptr = string_sprintf("bcc recipient detected");
1735 if (smtp_return_error_details)
1736 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1740 /* The remaining verification tests check recipient and sender addresses,
1741 either from the envelope or from the header. There are a number of
1742 slash-separated options that are common to all of them. */
1744 case VERIFY_HDR_SNDR:
1745 verify_header_sender = TRUE;
1749 /* In the case of a sender, this can optionally be followed by an address to use
1750 in place of the actual sender (rare special-case requirement). */
1754 verify_sender_address = sender_address;
1757 while (isspace(*s)) s++;
1758 if (*s++ != '=') goto BAD_VERIFY;
1759 while (isspace(*s)) s++;
1760 verify_sender_address = string_copy(s);
1771 /* Remaining items are optional; they apply to sender and recipient
1772 verification, including "header sender" verification. */
1774 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size))
1777 if (strcmpic(ss, US"defer_ok") == 0) defer_ok = TRUE;
1778 else if (strcmpic(ss, US"no_details") == 0) no_details = TRUE;
1779 else if (strcmpic(ss, US"success_on_redirect") == 0) success_on_redirect = TRUE;
1781 /* These two old options are left for backwards compatibility */
1783 else if (strcmpic(ss, US"callout_defer_ok") == 0)
1785 callout_defer_ok = TRUE;
1786 if (callout == -1) callout = CALLOUT_TIMEOUT_DEFAULT;
1789 else if (strcmpic(ss, US"check_postmaster") == 0)
1792 if (callout == -1) callout = CALLOUT_TIMEOUT_DEFAULT;
1795 /* The callout option has a number of sub-options, comma separated */
1797 else if (strncmpic(ss, US"callout", 7) == 0)
1799 callout = CALLOUT_TIMEOUT_DEFAULT;
1803 while (isspace(*ss)) ss++;
1806 const uschar * sublist = ss;
1810 while (isspace(*sublist)) sublist++;
1812 while ((opt = string_nextinlist(&sublist, &optsep, buffer, sizeof(buffer))))
1815 double period = 1.0F;
1817 for (op= callout_opt_list; op->name; op++)
1818 if (strncmpic(opt, op->name, Ustrlen(op->name)) == 0)
1821 verify_options |= op->flag;
1824 opt += Ustrlen(op->name);
1825 while (isspace(*opt)) opt++;
1828 *log_msgptr = string_sprintf("'=' expected after "
1829 "\"%s\" in ACL verify condition \"%s\"", op->name, arg);
1832 while (isspace(*opt)) opt++;
1834 if (op->timeval && (period = readconf_readtime(opt, 0, FALSE)) < 0)
1836 *log_msgptr = string_sprintf("bad time value in ACL condition "
1837 "\"verify %s\"", arg);
1843 case CALLOUT_DEFER_OK: callout_defer_ok = TRUE; break;
1844 case CALLOUT_POSTMASTER: pm_mailfrom = US""; break;
1845 case CALLOUT_FULLPOSTMASTER: pm_mailfrom = US""; break;
1846 case CALLOUT_MAILFROM:
1847 if (!verify_header_sender)
1849 *log_msgptr = string_sprintf("\"mailfrom\" is allowed as a "
1850 "callout option only for verify=header_sender (detected in ACL "
1851 "condition \"%s\")", arg);
1854 se_mailfrom = string_copy(opt);
1856 case CALLOUT_POSTMASTER_MAILFROM: pm_mailfrom = string_copy(opt); break;
1857 case CALLOUT_MAXWAIT: callout_overall = period; break;
1858 case CALLOUT_CONNECT: callout_connect = period; break;
1859 case CALLOUT_TIME: callout = period; break;
1865 *log_msgptr = string_sprintf("'=' expected after \"callout\" in "
1866 "ACL condition \"%s\"", arg);
1872 /* Option not recognized */
1876 *log_msgptr = string_sprintf("unknown option \"%s\" in ACL "
1877 "condition \"verify %s\"", ss, arg);
1882 if ((verify_options & (vopt_callout_recipsender|vopt_callout_recippmaster)) ==
1883 (vopt_callout_recipsender|vopt_callout_recippmaster))
1885 *log_msgptr = US"only one of use_sender and use_postmaster can be set "
1886 "for a recipient callout";
1890 /* Handle sender-in-header verification. Default the user message to the log
1891 message if giving out verification details. */
1893 if (verify_header_sender)
1897 if ((rc = verify_check_header_address(user_msgptr, log_msgptr, callout,
1898 callout_overall, callout_connect, se_mailfrom, pm_mailfrom, verify_options,
1901 *basic_errno = verrno;
1902 if (smtp_return_error_details)
1904 if (!*user_msgptr && *log_msgptr)
1905 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1906 if (rc == DEFER) acl_temp_details = TRUE;
1911 /* Handle a sender address. The default is to verify *the* sender address, but
1912 optionally a different address can be given, for special requirements. If the
1913 address is empty, we are dealing with a bounce message that has no sender, so
1914 we cannot do any checking. If the real sender address gets rewritten during
1915 verification (e.g. DNS widening), set the flag to stop it being rewritten again
1916 during message reception.
1918 A list of verified "sender" addresses is kept to try to avoid doing to much
1919 work repetitively when there are multiple recipients in a message and they all
1920 require sender verification. However, when callouts are involved, it gets too
1921 complicated because different recipients may require different callout options.
1922 Therefore, we always do a full sender verify when any kind of callout is
1923 specified. Caching elsewhere, for instance in the DNS resolver and in the
1924 callout handling, should ensure that this is not terribly inefficient. */
1926 else if (verify_sender_address)
1928 if ((verify_options & (vopt_callout_recipsender|vopt_callout_recippmaster)))
1930 *log_msgptr = US"use_sender or use_postmaster cannot be used for a "
1931 "sender verify callout";
1935 sender_vaddr = verify_checked_sender(verify_sender_address);
1936 if (sender_vaddr != NULL && /* Previously checked */
1937 callout <= 0) /* No callout needed this time */
1939 /* If the "routed" flag is set, it means that routing worked before, so
1940 this check can give OK (the saved return code value, if set, belongs to a
1941 callout that was done previously). If the "routed" flag is not set, routing
1942 must have failed, so we use the saved return code. */
1944 if (testflag(sender_vaddr, af_verify_routed))
1948 rc = sender_vaddr->special_action;
1949 *basic_errno = sender_vaddr->basic_errno;
1951 HDEBUG(D_acl) debug_printf_indent("using cached sender verify result\n");
1954 /* Do a new verification, and cache the result. The cache is used to avoid
1955 verifying the sender multiple times for multiple RCPTs when callouts are not
1956 specified (see comments above).
1958 The cache is also used on failure to give details in response to the first
1959 RCPT that gets bounced for this reason. However, this can be suppressed by
1960 the no_details option, which sets the flag that says "this detail has already
1961 been sent". The cache normally contains just one address, but there may be
1962 more in esoteric circumstances. */
1967 uschar *save_address_data = deliver_address_data;
1969 sender_vaddr = deliver_make_addr(verify_sender_address, TRUE);
1971 if ((sender_vaddr->prop.utf8_msg = message_smtputf8))
1973 sender_vaddr->prop.utf8_downcvt = message_utf8_downconvert == 1;
1974 sender_vaddr->prop.utf8_downcvt_maybe = message_utf8_downconvert == -1;
1977 if (no_details) setflag(sender_vaddr, af_sverify_told);
1978 if (verify_sender_address[0] != 0)
1980 /* If this is the real sender address, save the unrewritten version
1981 for use later in receive. Otherwise, set a flag so that rewriting the
1982 sender in verify_address() does not update sender_address. */
1984 if (verify_sender_address == sender_address)
1985 sender_address_unrewritten = sender_address;
1987 verify_options |= vopt_fake_sender;
1989 if (success_on_redirect)
1990 verify_options |= vopt_success_on_redirect;
1992 /* The recipient, qualify, and expn options are never set in
1995 rc = verify_address(sender_vaddr, NULL, verify_options, callout,
1996 callout_overall, callout_connect, se_mailfrom, pm_mailfrom, &routed);
1998 HDEBUG(D_acl) debug_printf_indent("----------- end verify ------------\n");
2001 *basic_errno = sender_vaddr->basic_errno;
2005 if (Ustrcmp(sender_vaddr->address, verify_sender_address) != 0)
2006 debug_printf_indent("sender %s verified ok as %s\n",
2007 verify_sender_address, sender_vaddr->address);
2009 debug_printf_indent("sender %s verified ok\n",
2010 verify_sender_address);
2014 rc = OK; /* Null sender */
2016 /* Cache the result code */
2018 if (routed) setflag(sender_vaddr, af_verify_routed);
2019 if (callout > 0) setflag(sender_vaddr, af_verify_callout);
2020 sender_vaddr->special_action = rc;
2021 sender_vaddr->next = sender_verified_list;
2022 sender_verified_list = sender_vaddr;
2024 /* Restore the recipient address data, which might have been clobbered by
2025 the sender verification. */
2027 deliver_address_data = save_address_data;
2030 /* Put the sender address_data value into $sender_address_data */
2032 sender_address_data = sender_vaddr->prop.address_data;
2035 /* A recipient address just gets a straightforward verify; again we must handle
2036 the DEFER overrides. */
2042 if (success_on_redirect)
2043 verify_options |= vopt_success_on_redirect;
2045 /* We must use a copy of the address for verification, because it might
2049 rc = verify_address(&addr2, NULL, verify_options|vopt_is_recipient, callout,
2050 callout_overall, callout_connect, se_mailfrom, pm_mailfrom, NULL);
2051 HDEBUG(D_acl) debug_printf_indent("----------- end verify ------------\n");
2053 *basic_errno = addr2.basic_errno;
2054 *log_msgptr = addr2.message;
2055 *user_msgptr = (addr2.user_message != NULL)?
2056 addr2.user_message : addr2.message;
2058 /* Allow details for temporary error if the address is so flagged. */
2059 if (testflag((&addr2), af_pass_message)) acl_temp_details = TRUE;
2061 /* Make $address_data visible */
2062 deliver_address_data = addr2.prop.address_data;
2065 /* We have a result from the relevant test. Handle defer overrides first. */
2067 if (rc == DEFER && (defer_ok ||
2068 (callout_defer_ok && *basic_errno == ERRNO_CALLOUTDEFER)))
2070 HDEBUG(D_acl) debug_printf_indent("verify defer overridden by %s\n",
2071 defer_ok? "defer_ok" : "callout_defer_ok");
2075 /* If we've failed a sender, set up a recipient message, and point
2076 sender_verified_failed to the address item that actually failed. */
2078 if (rc != OK && verify_sender_address != NULL)
2081 *log_msgptr = *user_msgptr = US"Sender verify failed";
2082 else if (*basic_errno != ERRNO_CALLOUTDEFER)
2083 *log_msgptr = *user_msgptr = US"Could not complete sender verify";
2086 *log_msgptr = US"Could not complete sender verify callout";
2087 *user_msgptr = smtp_return_error_details? sender_vaddr->user_message :
2091 sender_verified_failed = sender_vaddr;
2094 /* Verifying an address messes up the values of $domain and $local_part,
2095 so reset them before returning if this is a RCPT ACL. */
2099 deliver_domain = addr->domain;
2100 deliver_localpart = addr->local_part;
2104 /* Syntax errors in the verify argument come here. */
2107 *log_msgptr = string_sprintf("expected \"sender[=address]\", \"recipient\", "
2108 "\"helo\", \"header_syntax\", \"header_sender\", \"header_names_ascii\" "
2109 "or \"reverse_host_lookup\" at start of ACL condition "
2110 "\"verify %s\"", arg);
2117 /*************************************************
2118 * Check argument for control= modifier *
2119 *************************************************/
2121 /* Called from acl_check_condition() below
2124 arg the argument string for control=
2125 pptr set to point to the terminating character
2126 where which ACL we are in
2127 log_msgptr for error messages
2129 Returns: CONTROL_xxx value
2133 decode_control(const uschar *arg, const uschar **pptr, int where, uschar **log_msgptr)
2138 if ( (idx = find_control(arg, controls_list, nelem(controls_list))) < 0
2139 || ( arg[len = Ustrlen((d = controls_list+idx)->name)] != 0
2140 && (!d->has_option || arg[len] != '/')
2143 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
2144 return CONTROL_ERROR;
2154 /*************************************************
2155 * Return a ratelimit error *
2156 *************************************************/
2158 /* Called from acl_ratelimit() below
2161 log_msgptr for error messages
2162 format format string
2163 ... supplementary arguments
2164 ss ratelimit option name
2165 where ACL_WHERE_xxxx indicating which ACL this is
2171 ratelimit_error(uschar **log_msgptr, const char *format, ...)
2174 uschar buffer[STRING_SPRINTF_BUFFER_SIZE];
2175 va_start(ap, format);
2176 if (!string_vformat(buffer, sizeof(buffer), format, ap))
2177 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
2178 "string_sprintf expansion was longer than " SIZE_T_FMT, sizeof(buffer));
2180 *log_msgptr = string_sprintf(
2181 "error in arguments to \"ratelimit\" condition: %s", buffer);
2188 /*************************************************
2189 * Handle rate limiting *
2190 *************************************************/
2192 /* Called by acl_check_condition() below to calculate the result
2193 of the ACL ratelimit condition.
2195 Note that the return value might be slightly unexpected: if the
2196 sender's rate is above the limit then the result is OK. This is
2197 similar to the dnslists condition, and is so that you can write
2198 ACL clauses like: defer ratelimit = 15 / 1h
2201 arg the option string for ratelimit=
2202 where ACL_WHERE_xxxx indicating which ACL this is
2203 log_msgptr for error messages
2205 Returns: OK - Sender's rate is above limit
2206 FAIL - Sender's rate is below limit
2207 DEFER - Problem opening ratelimit database
2208 ERROR - Syntax error in options.
2212 acl_ratelimit(const uschar *arg, int where, uschar **log_msgptr)
2214 double limit, period, count;
2217 uschar *unique = NULL;
2219 BOOL leaky = FALSE, strict = FALSE, readonly = FALSE;
2220 BOOL noupdate = FALSE, badacl = FALSE;
2221 int mode = RATE_PER_WHAT;
2223 tree_node **anchor, *t;
2224 open_db dbblock, *dbm;
2226 dbdata_ratelimit *dbd;
2227 dbdata_ratelimit_unique *dbdb;
2230 /* Parse the first two options and record their values in expansion
2231 variables. These variables allow the configuration to have informative
2232 error messages based on rate limits obtained from a table lookup. */
2234 /* First is the maximum number of messages per period / maximum burst
2235 size, which must be greater than or equal to zero. Zero is useful for
2236 rate measurement as opposed to rate limiting. */
2238 sender_rate_limit = string_nextinlist(&arg, &sep, NULL, 0);
2239 if (sender_rate_limit == NULL)
2240 return ratelimit_error(log_msgptr, "sender rate limit not set");
2242 limit = Ustrtod(sender_rate_limit, &ss);
2243 if (tolower(*ss) == 'k') { limit *= 1024.0; ss++; }
2244 else if (tolower(*ss) == 'm') { limit *= 1024.0*1024.0; ss++; }
2245 else if (tolower(*ss) == 'g') { limit *= 1024.0*1024.0*1024.0; ss++; }
2247 if (limit < 0.0 || *ss != '\0')
2248 return ratelimit_error(log_msgptr,
2249 "\"%s\" is not a positive number", sender_rate_limit);
2251 /* Second is the rate measurement period / exponential smoothing time
2252 constant. This must be strictly greater than zero, because zero leads to
2253 run-time division errors. */
2255 sender_rate_period = string_nextinlist(&arg, &sep, NULL, 0);
2256 if (sender_rate_period == NULL) period = -1.0;
2257 else period = readconf_readtime(sender_rate_period, 0, FALSE);
2259 return ratelimit_error(log_msgptr,
2260 "\"%s\" is not a time value", sender_rate_period);
2262 /* By default we are counting one of something, but the per_rcpt,
2263 per_byte, and count options can change this. */
2267 /* Parse the other options. */
2269 while ((ss = string_nextinlist(&arg, &sep, big_buffer, big_buffer_size))
2272 if (strcmpic(ss, US"leaky") == 0) leaky = TRUE;
2273 else if (strcmpic(ss, US"strict") == 0) strict = TRUE;
2274 else if (strcmpic(ss, US"noupdate") == 0) noupdate = TRUE;
2275 else if (strcmpic(ss, US"readonly") == 0) readonly = TRUE;
2276 else if (strcmpic(ss, US"per_cmd") == 0) RATE_SET(mode, PER_CMD);
2277 else if (strcmpic(ss, US"per_conn") == 0)
2279 RATE_SET(mode, PER_CONN);
2280 if (where == ACL_WHERE_NOTSMTP || where == ACL_WHERE_NOTSMTP_START)
2283 else if (strcmpic(ss, US"per_mail") == 0)
2285 RATE_SET(mode, PER_MAIL);
2286 if (where > ACL_WHERE_NOTSMTP) badacl = TRUE;
2288 else if (strcmpic(ss, US"per_rcpt") == 0)
2290 /* If we are running in the RCPT ACL, then we'll count the recipients
2291 one by one, but if we are running when we have accumulated the whole
2292 list then we'll add them all in one batch. */
2293 if (where == ACL_WHERE_RCPT)
2294 RATE_SET(mode, PER_RCPT);
2295 else if (where >= ACL_WHERE_PREDATA && where <= ACL_WHERE_NOTSMTP)
2296 RATE_SET(mode, PER_ALLRCPTS), count = (double)recipients_count;
2297 else if (where == ACL_WHERE_MAIL || where > ACL_WHERE_NOTSMTP)
2298 RATE_SET(mode, PER_RCPT), badacl = TRUE;
2300 else if (strcmpic(ss, US"per_byte") == 0)
2302 /* If we have not yet received the message data and there was no SIZE
2303 declaration on the MAIL command, then it's safe to just use a value of
2304 zero and let the recorded rate decay as if nothing happened. */
2305 RATE_SET(mode, PER_MAIL);
2306 if (where > ACL_WHERE_NOTSMTP) badacl = TRUE;
2307 else count = message_size < 0 ? 0.0 : (double)message_size;
2309 else if (strcmpic(ss, US"per_addr") == 0)
2311 RATE_SET(mode, PER_RCPT);
2312 if (where != ACL_WHERE_RCPT) badacl = TRUE, unique = US"*";
2313 else unique = string_sprintf("%s@%s", deliver_localpart, deliver_domain);
2315 else if (strncmpic(ss, US"count=", 6) == 0)
2318 count = Ustrtod(ss+6, &e);
2319 if (count < 0.0 || *e != '\0')
2320 return ratelimit_error(log_msgptr,
2321 "\"%s\" is not a positive number", ss);
2323 else if (strncmpic(ss, US"unique=", 7) == 0)
2324 unique = string_copy(ss + 7);
2325 else if (key == NULL)
2326 key = string_copy(ss);
2328 key = string_sprintf("%s/%s", key, ss);
2331 /* Sanity check. When the badacl flag is set the update mode must either
2332 be readonly (which is the default if it is omitted) or, for backwards
2333 compatibility, a combination of noupdate and strict or leaky. */
2335 if (mode == RATE_PER_CLASH)
2336 return ratelimit_error(log_msgptr, "conflicting per_* options");
2337 if (leaky + strict + readonly > 1)
2338 return ratelimit_error(log_msgptr, "conflicting update modes");
2339 if (badacl && (leaky || strict) && !noupdate)
2340 return ratelimit_error(log_msgptr,
2341 "\"%s\" must not have /leaky or /strict option in %s ACL",
2342 ratelimit_option_string[mode], acl_wherenames[where]);
2344 /* Set the default values of any unset options. In readonly mode we
2345 perform the rate computation without any increment so that its value
2346 decays to eventually allow over-limit senders through. */
2348 if (noupdate) readonly = TRUE, leaky = strict = FALSE;
2349 if (badacl) readonly = TRUE;
2350 if (readonly) count = 0.0;
2351 if (!strict && !readonly) leaky = TRUE;
2352 if (mode == RATE_PER_WHAT) mode = RATE_PER_MAIL;
2354 /* Create the lookup key. If there is no explicit key, use sender_host_address.
2355 If there is no sender_host_address (e.g. -bs or acl_not_smtp) then we simply
2356 omit it. The smoothing constant (sender_rate_period) and the per_xxx options
2357 are added to the key because they alter the meaning of the stored data. */
2360 key = (sender_host_address == NULL)? US"" : sender_host_address;
2362 key = string_sprintf("%s/%s/%s%s",
2364 ratelimit_option_string[mode],
2365 unique == NULL ? "" : "unique/",
2369 debug_printf_indent("ratelimit condition count=%.0f %.1f/%s\n", count, limit, key);
2371 /* See if we have already computed the rate by looking in the relevant tree.
2372 For per-connection rate limiting, store tree nodes and dbdata in the permanent
2373 pool so that they survive across resets. In readonly mode we only remember the
2374 result for the rest of this command in case a later command changes it. After
2375 this bit of logic the code is independent of the per_* mode. */
2377 old_pool = store_pool;
2380 anchor = &ratelimiters_cmd;
2383 anchor = &ratelimiters_conn;
2384 store_pool = POOL_PERM;
2388 case RATE_PER_ALLRCPTS:
2389 anchor = &ratelimiters_mail;
2394 anchor = &ratelimiters_cmd;
2397 anchor = NULL; /* silence an "unused" complaint */
2398 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
2399 "internal ACL error: unknown ratelimit mode %d", mode);
2403 t = tree_search(*anchor, key);
2407 /* The following few lines duplicate some of the code below. */
2408 rc = (dbd->rate < limit)? FAIL : OK;
2409 store_pool = old_pool;
2410 sender_rate = string_sprintf("%.1f", dbd->rate);
2412 debug_printf_indent("ratelimit found pre-computed rate %s\n", sender_rate);
2416 /* We aren't using a pre-computed rate, so get a previously recorded rate
2417 from the database, which will be updated and written back if required. */
2419 if (!(dbm = dbfn_open(US"ratelimit", O_RDWR, &dbblock, TRUE)))
2421 store_pool = old_pool;
2423 HDEBUG(D_acl) debug_printf_indent("ratelimit database not available\n");
2424 *log_msgptr = US"ratelimit database not available";
2427 dbdb = dbfn_read_with_length(dbm, key, &dbdb_size);
2430 gettimeofday(&tv, NULL);
2434 /* Locate the basic ratelimit block inside the DB data. */
2435 HDEBUG(D_acl) debug_printf_indent("ratelimit found key in database\n");
2438 /* Forget the old Bloom filter if it is too old, so that we count each
2439 repeating event once per period. We don't simply clear and re-use the old
2440 filter because we want its size to change if the limit changes. Note that
2441 we keep the dbd pointer for copying the rate into the new data block. */
2443 if(unique != NULL && tv.tv_sec > dbdb->bloom_epoch + period)
2445 HDEBUG(D_acl) debug_printf_indent("ratelimit discarding old Bloom filter\n");
2451 if(unique != NULL && dbdb_size < sizeof(*dbdb))
2453 HDEBUG(D_acl) debug_printf_indent("ratelimit discarding undersize Bloom filter\n");
2458 /* Allocate a new data block if the database lookup failed
2459 or the Bloom filter passed its age limit. */
2465 /* No Bloom filter. This basic ratelimit block is initialized below. */
2466 HDEBUG(D_acl) debug_printf_indent("ratelimit creating new rate data block\n");
2467 dbdb_size = sizeof(*dbd);
2468 dbdb = store_get(dbdb_size);
2473 HDEBUG(D_acl) debug_printf_indent("ratelimit creating new Bloom filter\n");
2475 /* See the long comment below for an explanation of the magic number 2.
2476 The filter has a minimum size in case the rate limit is very small;
2477 this is determined by the definition of dbdata_ratelimit_unique. */
2479 extra = (int)limit * 2 - sizeof(dbdb->bloom);
2480 if (extra < 0) extra = 0;
2481 dbdb_size = sizeof(*dbdb) + extra;
2482 dbdb = store_get(dbdb_size);
2483 dbdb->bloom_epoch = tv.tv_sec;
2484 dbdb->bloom_size = sizeof(dbdb->bloom) + extra;
2485 memset(dbdb->bloom, 0, dbdb->bloom_size);
2487 /* Preserve any basic ratelimit data (which is our longer-term memory)
2488 by copying it from the discarded block. */
2498 /* If we are counting unique events, find out if this event is new or not.
2499 If the client repeats the event during the current period then it should be
2500 counted. We skip this code in readonly mode for efficiency, because any
2501 changes to the filter will be discarded and because count is already set to
2504 if (unique != NULL && !readonly)
2506 /* We identify unique events using a Bloom filter. (You can find my
2507 notes on Bloom filters at http://fanf.livejournal.com/81696.html)
2508 With the per_addr option, an "event" is a recipient address, though the
2509 user can use the unique option to define their own events. We only count
2510 an event if we have not seen it before.
2512 We size the filter according to the rate limit, which (in leaky mode)
2513 is the limit on the population of the filter. We allow 16 bits of space
2514 per entry (see the construction code above) and we set (up to) 8 of them
2515 when inserting an element (see the loop below). The probability of a false
2516 positive (an event we have not seen before but which we fail to count) is
2520 allzero = exp(-numhash * pop / size)
2521 = exp(-0.5 * pop / limit)
2522 fpr = pow(1 - allzero, numhash)
2524 For senders at the limit the fpr is 0.06% or 1 in 1700
2525 and for senders at half the limit it is 0.0006% or 1 in 170000
2527 In strict mode the Bloom filter can fill up beyond the normal limit, in
2528 which case the false positive rate will rise. This means that the
2529 measured rate for very fast senders can bogusly drop off after a while.
2531 At twice the limit, the fpr is 2.5% or 1 in 40
2532 At four times the limit, it is 31% or 1 in 3.2
2534 It takes ln(pop/limit) periods for an over-limit burst of pop events to
2535 decay below the limit, and if this is more than one then the Bloom filter
2536 will be discarded before the decay gets that far. The false positive rate
2537 at this threshold is 9.3% or 1 in 10.7. */
2540 unsigned n, hash, hinc;
2544 /* Instead of using eight independent hash values, we combine two values
2545 using the formula h1 + n * h2. This does not harm the Bloom filter's
2546 performance, and means the amount of hash we need is independent of the
2547 number of bits we set in the filter. */
2549 md5_start(&md5info);
2550 md5_end(&md5info, unique, Ustrlen(unique), md5sum);
2551 hash = md5sum[0] | md5sum[1] << 8 | md5sum[2] << 16 | md5sum[3] << 24;
2552 hinc = md5sum[4] | md5sum[5] << 8 | md5sum[6] << 16 | md5sum[7] << 24;
2554 /* Scan the bits corresponding to this event. A zero bit means we have
2555 not seen it before. Ensure all bits are set to record this event. */
2557 HDEBUG(D_acl) debug_printf_indent("ratelimit checking uniqueness of %s\n", unique);
2560 for (n = 0; n < 8; n++, hash += hinc)
2562 int bit = 1 << (hash % 8);
2563 int byte = (hash / 8) % dbdb->bloom_size;
2564 if ((dbdb->bloom[byte] & bit) == 0)
2566 dbdb->bloom[byte] |= bit;
2571 /* If this event has occurred before, do not count it. */
2575 HDEBUG(D_acl) debug_printf_indent("ratelimit event found in Bloom filter\n");
2579 HDEBUG(D_acl) debug_printf_indent("ratelimit event added to Bloom filter\n");
2582 /* If there was no previous ratelimit data block for this key, initialize
2583 the new one, otherwise update the block from the database. The initial rate
2584 is what would be computed by the code below for an infinite interval. */
2588 HDEBUG(D_acl) debug_printf_indent("ratelimit initializing new key's rate data\n");
2590 dbd->time_stamp = tv.tv_sec;
2591 dbd->time_usec = tv.tv_usec;
2596 /* The smoothed rate is computed using an exponentially weighted moving
2597 average adjusted for variable sampling intervals. The standard EWMA for
2598 a fixed sampling interval is: f'(t) = (1 - a) * f(t) + a * f'(t - 1)
2599 where f() is the measured value and f'() is the smoothed value.
2601 Old data decays out of the smoothed value exponentially, such that data n
2602 samples old is multiplied by a^n. The exponential decay time constant p
2603 is defined such that data p samples old is multiplied by 1/e, which means
2604 that a = exp(-1/p). We can maintain the same time constant for a variable
2605 sampling interval i by using a = exp(-i/p).
2607 The rate we are measuring is messages per period, suitable for directly
2608 comparing with the limit. The average rate between now and the previous
2609 message is period / interval, which we feed into the EWMA as the sample.
2611 It turns out that the number of messages required for the smoothed rate
2612 to reach the limit when they are sent in a burst is equal to the limit.
2613 This can be seen by analysing the value of the smoothed rate after N
2614 messages sent at even intervals. Let k = (1 - a) * p/i
2616 rate_1 = (1 - a) * p/i + a * rate_0
2618 rate_2 = k + a * rate_1
2619 = k + a * k + a^2 * rate_0
2620 rate_3 = k + a * k + a^2 * k + a^3 * rate_0
2621 rate_N = rate_0 * a^N + k * SUM(x=0..N-1)(a^x)
2622 = rate_0 * a^N + k * (1 - a^N) / (1 - a)
2623 = rate_0 * a^N + p/i * (1 - a^N)
2625 When N is large, a^N -> 0 so rate_N -> p/i as desired.
2627 rate_N = p/i + (rate_0 - p/i) * a^N
2628 a^N = (rate_N - p/i) / (rate_0 - p/i)
2629 N * -i/p = log((rate_N - p/i) / (rate_0 - p/i))
2630 N = p/i * log((rate_0 - p/i) / (rate_N - p/i))
2632 Numerical analysis of the above equation, setting the computed rate to
2633 increase from rate_0 = 0 to rate_N = limit, shows that for large sending
2634 rates, p/i, the number of messages N = limit. So limit serves as both the
2635 maximum rate measured in messages per period, and the maximum number of
2636 messages that can be sent in a fast burst. */
2638 double this_time = (double)tv.tv_sec
2639 + (double)tv.tv_usec / 1000000.0;
2640 double prev_time = (double)dbd->time_stamp
2641 + (double)dbd->time_usec / 1000000.0;
2643 /* We must avoid division by zero, and deal gracefully with the clock going
2644 backwards. If we blunder ahead when time is in reverse then the computed
2645 rate will be bogus. To be safe we clamp interval to a very small number. */
2647 double interval = this_time - prev_time <= 0.0 ? 1e-9
2648 : this_time - prev_time;
2650 double i_over_p = interval / period;
2651 double a = exp(-i_over_p);
2653 /* Combine the instantaneous rate (period / interval) with the previous rate
2654 using the smoothing factor a. In order to measure sized events, multiply the
2655 instantaneous rate by the count of bytes or recipients etc. */
2657 dbd->time_stamp = tv.tv_sec;
2658 dbd->time_usec = tv.tv_usec;
2659 dbd->rate = (1 - a) * count / i_over_p + a * dbd->rate;
2661 /* When events are very widely spaced the computed rate tends towards zero.
2662 Although this is accurate it turns out not to be useful for our purposes,
2663 especially when the first event after a long silence is the start of a spam
2664 run. A more useful model is that the rate for an isolated event should be the
2665 size of the event per the period size, ignoring the lack of events outside
2666 the current period and regardless of where the event falls in the period. So,
2667 if the interval was so long that the calculated rate is unhelpfully small, we
2668 re-initialize the rate. In the absence of higher-rate bursts, the condition
2669 below is true if the interval is greater than the period. */
2671 if (dbd->rate < count) dbd->rate = count;
2674 /* Clients sending at the limit are considered to be over the limit.
2675 This matters for edge cases such as a limit of zero, when the client
2676 should be completely blocked. */
2678 rc = (dbd->rate < limit)? FAIL : OK;
2680 /* Update the state if the rate is low or if we are being strict. If we
2681 are in leaky mode and the sender's rate is too high, we do not update
2682 the recorded rate in order to avoid an over-aggressive sender's retry
2683 rate preventing them from getting any email through. If readonly is set,
2684 neither leaky nor strict are set, so we do not do any updates. */
2686 if ((rc == FAIL && leaky) || strict)
2688 dbfn_write(dbm, key, dbdb, dbdb_size);
2689 HDEBUG(D_acl) debug_printf_indent("ratelimit db updated\n");
2693 HDEBUG(D_acl) debug_printf_indent("ratelimit db not updated: %s\n",
2694 readonly? "readonly mode" : "over the limit, but leaky");
2699 /* Store the result in the tree for future reference. */
2701 t = store_get(sizeof(tree_node) + Ustrlen(key));
2703 Ustrcpy(t->name, key);
2704 (void)tree_insertnode(anchor, t);
2706 /* We create the formatted version of the sender's rate very late in
2707 order to ensure that it is done using the correct storage pool. */
2709 store_pool = old_pool;
2710 sender_rate = string_sprintf("%.1f", dbd->rate);
2713 debug_printf_indent("ratelimit computed rate %s\n", sender_rate);
2720 /*************************************************
2721 * The udpsend ACL modifier *
2722 *************************************************/
2724 /* Called by acl_check_condition() below.
2727 arg the option string for udpsend=
2728 log_msgptr for error messages
2730 Returns: OK - Completed.
2731 DEFER - Problem with DNS lookup.
2732 ERROR - Syntax error in options.
2736 acl_udpsend(const uschar *arg, uschar **log_msgptr)
2748 hostname = string_nextinlist(&arg, &sep, NULL, 0);
2749 portstr = string_nextinlist(&arg, &sep, NULL, 0);
2753 *log_msgptr = US"missing destination host in \"udpsend\" modifier";
2758 *log_msgptr = US"missing destination port in \"udpsend\" modifier";
2763 *log_msgptr = US"missing datagram payload in \"udpsend\" modifier";
2766 portnum = Ustrtol(portstr, &portend, 10);
2767 if (*portend != '\0')
2769 *log_msgptr = US"bad destination port in \"udpsend\" modifier";
2773 /* Make a single-item host list. */
2774 h = store_get(sizeof(host_item));
2775 memset(h, 0, sizeof(host_item));
2780 if (string_is_ip_address(hostname, NULL))
2781 h->address = hostname, r = HOST_FOUND;
2783 r = host_find_byname(h, NULL, 0, NULL, FALSE);
2784 if (r == HOST_FIND_FAILED || r == HOST_FIND_AGAIN)
2786 *log_msgptr = US"DNS lookup failed in \"udpsend\" modifier";
2791 debug_printf_indent("udpsend [%s]:%d %s\n", h->address, portnum, arg);
2793 /*XXX this could better use sendto */
2794 r = s = ip_connectedsocket(SOCK_DGRAM, h->address, portnum, portnum,
2795 1, NULL, &errstr, NULL);
2796 if (r < 0) goto defer;
2798 r = send(s, arg, len, 0);
2801 errstr = US strerror(errno);
2809 string_sprintf("\"udpsend\" truncated from %d to %d octets", len, r);
2814 debug_printf_indent("udpsend %d bytes\n", r);
2819 *log_msgptr = string_sprintf("\"udpsend\" failed: %s", errstr);
2825 /*************************************************
2826 * Handle conditions/modifiers on an ACL item *
2827 *************************************************/
2829 /* Called from acl_check() below.
2833 cb ACL condition block - if NULL, result is OK
2834 where where called from
2835 addr the address being checked for RCPT, or NULL
2836 level the nesting level
2837 epp pointer to pass back TRUE if "endpass" encountered
2838 (applies only to "accept" and "discard")
2839 user_msgptr user message pointer
2840 log_msgptr log message pointer
2841 basic_errno pointer to where to put verify error
2843 Returns: OK - all conditions are met
2844 DISCARD - an "acl" condition returned DISCARD - only allowed
2845 for "accept" or "discard" verbs
2846 FAIL - at least one condition fails
2847 FAIL_DROP - an "acl" condition returned FAIL_DROP
2848 DEFER - can't tell at the moment (typically, lookup defer,
2849 but can be temporary callout problem)
2850 ERROR - ERROR from nested ACL or expansion failure or other
2855 acl_check_condition(int verb, acl_condition_block *cb, int where,
2856 address_item *addr, int level, BOOL *epp, uschar **user_msgptr,
2857 uschar **log_msgptr, int *basic_errno)
2859 uschar *user_message = NULL;
2860 uschar *log_message = NULL;
2862 #ifdef WITH_CONTENT_SCAN
2866 for (; cb != NULL; cb = cb->next)
2871 /* The message and log_message items set up messages to be used in
2872 case of rejection. They are expanded later. */
2874 if (cb->type == ACLC_MESSAGE)
2876 HDEBUG(D_acl) debug_printf_indent(" message: %s\n", cb->arg);
2877 user_message = cb->arg;
2881 if (cb->type == ACLC_LOG_MESSAGE)
2883 HDEBUG(D_acl) debug_printf_indent("l_message: %s\n", cb->arg);
2884 log_message = cb->arg;
2888 /* The endpass "condition" just sets a flag to show it occurred. This is
2889 checked at compile time to be on an "accept" or "discard" item. */
2891 if (cb->type == ACLC_ENDPASS)
2897 /* For other conditions and modifiers, the argument is expanded now for some
2898 of them, but not for all, because expansion happens down in some lower level
2899 checking functions in some cases. */
2901 if (!conditions[cb->type].expand_at_top)
2903 else if (!(arg = expand_string(cb->arg)))
2905 if (expand_string_forcedfail) continue;
2906 *log_msgptr = string_sprintf("failed to expand ACL string \"%s\": %s",
2907 cb->arg, expand_string_message);
2908 return search_find_defer ? DEFER : ERROR;
2911 /* Show condition, and expanded condition if it's different */
2916 debug_printf_indent("check %s%s %n",
2917 (!conditions[cb->type].is_modifier && cb->u.negated)? "!":"",
2918 conditions[cb->type].name, &lhswidth);
2920 if (cb->type == ACLC_SET)
2922 #ifndef DISABLE_DKIM
2923 if ( Ustrcmp(cb->u.varname, "dkim_verify_status") == 0
2924 || Ustrcmp(cb->u.varname, "dkim_verify_reason") == 0)
2926 debug_printf("%s ", cb->u.varname);
2932 debug_printf("acl_%s ", cb->u.varname);
2933 lhswidth += 5 + Ustrlen(cb->u.varname);
2937 debug_printf("= %s\n", cb->arg);
2940 debug_printf("%.*s= %s\n", lhswidth,
2944 /* Check that this condition makes sense at this time */
2946 if ((conditions[cb->type].forbids & (1 << where)) != 0)
2948 *log_msgptr = string_sprintf("cannot %s %s condition in %s ACL",
2949 conditions[cb->type].is_modifier ? "use" : "test",
2950 conditions[cb->type].name, acl_wherenames[where]);
2954 /* Run the appropriate test for each condition, or take the appropriate
2955 action for the remaining modifiers. */
2959 case ACLC_ADD_HEADER:
2963 /* A nested ACL that returns "discard" makes sense only for an "accept" or
2967 rc = acl_check_wargs(where, addr, arg, user_msgptr, log_msgptr);
2968 if (rc == DISCARD && verb != ACL_ACCEPT && verb != ACL_DISCARD)
2970 *log_msgptr = string_sprintf("nested ACL returned \"discard\" for "
2971 "\"%s\" command (only allowed with \"accept\" or \"discard\")",
2977 case ACLC_AUTHENTICATED:
2978 rc = (sender_host_authenticated == NULL)? FAIL :
2979 match_isinlist(sender_host_authenticated, &arg, 0, NULL, NULL, MCL_STRING,
2983 #ifdef EXPERIMENTAL_BRIGHTMAIL
2984 case ACLC_BMI_OPTIN:
2986 int old_pool = store_pool;
2987 store_pool = POOL_PERM;
2988 bmi_current_optin = string_copy(arg);
2989 store_pool = old_pool;
2994 case ACLC_CONDITION:
2995 /* The true/false parsing here should be kept in sync with that used in
2996 expand.c when dealing with ECOND_BOOL so that we don't have too many
2997 different definitions of what can be a boolean. */
2999 ? Ustrspn(arg+1, "0123456789") == Ustrlen(arg+1) /* Negative number */
3000 : Ustrspn(arg, "0123456789") == Ustrlen(arg)) /* Digits, or empty */
3001 rc = (Uatoi(arg) == 0)? FAIL : OK;
3003 rc = (strcmpic(arg, US"no") == 0 ||
3004 strcmpic(arg, US"false") == 0)? FAIL :
3005 (strcmpic(arg, US"yes") == 0 ||
3006 strcmpic(arg, US"true") == 0)? OK : DEFER;
3008 *log_msgptr = string_sprintf("invalid \"condition\" value \"%s\"", arg);
3011 case ACLC_CONTINUE: /* Always succeeds */
3016 const uschar *p = NULL;
3017 control_type = decode_control(arg, &p, where, log_msgptr);
3019 /* Check if this control makes sense at this time */
3021 if (controls_list[control_type].forbids & (1 << where))
3023 *log_msgptr = string_sprintf("cannot use \"control=%s\" in %s ACL",
3024 controls_list[control_type].name, acl_wherenames[where]);
3028 switch(control_type)
3030 case CONTROL_AUTH_UNADVERTISED:
3031 allow_auth_unadvertised = TRUE;
3034 #ifdef EXPERIMENTAL_BRIGHTMAIL
3035 case CONTROL_BMI_RUN:
3040 #ifndef DISABLE_DKIM
3041 case CONTROL_DKIM_VERIFY:
3042 dkim_disable_verify = TRUE;
3043 #ifdef EXPERIMENTAL_DMARC
3044 /* Since DKIM was blocked, skip DMARC too */
3045 dmarc_disable_verify = TRUE;
3046 dmarc_enable_forensic = FALSE;
3051 #ifdef EXPERIMENTAL_DMARC
3052 case CONTROL_DMARC_VERIFY:
3053 dmarc_disable_verify = TRUE;
3056 case CONTROL_DMARC_FORENSIC:
3057 dmarc_enable_forensic = TRUE;
3064 int fd, af, level, optname, value;
3065 /* If we are acting on stdin, the setsockopt may fail if stdin is not
3066 a socket; we can accept that, we'll just debug-log failures anyway. */
3067 fd = fileno(smtp_in);
3068 af = ip_get_address_family(fd);
3072 debug_printf_indent("smtp input is probably not a socket [%s], not setting DSCP\n",
3076 if (dscp_lookup(p+1, af, &level, &optname, &value))
3078 if (setsockopt(fd, level, optname, &value, sizeof(value)) < 0)
3080 HDEBUG(D_acl) debug_printf_indent("failed to set input DSCP[%s]: %s\n",
3081 p+1, strerror(errno));
3085 HDEBUG(D_acl) debug_printf_indent("set input DSCP to \"%s\"\n", p+1);
3090 *log_msgptr = string_sprintf("unrecognised DSCP value in \"control=%s\"", arg);
3096 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
3104 case CONTROL_CASEFUL_LOCAL_PART:
3105 deliver_localpart = addr->cc_local_part;
3108 case CONTROL_CASELOWER_LOCAL_PART:
3109 deliver_localpart = addr->lc_local_part;
3112 case CONTROL_ENFORCE_SYNC:
3113 smtp_enforce_sync = TRUE;
3116 case CONTROL_NO_ENFORCE_SYNC:
3117 smtp_enforce_sync = FALSE;
3120 #ifdef WITH_CONTENT_SCAN
3121 case CONTROL_NO_MBOX_UNSPOOL:
3122 no_mbox_unspool = TRUE;
3126 case CONTROL_NO_MULTILINE:
3127 no_multiline_responses = TRUE;
3130 case CONTROL_NO_PIPELINING:
3131 pipelining_enable = FALSE;
3134 case CONTROL_NO_DELAY_FLUSH:
3135 disable_delay_flush = TRUE;
3138 case CONTROL_NO_CALLOUT_FLUSH:
3139 disable_callout_flush = TRUE;
3142 case CONTROL_FAKEREJECT:
3143 cancel_cutthrough_connection(TRUE, US"fakereject");
3144 case CONTROL_FAKEDEFER:
3145 fake_response = (control_type == CONTROL_FAKEDEFER) ? DEFER : FAIL;
3148 const uschar *pp = p + 1;
3149 while (*pp != 0) pp++;
3150 fake_response_text = expand_string(string_copyn(p+1, pp-p-1));
3155 /* Explicitly reset to default string */
3156 fake_response_text = US"Your message has been rejected but is being kept for evaluation.\nIf it was a legitimate message, it may still be delivered to the target recipient(s).";
3160 case CONTROL_FREEZE:
3161 deliver_freeze = TRUE;
3162 deliver_frozen_at = time(NULL);
3163 freeze_tell = freeze_tell_config; /* Reset to configured value */
3164 if (Ustrncmp(p, "/no_tell", 8) == 0)
3171 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
3174 cancel_cutthrough_connection(TRUE, US"item frozen");
3177 case CONTROL_QUEUE_ONLY:
3178 queue_only_policy = TRUE;
3179 cancel_cutthrough_connection(TRUE, US"queueing forced");
3182 case CONTROL_SUBMISSION:
3183 originator_name = US"";
3184 submission_mode = TRUE;
3187 if (Ustrncmp(p, "/sender_retain", 14) == 0)
3190 active_local_sender_retain = TRUE;
3191 active_local_from_check = FALSE;
3193 else if (Ustrncmp(p, "/domain=", 8) == 0)
3195 const uschar *pp = p + 8;
3196 while (*pp != 0 && *pp != '/') pp++;
3197 submission_domain = string_copyn(p+8, pp-p-8);
3200 /* The name= option must be last, because it swallows the rest of
3202 else if (Ustrncmp(p, "/name=", 6) == 0)
3204 const uschar *pp = p + 6;
3205 while (*pp != 0) pp++;
3206 submission_name = string_copy(parse_fix_phrase(p+6, pp-p-6,
3207 big_buffer, big_buffer_size));
3214 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
3221 uschar * debug_tag = NULL;
3222 uschar * debug_opts = NULL;
3227 const uschar * pp = p+1;
3228 if (Ustrncmp(pp, "tag=", 4) == 0)
3230 for (pp += 4; *pp && *pp != '/';) pp++;
3231 debug_tag = string_copyn(p+5, pp-p-5);
3233 else if (Ustrncmp(pp, "opts=", 5) == 0)
3235 for (pp += 5; *pp && *pp != '/';) pp++;
3236 debug_opts = string_copyn(p+6, pp-p-6);
3238 else if (Ustrncmp(pp, "kill", 4) == 0)
3240 for (pp += 4; *pp && *pp != '/';) pp++;
3244 while (*pp && *pp != '/') pp++;
3249 debug_logging_stop();
3251 debug_logging_activate(debug_tag, debug_opts);
3255 case CONTROL_SUPPRESS_LOCAL_FIXUPS:
3256 suppress_local_fixups = TRUE;
3259 case CONTROL_CUTTHROUGH_DELIVERY:
3260 #ifndef DISABLE_PRDR
3265 /* Too hard to think about for now. We might in future cutthrough
3266 the case where both sides handle prdr and this-node prdr acl
3268 *log_msgptr = string_sprintf("PRDR on %s reception\n", arg);
3272 *log_msgptr = US"frozen";
3273 else if (queue_only_policy)
3274 *log_msgptr = US"queue-only";
3275 else if (fake_response == FAIL)
3276 *log_msgptr = US"fakereject";
3279 if (rcpt_count == 1)
3281 cutthrough.delivery = TRUE;
3284 const uschar * pp = p+1;
3285 if (Ustrncmp(pp, "defer=", 6) == 0)
3288 if (Ustrncmp(pp, "pass", 4) == 0) cutthrough.defer_pass = TRUE;
3289 /* else if (Ustrncmp(pp, "spool") == 0) ; default */
3292 while (*pp && *pp != '/') pp++;
3298 *log_msgptr = string_sprintf("\"control=%s\" on %s item",
3304 case CONTROL_UTF8_DOWNCONVERT:
3309 message_utf8_downconvert = 1;
3310 addr->prop.utf8_downcvt = TRUE;
3311 addr->prop.utf8_downcvt_maybe = FALSE;
3317 message_utf8_downconvert = 0;
3318 addr->prop.utf8_downcvt = FALSE;
3319 addr->prop.utf8_downcvt_maybe = FALSE;
3323 if (p[1] == '-' && p[2] == '1')
3325 message_utf8_downconvert = -1;
3326 addr->prop.utf8_downcvt = FALSE;
3327 addr->prop.utf8_downcvt_maybe = TRUE;
3331 *log_msgptr = US"bad option value for control=utf8_downconvert";
3335 message_utf8_downconvert = 1;
3336 addr->prop.utf8_downcvt = TRUE;
3337 addr->prop.utf8_downcvt_maybe = FALSE;
3347 #ifdef EXPERIMENTAL_DCC
3350 /* Separate the regular expression and any optional parameters. */
3351 const uschar * list = arg;
3352 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
3353 /* Run the dcc backend. */
3354 rc = dcc_process(&ss);
3355 /* Modify return code based upon the existence of options. */
3356 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size)))
3357 if (strcmpic(ss, US"defer_ok") == 0 && rc == DEFER)
3358 rc = FAIL; /* FAIL so that the message is passed to the next ACL */
3363 #ifdef WITH_CONTENT_SCAN
3365 rc = mime_decode(&arg);
3371 int delay = readconf_readtime(arg, 0, FALSE);
3374 *log_msgptr = string_sprintf("syntax error in argument for \"delay\" "
3375 "modifier: \"%s\" is not a time value", arg);
3380 HDEBUG(D_acl) debug_printf_indent("delay modifier requests %d-second delay\n",
3385 debug_printf_indent("delay skipped in -bh checking mode\n");
3388 /* NOTE 1: Remember that we may be
3389 dealing with stdin/stdout here, in addition to TCP/IP connections.
3390 Also, delays may be specified for non-SMTP input, where smtp_out and
3391 smtp_in will be NULL. Whatever is done must work in all cases.
3393 NOTE 2: The added feature of flushing the output before a delay must
3394 apply only to SMTP input. Hence the test for smtp_out being non-NULL.
3399 if (smtp_out != NULL && !disable_delay_flush)
3402 #if !defined(NO_POLL_H) && defined (POLLRDHUP)
3408 p.fd = fileno(smtp_out);
3409 p.events = POLLRDHUP;
3412 if (poll(&p, n, delay*1000) > 0)
3413 HDEBUG(D_acl) debug_printf_indent("delay cancelled by peer close\n");
3416 /* It appears to be impossible to detect that a TCP/IP connection has
3417 gone away without reading from it. This means that we cannot shorten
3418 the delay below if the client goes away, because we cannot discover
3419 that the client has closed its end of the connection. (The connection
3420 is actually in a half-closed state, waiting for the server to close its
3421 end.) It would be nice to be able to detect this state, so that the
3422 Exim process is not held up unnecessarily. However, it seems that we
3423 can't. The poll() function does not do the right thing, and in any case
3424 it is not always available.
3427 while (delay > 0) delay = sleep(delay);
3434 #ifndef DISABLE_DKIM
3435 case ACLC_DKIM_SIGNER:
3436 if (dkim_cur_signer)
3437 rc = match_isinlist(dkim_cur_signer,
3438 &arg,0,NULL,NULL,MCL_STRING,TRUE,NULL);
3443 case ACLC_DKIM_STATUS:
3444 rc = match_isinlist(dkim_verify_status,
3445 &arg,0,NULL,NULL,MCL_STRING,TRUE,NULL);
3449 #ifdef EXPERIMENTAL_DMARC
3450 case ACLC_DMARC_STATUS:
3451 if (!dmarc_has_been_checked)
3453 dmarc_has_been_checked = TRUE;
3454 /* used long way of dmarc_exim_expand_query() in case we need more
3455 * view into the process in the future. */
3456 rc = match_isinlist(dmarc_exim_expand_query(DMARC_VERIFY_STATUS),
3457 &arg,0,NULL,NULL,MCL_STRING,TRUE,NULL);
3462 rc = verify_check_dnsbl(where, &arg, log_msgptr);
3466 rc = match_isinlist(addr->domain, &arg, 0, &domainlist_anchor,
3467 addr->domain_cache, MCL_DOMAIN, TRUE, CUSS &deliver_domain_data);
3470 /* The value in tls_cipher is the full cipher name, for example,
3471 TLSv1:DES-CBC3-SHA:168, whereas the values to test for are just the
3472 cipher names such as DES-CBC3-SHA. But program defensively. We don't know
3473 what may in practice come out of the SSL library - which at the time of
3474 writing is poorly documented. */
3476 case ACLC_ENCRYPTED:
3477 if (tls_in.cipher == NULL) rc = FAIL; else
3479 uschar *endcipher = NULL;
3480 uschar *cipher = Ustrchr(tls_in.cipher, ':');
3481 if (cipher == NULL) cipher = tls_in.cipher; else
3483 endcipher = Ustrchr(++cipher, ':');
3484 if (endcipher != NULL) *endcipher = 0;
3486 rc = match_isinlist(cipher, &arg, 0, NULL, NULL, MCL_STRING, TRUE, NULL);
3487 if (endcipher != NULL) *endcipher = ':';
3491 /* Use verify_check_this_host() instead of verify_check_host() so that
3492 we can pass over &host_data to catch any looked up data. Once it has been
3493 set, it retains its value so that it's still there if another ACL verb
3494 comes through here and uses the cache. However, we must put it into
3495 permanent store in case it is also expected to be used in a subsequent
3496 message in the same SMTP connection. */
3499 rc = verify_check_this_host(&arg, sender_host_cache, NULL,
3500 (sender_host_address == NULL)? US"" : sender_host_address,
3502 if (rc == DEFER) *log_msgptr = search_error_message;
3503 if (host_data) host_data = string_copy_malloc(host_data);
3506 case ACLC_LOCAL_PARTS:
3507 rc = match_isinlist(addr->cc_local_part, &arg, 0,
3508 &localpartlist_anchor, addr->localpart_cache, MCL_LOCALPART, TRUE,
3509 CUSS &deliver_localpart_data);
3512 case ACLC_LOG_REJECT_TARGET:
3516 const uschar *s = arg;
3518 while ((ss = string_nextinlist(&s, &sep, big_buffer, big_buffer_size)))
3520 if (Ustrcmp(ss, "main") == 0) logbits |= LOG_MAIN;
3521 else if (Ustrcmp(ss, "panic") == 0) logbits |= LOG_PANIC;
3522 else if (Ustrcmp(ss, "reject") == 0) logbits |= LOG_REJECT;
3525 logbits |= LOG_MAIN|LOG_REJECT;
3526 log_write(0, LOG_MAIN|LOG_PANIC, "unknown log name \"%s\" in "
3527 "\"log_reject_target\" in %s ACL", ss, acl_wherenames[where]);
3530 log_reject_target = logbits;
3537 const uschar *s = arg;
3543 if (Ustrncmp(s, "main", 4) == 0)
3544 { logbits |= LOG_MAIN; s += 4; }
3545 else if (Ustrncmp(s, "panic", 5) == 0)
3546 { logbits |= LOG_PANIC; s += 5; }
3547 else if (Ustrncmp(s, "reject", 6) == 0)
3548 { logbits |= LOG_REJECT; s += 6; }
3551 logbits = LOG_MAIN|LOG_PANIC;
3552 s = string_sprintf(":unknown log name in \"%s\" in "
3553 "\"logwrite\" in %s ACL", arg, acl_wherenames[where]);
3559 while (isspace(*s)) s++;
3562 if (logbits == 0) logbits = LOG_MAIN;
3563 log_write(0, logbits, "%s", string_printing(s));
3567 #ifdef WITH_CONTENT_SCAN
3568 case ACLC_MALWARE: /* Run the malware backend. */
3570 /* Separate the regular expression and any optional parameters. */
3571 const uschar * list = arg;
3572 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
3574 BOOL defer_ok = FALSE;
3577 while ((opt = string_nextinlist(&list, &sep, NULL, 0)))
3578 if (strcmpic(opt, US"defer_ok") == 0)
3580 else if ( strncmpic(opt, US"tmo=", 4) == 0
3581 && (timeout = readconf_readtime(opt+4, '\0', FALSE)) < 0
3584 *log_msgptr = string_sprintf("bad timeout value in '%s'", opt);
3588 rc = malware(ss, timeout);
3589 if (rc == DEFER && defer_ok)
3590 rc = FAIL; /* FAIL so that the message is passed to the next ACL */
3594 case ACLC_MIME_REGEX:
3595 rc = mime_regex(&arg);
3600 queue_name = string_copy_malloc(arg);
3603 case ACLC_RATELIMIT:
3604 rc = acl_ratelimit(arg, where, log_msgptr);
3607 case ACLC_RECIPIENTS:
3608 rc = match_address_list(CUS addr->address, TRUE, TRUE, &arg, NULL, -1, 0,
3609 CUSS &recipient_data);
3612 #ifdef WITH_CONTENT_SCAN
3618 case ACLC_REMOVE_HEADER:
3619 setup_remove_header(arg);
3622 case ACLC_SENDER_DOMAINS:
3625 sdomain = Ustrrchr(sender_address, '@');
3626 sdomain = sdomain ? sdomain + 1 : US"";
3627 rc = match_isinlist(sdomain, &arg, 0, &domainlist_anchor,
3628 sender_domain_cache, MCL_DOMAIN, TRUE, NULL);
3633 rc = match_address_list(CUS sender_address, TRUE, TRUE, &arg,
3634 sender_address_cache, -1, 0, CUSS &sender_data);
3637 /* Connection variables must persist forever */
3641 int old_pool = store_pool;
3642 if ( cb->u.varname[0] == 'c'
3643 #ifndef DISABLE_DKIM
3644 || cb->u.varname[0] == 'd'
3646 #ifndef DISABLE_EVENT
3647 || event_name /* An event is being delivered */
3650 store_pool = POOL_PERM;
3651 #ifndef DISABLE_DKIM /* Overwriteable dkim result variables */
3652 if (Ustrcmp(cb->u.varname, "dkim_verify_status") == 0)
3653 dkim_verify_status = string_copy(arg);
3654 else if (Ustrcmp(cb->u.varname, "dkim_verify_reason") == 0)
3655 dkim_verify_reason = string_copy(arg);
3658 acl_var_create(cb->u.varname)->data.ptr = string_copy(arg);
3659 store_pool = old_pool;
3663 #ifdef WITH_CONTENT_SCAN
3666 /* Separate the regular expression and any optional parameters. */
3667 const uschar * list = arg;
3668 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
3669 /* Run the spam backend. */
3670 rc = spam(CUSS &ss);
3671 /* Modify return code based upon the existence of options. */
3672 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size))
3674 if (strcmpic(ss, US"defer_ok") == 0 && rc == DEFER)
3676 /* FAIL so that the message is passed to the next ACL */
3684 #ifdef EXPERIMENTAL_SPF
3686 rc = spf_process(&arg, sender_address, SPF_PROCESS_NORMAL);
3688 case ACLC_SPF_GUESS:
3689 rc = spf_process(&arg, sender_address, SPF_PROCESS_GUESS);
3694 rc = acl_udpsend(arg, log_msgptr);
3697 /* If the verb is WARN, discard any user message from verification, because
3698 such messages are SMTP responses, not header additions. The latter come
3699 only from explicit "message" modifiers. However, put the user message into
3700 $acl_verify_message so it can be used in subsequent conditions or modifiers
3701 (until something changes it). */
3704 rc = acl_verify(where, addr, arg, user_msgptr, log_msgptr, basic_errno);
3706 acl_verify_message = *user_msgptr;
3707 if (verb == ACL_WARN) *user_msgptr = NULL;
3711 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "internal ACL error: unknown "
3712 "condition %d", cb->type);
3716 /* If a condition was negated, invert OK/FAIL. */
3718 if (!conditions[cb->type].is_modifier && cb->u.negated)
3719 if (rc == OK) rc = FAIL;
3720 else if (rc == FAIL || rc == FAIL_DROP) rc = OK;
3722 if (rc != OK) break; /* Conditions loop */
3726 /* If the result is the one for which "message" and/or "log_message" are used,
3727 handle the values of these modifiers. If there isn't a log message set, we make
3728 it the same as the user message.
3730 "message" is a user message that will be included in an SMTP response. Unless
3731 it is empty, it overrides any previously set user message.
3733 "log_message" is a non-user message, and it adds to any existing non-user
3734 message that is already set.
3736 Most verbs have but a single return for which the messages are relevant, but
3737 for "discard", it's useful to have the log message both when it succeeds and
3738 when it fails. For "accept", the message is used in the OK case if there is no
3739 "endpass", but (for backwards compatibility) in the FAIL case if "endpass" is
3742 if (*epp && rc == OK) user_message = NULL;
3744 if (((1<<rc) & msgcond[verb]) != 0)
3747 uschar *old_user_msgptr = *user_msgptr;
3748 uschar *old_log_msgptr = (*log_msgptr != NULL)? *log_msgptr : old_user_msgptr;
3750 /* If the verb is "warn", messages generated by conditions (verification or
3751 nested ACLs) are always discarded. This also happens for acceptance verbs
3752 when they actually do accept. Only messages specified at this level are used.
3753 However, the value of an existing message is available in $acl_verify_message
3754 during expansions. */
3756 if (verb == ACL_WARN ||
3757 (rc == OK && (verb == ACL_ACCEPT || verb == ACL_DISCARD)))
3758 *log_msgptr = *user_msgptr = NULL;
3760 if (user_message != NULL)
3762 acl_verify_message = old_user_msgptr;
3763 expmessage = expand_string(user_message);
3764 if (expmessage == NULL)
3766 if (!expand_string_forcedfail)
3767 log_write(0, LOG_MAIN|LOG_PANIC, "failed to expand ACL message \"%s\": %s",
3768 user_message, expand_string_message);
3770 else if (expmessage[0] != 0) *user_msgptr = expmessage;
3773 if (log_message != NULL)
3775 acl_verify_message = old_log_msgptr;
3776 expmessage = expand_string(log_message);
3777 if (expmessage == NULL)
3779 if (!expand_string_forcedfail)
3780 log_write(0, LOG_MAIN|LOG_PANIC, "failed to expand ACL message \"%s\": %s",
3781 log_message, expand_string_message);
3783 else if (expmessage[0] != 0)
3785 *log_msgptr = (*log_msgptr == NULL)? expmessage :
3786 string_sprintf("%s: %s", expmessage, *log_msgptr);
3790 /* If no log message, default it to the user message */
3792 if (*log_msgptr == NULL) *log_msgptr = *user_msgptr;
3795 acl_verify_message = NULL;
3803 /*************************************************
3804 * Get line from a literal ACL *
3805 *************************************************/
3807 /* This function is passed to acl_read() in order to extract individual lines
3808 of a literal ACL, which we access via static pointers. We can destroy the
3809 contents because this is called only once (the compiled ACL is remembered).
3811 This code is intended to treat the data in the same way as lines in the main
3812 Exim configuration file. That is:
3814 . Leading spaces are ignored.
3816 . A \ at the end of a line is a continuation - trailing spaces after the \
3817 are permitted (this is because I don't believe in making invisible things
3818 significant). Leading spaces on the continued part of a line are ignored.
3820 . Physical lines starting (significantly) with # are totally ignored, and
3821 may appear within a sequence of backslash-continued lines.
3823 . Blank lines are ignored, but will end a sequence of continuations.
3826 Returns: a pointer to the next line
3830 static uschar *acl_text; /* Current pointer in the text */
3831 static uschar *acl_text_end; /* Points one past the terminating '0' */
3839 /* This loop handles leading blank lines and comments. */
3843 while (isspace(*acl_text)) acl_text++; /* Leading spaces/empty lines */
3844 if (*acl_text == 0) return NULL; /* No more data */
3845 yield = acl_text; /* Potential data line */
3847 while (*acl_text != 0 && *acl_text != '\n') acl_text++;
3849 /* If we hit the end before a newline, we have the whole logical line. If
3850 it's a comment, there's no more data to be given. Otherwise, yield it. */
3852 if (*acl_text == 0) return (*yield == '#')? NULL : yield;
3854 /* After reaching a newline, end this loop if the physical line does not
3855 start with '#'. If it does, it's a comment, and the loop continues. */
3857 if (*yield != '#') break;
3860 /* This loop handles continuations. We know we have some real data, ending in
3861 newline. See if there is a continuation marker at the end (ignoring trailing
3862 white space). We know that *yield is not white space, so no need to test for
3863 cont > yield in the backwards scanning loop. */
3868 for (cont = acl_text - 1; isspace(*cont); cont--);
3870 /* If no continuation follows, we are done. Mark the end of the line and
3879 /* We have encountered a continuation. Skip over whitespace at the start of
3880 the next line, and indeed the whole of the next line or lines if they are
3885 while (*(++acl_text) == ' ' || *acl_text == '\t');
3886 if (*acl_text != '#') break;
3887 while (*(++acl_text) != 0 && *acl_text != '\n');
3890 /* We have the start of a continuation line. Move all the rest of the data
3891 to join onto the previous line, and then find its end. If the end is not a
3892 newline, we are done. Otherwise loop to look for another continuation. */
3894 memmove(cont, acl_text, acl_text_end - acl_text);
3895 acl_text_end -= acl_text - cont;
3897 while (*acl_text != 0 && *acl_text != '\n') acl_text++;
3898 if (*acl_text == 0) return yield;
3901 /* Control does not reach here */
3908 /*************************************************
3909 * Check access using an ACL *
3910 *************************************************/
3912 /* This function is called from address_check. It may recurse via
3913 acl_check_condition() - hence the use of a level to stop looping. The ACL is
3914 passed as a string which is expanded. A forced failure implies no access check
3915 is required. If the result is a single word, it is taken as the name of an ACL
3916 which is sought in the global ACL tree. Otherwise, it is taken as literal ACL
3917 text, complete with newlines, and parsed as such. In both cases, the ACL check
3918 is then run. This function uses an auxiliary function for acl_read() to call
3919 for reading individual lines of a literal ACL. This is acl_getline(), which
3920 appears immediately above.
3923 where where called from
3924 addr address item when called from RCPT; otherwise NULL
3925 s the input string; NULL is the same as an empty ACL => DENY
3926 user_msgptr where to put a user error (for SMTP response)
3927 log_msgptr where to put a logging message (not for SMTP response)
3929 Returns: OK access is granted
3930 DISCARD access is apparently granted...
3931 FAIL access is denied
3932 FAIL_DROP access is denied; drop the connection
3933 DEFER can't tell at the moment
3938 acl_check_internal(int where, address_item *addr, uschar *s,
3939 uschar **user_msgptr, uschar **log_msgptr)
3942 acl_block *acl = NULL;
3943 uschar *acl_name = US"inline ACL";
3946 /* Catch configuration loops */
3950 *log_msgptr = US"ACL nested too deep: possible loop";
3956 HDEBUG(D_acl) debug_printf_indent("ACL is NULL: implicit DENY\n");
3960 /* At top level, we expand the incoming string. At lower levels, it has already
3961 been expanded as part of condition processing. */
3965 if (!(ss = expand_string(s)))
3967 if (expand_string_forcedfail) return OK;
3968 *log_msgptr = string_sprintf("failed to expand ACL string \"%s\": %s", s,
3969 expand_string_message);
3975 while (isspace(*ss)) ss++;
3977 /* If we can't find a named ACL, the default is to parse it as an inline one.
3978 (Unless it begins with a slash; non-existent files give rise to an error.) */
3982 /* Handle the case of a string that does not contain any spaces. Look for a
3983 named ACL among those read from the configuration, or a previously read file.
3984 It is possible that the pointer to the ACL is NULL if the configuration
3985 contains a name with no data. If not found, and the text begins with '/',
3986 read an ACL from a file, and save it so it can be re-used. */
3988 if (Ustrchr(ss, ' ') == NULL)
3990 tree_node *t = tree_search(acl_anchor, ss);
3993 acl = (acl_block *)(t->data.ptr);
3996 HDEBUG(D_acl) debug_printf_indent("ACL \"%s\" is empty: implicit DENY\n", ss);
3999 acl_name = string_sprintf("ACL \"%s\"", ss);
4000 HDEBUG(D_acl) debug_printf_indent("using ACL \"%s\"\n", ss);
4003 else if (*ss == '/')
4005 struct stat statbuf;
4006 fd = Uopen(ss, O_RDONLY, 0);
4009 *log_msgptr = string_sprintf("failed to open ACL file \"%s\": %s", ss,
4014 if (fstat(fd, &statbuf) != 0)
4016 *log_msgptr = string_sprintf("failed to fstat ACL file \"%s\": %s", ss,
4021 acl_text = store_get(statbuf.st_size + 1);
4022 acl_text_end = acl_text + statbuf.st_size + 1;
4024 if (read(fd, acl_text, statbuf.st_size) != statbuf.st_size)
4026 *log_msgptr = string_sprintf("failed to read ACL file \"%s\": %s",
4027 ss, strerror(errno));
4030 acl_text[statbuf.st_size] = 0;
4033 acl_name = string_sprintf("ACL \"%s\"", ss);
4034 HDEBUG(D_acl) debug_printf_indent("read ACL from file %s\n", ss);
4038 /* Parse an ACL that is still in text form. If it came from a file, remember it
4039 in the ACL tree, having read it into the POOL_PERM store pool so that it
4040 persists between multiple messages. */
4044 int old_pool = store_pool;
4045 if (fd >= 0) store_pool = POOL_PERM;
4046 acl = acl_read(acl_getline, log_msgptr);
4047 store_pool = old_pool;
4048 if (acl == NULL && *log_msgptr != NULL) return ERROR;
4051 tree_node *t = store_get_perm(sizeof(tree_node) + Ustrlen(ss));
4052 Ustrcpy(t->name, ss);
4054 (void)tree_insertnode(&acl_anchor, t);
4058 /* Now we have an ACL to use. It's possible it may be NULL. */
4063 int basic_errno = 0;
4064 BOOL endpass_seen = FALSE;
4065 BOOL acl_quit_check = acl_level == 0
4066 && (where == ACL_WHERE_QUIT || where == ACL_WHERE_NOTQUIT);
4068 *log_msgptr = *user_msgptr = NULL;
4069 acl_temp_details = FALSE;
4071 HDEBUG(D_acl) debug_printf_indent("processing \"%s\"\n", verbs[acl->verb]);
4073 /* Clear out any search error message from a previous check before testing
4076 search_error_message = NULL;
4077 cond = acl_check_condition(acl->verb, acl->condition, where, addr, acl_level,
4078 &endpass_seen, user_msgptr, log_msgptr, &basic_errno);
4080 /* Handle special returns: DEFER causes a return except on a WARN verb;
4081 ERROR always causes a return. */
4086 HDEBUG(D_acl) debug_printf_indent("%s: condition test deferred in %s\n", verbs[acl->verb], acl_name);
4087 if (basic_errno != ERRNO_CALLOUTDEFER)
4089 if (search_error_message != NULL && *search_error_message != 0)
4090 *log_msgptr = search_error_message;
4091 if (smtp_return_error_details) acl_temp_details = TRUE;
4095 acl_temp_details = TRUE;
4097 if (acl->verb != ACL_WARN) return DEFER;
4100 default: /* Paranoia */
4102 HDEBUG(D_acl) debug_printf_indent("%s: condition test error in %s\n", verbs[acl->verb], acl_name);
4106 HDEBUG(D_acl) debug_printf_indent("%s: condition test succeeded in %s\n",
4107 verbs[acl->verb], acl_name);
4111 HDEBUG(D_acl) debug_printf_indent("%s: condition test failed in %s\n", verbs[acl->verb], acl_name);
4114 /* DISCARD and DROP can happen only from a nested ACL condition, and
4115 DISCARD can happen only for an "accept" or "discard" verb. */
4118 HDEBUG(D_acl) debug_printf_indent("%s: condition test yielded \"discard\" in %s\n",
4119 verbs[acl->verb], acl_name);
4123 HDEBUG(D_acl) debug_printf_indent("%s: condition test yielded \"drop\" in %s\n",
4124 verbs[acl->verb], acl_name);
4128 /* At this point, cond for most verbs is either OK or FAIL or (as a result of
4129 a nested ACL condition) FAIL_DROP. However, for WARN, cond may be DEFER, and
4130 for ACCEPT and DISCARD, it may be DISCARD after a nested ACL call. */
4135 if (cond == OK || cond == DISCARD)
4137 HDEBUG(D_acl) debug_printf_indent("end of %s: ACCEPT\n", acl_name);
4142 HDEBUG(D_acl) debug_printf_indent("accept: endpass encountered - denying access\n");
4150 HDEBUG(D_acl) debug_printf_indent("end of %s: DEFER\n", acl_name);
4151 if (acl_quit_check) goto badquit;
4152 acl_temp_details = TRUE;
4160 HDEBUG(D_acl) debug_printf_indent("end of %s: DENY\n", acl_name);
4161 if (acl_quit_check) goto badquit;
4167 if (cond == OK || cond == DISCARD)
4169 HDEBUG(D_acl) debug_printf_indent("end of %s: DISCARD\n", acl_name);
4170 if (acl_quit_check) goto badquit;
4175 HDEBUG(D_acl) debug_printf_indent("discard: endpass encountered - denying access\n");
4183 HDEBUG(D_acl) debug_printf_indent("end of %s: DROP\n", acl_name);
4184 if (acl_quit_check) goto badquit;
4192 HDEBUG(D_acl) debug_printf_indent("end of %s: not OK\n", acl_name);
4193 if (acl_quit_check) goto badquit;
4200 acl_warn(where, *user_msgptr, *log_msgptr);
4201 else if (cond == DEFER && LOGGING(acl_warn_skipped))
4202 log_write(0, LOG_MAIN, "%s Warning: ACL \"warn\" statement skipped: "
4203 "condition test deferred%s%s", host_and_ident(TRUE),
4204 (*log_msgptr == NULL)? US"" : US": ",
4205 (*log_msgptr == NULL)? US"" : *log_msgptr);
4206 *log_msgptr = *user_msgptr = NULL; /* In case implicit DENY follows */
4210 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "internal ACL error: unknown verb %d",
4215 /* Pass to the next ACL item */
4220 /* We have reached the end of the ACL. This is an implicit DENY. */
4222 HDEBUG(D_acl) debug_printf_indent("end of %s: implicit DENY\n", acl_name);
4226 *log_msgptr = string_sprintf("QUIT or not-QUIT toplevel ACL may not fail "
4227 "('%s' verb used incorrectly)", verbs[acl->verb]);
4234 /* Same args as acl_check_internal() above, but the string s is
4235 the name of an ACL followed optionally by up to 9 space-separated arguments.
4236 The name and args are separately expanded. Args go into $acl_arg globals. */
4238 acl_check_wargs(int where, address_item *addr, const uschar *s,
4239 uschar **user_msgptr, uschar **log_msgptr)
4242 uschar * tmp_arg[9]; /* must match acl_arg[] */
4243 uschar * sav_arg[9]; /* must match acl_arg[] */
4249 if (!(tmp = string_dequote(&s)) || !(name = expand_string(tmp)))
4252 for (i = 0; i < 9; i++)
4254 while (*s && isspace(*s)) s++;
4256 if (!(tmp = string_dequote(&s)) || !(tmp_arg[i] = expand_string(tmp)))
4263 sav_narg = acl_narg;
4265 for (i = 0; i < acl_narg; i++)
4267 sav_arg[i] = acl_arg[i];
4268 acl_arg[i] = tmp_arg[i];
4272 sav_arg[i] = acl_arg[i];
4273 acl_arg[i++] = NULL;
4277 ret = acl_check_internal(where, addr, name, user_msgptr, log_msgptr);
4280 acl_narg = sav_narg;
4281 for (i = 0; i < 9; i++) acl_arg[i] = sav_arg[i];
4285 if (expand_string_forcedfail) return ERROR;
4286 *log_msgptr = string_sprintf("failed to expand ACL string \"%s\": %s",
4287 tmp, expand_string_message);
4288 return search_find_defer?DEFER:ERROR;
4293 /*************************************************
4294 * Check access using an ACL *
4295 *************************************************/
4297 /* Alternate interface for ACL, used by expansions */
4299 acl_eval(int where, uschar *s, uschar **user_msgptr, uschar **log_msgptr)
4302 address_item *addr = NULL;
4305 *user_msgptr = *log_msgptr = NULL;
4306 sender_verified_failed = NULL;
4307 ratelimiters_cmd = NULL;
4308 log_reject_target = LOG_MAIN|LOG_REJECT;
4310 if (where == ACL_WHERE_RCPT)
4312 adb = address_defaults;
4314 addr->address = expand_string(US"$local_part@$domain");
4315 addr->domain = deliver_domain;
4316 addr->local_part = deliver_localpart;
4317 addr->cc_local_part = deliver_localpart;
4318 addr->lc_local_part = deliver_localpart;
4322 rc = acl_check_internal(where, addr, s, user_msgptr, log_msgptr);
4329 /* This is the external interface for ACL checks. It sets up an address and the
4330 expansions for $domain and $local_part when called after RCPT, then calls
4331 acl_check_internal() to do the actual work.
4334 where ACL_WHERE_xxxx indicating where called from
4335 recipient RCPT address for RCPT check, else NULL
4336 s the input string; NULL is the same as an empty ACL => DENY
4337 user_msgptr where to put a user error (for SMTP response)
4338 log_msgptr where to put a logging message (not for SMTP response)
4340 Returns: OK access is granted by an ACCEPT verb
4341 DISCARD access is granted by a DISCARD verb
4342 FAIL access is denied
4343 FAIL_DROP access is denied; drop the connection
4344 DEFER can't tell at the moment
4347 int acl_where = ACL_WHERE_UNKNOWN;
4350 acl_check(int where, uschar *recipient, uschar *s, uschar **user_msgptr,
4351 uschar **log_msgptr)
4355 address_item *addr = NULL;
4357 *user_msgptr = *log_msgptr = NULL;
4358 sender_verified_failed = NULL;
4359 ratelimiters_cmd = NULL;
4360 log_reject_target = LOG_MAIN|LOG_REJECT;
4362 #ifndef DISABLE_PRDR
4363 if (where==ACL_WHERE_RCPT || where==ACL_WHERE_VRFY || where==ACL_WHERE_PRDR)
4365 if (where==ACL_WHERE_RCPT || where==ACL_WHERE_VRFY)
4368 adb = address_defaults;
4370 addr->address = recipient;
4371 if (deliver_split_address(addr) == DEFER)
4373 *log_msgptr = US"defer in percent_hack_domains check";
4377 if ((addr->prop.utf8_msg = message_smtputf8))
4379 addr->prop.utf8_downcvt = message_utf8_downconvert == 1;
4380 addr->prop.utf8_downcvt_maybe = message_utf8_downconvert == -1;
4383 deliver_domain = addr->domain;
4384 deliver_localpart = addr->local_part;
4389 rc = acl_check_internal(where, addr, s, user_msgptr, log_msgptr);
4391 acl_where = ACL_WHERE_UNKNOWN;
4393 /* Cutthrough - if requested,
4394 and WHERE_RCPT and not yet opened conn as result of recipient-verify,
4395 and rcpt acl returned accept,
4396 and first recipient (cancel on any subsequents)
4397 open one now and run it up to RCPT acceptance.
4398 A failed verify should cancel cutthrough request,
4399 and will pass the fail to the originator.
4400 Initial implementation: dual-write to spool.
4401 Assume the rxd datastream is now being copied byte-for-byte to an open cutthrough connection.
4403 Cease cutthrough copy on rxd final dot; do not send one.
4405 On a data acl, if not accept and a cutthrough conn is open, hard-close it (no SMTP niceness).
4407 On data acl accept, terminate the dataphase on an open cutthrough conn. If accepted or
4408 perm-rejected, reflect that to the original sender - and dump the spooled copy.
4409 If temp-reject, close the conn (and keep the spooled copy).
4410 If conn-failure, no action (and keep the spooled copy).
4414 case ACL_WHERE_RCPT:
4415 #ifndef DISABLE_PRDR
4416 case ACL_WHERE_PRDR:
4419 if (host_checking_callout) /* -bhc mode */
4420 cancel_cutthrough_connection(TRUE, US"host-checking mode");
4423 && cutthrough.delivery
4424 && rcpt_count > cutthrough.nrcpt
4425 && (rc = open_cutthrough_connection(addr)) == DEFER
4427 if (cutthrough.defer_pass)
4429 uschar * s = addr->message;
4430 /* Horrid kludge to recover target's SMTP message */
4432 do --s; while (!isdigit(*s));
4433 if (*--s && isdigit(*s) && *--s && isdigit(*s)) *user_msgptr = s;
4434 acl_temp_details = TRUE;
4438 HDEBUG(D_acl) debug_printf_indent("cutthrough defer; will spool\n");
4443 case ACL_WHERE_PREDATA:
4445 cutthrough_predata();
4447 cancel_cutthrough_connection(TRUE, US"predata acl not ok");
4450 case ACL_WHERE_QUIT:
4451 case ACL_WHERE_NOTQUIT:
4452 /* Drop cutthrough conns, and drop heldopen verify conns if
4453 the previous was not DATA */
4455 uschar prev = smtp_connection_had[smtp_ch_index-2];
4456 BOOL dropverify = !(prev == SCH_DATA || prev == SCH_BDAT);
4458 cancel_cutthrough_connection(dropverify, US"quit or conndrop");
4466 deliver_domain = deliver_localpart = deliver_address_data =
4467 sender_address_data = NULL;
4469 /* A DISCARD response is permitted only for message ACLs, excluding the PREDATA
4470 ACL, which is really in the middle of an SMTP command. */
4474 if (where > ACL_WHERE_NOTSMTP || where == ACL_WHERE_PREDATA)
4476 log_write(0, LOG_MAIN|LOG_PANIC, "\"discard\" verb not allowed in %s "
4477 "ACL", acl_wherenames[where]);
4483 /* A DROP response is not permitted from MAILAUTH */
4485 if (rc == FAIL_DROP && where == ACL_WHERE_MAILAUTH)
4487 log_write(0, LOG_MAIN|LOG_PANIC, "\"drop\" verb not allowed in %s "
4488 "ACL", acl_wherenames[where]);
4492 /* Before giving a response, take a look at the length of any user message, and
4493 split it up into multiple lines if possible. */
4495 *user_msgptr = string_split_message(*user_msgptr);
4496 if (fake_response != OK)
4497 fake_response_text = string_split_message(fake_response_text);
4503 /*************************************************
4504 * Create ACL variable *
4505 *************************************************/
4507 /* Create an ACL variable or reuse an existing one. ACL variables are in a
4508 binary tree (see tree.c) with acl_var_c and acl_var_m as root nodes.
4511 name pointer to the variable's name, starting with c or m
4513 Returns the pointer to variable's tree node
4517 acl_var_create(uschar * name)
4519 tree_node * node, ** root = name[0] == 'c' ? &acl_var_c : &acl_var_m;
4520 if (!(node = tree_search(*root, name)))
4522 node = store_get(sizeof(tree_node) + Ustrlen(name));
4523 Ustrcpy(node->name, name);
4524 (void)tree_insertnode(root, node);
4526 node->data.ptr = NULL;
4532 /*************************************************
4533 * Write an ACL variable in spool format *
4534 *************************************************/
4536 /* This function is used as a callback for tree_walk when writing variables to
4537 the spool file. To retain spool file compatibility, what is written is -aclc or
4538 -aclm followed by the rest of the name and the data length, space separated,
4539 then the value itself, starting on a new line, and terminated by an additional
4540 newline. When we had only numbered ACL variables, the first line might look
4541 like this: "-aclc 5 20". Now it might be "-aclc foo 20" for the variable called
4545 name of the variable
4546 value of the variable
4547 ctx FILE pointer (as a void pointer)
4553 acl_var_write(uschar *name, uschar *value, void *ctx)
4555 FILE *f = (FILE *)ctx;
4556 fprintf(f, "-acl%c %s %d\n%s\n", name[0], name+1, Ustrlen(value), value);