1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2018 */
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] = BIT(OK) | BIT(FAIL) | BIT(FAIL_DROP),
41 [ACL_DEFER] = BIT(OK),
43 [ACL_DISCARD] = BIT(OK) | BIT(FAIL) | BIT(FAIL_DROP),
45 [ACL_REQUIRE] = BIT(FAIL) | BIT(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
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 ~(ACL_BIT_MAIL | ACL_BIT_RCPT |
141 ACL_BIT_PREDATA | ACL_BIT_DATA |
145 ACL_BIT_MIME | ACL_BIT_NOTSMTP |
147 ACL_BIT_NOTSMTP_START),
150 [ACLC_AUTHENTICATED] = { US"authenticated", FALSE, FALSE,
151 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START |
152 ACL_BIT_CONNECT | ACL_BIT_HELO,
154 #ifdef EXPERIMENTAL_BRIGHTMAIL
155 [ACLC_BMI_OPTIN] = { US"bmi_optin", TRUE, TRUE,
157 ACL_BIT_CONNECT | ACL_BIT_HELO |
158 ACL_BIT_DATA | ACL_BIT_MIME |
159 # ifndef DISABLE_PRDR
162 ACL_BIT_ETRN | ACL_BIT_EXPN |
164 ACL_BIT_MAIL | ACL_BIT_STARTTLS |
165 ACL_BIT_VRFY | ACL_BIT_PREDATA |
166 ACL_BIT_NOTSMTP_START,
169 [ACLC_CONDITION] = { US"condition", TRUE, FALSE, 0 },
170 [ACLC_CONTINUE] = { US"continue", TRUE, TRUE, 0 },
172 /* Certain types of control are always allowed, so we let it through
173 always and check in the control processing itself. */
174 [ACLC_CONTROL] = { US"control", TRUE, TRUE, 0 },
176 #ifdef EXPERIMENTAL_DCC
177 [ACLC_DCC] = { US"dcc", TRUE, FALSE,
180 # ifndef DISABLE_PRDR
186 #ifdef WITH_CONTENT_SCAN
187 [ACLC_DECODE] = { US"decode", TRUE, FALSE, (unsigned int) ~ACL_BIT_MIME },
190 [ACLC_DELAY] = { US"delay", TRUE, TRUE, ACL_BIT_NOTQUIT },
192 [ACLC_DKIM_SIGNER] = { US"dkim_signers", TRUE, FALSE, (unsigned int) ~ACL_BIT_DKIM },
193 [ACLC_DKIM_STATUS] = { US"dkim_status", TRUE, FALSE, (unsigned int) ~ACL_BIT_DKIM },
195 #ifdef EXPERIMENTAL_DMARC
196 [ACLC_DMARC_STATUS] = { US"dmarc_status", TRUE, FALSE, (unsigned int) ~ACL_BIT_DATA },
199 /* Explicit key lookups can be made in non-smtp ACLs so pass
200 always and check in the verify processing itself. */
201 [ACLC_DNSLISTS] = { US"dnslists", TRUE, FALSE, 0 },
203 [ACLC_DOMAINS] = { US"domains", FALSE, FALSE,
205 ~(ACL_BIT_RCPT | ACL_BIT_VRFY
211 [ACLC_ENCRYPTED] = { US"encrypted", FALSE, FALSE,
212 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START |
216 [ACLC_ENDPASS] = { US"endpass", TRUE, TRUE, 0 },
218 [ACLC_HOSTS] = { US"hosts", FALSE, FALSE,
219 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START,
221 [ACLC_LOCAL_PARTS] = { US"local_parts", FALSE, FALSE,
223 ~(ACL_BIT_RCPT | ACL_BIT_VRFY
230 [ACLC_LOG_MESSAGE] = { US"log_message", TRUE, TRUE, 0 },
231 [ACLC_LOG_REJECT_TARGET] = { US"log_reject_target", TRUE, TRUE, 0 },
232 [ACLC_LOGWRITE] = { US"logwrite", TRUE, TRUE, 0 },
234 #ifdef WITH_CONTENT_SCAN
235 [ACLC_MALWARE] = { US"malware", TRUE, FALSE,
238 # ifndef DISABLE_PRDR
245 [ACLC_MESSAGE] = { US"message", TRUE, TRUE, 0 },
246 #ifdef WITH_CONTENT_SCAN
247 [ACLC_MIME_REGEX] = { US"mime_regex", TRUE, FALSE, (unsigned int) ~ACL_BIT_MIME },
250 [ACLC_QUEUE] = { US"queue", TRUE, TRUE,
258 [ACLC_RATELIMIT] = { US"ratelimit", TRUE, FALSE, 0 },
259 [ACLC_RECIPIENTS] = { US"recipients", FALSE, FALSE, (unsigned int) ~ACL_BIT_RCPT },
261 #ifdef WITH_CONTENT_SCAN
262 [ACLC_REGEX] = { US"regex", TRUE, FALSE,
265 # ifndef DISABLE_PRDR
273 [ACLC_REMOVE_HEADER] = { US"remove_header", TRUE, TRUE,
275 ~(ACL_BIT_MAIL|ACL_BIT_RCPT |
276 ACL_BIT_PREDATA | ACL_BIT_DATA |
280 ACL_BIT_MIME | ACL_BIT_NOTSMTP |
281 ACL_BIT_NOTSMTP_START),
283 [ACLC_SENDER_DOMAINS] = { US"sender_domains", FALSE, FALSE,
284 ACL_BIT_AUTH | ACL_BIT_CONNECT |
286 ACL_BIT_MAILAUTH | ACL_BIT_QUIT |
287 ACL_BIT_ETRN | ACL_BIT_EXPN |
288 ACL_BIT_STARTTLS | ACL_BIT_VRFY,
290 [ACLC_SENDERS] = { US"senders", FALSE, FALSE,
291 ACL_BIT_AUTH | ACL_BIT_CONNECT |
293 ACL_BIT_MAILAUTH | ACL_BIT_QUIT |
294 ACL_BIT_ETRN | ACL_BIT_EXPN |
295 ACL_BIT_STARTTLS | ACL_BIT_VRFY,
298 [ACLC_SET] = { US"set", TRUE, TRUE, 0 },
300 #ifdef WITH_CONTENT_SCAN
301 [ACLC_SPAM] = { US"spam", TRUE, FALSE,
302 (unsigned int) ~(ACL_BIT_DATA |
303 # ifndef DISABLE_PRDR
310 [ACLC_SPF] = { US"spf", TRUE, FALSE,
311 ACL_BIT_AUTH | ACL_BIT_CONNECT |
312 ACL_BIT_HELO | ACL_BIT_MAILAUTH |
313 ACL_BIT_ETRN | ACL_BIT_EXPN |
314 ACL_BIT_STARTTLS | ACL_BIT_VRFY |
315 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START,
317 [ACLC_SPF_GUESS] = { US"spf_guess", TRUE, FALSE,
318 ACL_BIT_AUTH | ACL_BIT_CONNECT |
319 ACL_BIT_HELO | ACL_BIT_MAILAUTH |
320 ACL_BIT_ETRN | ACL_BIT_EXPN |
321 ACL_BIT_STARTTLS | ACL_BIT_VRFY |
322 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START,
325 [ACLC_UDPSEND] = { US"udpsend", TRUE, TRUE, 0 },
327 /* Certain types of verify are always allowed, so we let it through
328 always and check in the verify function itself */
329 [ACLC_VERIFY] = { US"verify", TRUE, FALSE, 0 },
334 /* Return values from decode_control(); used as index so keep in step
335 with the controls_list table that follows! */
338 CONTROL_AUTH_UNADVERTISED,
339 #ifdef EXPERIMENTAL_BRIGHTMAIL
342 CONTROL_CASEFUL_LOCAL_PART,
343 CONTROL_CASELOWER_LOCAL_PART,
344 CONTROL_CUTTHROUGH_DELIVERY,
349 #ifdef EXPERIMENTAL_DMARC
350 CONTROL_DMARC_VERIFY,
351 CONTROL_DMARC_FORENSIC,
354 CONTROL_ENFORCE_SYNC,
355 CONTROL_ERROR, /* pseudo-value for decode errors */
360 CONTROL_NO_CALLOUT_FLUSH,
361 CONTROL_NO_DELAY_FLUSH,
362 CONTROL_NO_ENFORCE_SYNC,
363 #ifdef WITH_CONTENT_SCAN
364 CONTROL_NO_MBOX_UNSPOOL,
366 CONTROL_NO_MULTILINE,
367 CONTROL_NO_PIPELINING,
370 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_REQUIRETLS)
374 CONTROL_SUPPRESS_LOCAL_FIXUPS,
376 CONTROL_UTF8_DOWNCONVERT,
382 /* Structure listing various control arguments, with their characteristics.
383 For each control, there's a bitmap of dis-allowed times. For some, it is easier
384 to specify the negation of a small number of allowed times. */
386 typedef struct control_def {
388 BOOL has_option; /* Has /option(s) following */
389 unsigned forbids; /* bitmap of dis-allowed times */
392 static control_def controls_list[] = {
393 /* name has_option forbids */
394 [CONTROL_AUTH_UNADVERTISED] =
395 { US"allow_auth_unadvertised", FALSE,
397 ~(ACL_BIT_CONNECT | ACL_BIT_HELO)
399 #ifdef EXPERIMENTAL_BRIGHTMAIL
401 { US"bmi_run", FALSE, 0 },
403 [CONTROL_CASEFUL_LOCAL_PART] =
404 { US"caseful_local_part", FALSE, (unsigned) ~ACL_BIT_RCPT },
405 [CONTROL_CASELOWER_LOCAL_PART] =
406 { US"caselower_local_part", FALSE, (unsigned) ~ACL_BIT_RCPT },
407 [CONTROL_CUTTHROUGH_DELIVERY] =
408 { US"cutthrough_delivery", TRUE, 0 },
410 { US"debug", TRUE, 0 },
413 [CONTROL_DKIM_VERIFY] =
414 { US"dkim_disable_verify", FALSE,
415 ACL_BIT_DATA | ACL_BIT_NOTSMTP |
416 # ifndef DISABLE_PRDR
419 ACL_BIT_NOTSMTP_START
423 #ifdef EXPERIMENTAL_DMARC
424 [CONTROL_DMARC_VERIFY] =
425 { US"dmarc_disable_verify", FALSE,
426 ACL_BIT_DATA | ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
428 [CONTROL_DMARC_FORENSIC] =
429 { US"dmarc_enable_forensic", FALSE,
430 ACL_BIT_DATA | ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
436 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START | ACL_BIT_NOTQUIT
438 [CONTROL_ENFORCE_SYNC] =
439 { US"enforce_sync", FALSE,
440 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
443 /* Pseudo-value for decode errors */
445 { US"error", FALSE, 0 },
447 [CONTROL_FAKEDEFER] =
448 { US"fakedefer", TRUE,
450 ~(ACL_BIT_MAIL | ACL_BIT_RCPT |
451 ACL_BIT_PREDATA | ACL_BIT_DATA |
457 [CONTROL_FAKEREJECT] =
458 { US"fakereject", TRUE,
460 ~(ACL_BIT_MAIL | ACL_BIT_RCPT |
461 ACL_BIT_PREDATA | ACL_BIT_DATA |
470 ~(ACL_BIT_MAIL | ACL_BIT_RCPT |
471 ACL_BIT_PREDATA | ACL_BIT_DATA |
472 // ACL_BIT_PRDR| /* Not allow one user to freeze for all */
473 ACL_BIT_NOTSMTP | ACL_BIT_MIME)
476 [CONTROL_NO_CALLOUT_FLUSH] =
477 { US"no_callout_flush", FALSE,
478 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
480 [CONTROL_NO_DELAY_FLUSH] =
481 { US"no_delay_flush", FALSE,
482 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
485 [CONTROL_NO_ENFORCE_SYNC] =
486 { US"no_enforce_sync", FALSE,
487 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
489 #ifdef WITH_CONTENT_SCAN
490 [CONTROL_NO_MBOX_UNSPOOL] =
491 { US"no_mbox_unspool", FALSE,
493 ~(ACL_BIT_MAIL | ACL_BIT_RCPT |
494 ACL_BIT_PREDATA | ACL_BIT_DATA |
495 // ACL_BIT_PRDR| /* Not allow one user to freeze for all */
499 [CONTROL_NO_MULTILINE] =
500 { US"no_multiline_responses", FALSE,
501 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
503 [CONTROL_NO_PIPELINING] =
504 { US"no_pipelining", FALSE,
505 ACL_BIT_NOTSMTP | ACL_BIT_NOTSMTP_START
508 [CONTROL_QUEUE_ONLY] =
509 { US"queue_only", FALSE,
511 ~(ACL_BIT_MAIL | ACL_BIT_RCPT |
512 ACL_BIT_PREDATA | ACL_BIT_DATA |
513 // ACL_BIT_PRDR| /* Not allow one user to freeze for all */
514 ACL_BIT_NOTSMTP | ACL_BIT_MIME)
518 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_REQUIRETLS)
519 [CONTROL_REQUIRETLS] =
520 { US"requiretls", FALSE,
522 ~(ACL_BIT_MAIL | ACL_BIT_RCPT | ACL_BIT_PREDATA |
523 ACL_BIT_DATA | ACL_BIT_MIME |
528 [CONTROL_SUBMISSION] =
529 { US"submission", TRUE,
531 ~(ACL_BIT_MAIL | ACL_BIT_RCPT | ACL_BIT_PREDATA)
533 [CONTROL_SUPPRESS_LOCAL_FIXUPS] =
534 { US"suppress_local_fixups", FALSE,
536 ~(ACL_BIT_MAIL | ACL_BIT_RCPT | ACL_BIT_PREDATA |
537 ACL_BIT_NOTSMTP_START)
540 [CONTROL_UTF8_DOWNCONVERT] =
541 { US"utf8_downconvert", TRUE, (unsigned) ~(ACL_BIT_RCPT | ACL_BIT_VRFY)
546 /* Support data structures for Client SMTP Authorization. acl_verify_csa()
547 caches its result in a tree to avoid repeated DNS queries. The result is an
548 integer code which is used as an index into the following tables of
549 explanatory strings and verification return codes. */
551 static tree_node *csa_cache = NULL;
553 enum { CSA_UNKNOWN, CSA_OK, CSA_DEFER_SRV, CSA_DEFER_ADDR,
554 CSA_FAIL_EXPLICIT, CSA_FAIL_DOMAIN, CSA_FAIL_NOADDR, CSA_FAIL_MISMATCH };
556 /* The acl_verify_csa() return code is translated into an acl_verify() return
557 code using the following table. It is OK unless the client is definitely not
558 authorized. This is because CSA is supposed to be optional for sending sites,
559 so recipients should not be too strict about checking it - especially because
560 DNS problems are quite likely to occur. It's possible to use $csa_status in
561 further ACL conditions to distinguish ok, unknown, and defer if required, but
562 the aim is to make the usual configuration simple. */
564 static int csa_return_code[] = {
567 [CSA_DEFER_SRV] = OK,
568 [CSA_DEFER_ADDR] = OK,
569 [CSA_FAIL_EXPLICIT] = FAIL,
570 [CSA_FAIL_DOMAIN] = FAIL,
571 [CSA_FAIL_NOADDR] = FAIL,
572 [CSA_FAIL_MISMATCH] = FAIL
575 static uschar *csa_status_string[] = {
576 [CSA_UNKNOWN] = US"unknown",
578 [CSA_DEFER_SRV] = US"defer",
579 [CSA_DEFER_ADDR] = US"defer",
580 [CSA_FAIL_EXPLICIT] = US"fail",
581 [CSA_FAIL_DOMAIN] = US"fail",
582 [CSA_FAIL_NOADDR] = US"fail",
583 [CSA_FAIL_MISMATCH] = US"fail"
586 static uschar *csa_reason_string[] = {
587 [CSA_UNKNOWN] = US"unknown",
589 [CSA_DEFER_SRV] = US"deferred (SRV lookup failed)",
590 [CSA_DEFER_ADDR] = US"deferred (target address lookup failed)",
591 [CSA_FAIL_EXPLICIT] = US"failed (explicit authorization required)",
592 [CSA_FAIL_DOMAIN] = US"failed (host name not authorized)",
593 [CSA_FAIL_NOADDR] = US"failed (no authorized addresses)",
594 [CSA_FAIL_MISMATCH] = US"failed (client address mismatch)"
597 /* Options for the ratelimit condition. Note that there are two variants of
598 the per_rcpt option, depending on the ACL that is used to measure the rate.
599 However any ACL must be able to look up per_rcpt rates in /noupdate mode,
600 so the two variants must have the same internal representation as well as
601 the same configuration string. */
604 RATE_PER_WHAT, RATE_PER_CLASH, RATE_PER_ADDR, RATE_PER_BYTE, RATE_PER_CMD,
605 RATE_PER_CONN, RATE_PER_MAIL, RATE_PER_RCPT, RATE_PER_ALLRCPTS
608 #define RATE_SET(var,new) \
609 (((var) == RATE_PER_WHAT) ? ((var) = RATE_##new) : ((var) = RATE_PER_CLASH))
611 static uschar *ratelimit_option_string[] = {
612 [RATE_PER_WHAT] = US"?",
613 [RATE_PER_CLASH] = US"!",
614 [RATE_PER_ADDR] = US"per_addr",
615 [RATE_PER_BYTE] = US"per_byte",
616 [RATE_PER_CMD] = US"per_cmd",
617 [RATE_PER_CONN] = US"per_conn",
618 [RATE_PER_MAIL] = US"per_mail",
619 [RATE_PER_RCPT] = US"per_rcpt",
620 [RATE_PER_ALLRCPTS] = US"per_rcpt"
623 /* Enable recursion between acl_check_internal() and acl_check_condition() */
625 static int acl_check_wargs(int, address_item *, const uschar *, uschar **,
629 /*************************************************
630 * Find control in list *
631 *************************************************/
633 /* The lists are always in order, so binary chop can be used.
636 name the control name to search for
637 ol the first entry in the control list
638 last one more than the offset of the last entry in the control list
640 Returns: index of a control entry, or -1 if not found
644 find_control(const uschar * name, control_def * ol, int last)
646 for (int first = 0; last > first; )
648 int middle = (first + last)/2;
649 uschar * s = ol[middle].name;
650 int c = Ustrncmp(name, s, Ustrlen(s));
651 if (c == 0) return middle;
652 else if (c > 0) first = middle + 1;
660 /*************************************************
661 * Pick out condition from list *
662 *************************************************/
664 /* Use a binary chop method
668 list list of conditions
671 Returns: offset in list, or -1 if not found
675 acl_checkcondition(uschar * name, condition_def * list, int end)
677 for (int start = 0; start < end; )
679 int mid = (start + end)/2;
680 int c = Ustrcmp(name, list[mid].name);
681 if (c == 0) return mid;
682 if (c < 0) end = mid;
683 else start = mid + 1;
689 /*************************************************
690 * Pick out name from list *
691 *************************************************/
693 /* Use a binary chop method
700 Returns: offset in list, or -1 if not found
704 acl_checkname(uschar *name, uschar **list, int end)
706 for (int start = 0; start < end; )
708 int mid = (start + end)/2;
709 int c = Ustrcmp(name, list[mid]);
710 if (c == 0) return mid;
711 if (c < 0) end = mid; else start = mid + 1;
718 /*************************************************
719 * Read and parse one ACL *
720 *************************************************/
722 /* This function is called both from readconf in order to parse the ACLs in the
723 configuration file, and also when an ACL is encountered dynamically (e.g. as
724 the result of an expansion). It is given a function to call in order to
725 retrieve the lines of the ACL. This function handles skipping comments and
726 blank lines (where relevant).
729 func function to get next line of ACL
730 error where to put an error message
732 Returns: pointer to ACL, or NULL
733 NULL can be legal (empty ACL); in this case error will be NULL
737 acl_read(uschar *(*func)(void), uschar **error)
739 acl_block *yield = NULL;
740 acl_block **lastp = &yield;
741 acl_block *this = NULL;
742 acl_condition_block *cond;
743 acl_condition_block **condp = NULL;
748 while ((s = (*func)()) != NULL)
751 BOOL negated = FALSE;
752 uschar *saveline = s;
755 /* Conditions (but not verbs) are allowed to be negated by an initial
758 while (isspace(*s)) s++;
765 /* Read the name of a verb or a condition, or the start of a new ACL, which
766 can be started by a name, or by a macro definition. */
768 s = readconf_readname(name, sizeof(name), s);
769 if (*s == ':' || (isupper(name[0]) && *s == '=')) return yield;
771 /* If a verb is unrecognized, it may be another condition or modifier that
772 continues the previous verb. */
774 if ((v = acl_checkname(name, verbs, nelem(verbs))) < 0)
778 *error = string_sprintf("unknown ACL verb \"%s\" in \"%s\"", name,
790 *error = string_sprintf("malformed ACL line \"%s\"", saveline);
793 this = store_get(sizeof(acl_block));
795 lastp = &(this->next);
798 this->condition = NULL;
799 condp = &(this->condition);
800 if (*s == 0) continue; /* No condition on this line */
806 s = readconf_readname(name, sizeof(name), s); /* Condition name */
809 /* Handle a condition or modifier. */
811 if ((c = acl_checkcondition(name, conditions, nelem(conditions))) < 0)
813 *error = string_sprintf("unknown ACL condition/modifier in \"%s\"",
818 /* The modifiers may not be negated */
820 if (negated && conditions[c].is_modifier)
822 *error = string_sprintf("ACL error: negation is not allowed with "
823 "\"%s\"", conditions[c].name);
827 /* ENDPASS may occur only with ACCEPT or DISCARD. */
829 if (c == ACLC_ENDPASS &&
830 this->verb != ACL_ACCEPT &&
831 this->verb != ACL_DISCARD)
833 *error = string_sprintf("ACL error: \"%s\" is not allowed with \"%s\"",
834 conditions[c].name, verbs[this->verb]);
838 cond = store_get(sizeof(acl_condition_block));
841 cond->u.negated = negated;
844 condp = &(cond->next);
846 /* The "set" modifier is different in that its argument is "name=value"
847 rather than just a value, and we can check the validity of the name, which
848 gives us a variable name to insert into the data block. The original ACL
849 variable names were acl_c0 ... acl_c9 and acl_m0 ... acl_m9. This was
850 extended to 20 of each type, but after that people successfully argued for
851 arbitrary names. In the new scheme, the names must start with acl_c or acl_m.
852 After that, we allow alphanumerics and underscores, but the first character
853 after c or m must be a digit or an underscore. This retains backwards
858 if ( Ustrncmp(s, "dkim_verify_status", 18) == 0
859 || Ustrncmp(s, "dkim_verify_reason", 18) == 0)
861 uschar * endptr = s+18;
863 if (isalnum(*endptr))
865 *error = string_sprintf("invalid variable name after \"set\" in ACL "
866 "modifier \"set %s\" "
867 "(only \"dkim_verify_status\" or \"dkim_verify_reason\" permitted)",
871 cond->u.varname = string_copyn(s, 18);
873 while (isspace(*s)) s++;
880 if (Ustrncmp(s, "acl_c", 5) != 0 &&
881 Ustrncmp(s, "acl_m", 5) != 0)
883 *error = string_sprintf("invalid variable name after \"set\" in ACL "
884 "modifier \"set %s\" (must start \"acl_c\" or \"acl_m\")", s);
889 if (!isdigit(*endptr) && *endptr != '_')
891 *error = string_sprintf("invalid variable name after \"set\" in ACL "
892 "modifier \"set %s\" (digit or underscore must follow acl_c or acl_m)",
897 while (*endptr != 0 && *endptr != '=' && !isspace(*endptr))
899 if (!isalnum(*endptr) && *endptr != '_')
901 *error = string_sprintf("invalid character \"%c\" in variable name "
902 "in ACL modifier \"set %s\"", *endptr, s);
908 cond->u.varname = string_copyn(s + 4, endptr - s - 4);
910 while (isspace(*s)) s++;
913 /* For "set", we are now positioned for the data. For the others, only
914 "endpass" has no data */
916 if (c != ACLC_ENDPASS)
920 *error = string_sprintf("\"=\" missing after ACL \"%s\" %s", name,
921 conditions[c].is_modifier ? US"modifier" : US"condition");
924 while (isspace(*s)) s++;
925 cond->arg = string_copy(s);
934 /*************************************************
935 * Set up added header line(s) *
936 *************************************************/
938 /* This function is called by the add_header modifier, and also from acl_warn()
939 to implement the now-deprecated way of adding header lines using "message" on a
940 "warn" verb. The argument is treated as a sequence of header lines which are
941 added to a chain, provided there isn't an identical one already there.
943 Argument: string of header lines
948 setup_header(const uschar *hstring)
951 int hlen = Ustrlen(hstring);
953 /* Ignore any leading newlines */
954 while (*hstring == '\n') hstring++, hlen--;
956 /* An empty string does nothing; ensure exactly one final newline. */
957 if (hlen <= 0) return;
958 if (hstring[--hlen] != '\n') /* no newline */
959 q = string_sprintf("%s\n", hstring);
960 else if (hstring[hlen-1] == '\n') /* double newline */
962 uschar * s = string_copy(hstring);
963 while(s[--hlen] == '\n')
970 /* Loop for multiple header lines, taking care about continuations */
972 for (p = q; *p; p = q)
976 int newtype = htype_add_bot;
977 header_line **hptr = &acl_added_headers;
979 /* Find next header line within the string */
983 q = Ustrchr(q, '\n'); /* we know there was a newline */
984 if (*++q != ' ' && *q != '\t') break;
987 /* If the line starts with a colon, interpret the instruction for where to
988 add it. This temporarily sets up a new type. */
992 if (strncmpic(p, US":after_received:", 16) == 0)
994 newtype = htype_add_rec;
997 else if (strncmpic(p, US":at_start_rfc:", 14) == 0)
999 newtype = htype_add_rfc;
1002 else if (strncmpic(p, US":at_start:", 10) == 0)
1004 newtype = htype_add_top;
1007 else if (strncmpic(p, US":at_end:", 8) == 0)
1009 newtype = htype_add_bot;
1012 while (*p == ' ' || *p == '\t') p++;
1015 /* See if this line starts with a header name, and if not, add X-ACL-Warn:
1016 to the front of it. */
1018 for (s = p; s < q - 1; s++)
1019 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 */
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));
1049 /*************************************************
1050 * List the added header lines *
1051 *************************************************/
1057 for (header_line * h = acl_added_headers; h; h = h->next)
1060 if (h->text[i-1] == '\n') i--;
1061 g = string_append_listele_n(g, '\n', h->text, i);
1064 return g ? g->s : NULL;
1068 /*************************************************
1069 * Set up removed header line(s) *
1070 *************************************************/
1072 /* This function is called by the remove_header modifier. The argument is
1073 treated as a sequence of header names which are added to a colon separated
1074 list, provided there isn't an identical one already there.
1076 Argument: string of header names
1081 setup_remove_header(const uschar *hnames)
1084 acl_removed_headers = acl_removed_headers
1085 ? string_sprintf("%s : %s", acl_removed_headers, hnames)
1086 : string_copy(hnames);
1091 /*************************************************
1093 *************************************************/
1095 /* This function is called when a WARN verb's conditions are true. It adds to
1096 the message's headers, and/or writes information to the log. In each case, this
1097 only happens once (per message for headers, per connection for log).
1099 ** NOTE: The header adding action using the "message" setting is historic, and
1100 its use is now deprecated. The new add_header modifier should be used instead.
1103 where ACL_WHERE_xxxx indicating which ACL this is
1104 user_message message for adding to headers
1105 log_message message for logging, if different
1111 acl_warn(int where, uschar *user_message, uschar *log_message)
1113 if (log_message != NULL && log_message != user_message)
1116 string_item *logged;
1118 text = string_sprintf("%s Warning: %s", host_and_ident(TRUE),
1119 string_printing(log_message));
1121 /* If a sender verification has failed, and the log message is "sender verify
1122 failed", add the failure message. */
1124 if (sender_verified_failed != NULL &&
1125 sender_verified_failed->message != NULL &&
1126 strcmpic(log_message, US"sender verify failed") == 0)
1127 text = string_sprintf("%s: %s", text, sender_verified_failed->message);
1129 /* Search previously logged warnings. They are kept in malloc
1130 store so they can be freed at the start of a new message. */
1132 for (logged = acl_warn_logged; logged; logged = logged->next)
1133 if (Ustrcmp(logged->text, text) == 0) break;
1137 int length = Ustrlen(text) + 1;
1138 log_write(0, LOG_MAIN, "%s", text);
1139 logged = store_malloc(sizeof(string_item) + length);
1140 logged->text = US logged + sizeof(string_item);
1141 memcpy(logged->text, text, length);
1142 logged->next = acl_warn_logged;
1143 acl_warn_logged = logged;
1147 /* If there's no user message, we are done. */
1149 if (!user_message) return;
1151 /* If this isn't a message ACL, we can't do anything with a user message.
1154 if (where > ACL_WHERE_NOTSMTP)
1156 log_write(0, LOG_MAIN|LOG_PANIC, "ACL \"warn\" with \"message\" setting "
1157 "found in a non-message (%s) ACL: cannot specify header lines here: "
1158 "message ignored", acl_wherenames[where]);
1162 /* The code for setting up header lines is now abstracted into a separate
1163 function so that it can be used for the add_header modifier as well. */
1165 setup_header(user_message);
1170 /*************************************************
1171 * Verify and check reverse DNS *
1172 *************************************************/
1174 /* Called from acl_verify() below. We look up the host name(s) of the client IP
1175 address if this has not yet been done. The host_name_lookup() function checks
1176 that one of these names resolves to an address list that contains the client IP
1177 address, so we don't actually have to do the check here.
1180 user_msgptr pointer for user message
1181 log_msgptr pointer for log message
1183 Returns: OK verification condition succeeded
1184 FAIL verification failed
1185 DEFER there was a problem verifying
1189 acl_verify_reverse(uschar **user_msgptr, uschar **log_msgptr)
1193 user_msgptr = user_msgptr; /* stop compiler warning */
1195 /* Previous success */
1197 if (sender_host_name != NULL) return OK;
1199 /* Previous failure */
1201 if (host_lookup_failed)
1203 *log_msgptr = string_sprintf("host lookup failed%s", host_lookup_msg);
1207 /* Need to do a lookup */
1210 debug_printf_indent("looking up host name to force name/address consistency check\n");
1212 if ((rc = host_name_lookup()) != OK)
1214 *log_msgptr = rc == DEFER
1215 ? US"host lookup deferred for reverse lookup check"
1216 : string_sprintf("host lookup failed for reverse lookup check%s",
1218 return rc; /* DEFER or FAIL */
1221 host_build_sender_fullhost();
1227 /*************************************************
1228 * Check client IP address matches CSA target *
1229 *************************************************/
1231 /* Called from acl_verify_csa() below. This routine scans a section of a DNS
1232 response for address records belonging to the CSA target hostname. The section
1233 is specified by the reset argument, either RESET_ADDITIONAL or RESET_ANSWERS.
1234 If one of the addresses matches the client's IP address, then the client is
1235 authorized by CSA. If there are target IP addresses but none of them match
1236 then the client is using an unauthorized IP address. If there are no target IP
1237 addresses then the client cannot be using an authorized IP address. (This is
1238 an odd configuration - why didn't the SRV record have a weight of 1 instead?)
1241 dnsa the DNS answer block
1242 dnss a DNS scan block for us to use
1243 reset option specifying what portion to scan, as described above
1244 target the target hostname to use for matching RR names
1246 Returns: CSA_OK successfully authorized
1247 CSA_FAIL_MISMATCH addresses found but none matched
1248 CSA_FAIL_NOADDR no target addresses found
1252 acl_verify_csa_address(dns_answer *dnsa, dns_scan *dnss, int reset,
1255 int rc = CSA_FAIL_NOADDR;
1257 for (dns_record * rr = dns_next_rr(dnsa, dnss, reset);
1259 rr = dns_next_rr(dnsa, dnss, RESET_NEXT))
1261 /* Check this is an address RR for the target hostname. */
1265 && rr->type != T_AAAA
1269 if (strcmpic(target, rr->name) != 0) continue;
1271 rc = CSA_FAIL_MISMATCH;
1273 /* Turn the target address RR into a list of textual IP addresses and scan
1274 the list. There may be more than one if it is an A6 RR. */
1276 for (dns_address * da = dns_address_from_rr(dnsa, rr); da; da = da->next)
1278 /* If the client IP address matches the target IP address, it's good! */
1280 DEBUG(D_acl) debug_printf_indent("CSA target address is %s\n", da->address);
1282 if (strcmpic(sender_host_address, da->address) == 0) return CSA_OK;
1286 /* If we found some target addresses but none of them matched, the client is
1287 using an unauthorized IP address, otherwise the target has no authorized IP
1295 /*************************************************
1296 * Verify Client SMTP Authorization *
1297 *************************************************/
1299 /* Called from acl_verify() below. This routine calls dns_lookup_special()
1300 to find the CSA SRV record corresponding to the domain argument, or
1301 $sender_helo_name if no argument is provided. It then checks that the
1302 client is authorized, and that its IP address corresponds to the SRV
1303 target's address by calling acl_verify_csa_address() above. The address
1304 should have been returned in the DNS response's ADDITIONAL section, but if
1305 not we perform another DNS lookup to get it.
1308 domain pointer to optional parameter following verify = csa
1310 Returns: CSA_UNKNOWN no valid CSA record found
1311 CSA_OK successfully authorized
1312 CSA_FAIL_* client is definitely not authorized
1313 CSA_DEFER_* there was a DNS problem
1317 acl_verify_csa(const uschar *domain)
1320 const uschar *found;
1321 int priority, weight, port;
1328 /* Work out the domain we are using for the CSA lookup. The default is the
1329 client's HELO domain. If the client has not said HELO, use its IP address
1330 instead. If it's a local client (exim -bs), CSA isn't applicable. */
1332 while (isspace(*domain) && *domain != '\0') ++domain;
1333 if (*domain == '\0') domain = sender_helo_name;
1334 if (domain == NULL) domain = sender_host_address;
1335 if (sender_host_address == NULL) return CSA_UNKNOWN;
1337 /* If we have an address literal, strip off the framing ready for turning it
1338 into a domain. The framing consists of matched square brackets possibly
1339 containing a keyword and a colon before the actual IP address. */
1341 if (domain[0] == '[')
1343 const uschar *start = Ustrchr(domain, ':');
1344 if (start == NULL) start = domain;
1345 domain = string_copyn(start + 1, Ustrlen(start) - 2);
1348 /* Turn domains that look like bare IP addresses into domains in the reverse
1349 DNS. This code also deals with address literals and $sender_host_address. It's
1350 not quite kosher to treat bare domains such as EHLO 192.0.2.57 the same as
1351 address literals, but it's probably the most friendly thing to do. This is an
1352 extension to CSA, so we allow it to be turned off for proper conformance. */
1354 if (string_is_ip_address(domain, NULL) != 0)
1356 if (!dns_csa_use_reverse) return CSA_UNKNOWN;
1357 dns_build_reverse(domain, target);
1361 /* Find out if we've already done the CSA check for this domain. If we have,
1362 return the same result again. Otherwise build a new cached result structure
1363 for this domain. The name is filled in now, and the value is filled in when
1364 we return from this function. */
1366 t = tree_search(csa_cache, domain);
1367 if (t != NULL) return t->data.val;
1369 t = store_get_perm(sizeof(tree_node) + Ustrlen(domain));
1370 Ustrcpy(t->name, domain);
1371 (void)tree_insertnode(&csa_cache, t);
1373 /* Now we are ready to do the actual DNS lookup(s). */
1376 switch (dns_special_lookup(&dnsa, domain, T_CSA, &found))
1378 /* If something bad happened (most commonly DNS_AGAIN), defer. */
1381 return t->data.val = CSA_DEFER_SRV;
1383 /* If we found nothing, the client's authorization is unknown. */
1387 return t->data.val = CSA_UNKNOWN;
1389 /* We got something! Go on to look at the reply in more detail. */
1395 /* Scan the reply for well-formed CSA SRV records. */
1397 for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
1399 rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT)) if (rr->type == T_SRV)
1401 const uschar * p = rr->data;
1403 /* Extract the numerical SRV fields (p is incremented) */
1405 GETSHORT(priority, p);
1406 GETSHORT(weight, p);
1410 debug_printf_indent("CSA priority=%d weight=%d port=%d\n", priority, weight, port);
1412 /* Check the CSA version number */
1414 if (priority != 1) continue;
1416 /* If the domain does not have a CSA SRV record of its own (i.e. the domain
1417 found by dns_special_lookup() is a parent of the one we asked for), we check
1418 the subdomain assertions in the port field. At the moment there's only one
1419 assertion: legitimate SMTP clients are all explicitly authorized with CSA
1420 SRV records of their own. */
1422 if (Ustrcmp(found, domain) != 0)
1423 return t->data.val = port & 1 ? CSA_FAIL_EXPLICIT : CSA_UNKNOWN;
1425 /* This CSA SRV record refers directly to our domain, so we check the value
1426 in the weight field to work out the domain's authorization. 0 and 1 are
1427 unauthorized; 3 means the client is authorized but we can't check the IP
1428 address in order to authenticate it, so we treat it as unknown; values
1429 greater than 3 are undefined. */
1431 if (weight < 2) return t->data.val = CSA_FAIL_DOMAIN;
1433 if (weight > 2) continue;
1435 /* Weight == 2, which means the domain is authorized. We must check that the
1436 client's IP address is listed as one of the SRV target addresses. Save the
1437 target hostname then break to scan the additional data for its addresses. */
1439 (void)dn_expand(dnsa.answer, dnsa.answer + dnsa.answerlen, p,
1440 (DN_EXPAND_ARG4_TYPE)target, sizeof(target));
1442 DEBUG(D_acl) debug_printf_indent("CSA target is %s\n", target);
1447 /* If we didn't break the loop then no appropriate records were found. */
1449 if (!rr) return t->data.val = CSA_UNKNOWN;
1451 /* Do not check addresses if the target is ".", in accordance with RFC 2782.
1452 A target of "." indicates there are no valid addresses, so the client cannot
1453 be authorized. (This is an odd configuration because weight=2 target=. is
1454 equivalent to weight=1, but we check for it in order to keep load off the
1455 root name servers.) Note that dn_expand() turns "." into "". */
1457 if (Ustrcmp(target, "") == 0) return t->data.val = CSA_FAIL_NOADDR;
1459 /* Scan the additional section of the CSA SRV reply for addresses belonging
1460 to the target. If the name server didn't return any additional data (e.g.
1461 because it does not fully support SRV records), we need to do another lookup
1462 to obtain the target addresses; otherwise we have a definitive result. */
1464 rc = acl_verify_csa_address(&dnsa, &dnss, RESET_ADDITIONAL, target);
1465 if (rc != CSA_FAIL_NOADDR) return t->data.val = rc;
1467 /* The DNS lookup type corresponds to the IP version used by the client. */
1470 if (Ustrchr(sender_host_address, ':') != NULL)
1473 #endif /* HAVE_IPV6 */
1477 lookup_dnssec_authenticated = NULL;
1478 switch (dns_lookup(&dnsa, target, type, NULL))
1480 /* If something bad happened (most commonly DNS_AGAIN), defer. */
1483 return t->data.val = CSA_DEFER_ADDR;
1485 /* If the query succeeded, scan the addresses and return the result. */
1488 rc = acl_verify_csa_address(&dnsa, &dnss, RESET_ANSWERS, target);
1489 if (rc != CSA_FAIL_NOADDR) return t->data.val = rc;
1490 /* else fall through */
1492 /* If the target has no IP addresses, the client cannot have an authorized
1493 IP address. However, if the target site uses A6 records (not AAAA records)
1494 we have to do yet another lookup in order to check them. */
1498 return t->data.val = CSA_FAIL_NOADDR;
1504 /*************************************************
1505 * Handle verification (address & other) *
1506 *************************************************/
1508 enum { VERIFY_REV_HOST_LKUP, VERIFY_CERT, VERIFY_HELO, VERIFY_CSA, VERIFY_HDR_SYNTAX,
1509 VERIFY_NOT_BLIND, VERIFY_HDR_SNDR, VERIFY_SNDR, VERIFY_RCPT,
1510 VERIFY_HDR_NAMES_ASCII, VERIFY_ARC
1515 unsigned where_allowed; /* bitmap */
1516 BOOL no_options; /* Never has /option(s) following */
1517 unsigned alt_opt_sep; /* >0 Non-/ option separator (custom parser) */
1519 static verify_type_t verify_type_list[] = {
1520 /* name value where no-opt opt-sep */
1521 { US"reverse_host_lookup", VERIFY_REV_HOST_LKUP, ~0, FALSE, 0 },
1522 { US"certificate", VERIFY_CERT, ~0, TRUE, 0 },
1523 { US"helo", VERIFY_HELO, ~0, TRUE, 0 },
1524 { US"csa", VERIFY_CSA, ~0, FALSE, 0 },
1525 { US"header_syntax", VERIFY_HDR_SYNTAX, ACL_BIT_DATA | ACL_BIT_NOTSMTP, TRUE, 0 },
1526 { US"not_blind", VERIFY_NOT_BLIND, ACL_BIT_DATA | ACL_BIT_NOTSMTP, TRUE, 0 },
1527 { US"header_sender", VERIFY_HDR_SNDR, ACL_BIT_DATA | ACL_BIT_NOTSMTP, FALSE, 0 },
1528 { US"sender", VERIFY_SNDR, ACL_BIT_MAIL | ACL_BIT_RCPT
1529 |ACL_BIT_PREDATA | ACL_BIT_DATA | ACL_BIT_NOTSMTP,
1531 { US"recipient", VERIFY_RCPT, ACL_BIT_RCPT, FALSE, 0 },
1532 { US"header_names_ascii", VERIFY_HDR_NAMES_ASCII, ACL_BIT_DATA | ACL_BIT_NOTSMTP, TRUE, 0 },
1533 #ifdef EXPERIMENTAL_ARC
1534 { US"arc", VERIFY_ARC, ACL_BIT_DATA, FALSE , 0 },
1539 enum { CALLOUT_DEFER_OK, CALLOUT_NOCACHE, CALLOUT_RANDOM, CALLOUT_USE_SENDER,
1540 CALLOUT_USE_POSTMASTER, CALLOUT_POSTMASTER, CALLOUT_FULLPOSTMASTER,
1541 CALLOUT_MAILFROM, CALLOUT_POSTMASTER_MAILFROM, CALLOUT_MAXWAIT, CALLOUT_CONNECT,
1542 CALLOUT_HOLD, CALLOUT_TIME /* TIME must be last */
1548 BOOL has_option; /* Has =option(s) following */
1549 BOOL timeval; /* Has a time value */
1551 static callout_opt_t callout_opt_list[] = {
1552 /* name value flag has-opt has-time */
1553 { US"defer_ok", CALLOUT_DEFER_OK, 0, FALSE, FALSE },
1554 { US"no_cache", CALLOUT_NOCACHE, vopt_callout_no_cache, FALSE, FALSE },
1555 { US"random", CALLOUT_RANDOM, vopt_callout_random, FALSE, FALSE },
1556 { US"use_sender", CALLOUT_USE_SENDER, vopt_callout_recipsender, FALSE, FALSE },
1557 { US"use_postmaster", CALLOUT_USE_POSTMASTER,vopt_callout_recippmaster, FALSE, FALSE },
1558 { US"postmaster_mailfrom",CALLOUT_POSTMASTER_MAILFROM,0, TRUE, FALSE },
1559 { US"postmaster", CALLOUT_POSTMASTER, 0, FALSE, FALSE },
1560 { US"fullpostmaster", CALLOUT_FULLPOSTMASTER,vopt_callout_fullpm, FALSE, FALSE },
1561 { US"mailfrom", CALLOUT_MAILFROM, 0, TRUE, FALSE },
1562 { US"maxwait", CALLOUT_MAXWAIT, 0, TRUE, TRUE },
1563 { US"connect", CALLOUT_CONNECT, 0, TRUE, TRUE },
1564 { US"hold", CALLOUT_HOLD, vopt_callout_hold, FALSE, FALSE },
1565 { NULL, CALLOUT_TIME, 0, FALSE, TRUE }
1570 /* This function implements the "verify" condition. It is called when
1571 encountered in any ACL, because some tests are almost always permitted. Some
1572 just don't make sense, and always fail (for example, an attempt to test a host
1573 lookup for a non-TCP/IP message). Others are restricted to certain ACLs.
1576 where where called from
1577 addr the recipient address that the ACL is handling, or NULL
1578 arg the argument of "verify"
1579 user_msgptr pointer for user message
1580 log_msgptr pointer for log message
1581 basic_errno where to put verify errno
1583 Returns: OK verification condition succeeded
1584 FAIL verification failed
1585 DEFER there was a problem verifying
1590 acl_verify(int where, address_item *addr, const uschar *arg,
1591 uschar **user_msgptr, uschar **log_msgptr, int *basic_errno)
1595 int callout_overall = -1;
1596 int callout_connect = -1;
1597 int verify_options = 0;
1599 BOOL verify_header_sender = FALSE;
1600 BOOL defer_ok = FALSE;
1601 BOOL callout_defer_ok = FALSE;
1602 BOOL no_details = FALSE;
1603 BOOL success_on_redirect = FALSE;
1604 address_item *sender_vaddr = NULL;
1605 uschar *verify_sender_address = NULL;
1606 uschar *pm_mailfrom = NULL;
1607 uschar *se_mailfrom = NULL;
1609 /* Some of the verify items have slash-separated options; some do not. Diagnose
1610 an error if options are given for items that don't expect them.
1613 uschar *slash = Ustrchr(arg, '/');
1614 const uschar *list = arg;
1615 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
1618 if (!ss) goto BAD_VERIFY;
1620 /* Handle name/address consistency verification in a separate function. */
1622 for (vp = verify_type_list;
1623 CS vp < CS verify_type_list + sizeof(verify_type_list);
1626 if (vp->alt_opt_sep ? strncmpic(ss, vp->name, vp->alt_opt_sep) == 0
1627 : strcmpic (ss, vp->name) == 0)
1629 if (CS vp >= CS verify_type_list + sizeof(verify_type_list))
1632 if (vp->no_options && slash)
1634 *log_msgptr = string_sprintf("unexpected '/' found in \"%s\" "
1635 "(this verify item has no options)", arg);
1638 if (!(vp->where_allowed & BIT(where)))
1640 *log_msgptr = string_sprintf("cannot verify %s in ACL for %s",
1641 vp->name, acl_wherenames[where]);
1646 case VERIFY_REV_HOST_LKUP:
1647 if (!sender_host_address) return OK;
1648 if ((rc = acl_verify_reverse(user_msgptr, log_msgptr)) == DEFER)
1649 while ((ss = string_nextinlist(&list, &sep, NULL, 0)))
1650 if (strcmpic(ss, US"defer_ok") == 0)
1655 /* TLS certificate verification is done at STARTTLS time; here we just
1656 test whether it was successful or not. (This is for optional verification; for
1657 mandatory verification, the connection doesn't last this long.) */
1659 if (tls_in.certificate_verified) return OK;
1660 *user_msgptr = US"no verified certificate";
1664 /* We can test the result of optional HELO verification that might have
1665 occurred earlier. If not, we can attempt the verification now. */
1667 if (!f.helo_verified && !f.helo_verify_failed) smtp_verify_helo();
1668 return f.helo_verified ? OK : FAIL;
1671 /* Do Client SMTP Authorization checks in a separate function, and turn the
1672 result code into user-friendly strings. */
1674 rc = acl_verify_csa(list);
1675 *log_msgptr = *user_msgptr = string_sprintf("client SMTP authorization %s",
1676 csa_reason_string[rc]);
1677 csa_status = csa_status_string[rc];
1678 DEBUG(D_acl) debug_printf_indent("CSA result %s\n", csa_status);
1679 return csa_return_code[rc];
1681 #ifdef EXPERIMENTAL_ARC
1683 { /* Do Authenticated Received Chain checks in a separate function. */
1684 const uschar * condlist = CUS string_nextinlist(&list, &sep, NULL, 0);
1688 if (!(arc_state = acl_verify_arc())) return DEFER;
1689 DEBUG(D_acl) debug_printf_indent("ARC verify result %s %s%s%s\n", arc_state,
1690 arc_state_reason ? "(":"", arc_state_reason, arc_state_reason ? ")":"");
1692 if (!condlist) condlist = US"none:pass";
1693 while ((cond = string_nextinlist(&condlist, &csep, NULL, 0)))
1694 if (Ustrcmp(arc_state, cond) == 0) return OK;
1699 case VERIFY_HDR_SYNTAX:
1700 /* Check that all relevant header lines have the correct 5322-syntax. If there is
1701 a syntax error, we return details of the error to the sender if configured to
1702 send out full details. (But a "message" setting on the ACL can override, as
1705 rc = verify_check_headers(log_msgptr);
1706 if (rc != OK && *log_msgptr)
1707 if (smtp_return_error_details)
1708 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1710 acl_verify_message = *log_msgptr;
1713 case VERIFY_HDR_NAMES_ASCII:
1714 /* Check that all header names are true 7 bit strings
1715 See RFC 5322, 2.2. and RFC 6532, 3. */
1717 rc = verify_check_header_names_ascii(log_msgptr);
1718 if (rc != OK && smtp_return_error_details && *log_msgptr)
1719 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1722 case VERIFY_NOT_BLIND:
1723 /* Check that no recipient of this message is "blind", that is, every envelope
1724 recipient must be mentioned in either To: or Cc:. */
1726 if ((rc = verify_check_notblind()) != OK)
1728 *log_msgptr = string_sprintf("bcc recipient detected");
1729 if (smtp_return_error_details)
1730 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1734 /* The remaining verification tests check recipient and sender addresses,
1735 either from the envelope or from the header. There are a number of
1736 slash-separated options that are common to all of them. */
1738 case VERIFY_HDR_SNDR:
1739 verify_header_sender = TRUE;
1743 /* In the case of a sender, this can optionally be followed by an address to use
1744 in place of the actual sender (rare special-case requirement). */
1748 verify_sender_address = sender_address;
1751 while (isspace(*s)) s++;
1752 if (*s++ != '=') goto BAD_VERIFY;
1753 while (isspace(*s)) s++;
1754 verify_sender_address = string_copy(s);
1765 /* Remaining items are optional; they apply to sender and recipient
1766 verification, including "header sender" verification. */
1768 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size)))
1770 if (strcmpic(ss, US"defer_ok") == 0) defer_ok = TRUE;
1771 else if (strcmpic(ss, US"no_details") == 0) no_details = TRUE;
1772 else if (strcmpic(ss, US"success_on_redirect") == 0) success_on_redirect = TRUE;
1774 /* These two old options are left for backwards compatibility */
1776 else if (strcmpic(ss, US"callout_defer_ok") == 0)
1778 callout_defer_ok = TRUE;
1779 if (callout == -1) callout = CALLOUT_TIMEOUT_DEFAULT;
1782 else if (strcmpic(ss, US"check_postmaster") == 0)
1785 if (callout == -1) callout = CALLOUT_TIMEOUT_DEFAULT;
1788 /* The callout option has a number of sub-options, comma separated */
1790 else if (strncmpic(ss, US"callout", 7) == 0)
1792 callout = CALLOUT_TIMEOUT_DEFAULT;
1796 while (isspace(*ss)) ss++;
1799 const uschar * sublist = ss;
1804 while (isspace(*sublist)) sublist++;
1805 while ((opt = string_nextinlist(&sublist, &optsep, buffer, sizeof(buffer))))
1808 double period = 1.0F;
1810 for (op= callout_opt_list; op->name; op++)
1811 if (strncmpic(opt, op->name, Ustrlen(op->name)) == 0)
1814 verify_options |= op->flag;
1817 opt += Ustrlen(op->name);
1818 while (isspace(*opt)) opt++;
1821 *log_msgptr = string_sprintf("'=' expected after "
1822 "\"%s\" in ACL verify condition \"%s\"", op->name, arg);
1825 while (isspace(*opt)) opt++;
1827 if (op->timeval && (period = readconf_readtime(opt, 0, FALSE)) < 0)
1829 *log_msgptr = string_sprintf("bad time value in ACL condition "
1830 "\"verify %s\"", arg);
1836 case CALLOUT_DEFER_OK: callout_defer_ok = TRUE; break;
1837 case CALLOUT_POSTMASTER: pm_mailfrom = US""; break;
1838 case CALLOUT_FULLPOSTMASTER: pm_mailfrom = US""; break;
1839 case CALLOUT_MAILFROM:
1840 if (!verify_header_sender)
1842 *log_msgptr = string_sprintf("\"mailfrom\" is allowed as a "
1843 "callout option only for verify=header_sender (detected in ACL "
1844 "condition \"%s\")", arg);
1847 se_mailfrom = string_copy(opt);
1849 case CALLOUT_POSTMASTER_MAILFROM: pm_mailfrom = string_copy(opt); break;
1850 case CALLOUT_MAXWAIT: callout_overall = period; break;
1851 case CALLOUT_CONNECT: callout_connect = period; break;
1852 case CALLOUT_TIME: callout = period; break;
1858 *log_msgptr = string_sprintf("'=' expected after \"callout\" in "
1859 "ACL condition \"%s\"", arg);
1865 /* Option not recognized */
1869 *log_msgptr = string_sprintf("unknown option \"%s\" in ACL "
1870 "condition \"verify %s\"", ss, arg);
1875 if ((verify_options & (vopt_callout_recipsender|vopt_callout_recippmaster)) ==
1876 (vopt_callout_recipsender|vopt_callout_recippmaster))
1878 *log_msgptr = US"only one of use_sender and use_postmaster can be set "
1879 "for a recipient callout";
1883 /* Handle sender-in-header verification. Default the user message to the log
1884 message if giving out verification details. */
1886 if (verify_header_sender)
1890 if ((rc = verify_check_header_address(user_msgptr, log_msgptr, callout,
1891 callout_overall, callout_connect, se_mailfrom, pm_mailfrom, verify_options,
1894 *basic_errno = verrno;
1895 if (smtp_return_error_details)
1897 if (!*user_msgptr && *log_msgptr)
1898 *user_msgptr = string_sprintf("Rejected after DATA: %s", *log_msgptr);
1899 if (rc == DEFER) f.acl_temp_details = TRUE;
1904 /* Handle a sender address. The default is to verify *the* sender address, but
1905 optionally a different address can be given, for special requirements. If the
1906 address is empty, we are dealing with a bounce message that has no sender, so
1907 we cannot do any checking. If the real sender address gets rewritten during
1908 verification (e.g. DNS widening), set the flag to stop it being rewritten again
1909 during message reception.
1911 A list of verified "sender" addresses is kept to try to avoid doing to much
1912 work repetitively when there are multiple recipients in a message and they all
1913 require sender verification. However, when callouts are involved, it gets too
1914 complicated because different recipients may require different callout options.
1915 Therefore, we always do a full sender verify when any kind of callout is
1916 specified. Caching elsewhere, for instance in the DNS resolver and in the
1917 callout handling, should ensure that this is not terribly inefficient. */
1919 else if (verify_sender_address)
1921 if ((verify_options & (vopt_callout_recipsender|vopt_callout_recippmaster)))
1923 *log_msgptr = US"use_sender or use_postmaster cannot be used for a "
1924 "sender verify callout";
1928 sender_vaddr = verify_checked_sender(verify_sender_address);
1929 if (sender_vaddr != NULL && /* Previously checked */
1930 callout <= 0) /* No callout needed this time */
1932 /* If the "routed" flag is set, it means that routing worked before, so
1933 this check can give OK (the saved return code value, if set, belongs to a
1934 callout that was done previously). If the "routed" flag is not set, routing
1935 must have failed, so we use the saved return code. */
1937 if (testflag(sender_vaddr, af_verify_routed))
1941 rc = sender_vaddr->special_action;
1942 *basic_errno = sender_vaddr->basic_errno;
1944 HDEBUG(D_acl) debug_printf_indent("using cached sender verify result\n");
1947 /* Do a new verification, and cache the result. The cache is used to avoid
1948 verifying the sender multiple times for multiple RCPTs when callouts are not
1949 specified (see comments above).
1951 The cache is also used on failure to give details in response to the first
1952 RCPT that gets bounced for this reason. However, this can be suppressed by
1953 the no_details option, which sets the flag that says "this detail has already
1954 been sent". The cache normally contains just one address, but there may be
1955 more in esoteric circumstances. */
1960 uschar *save_address_data = deliver_address_data;
1962 sender_vaddr = deliver_make_addr(verify_sender_address, TRUE);
1964 if ((sender_vaddr->prop.utf8_msg = message_smtputf8))
1966 sender_vaddr->prop.utf8_downcvt = message_utf8_downconvert == 1;
1967 sender_vaddr->prop.utf8_downcvt_maybe = message_utf8_downconvert == -1;
1970 if (no_details) setflag(sender_vaddr, af_sverify_told);
1971 if (verify_sender_address[0] != 0)
1973 /* If this is the real sender address, save the unrewritten version
1974 for use later in receive. Otherwise, set a flag so that rewriting the
1975 sender in verify_address() does not update sender_address. */
1977 if (verify_sender_address == sender_address)
1978 sender_address_unrewritten = sender_address;
1980 verify_options |= vopt_fake_sender;
1982 if (success_on_redirect)
1983 verify_options |= vopt_success_on_redirect;
1985 /* The recipient, qualify, and expn options are never set in
1988 rc = verify_address(sender_vaddr, NULL, verify_options, callout,
1989 callout_overall, callout_connect, se_mailfrom, pm_mailfrom, &routed);
1991 HDEBUG(D_acl) debug_printf_indent("----------- end verify ------------\n");
1994 *basic_errno = sender_vaddr->basic_errno;
1998 if (Ustrcmp(sender_vaddr->address, verify_sender_address) != 0)
1999 debug_printf_indent("sender %s verified ok as %s\n",
2000 verify_sender_address, sender_vaddr->address);
2002 debug_printf_indent("sender %s verified ok\n",
2003 verify_sender_address);
2007 rc = OK; /* Null sender */
2009 /* Cache the result code */
2011 if (routed) setflag(sender_vaddr, af_verify_routed);
2012 if (callout > 0) setflag(sender_vaddr, af_verify_callout);
2013 sender_vaddr->special_action = rc;
2014 sender_vaddr->next = sender_verified_list;
2015 sender_verified_list = sender_vaddr;
2017 /* Restore the recipient address data, which might have been clobbered by
2018 the sender verification. */
2020 deliver_address_data = save_address_data;
2023 /* Put the sender address_data value into $sender_address_data */
2025 sender_address_data = sender_vaddr->prop.address_data;
2028 /* A recipient address just gets a straightforward verify; again we must handle
2029 the DEFER overrides. */
2035 if (success_on_redirect)
2036 verify_options |= vopt_success_on_redirect;
2038 /* We must use a copy of the address for verification, because it might
2042 rc = verify_address(&addr2, NULL, verify_options|vopt_is_recipient, callout,
2043 callout_overall, callout_connect, se_mailfrom, pm_mailfrom, NULL);
2044 HDEBUG(D_acl) debug_printf_indent("----------- end verify ------------\n");
2046 *basic_errno = addr2.basic_errno;
2047 *log_msgptr = addr2.message;
2048 *user_msgptr = (addr2.user_message != NULL)?
2049 addr2.user_message : addr2.message;
2051 /* Allow details for temporary error if the address is so flagged. */
2052 if (testflag((&addr2), af_pass_message)) f.acl_temp_details = TRUE;
2054 /* Make $address_data visible */
2055 deliver_address_data = addr2.prop.address_data;
2058 /* We have a result from the relevant test. Handle defer overrides first. */
2060 if (rc == DEFER && (defer_ok ||
2061 (callout_defer_ok && *basic_errno == ERRNO_CALLOUTDEFER)))
2063 HDEBUG(D_acl) debug_printf_indent("verify defer overridden by %s\n",
2064 defer_ok? "defer_ok" : "callout_defer_ok");
2068 /* If we've failed a sender, set up a recipient message, and point
2069 sender_verified_failed to the address item that actually failed. */
2071 if (rc != OK && verify_sender_address != NULL)
2074 *log_msgptr = *user_msgptr = US"Sender verify failed";
2075 else if (*basic_errno != ERRNO_CALLOUTDEFER)
2076 *log_msgptr = *user_msgptr = US"Could not complete sender verify";
2079 *log_msgptr = US"Could not complete sender verify callout";
2080 *user_msgptr = smtp_return_error_details? sender_vaddr->user_message :
2084 sender_verified_failed = sender_vaddr;
2087 /* Verifying an address messes up the values of $domain and $local_part,
2088 so reset them before returning if this is a RCPT ACL. */
2092 deliver_domain = addr->domain;
2093 deliver_localpart = addr->local_part;
2097 /* Syntax errors in the verify argument come here. */
2100 *log_msgptr = string_sprintf("expected \"sender[=address]\", \"recipient\", "
2101 "\"helo\", \"header_syntax\", \"header_sender\", \"header_names_ascii\" "
2102 "or \"reverse_host_lookup\" at start of ACL condition "
2103 "\"verify %s\"", arg);
2110 /*************************************************
2111 * Check argument for control= modifier *
2112 *************************************************/
2114 /* Called from acl_check_condition() below
2117 arg the argument string for control=
2118 pptr set to point to the terminating character
2119 where which ACL we are in
2120 log_msgptr for error messages
2122 Returns: CONTROL_xxx value
2126 decode_control(const uschar *arg, const uschar **pptr, int where, uschar **log_msgptr)
2131 if ( (idx = find_control(arg, controls_list, nelem(controls_list))) < 0
2132 || ( arg[len = Ustrlen((d = controls_list+idx)->name)] != 0
2133 && (!d->has_option || arg[len] != '/')
2136 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
2137 return CONTROL_ERROR;
2147 /*************************************************
2148 * Return a ratelimit error *
2149 *************************************************/
2151 /* Called from acl_ratelimit() below
2154 log_msgptr for error messages
2155 format format string
2156 ... supplementary arguments
2162 ratelimit_error(uschar **log_msgptr, const char *format, ...)
2166 string_cat(NULL, US"error in arguments to \"ratelimit\" condition: ");
2168 va_start(ap, format);
2169 g = string_vformat(g, TRUE, format, ap);
2172 gstring_reset_unused(g);
2173 *log_msgptr = string_from_gstring(g);
2180 /*************************************************
2181 * Handle rate limiting *
2182 *************************************************/
2184 /* Called by acl_check_condition() below to calculate the result
2185 of the ACL ratelimit condition.
2187 Note that the return value might be slightly unexpected: if the
2188 sender's rate is above the limit then the result is OK. This is
2189 similar to the dnslists condition, and is so that you can write
2190 ACL clauses like: defer ratelimit = 15 / 1h
2193 arg the option string for ratelimit=
2194 where ACL_WHERE_xxxx indicating which ACL this is
2195 log_msgptr for error messages
2197 Returns: OK - Sender's rate is above limit
2198 FAIL - Sender's rate is below limit
2199 DEFER - Problem opening ratelimit database
2200 ERROR - Syntax error in options.
2204 acl_ratelimit(const uschar *arg, int where, uschar **log_msgptr)
2206 double limit, period, count;
2209 uschar *unique = NULL;
2211 BOOL leaky = FALSE, strict = FALSE, readonly = FALSE;
2212 BOOL noupdate = FALSE, badacl = FALSE;
2213 int mode = RATE_PER_WHAT;
2215 tree_node **anchor, *t;
2216 open_db dbblock, *dbm;
2218 dbdata_ratelimit *dbd;
2219 dbdata_ratelimit_unique *dbdb;
2222 /* Parse the first two options and record their values in expansion
2223 variables. These variables allow the configuration to have informative
2224 error messages based on rate limits obtained from a table lookup. */
2226 /* First is the maximum number of messages per period / maximum burst
2227 size, which must be greater than or equal to zero. Zero is useful for
2228 rate measurement as opposed to rate limiting. */
2230 if (!(sender_rate_limit = string_nextinlist(&arg, &sep, NULL, 0)))
2231 return ratelimit_error(log_msgptr, "sender rate limit not set");
2233 limit = Ustrtod(sender_rate_limit, &ss);
2234 if (tolower(*ss) == 'k') { limit *= 1024.0; ss++; }
2235 else if (tolower(*ss) == 'm') { limit *= 1024.0*1024.0; ss++; }
2236 else if (tolower(*ss) == 'g') { limit *= 1024.0*1024.0*1024.0; ss++; }
2238 if (limit < 0.0 || *ss != '\0')
2239 return ratelimit_error(log_msgptr,
2240 "\"%s\" is not a positive number", sender_rate_limit);
2242 /* Second is the rate measurement period / exponential smoothing time
2243 constant. This must be strictly greater than zero, because zero leads to
2244 run-time division errors. */
2246 period = !(sender_rate_period = string_nextinlist(&arg, &sep, NULL, 0))
2247 ? -1.0 : readconf_readtime(sender_rate_period, 0, FALSE);
2249 return ratelimit_error(log_msgptr,
2250 "\"%s\" is not a time value", sender_rate_period);
2252 /* By default we are counting one of something, but the per_rcpt,
2253 per_byte, and count options can change this. */
2257 /* Parse the other options. */
2259 while ((ss = string_nextinlist(&arg, &sep, big_buffer, big_buffer_size)))
2261 if (strcmpic(ss, US"leaky") == 0) leaky = TRUE;
2262 else if (strcmpic(ss, US"strict") == 0) strict = TRUE;
2263 else if (strcmpic(ss, US"noupdate") == 0) noupdate = TRUE;
2264 else if (strcmpic(ss, US"readonly") == 0) readonly = TRUE;
2265 else if (strcmpic(ss, US"per_cmd") == 0) RATE_SET(mode, PER_CMD);
2266 else if (strcmpic(ss, US"per_conn") == 0)
2268 RATE_SET(mode, PER_CONN);
2269 if (where == ACL_WHERE_NOTSMTP || where == ACL_WHERE_NOTSMTP_START)
2272 else if (strcmpic(ss, US"per_mail") == 0)
2274 RATE_SET(mode, PER_MAIL);
2275 if (where > ACL_WHERE_NOTSMTP) badacl = TRUE;
2277 else if (strcmpic(ss, US"per_rcpt") == 0)
2279 /* If we are running in the RCPT ACL, then we'll count the recipients
2280 one by one, but if we are running when we have accumulated the whole
2281 list then we'll add them all in one batch. */
2282 if (where == ACL_WHERE_RCPT)
2283 RATE_SET(mode, PER_RCPT);
2284 else if (where >= ACL_WHERE_PREDATA && where <= ACL_WHERE_NOTSMTP)
2285 RATE_SET(mode, PER_ALLRCPTS), count = (double)recipients_count;
2286 else if (where == ACL_WHERE_MAIL || where > ACL_WHERE_NOTSMTP)
2287 RATE_SET(mode, PER_RCPT), badacl = TRUE;
2289 else if (strcmpic(ss, US"per_byte") == 0)
2291 /* If we have not yet received the message data and there was no SIZE
2292 declaration on the MAIL command, then it's safe to just use a value of
2293 zero and let the recorded rate decay as if nothing happened. */
2294 RATE_SET(mode, PER_MAIL);
2295 if (where > ACL_WHERE_NOTSMTP) badacl = TRUE;
2296 else count = message_size < 0 ? 0.0 : (double)message_size;
2298 else if (strcmpic(ss, US"per_addr") == 0)
2300 RATE_SET(mode, PER_RCPT);
2301 if (where != ACL_WHERE_RCPT) badacl = TRUE, unique = US"*";
2302 else unique = string_sprintf("%s@%s", deliver_localpart, deliver_domain);
2304 else if (strncmpic(ss, US"count=", 6) == 0)
2307 count = Ustrtod(ss+6, &e);
2308 if (count < 0.0 || *e != '\0')
2309 return ratelimit_error(log_msgptr, "\"%s\" is not a positive number", ss);
2311 else if (strncmpic(ss, US"unique=", 7) == 0)
2312 unique = string_copy(ss + 7);
2314 key = string_copy(ss);
2316 key = string_sprintf("%s/%s", key, ss);
2319 /* Sanity check. When the badacl flag is set the update mode must either
2320 be readonly (which is the default if it is omitted) or, for backwards
2321 compatibility, a combination of noupdate and strict or leaky. */
2323 if (mode == RATE_PER_CLASH)
2324 return ratelimit_error(log_msgptr, "conflicting per_* options");
2325 if (leaky + strict + readonly > 1)
2326 return ratelimit_error(log_msgptr, "conflicting update modes");
2327 if (badacl && (leaky || strict) && !noupdate)
2328 return ratelimit_error(log_msgptr,
2329 "\"%s\" must not have /leaky or /strict option, or cannot be used in %s ACL",
2330 ratelimit_option_string[mode], acl_wherenames[where]);
2332 /* Set the default values of any unset options. In readonly mode we
2333 perform the rate computation without any increment so that its value
2334 decays to eventually allow over-limit senders through. */
2336 if (noupdate) readonly = TRUE, leaky = strict = FALSE;
2337 if (badacl) readonly = TRUE;
2338 if (readonly) count = 0.0;
2339 if (!strict && !readonly) leaky = TRUE;
2340 if (mode == RATE_PER_WHAT) mode = RATE_PER_MAIL;
2342 /* Create the lookup key. If there is no explicit key, use sender_host_address.
2343 If there is no sender_host_address (e.g. -bs or acl_not_smtp) then we simply
2344 omit it. The smoothing constant (sender_rate_period) and the per_xxx options
2345 are added to the key because they alter the meaning of the stored data. */
2348 key = !sender_host_address ? US"" : sender_host_address;
2350 key = string_sprintf("%s/%s/%s%s",
2352 ratelimit_option_string[mode],
2353 unique == NULL ? "" : "unique/",
2357 debug_printf_indent("ratelimit condition count=%.0f %.1f/%s\n", count, limit, key);
2359 /* See if we have already computed the rate by looking in the relevant tree.
2360 For per-connection rate limiting, store tree nodes and dbdata in the permanent
2361 pool so that they survive across resets. In readonly mode we only remember the
2362 result for the rest of this command in case a later command changes it. After
2363 this bit of logic the code is independent of the per_* mode. */
2365 old_pool = store_pool;
2368 anchor = &ratelimiters_cmd;
2372 anchor = &ratelimiters_conn;
2373 store_pool = POOL_PERM;
2377 case RATE_PER_ALLRCPTS:
2378 anchor = &ratelimiters_mail;
2383 anchor = &ratelimiters_cmd;
2386 anchor = NULL; /* silence an "unused" complaint */
2387 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
2388 "internal ACL error: unknown ratelimit mode %d", mode);
2392 if ((t = tree_search(*anchor, key)))
2395 /* The following few lines duplicate some of the code below. */
2396 rc = (dbd->rate < limit)? FAIL : OK;
2397 store_pool = old_pool;
2398 sender_rate = string_sprintf("%.1f", dbd->rate);
2400 debug_printf_indent("ratelimit found pre-computed rate %s\n", sender_rate);
2404 /* We aren't using a pre-computed rate, so get a previously recorded rate
2405 from the database, which will be updated and written back if required. */
2407 if (!(dbm = dbfn_open(US"ratelimit", O_RDWR, &dbblock, TRUE)))
2409 store_pool = old_pool;
2411 HDEBUG(D_acl) debug_printf_indent("ratelimit database not available\n");
2412 *log_msgptr = US"ratelimit database not available";
2415 dbdb = dbfn_read_with_length(dbm, key, &dbdb_size);
2418 gettimeofday(&tv, NULL);
2422 /* Locate the basic ratelimit block inside the DB data. */
2423 HDEBUG(D_acl) debug_printf_indent("ratelimit found key in database\n");
2426 /* Forget the old Bloom filter if it is too old, so that we count each
2427 repeating event once per period. We don't simply clear and re-use the old
2428 filter because we want its size to change if the limit changes. Note that
2429 we keep the dbd pointer for copying the rate into the new data block. */
2431 if(unique && tv.tv_sec > dbdb->bloom_epoch + period)
2433 HDEBUG(D_acl) debug_printf_indent("ratelimit discarding old Bloom filter\n");
2439 if(unique && dbdb_size < sizeof(*dbdb))
2441 HDEBUG(D_acl) debug_printf_indent("ratelimit discarding undersize Bloom filter\n");
2446 /* Allocate a new data block if the database lookup failed
2447 or the Bloom filter passed its age limit. */
2453 /* No Bloom filter. This basic ratelimit block is initialized below. */
2454 HDEBUG(D_acl) debug_printf_indent("ratelimit creating new rate data block\n");
2455 dbdb_size = sizeof(*dbd);
2456 dbdb = store_get(dbdb_size);
2461 HDEBUG(D_acl) debug_printf_indent("ratelimit creating new Bloom filter\n");
2463 /* See the long comment below for an explanation of the magic number 2.
2464 The filter has a minimum size in case the rate limit is very small;
2465 this is determined by the definition of dbdata_ratelimit_unique. */
2467 extra = (int)limit * 2 - sizeof(dbdb->bloom);
2468 if (extra < 0) extra = 0;
2469 dbdb_size = sizeof(*dbdb) + extra;
2470 dbdb = store_get(dbdb_size);
2471 dbdb->bloom_epoch = tv.tv_sec;
2472 dbdb->bloom_size = sizeof(dbdb->bloom) + extra;
2473 memset(dbdb->bloom, 0, dbdb->bloom_size);
2475 /* Preserve any basic ratelimit data (which is our longer-term memory)
2476 by copying it from the discarded block. */
2486 /* If we are counting unique events, find out if this event is new or not.
2487 If the client repeats the event during the current period then it should be
2488 counted. We skip this code in readonly mode for efficiency, because any
2489 changes to the filter will be discarded and because count is already set to
2492 if (unique && !readonly)
2494 /* We identify unique events using a Bloom filter. (You can find my
2495 notes on Bloom filters at http://fanf.livejournal.com/81696.html)
2496 With the per_addr option, an "event" is a recipient address, though the
2497 user can use the unique option to define their own events. We only count
2498 an event if we have not seen it before.
2500 We size the filter according to the rate limit, which (in leaky mode)
2501 is the limit on the population of the filter. We allow 16 bits of space
2502 per entry (see the construction code above) and we set (up to) 8 of them
2503 when inserting an element (see the loop below). The probability of a false
2504 positive (an event we have not seen before but which we fail to count) is
2508 allzero = exp(-numhash * pop / size)
2509 = exp(-0.5 * pop / limit)
2510 fpr = pow(1 - allzero, numhash)
2512 For senders at the limit the fpr is 0.06% or 1 in 1700
2513 and for senders at half the limit it is 0.0006% or 1 in 170000
2515 In strict mode the Bloom filter can fill up beyond the normal limit, in
2516 which case the false positive rate will rise. This means that the
2517 measured rate for very fast senders can bogusly drop off after a while.
2519 At twice the limit, the fpr is 2.5% or 1 in 40
2520 At four times the limit, it is 31% or 1 in 3.2
2522 It takes ln(pop/limit) periods for an over-limit burst of pop events to
2523 decay below the limit, and if this is more than one then the Bloom filter
2524 will be discarded before the decay gets that far. The false positive rate
2525 at this threshold is 9.3% or 1 in 10.7. */
2528 unsigned n, hash, hinc;
2532 /* Instead of using eight independent hash values, we combine two values
2533 using the formula h1 + n * h2. This does not harm the Bloom filter's
2534 performance, and means the amount of hash we need is independent of the
2535 number of bits we set in the filter. */
2537 md5_start(&md5info);
2538 md5_end(&md5info, unique, Ustrlen(unique), md5sum);
2539 hash = md5sum[0] | md5sum[1] << 8 | md5sum[2] << 16 | md5sum[3] << 24;
2540 hinc = md5sum[4] | md5sum[5] << 8 | md5sum[6] << 16 | md5sum[7] << 24;
2542 /* Scan the bits corresponding to this event. A zero bit means we have
2543 not seen it before. Ensure all bits are set to record this event. */
2545 HDEBUG(D_acl) debug_printf_indent("ratelimit checking uniqueness of %s\n", unique);
2548 for (n = 0; n < 8; n++, hash += hinc)
2550 int bit = 1 << (hash % 8);
2551 int byte = (hash / 8) % dbdb->bloom_size;
2552 if ((dbdb->bloom[byte] & bit) == 0)
2554 dbdb->bloom[byte] |= bit;
2559 /* If this event has occurred before, do not count it. */
2563 HDEBUG(D_acl) debug_printf_indent("ratelimit event found in Bloom filter\n");
2567 HDEBUG(D_acl) debug_printf_indent("ratelimit event added to Bloom filter\n");
2570 /* If there was no previous ratelimit data block for this key, initialize
2571 the new one, otherwise update the block from the database. The initial rate
2572 is what would be computed by the code below for an infinite interval. */
2576 HDEBUG(D_acl) debug_printf_indent("ratelimit initializing new key's rate data\n");
2578 dbd->time_stamp = tv.tv_sec;
2579 dbd->time_usec = tv.tv_usec;
2584 /* The smoothed rate is computed using an exponentially weighted moving
2585 average adjusted for variable sampling intervals. The standard EWMA for
2586 a fixed sampling interval is: f'(t) = (1 - a) * f(t) + a * f'(t - 1)
2587 where f() is the measured value and f'() is the smoothed value.
2589 Old data decays out of the smoothed value exponentially, such that data n
2590 samples old is multiplied by a^n. The exponential decay time constant p
2591 is defined such that data p samples old is multiplied by 1/e, which means
2592 that a = exp(-1/p). We can maintain the same time constant for a variable
2593 sampling interval i by using a = exp(-i/p).
2595 The rate we are measuring is messages per period, suitable for directly
2596 comparing with the limit. The average rate between now and the previous
2597 message is period / interval, which we feed into the EWMA as the sample.
2599 It turns out that the number of messages required for the smoothed rate
2600 to reach the limit when they are sent in a burst is equal to the limit.
2601 This can be seen by analysing the value of the smoothed rate after N
2602 messages sent at even intervals. Let k = (1 - a) * p/i
2604 rate_1 = (1 - a) * p/i + a * rate_0
2606 rate_2 = k + a * rate_1
2607 = k + a * k + a^2 * rate_0
2608 rate_3 = k + a * k + a^2 * k + a^3 * rate_0
2609 rate_N = rate_0 * a^N + k * SUM(x=0..N-1)(a^x)
2610 = rate_0 * a^N + k * (1 - a^N) / (1 - a)
2611 = rate_0 * a^N + p/i * (1 - a^N)
2613 When N is large, a^N -> 0 so rate_N -> p/i as desired.
2615 rate_N = p/i + (rate_0 - p/i) * a^N
2616 a^N = (rate_N - p/i) / (rate_0 - p/i)
2617 N * -i/p = log((rate_N - p/i) / (rate_0 - p/i))
2618 N = p/i * log((rate_0 - p/i) / (rate_N - p/i))
2620 Numerical analysis of the above equation, setting the computed rate to
2621 increase from rate_0 = 0 to rate_N = limit, shows that for large sending
2622 rates, p/i, the number of messages N = limit. So limit serves as both the
2623 maximum rate measured in messages per period, and the maximum number of
2624 messages that can be sent in a fast burst. */
2626 double this_time = (double)tv.tv_sec
2627 + (double)tv.tv_usec / 1000000.0;
2628 double prev_time = (double)dbd->time_stamp
2629 + (double)dbd->time_usec / 1000000.0;
2631 /* We must avoid division by zero, and deal gracefully with the clock going
2632 backwards. If we blunder ahead when time is in reverse then the computed
2633 rate will be bogus. To be safe we clamp interval to a very small number. */
2635 double interval = this_time - prev_time <= 0.0 ? 1e-9
2636 : this_time - prev_time;
2638 double i_over_p = interval / period;
2639 double a = exp(-i_over_p);
2641 /* Combine the instantaneous rate (period / interval) with the previous rate
2642 using the smoothing factor a. In order to measure sized events, multiply the
2643 instantaneous rate by the count of bytes or recipients etc. */
2645 dbd->time_stamp = tv.tv_sec;
2646 dbd->time_usec = tv.tv_usec;
2647 dbd->rate = (1 - a) * count / i_over_p + a * dbd->rate;
2649 /* When events are very widely spaced the computed rate tends towards zero.
2650 Although this is accurate it turns out not to be useful for our purposes,
2651 especially when the first event after a long silence is the start of a spam
2652 run. A more useful model is that the rate for an isolated event should be the
2653 size of the event per the period size, ignoring the lack of events outside
2654 the current period and regardless of where the event falls in the period. So,
2655 if the interval was so long that the calculated rate is unhelpfully small, we
2656 re-initialize the rate. In the absence of higher-rate bursts, the condition
2657 below is true if the interval is greater than the period. */
2659 if (dbd->rate < count) dbd->rate = count;
2662 /* Clients sending at the limit are considered to be over the limit.
2663 This matters for edge cases such as a limit of zero, when the client
2664 should be completely blocked. */
2666 rc = dbd->rate < limit ? FAIL : OK;
2668 /* Update the state if the rate is low or if we are being strict. If we
2669 are in leaky mode and the sender's rate is too high, we do not update
2670 the recorded rate in order to avoid an over-aggressive sender's retry
2671 rate preventing them from getting any email through. If readonly is set,
2672 neither leaky nor strict are set, so we do not do any updates. */
2674 if ((rc == FAIL && leaky) || strict)
2676 dbfn_write(dbm, key, dbdb, dbdb_size);
2677 HDEBUG(D_acl) debug_printf_indent("ratelimit db updated\n");
2681 HDEBUG(D_acl) debug_printf_indent("ratelimit db not updated: %s\n",
2682 readonly? "readonly mode" : "over the limit, but leaky");
2687 /* Store the result in the tree for future reference. */
2689 t = store_get(sizeof(tree_node) + Ustrlen(key));
2691 Ustrcpy(t->name, key);
2692 (void)tree_insertnode(anchor, t);
2694 /* We create the formatted version of the sender's rate very late in
2695 order to ensure that it is done using the correct storage pool. */
2697 store_pool = old_pool;
2698 sender_rate = string_sprintf("%.1f", dbd->rate);
2701 debug_printf_indent("ratelimit computed rate %s\n", sender_rate);
2708 /*************************************************
2709 * The udpsend ACL modifier *
2710 *************************************************/
2712 /* Called by acl_check_condition() below.
2715 arg the option string for udpsend=
2716 log_msgptr for error messages
2718 Returns: OK - Completed.
2719 DEFER - Problem with DNS lookup.
2720 ERROR - Syntax error in options.
2724 acl_udpsend(const uschar *arg, uschar **log_msgptr)
2736 hostname = string_nextinlist(&arg, &sep, NULL, 0);
2737 portstr = string_nextinlist(&arg, &sep, NULL, 0);
2741 *log_msgptr = US"missing destination host in \"udpsend\" modifier";
2746 *log_msgptr = US"missing destination port in \"udpsend\" modifier";
2751 *log_msgptr = US"missing datagram payload in \"udpsend\" modifier";
2754 portnum = Ustrtol(portstr, &portend, 10);
2755 if (*portend != '\0')
2757 *log_msgptr = US"bad destination port in \"udpsend\" modifier";
2761 /* Make a single-item host list. */
2762 h = store_get(sizeof(host_item));
2763 memset(h, 0, sizeof(host_item));
2768 if (string_is_ip_address(hostname, NULL))
2769 h->address = hostname, r = HOST_FOUND;
2771 r = host_find_byname(h, NULL, 0, NULL, FALSE);
2772 if (r == HOST_FIND_FAILED || r == HOST_FIND_AGAIN)
2774 *log_msgptr = US"DNS lookup failed in \"udpsend\" modifier";
2779 debug_printf_indent("udpsend [%s]:%d %s\n", h->address, portnum, arg);
2781 /*XXX this could better use sendto */
2782 r = s = ip_connectedsocket(SOCK_DGRAM, h->address, portnum, portnum,
2783 1, NULL, &errstr, NULL);
2784 if (r < 0) goto defer;
2786 r = send(s, arg, len, 0);
2789 errstr = US strerror(errno);
2797 string_sprintf("\"udpsend\" truncated from %d to %d octets", len, r);
2802 debug_printf_indent("udpsend %d bytes\n", r);
2807 *log_msgptr = string_sprintf("\"udpsend\" failed: %s", errstr);
2813 /*************************************************
2814 * Handle conditions/modifiers on an ACL item *
2815 *************************************************/
2817 /* Called from acl_check() below.
2821 cb ACL condition block - if NULL, result is OK
2822 where where called from
2823 addr the address being checked for RCPT, or NULL
2824 level the nesting level
2825 epp pointer to pass back TRUE if "endpass" encountered
2826 (applies only to "accept" and "discard")
2827 user_msgptr user message pointer
2828 log_msgptr log message pointer
2829 basic_errno pointer to where to put verify error
2831 Returns: OK - all conditions are met
2832 DISCARD - an "acl" condition returned DISCARD - only allowed
2833 for "accept" or "discard" verbs
2834 FAIL - at least one condition fails
2835 FAIL_DROP - an "acl" condition returned FAIL_DROP
2836 DEFER - can't tell at the moment (typically, lookup defer,
2837 but can be temporary callout problem)
2838 ERROR - ERROR from nested ACL or expansion failure or other
2843 acl_check_condition(int verb, acl_condition_block *cb, int where,
2844 address_item *addr, int level, BOOL *epp, uschar **user_msgptr,
2845 uschar **log_msgptr, int *basic_errno)
2847 uschar *user_message = NULL;
2848 uschar *log_message = NULL;
2850 #ifdef WITH_CONTENT_SCAN
2854 for (; cb; cb = cb->next)
2859 /* The message and log_message items set up messages to be used in
2860 case of rejection. They are expanded later. */
2862 if (cb->type == ACLC_MESSAGE)
2864 HDEBUG(D_acl) debug_printf_indent(" message: %s\n", cb->arg);
2865 user_message = cb->arg;
2869 if (cb->type == ACLC_LOG_MESSAGE)
2871 HDEBUG(D_acl) debug_printf_indent("l_message: %s\n", cb->arg);
2872 log_message = cb->arg;
2876 /* The endpass "condition" just sets a flag to show it occurred. This is
2877 checked at compile time to be on an "accept" or "discard" item. */
2879 if (cb->type == ACLC_ENDPASS)
2885 /* For other conditions and modifiers, the argument is expanded now for some
2886 of them, but not for all, because expansion happens down in some lower level
2887 checking functions in some cases. */
2889 if (!conditions[cb->type].expand_at_top)
2891 else if (!(arg = expand_string(cb->arg)))
2893 if (f.expand_string_forcedfail) continue;
2894 *log_msgptr = string_sprintf("failed to expand ACL string \"%s\": %s",
2895 cb->arg, expand_string_message);
2896 return f.search_find_defer ? DEFER : ERROR;
2899 /* Show condition, and expanded condition if it's different */
2904 debug_printf_indent("check %s%s %n",
2905 (!conditions[cb->type].is_modifier && cb->u.negated)? "!":"",
2906 conditions[cb->type].name, &lhswidth);
2908 if (cb->type == ACLC_SET)
2910 #ifndef DISABLE_DKIM
2911 if ( Ustrcmp(cb->u.varname, "dkim_verify_status") == 0
2912 || Ustrcmp(cb->u.varname, "dkim_verify_reason") == 0)
2914 debug_printf("%s ", cb->u.varname);
2920 debug_printf("acl_%s ", cb->u.varname);
2921 lhswidth += 5 + Ustrlen(cb->u.varname);
2925 debug_printf("= %s\n", cb->arg);
2928 debug_printf("%.*s= %s\n", lhswidth,
2932 /* Check that this condition makes sense at this time */
2934 if ((conditions[cb->type].forbids & (1 << where)) != 0)
2936 *log_msgptr = string_sprintf("cannot %s %s condition in %s ACL",
2937 conditions[cb->type].is_modifier ? "use" : "test",
2938 conditions[cb->type].name, acl_wherenames[where]);
2942 /* Run the appropriate test for each condition, or take the appropriate
2943 action for the remaining modifiers. */
2947 case ACLC_ADD_HEADER:
2951 /* A nested ACL that returns "discard" makes sense only for an "accept" or
2955 rc = acl_check_wargs(where, addr, arg, user_msgptr, log_msgptr);
2956 if (rc == DISCARD && verb != ACL_ACCEPT && verb != ACL_DISCARD)
2958 *log_msgptr = string_sprintf("nested ACL returned \"discard\" for "
2959 "\"%s\" command (only allowed with \"accept\" or \"discard\")",
2965 case ACLC_AUTHENTICATED:
2966 rc = sender_host_authenticated ? match_isinlist(sender_host_authenticated,
2967 &arg, 0, NULL, NULL, MCL_STRING, TRUE, NULL) : FAIL;
2970 #ifdef EXPERIMENTAL_BRIGHTMAIL
2971 case ACLC_BMI_OPTIN:
2973 int old_pool = store_pool;
2974 store_pool = POOL_PERM;
2975 bmi_current_optin = string_copy(arg);
2976 store_pool = old_pool;
2981 case ACLC_CONDITION:
2982 /* The true/false parsing here should be kept in sync with that used in
2983 expand.c when dealing with ECOND_BOOL so that we don't have too many
2984 different definitions of what can be a boolean. */
2986 ? Ustrspn(arg+1, "0123456789") == Ustrlen(arg+1) /* Negative number */
2987 : Ustrspn(arg, "0123456789") == Ustrlen(arg)) /* Digits, or empty */
2988 rc = (Uatoi(arg) == 0)? FAIL : OK;
2990 rc = (strcmpic(arg, US"no") == 0 ||
2991 strcmpic(arg, US"false") == 0)? FAIL :
2992 (strcmpic(arg, US"yes") == 0 ||
2993 strcmpic(arg, US"true") == 0)? OK : DEFER;
2995 *log_msgptr = string_sprintf("invalid \"condition\" value \"%s\"", arg);
2998 case ACLC_CONTINUE: /* Always succeeds */
3003 const uschar *p = NULL;
3004 control_type = decode_control(arg, &p, where, log_msgptr);
3006 /* Check if this control makes sense at this time */
3008 if (controls_list[control_type].forbids & (1 << where))
3010 *log_msgptr = string_sprintf("cannot use \"control=%s\" in %s ACL",
3011 controls_list[control_type].name, acl_wherenames[where]);
3015 switch(control_type)
3017 case CONTROL_AUTH_UNADVERTISED:
3018 f.allow_auth_unadvertised = TRUE;
3021 #ifdef EXPERIMENTAL_BRIGHTMAIL
3022 case CONTROL_BMI_RUN:
3027 #ifndef DISABLE_DKIM
3028 case CONTROL_DKIM_VERIFY:
3029 f.dkim_disable_verify = TRUE;
3030 #ifdef EXPERIMENTAL_DMARC
3031 /* Since DKIM was blocked, skip DMARC too */
3032 f.dmarc_disable_verify = TRUE;
3033 f.dmarc_enable_forensic = FALSE;
3038 #ifdef EXPERIMENTAL_DMARC
3039 case CONTROL_DMARC_VERIFY:
3040 f.dmarc_disable_verify = TRUE;
3043 case CONTROL_DMARC_FORENSIC:
3044 f.dmarc_enable_forensic = TRUE;
3051 int fd, af, level, optname, value;
3052 /* If we are acting on stdin, the setsockopt may fail if stdin is not
3053 a socket; we can accept that, we'll just debug-log failures anyway. */
3054 fd = fileno(smtp_in);
3055 af = ip_get_address_family(fd);
3059 debug_printf_indent("smtp input is probably not a socket [%s], not setting DSCP\n",
3063 if (dscp_lookup(p+1, af, &level, &optname, &value))
3065 if (setsockopt(fd, level, optname, &value, sizeof(value)) < 0)
3067 HDEBUG(D_acl) debug_printf_indent("failed to set input DSCP[%s]: %s\n",
3068 p+1, strerror(errno));
3072 HDEBUG(D_acl) debug_printf_indent("set input DSCP to \"%s\"\n", p+1);
3077 *log_msgptr = string_sprintf("unrecognised DSCP value in \"control=%s\"", arg);
3083 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
3091 case CONTROL_CASEFUL_LOCAL_PART:
3092 deliver_localpart = addr->cc_local_part;
3095 case CONTROL_CASELOWER_LOCAL_PART:
3096 deliver_localpart = addr->lc_local_part;
3099 case CONTROL_ENFORCE_SYNC:
3100 smtp_enforce_sync = TRUE;
3103 case CONTROL_NO_ENFORCE_SYNC:
3104 smtp_enforce_sync = FALSE;
3107 #ifdef WITH_CONTENT_SCAN
3108 case CONTROL_NO_MBOX_UNSPOOL:
3109 f.no_mbox_unspool = TRUE;
3113 case CONTROL_NO_MULTILINE:
3114 f.no_multiline_responses = TRUE;
3117 case CONTROL_NO_PIPELINING:
3118 f.pipelining_enable = FALSE;
3121 case CONTROL_NO_DELAY_FLUSH:
3122 f.disable_delay_flush = TRUE;
3125 case CONTROL_NO_CALLOUT_FLUSH:
3126 f.disable_callout_flush = TRUE;
3129 case CONTROL_FAKEREJECT:
3130 cancel_cutthrough_connection(TRUE, US"fakereject");
3131 case CONTROL_FAKEDEFER:
3132 fake_response = (control_type == CONTROL_FAKEDEFER) ? DEFER : FAIL;
3135 const uschar *pp = p + 1;
3137 fake_response_text = expand_string(string_copyn(p+1, pp-p-1));
3142 /* Explicitly reset to default string */
3143 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).";
3147 case CONTROL_FREEZE:
3148 f.deliver_freeze = TRUE;
3149 deliver_frozen_at = time(NULL);
3150 freeze_tell = freeze_tell_config; /* Reset to configured value */
3151 if (Ustrncmp(p, "/no_tell", 8) == 0)
3158 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
3161 cancel_cutthrough_connection(TRUE, US"item frozen");
3164 case CONTROL_QUEUE_ONLY:
3165 f.queue_only_policy = TRUE;
3166 cancel_cutthrough_connection(TRUE, US"queueing forced");
3169 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_REQUIRETLS)
3170 case CONTROL_REQUIRETLS:
3171 tls_requiretls |= REQUIRETLS_MSG;
3174 case CONTROL_SUBMISSION:
3175 originator_name = US"";
3176 f.submission_mode = TRUE;
3179 if (Ustrncmp(p, "/sender_retain", 14) == 0)
3182 f.active_local_sender_retain = TRUE;
3183 f.active_local_from_check = FALSE;
3185 else if (Ustrncmp(p, "/domain=", 8) == 0)
3187 const uschar *pp = p + 8;
3188 while (*pp && *pp != '/') pp++;
3189 submission_domain = string_copyn(p+8, pp-p-8);
3192 /* The name= option must be last, because it swallows the rest of
3194 else if (Ustrncmp(p, "/name=", 6) == 0)
3196 const uschar *pp = p + 6;
3198 submission_name = string_copy(parse_fix_phrase(p+6, pp-p-6,
3199 big_buffer, big_buffer_size));
3206 *log_msgptr = string_sprintf("syntax error in \"control=%s\"", arg);
3213 uschar * debug_tag = NULL;
3214 uschar * debug_opts = NULL;
3219 const uschar * pp = p+1;
3220 if (Ustrncmp(pp, "tag=", 4) == 0)
3222 for (pp += 4; *pp && *pp != '/';) pp++;
3223 debug_tag = string_copyn(p+5, pp-p-5);
3225 else if (Ustrncmp(pp, "opts=", 5) == 0)
3227 for (pp += 5; *pp && *pp != '/';) pp++;
3228 debug_opts = string_copyn(p+6, pp-p-6);
3230 else if (Ustrncmp(pp, "kill", 4) == 0)
3232 for (pp += 4; *pp && *pp != '/';) pp++;
3236 while (*pp && *pp != '/') pp++;
3241 debug_logging_stop();
3243 debug_logging_activate(debug_tag, debug_opts);
3247 case CONTROL_SUPPRESS_LOCAL_FIXUPS:
3248 f.suppress_local_fixups = TRUE;
3251 case CONTROL_CUTTHROUGH_DELIVERY:
3253 uschar * ignored = NULL;
3254 #ifndef DISABLE_PRDR
3259 /* Too hard to think about for now. We might in future cutthrough
3260 the case where both sides handle prdr and this-node prdr acl
3262 ignored = US"PRDR active";
3265 if (f.deliver_freeze)
3266 ignored = US"frozen";
3267 else if (f.queue_only_policy)
3268 ignored = US"queue-only";
3269 else if (fake_response == FAIL)
3270 ignored = US"fakereject";
3273 if (rcpt_count == 1)
3275 cutthrough.delivery = TRUE; /* control accepted */
3278 const uschar * pp = p+1;
3279 if (Ustrncmp(pp, "defer=", 6) == 0)
3282 if (Ustrncmp(pp, "pass", 4) == 0) cutthrough.defer_pass = TRUE;
3283 /* else if (Ustrncmp(pp, "spool") == 0) ; default */
3286 while (*pp && *pp != '/') pp++;
3291 ignored = US"nonfirst rcpt";
3294 DEBUG(D_acl) if (ignored)
3295 debug_printf(" cutthrough request ignored on %s item\n", ignored);
3300 case CONTROL_UTF8_DOWNCONVERT:
3305 message_utf8_downconvert = 1;
3306 addr->prop.utf8_downcvt = TRUE;
3307 addr->prop.utf8_downcvt_maybe = FALSE;
3313 message_utf8_downconvert = 0;
3314 addr->prop.utf8_downcvt = FALSE;
3315 addr->prop.utf8_downcvt_maybe = FALSE;
3319 if (p[1] == '-' && p[2] == '1')
3321 message_utf8_downconvert = -1;
3322 addr->prop.utf8_downcvt = FALSE;
3323 addr->prop.utf8_downcvt_maybe = TRUE;
3327 *log_msgptr = US"bad option value for control=utf8_downconvert";
3331 message_utf8_downconvert = 1;
3332 addr->prop.utf8_downcvt = TRUE;
3333 addr->prop.utf8_downcvt_maybe = FALSE;
3343 #ifdef EXPERIMENTAL_DCC
3346 /* Separate the regular expression and any optional parameters. */
3347 const uschar * list = arg;
3348 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
3349 /* Run the dcc backend. */
3350 rc = dcc_process(&ss);
3351 /* Modify return code based upon the existence of options. */
3352 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size)))
3353 if (strcmpic(ss, US"defer_ok") == 0 && rc == DEFER)
3354 rc = FAIL; /* FAIL so that the message is passed to the next ACL */
3359 #ifdef WITH_CONTENT_SCAN
3361 rc = mime_decode(&arg);
3367 int delay = readconf_readtime(arg, 0, FALSE);
3370 *log_msgptr = string_sprintf("syntax error in argument for \"delay\" "
3371 "modifier: \"%s\" is not a time value", arg);
3376 HDEBUG(D_acl) debug_printf_indent("delay modifier requests %d-second delay\n",
3381 debug_printf_indent("delay skipped in -bh checking mode\n");
3384 /* NOTE 1: Remember that we may be
3385 dealing with stdin/stdout here, in addition to TCP/IP connections.
3386 Also, delays may be specified for non-SMTP input, where smtp_out and
3387 smtp_in will be NULL. Whatever is done must work in all cases.
3389 NOTE 2: The added feature of flushing the output before a delay must
3390 apply only to SMTP input. Hence the test for smtp_out being non-NULL.
3395 if (smtp_out && !f.disable_delay_flush)
3398 #if !defined(NO_POLL_H) && defined (POLLRDHUP)
3404 p.fd = fileno(smtp_out);
3405 p.events = POLLRDHUP;
3408 if (poll(&p, n, delay*1000) > 0)
3409 HDEBUG(D_acl) debug_printf_indent("delay cancelled by peer close\n");
3412 /* Lacking POLLRDHUP it appears to be impossible to detect that a
3413 TCP/IP connection has gone away without reading from it. This means
3414 that we cannot shorten the delay below if the client goes away,
3415 because we cannot discover that the client has closed its end of the
3416 connection. (The connection is actually in a half-closed state,
3417 waiting for the server to close its end.) It would be nice to be able
3418 to detect this state, so that the Exim process is not held up
3419 unnecessarily. However, it seems that we can't. The poll() function
3420 does not do the right thing, and in any case it is not always
3423 while (delay > 0) delay = sleep(delay);
3430 #ifndef DISABLE_DKIM
3431 case ACLC_DKIM_SIGNER:
3432 if (dkim_cur_signer)
3433 rc = match_isinlist(dkim_cur_signer,
3434 &arg,0,NULL,NULL,MCL_STRING,TRUE,NULL);
3439 case ACLC_DKIM_STATUS:
3440 rc = match_isinlist(dkim_verify_status,
3441 &arg,0,NULL,NULL,MCL_STRING,TRUE,NULL);
3445 #ifdef EXPERIMENTAL_DMARC
3446 case ACLC_DMARC_STATUS:
3447 if (!f.dmarc_has_been_checked)
3449 f.dmarc_has_been_checked = TRUE;
3450 /* used long way of dmarc_exim_expand_query() in case we need more
3451 * view into the process in the future. */
3452 rc = match_isinlist(dmarc_exim_expand_query(DMARC_VERIFY_STATUS),
3453 &arg,0,NULL,NULL,MCL_STRING,TRUE,NULL);
3458 rc = verify_check_dnsbl(where, &arg, log_msgptr);
3462 rc = match_isinlist(addr->domain, &arg, 0, &domainlist_anchor,
3463 addr->domain_cache, MCL_DOMAIN, TRUE, CUSS &deliver_domain_data);
3466 /* The value in tls_cipher is the full cipher name, for example,
3467 TLSv1:DES-CBC3-SHA:168, whereas the values to test for are just the
3468 cipher names such as DES-CBC3-SHA. But program defensively. We don't know
3469 what may in practice come out of the SSL library - which at the time of
3470 writing is poorly documented. */
3472 case ACLC_ENCRYPTED:
3473 if (tls_in.cipher == NULL) rc = FAIL; else
3475 uschar *endcipher = NULL;
3476 uschar *cipher = Ustrchr(tls_in.cipher, ':');
3477 if (cipher == NULL) cipher = tls_in.cipher; else
3479 endcipher = Ustrchr(++cipher, ':');
3480 if (endcipher != NULL) *endcipher = 0;
3482 rc = match_isinlist(cipher, &arg, 0, NULL, NULL, MCL_STRING, TRUE, NULL);
3483 if (endcipher != NULL) *endcipher = ':';
3487 /* Use verify_check_this_host() instead of verify_check_host() so that
3488 we can pass over &host_data to catch any looked up data. Once it has been
3489 set, it retains its value so that it's still there if another ACL verb
3490 comes through here and uses the cache. However, we must put it into
3491 permanent store in case it is also expected to be used in a subsequent
3492 message in the same SMTP connection. */
3495 rc = verify_check_this_host(&arg, sender_host_cache, NULL,
3496 (sender_host_address == NULL)? US"" : sender_host_address,
3498 if (rc == DEFER) *log_msgptr = search_error_message;
3499 if (host_data) host_data = string_copy_malloc(host_data);
3502 case ACLC_LOCAL_PARTS:
3503 rc = match_isinlist(addr->cc_local_part, &arg, 0,
3504 &localpartlist_anchor, addr->localpart_cache, MCL_LOCALPART, TRUE,
3505 CUSS &deliver_localpart_data);
3508 case ACLC_LOG_REJECT_TARGET:
3512 const uschar *s = arg;
3514 while ((ss = string_nextinlist(&s, &sep, big_buffer, big_buffer_size)))
3516 if (Ustrcmp(ss, "main") == 0) logbits |= LOG_MAIN;
3517 else if (Ustrcmp(ss, "panic") == 0) logbits |= LOG_PANIC;
3518 else if (Ustrcmp(ss, "reject") == 0) logbits |= LOG_REJECT;
3521 logbits |= LOG_MAIN|LOG_REJECT;
3522 log_write(0, LOG_MAIN|LOG_PANIC, "unknown log name \"%s\" in "
3523 "\"log_reject_target\" in %s ACL", ss, acl_wherenames[where]);
3526 log_reject_target = logbits;
3533 const uschar *s = arg;
3539 if (Ustrncmp(s, "main", 4) == 0)
3540 { logbits |= LOG_MAIN; s += 4; }
3541 else if (Ustrncmp(s, "panic", 5) == 0)
3542 { logbits |= LOG_PANIC; s += 5; }
3543 else if (Ustrncmp(s, "reject", 6) == 0)
3544 { logbits |= LOG_REJECT; s += 6; }
3547 logbits = LOG_MAIN|LOG_PANIC;
3548 s = string_sprintf(":unknown log name in \"%s\" in "
3549 "\"logwrite\" in %s ACL", arg, acl_wherenames[where]);
3555 while (isspace(*s)) s++;
3557 if (logbits == 0) logbits = LOG_MAIN;
3558 log_write(0, logbits, "%s", string_printing(s));
3562 #ifdef WITH_CONTENT_SCAN
3563 case ACLC_MALWARE: /* Run the malware backend. */
3565 /* Separate the regular expression and any optional parameters. */
3566 const uschar * list = arg;
3567 uschar * ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
3569 BOOL defer_ok = FALSE;
3572 while ((opt = string_nextinlist(&list, &sep, NULL, 0)))
3573 if (strcmpic(opt, US"defer_ok") == 0)
3575 else if ( strncmpic(opt, US"tmo=", 4) == 0
3576 && (timeout = readconf_readtime(opt+4, '\0', FALSE)) < 0
3579 *log_msgptr = string_sprintf("bad timeout value in '%s'", opt);
3583 rc = malware(ss, timeout);
3584 if (rc == DEFER && defer_ok)
3585 rc = FAIL; /* FAIL so that the message is passed to the next ACL */
3589 case ACLC_MIME_REGEX:
3590 rc = mime_regex(&arg);
3595 if (Ustrchr(arg, '/'))
3597 *log_msgptr = string_sprintf(
3598 "Directory separator not permitted in queue name: '%s'", arg);
3601 queue_name = string_copy_malloc(arg);
3604 case ACLC_RATELIMIT:
3605 rc = acl_ratelimit(arg, where, log_msgptr);
3608 case ACLC_RECIPIENTS:
3609 rc = match_address_list(CUS addr->address, TRUE, TRUE, &arg, NULL, -1, 0,
3610 CUSS &recipient_data);
3613 #ifdef WITH_CONTENT_SCAN
3619 case ACLC_REMOVE_HEADER:
3620 setup_remove_header(arg);
3623 case ACLC_SENDER_DOMAINS:
3626 sdomain = Ustrrchr(sender_address, '@');
3627 sdomain = sdomain ? sdomain + 1 : US"";
3628 rc = match_isinlist(sdomain, &arg, 0, &domainlist_anchor,
3629 sender_domain_cache, MCL_DOMAIN, TRUE, NULL);
3634 rc = match_address_list(CUS sender_address, TRUE, TRUE, &arg,
3635 sender_address_cache, -1, 0, CUSS &sender_data);
3638 /* Connection variables must persist forever */
3642 int old_pool = store_pool;
3643 if ( cb->u.varname[0] == 'c'
3644 #ifndef DISABLE_DKIM
3645 || cb->u.varname[0] == 'd'
3647 #ifndef DISABLE_EVENT
3648 || event_name /* An event is being delivered */
3651 store_pool = POOL_PERM;
3652 #ifndef DISABLE_DKIM /* Overwriteable dkim result variables */
3653 if (Ustrcmp(cb->u.varname, "dkim_verify_status") == 0)
3654 dkim_verify_status = string_copy(arg);
3655 else if (Ustrcmp(cb->u.varname, "dkim_verify_reason") == 0)
3656 dkim_verify_reason = string_copy(arg);
3659 acl_var_create(cb->u.varname)->data.ptr = string_copy(arg);
3660 store_pool = old_pool;
3664 #ifdef WITH_CONTENT_SCAN
3667 /* Separate the regular expression and any optional parameters. */
3668 const uschar * list = arg;
3669 uschar *ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size);
3671 rc = spam(CUSS &ss);
3672 /* Modify return code based upon the existence of options. */
3673 while ((ss = string_nextinlist(&list, &sep, big_buffer, big_buffer_size)))
3674 if (strcmpic(ss, US"defer_ok") == 0 && rc == DEFER)
3675 rc = FAIL; /* FAIL so that the message is passed to the next ACL */
3682 rc = spf_process(&arg, sender_address, SPF_PROCESS_NORMAL);
3684 case ACLC_SPF_GUESS:
3685 rc = spf_process(&arg, sender_address, SPF_PROCESS_GUESS);
3690 rc = acl_udpsend(arg, log_msgptr);
3693 /* If the verb is WARN, discard any user message from verification, because
3694 such messages are SMTP responses, not header additions. The latter come
3695 only from explicit "message" modifiers. However, put the user message into
3696 $acl_verify_message so it can be used in subsequent conditions or modifiers
3697 (until something changes it). */
3700 rc = acl_verify(where, addr, arg, user_msgptr, log_msgptr, basic_errno);
3702 acl_verify_message = *user_msgptr;
3703 if (verb == ACL_WARN) *user_msgptr = NULL;
3707 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "internal ACL error: unknown "
3708 "condition %d", cb->type);
3712 /* If a condition was negated, invert OK/FAIL. */
3714 if (!conditions[cb->type].is_modifier && cb->u.negated)
3715 if (rc == OK) rc = FAIL;
3716 else if (rc == FAIL || rc == FAIL_DROP) rc = OK;
3718 if (rc != OK) break; /* Conditions loop */
3722 /* If the result is the one for which "message" and/or "log_message" are used,
3723 handle the values of these modifiers. If there isn't a log message set, we make
3724 it the same as the user message.
3726 "message" is a user message that will be included in an SMTP response. Unless
3727 it is empty, it overrides any previously set user message.
3729 "log_message" is a non-user message, and it adds to any existing non-user
3730 message that is already set.
3732 Most verbs have but a single return for which the messages are relevant, but
3733 for "discard", it's useful to have the log message both when it succeeds and
3734 when it fails. For "accept", the message is used in the OK case if there is no
3735 "endpass", but (for backwards compatibility) in the FAIL case if "endpass" is
3738 if (*epp && rc == OK) user_message = NULL;
3740 if ((BIT(rc) & msgcond[verb]) != 0)
3743 uschar *old_user_msgptr = *user_msgptr;
3744 uschar *old_log_msgptr = (*log_msgptr != NULL)? *log_msgptr : old_user_msgptr;
3746 /* If the verb is "warn", messages generated by conditions (verification or
3747 nested ACLs) are always discarded. This also happens for acceptance verbs
3748 when they actually do accept. Only messages specified at this level are used.
3749 However, the value of an existing message is available in $acl_verify_message
3750 during expansions. */
3752 if (verb == ACL_WARN ||
3753 (rc == OK && (verb == ACL_ACCEPT || verb == ACL_DISCARD)))
3754 *log_msgptr = *user_msgptr = NULL;
3758 acl_verify_message = old_user_msgptr;
3759 expmessage = expand_string(user_message);
3762 if (!f.expand_string_forcedfail)
3763 log_write(0, LOG_MAIN|LOG_PANIC, "failed to expand ACL message \"%s\": %s",
3764 user_message, expand_string_message);
3766 else if (expmessage[0] != 0) *user_msgptr = expmessage;
3771 acl_verify_message = old_log_msgptr;
3772 expmessage = expand_string(log_message);
3775 if (!f.expand_string_forcedfail)
3776 log_write(0, LOG_MAIN|LOG_PANIC, "failed to expand ACL message \"%s\": %s",
3777 log_message, expand_string_message);
3779 else if (expmessage[0] != 0)
3781 *log_msgptr = (*log_msgptr == NULL)? expmessage :
3782 string_sprintf("%s: %s", expmessage, *log_msgptr);
3786 /* If no log message, default it to the user message */
3788 if (!*log_msgptr) *log_msgptr = *user_msgptr;
3791 acl_verify_message = NULL;
3799 /*************************************************
3800 * Get line from a literal ACL *
3801 *************************************************/
3803 /* This function is passed to acl_read() in order to extract individual lines
3804 of a literal ACL, which we access via static pointers. We can destroy the
3805 contents because this is called only once (the compiled ACL is remembered).
3807 This code is intended to treat the data in the same way as lines in the main
3808 Exim configuration file. That is:
3810 . Leading spaces are ignored.
3812 . A \ at the end of a line is a continuation - trailing spaces after the \
3813 are permitted (this is because I don't believe in making invisible things
3814 significant). Leading spaces on the continued part of a line are ignored.
3816 . Physical lines starting (significantly) with # are totally ignored, and
3817 may appear within a sequence of backslash-continued lines.
3819 . Blank lines are ignored, but will end a sequence of continuations.
3822 Returns: a pointer to the next line
3826 static uschar *acl_text; /* Current pointer in the text */
3827 static uschar *acl_text_end; /* Points one past the terminating '0' */
3835 /* This loop handles leading blank lines and comments. */
3839 while (isspace(*acl_text)) acl_text++; /* Leading spaces/empty lines */
3840 if (*acl_text == 0) return NULL; /* No more data */
3841 yield = acl_text; /* Potential data line */
3843 while (*acl_text && *acl_text != '\n') acl_text++;
3845 /* If we hit the end before a newline, we have the whole logical line. If
3846 it's a comment, there's no more data to be given. Otherwise, yield it. */
3848 if (*acl_text == 0) return (*yield == '#')? NULL : yield;
3850 /* After reaching a newline, end this loop if the physical line does not
3851 start with '#'. If it does, it's a comment, and the loop continues. */
3853 if (*yield != '#') break;
3856 /* This loop handles continuations. We know we have some real data, ending in
3857 newline. See if there is a continuation marker at the end (ignoring trailing
3858 white space). We know that *yield is not white space, so no need to test for
3859 cont > yield in the backwards scanning loop. */
3864 for (cont = acl_text - 1; isspace(*cont); cont--);
3866 /* If no continuation follows, we are done. Mark the end of the line and
3875 /* We have encountered a continuation. Skip over whitespace at the start of
3876 the next line, and indeed the whole of the next line or lines if they are
3881 while (*(++acl_text) == ' ' || *acl_text == '\t');
3882 if (*acl_text != '#') break;
3883 while (*(++acl_text) != 0 && *acl_text != '\n');
3886 /* We have the start of a continuation line. Move all the rest of the data
3887 to join onto the previous line, and then find its end. If the end is not a
3888 newline, we are done. Otherwise loop to look for another continuation. */
3890 memmove(cont, acl_text, acl_text_end - acl_text);
3891 acl_text_end -= acl_text - cont;
3893 while (*acl_text != 0 && *acl_text != '\n') acl_text++;
3894 if (*acl_text == 0) return yield;
3897 /* Control does not reach here */
3904 /*************************************************
3905 * Check access using an ACL *
3906 *************************************************/
3908 /* This function is called from address_check. It may recurse via
3909 acl_check_condition() - hence the use of a level to stop looping. The ACL is
3910 passed as a string which is expanded. A forced failure implies no access check
3911 is required. If the result is a single word, it is taken as the name of an ACL
3912 which is sought in the global ACL tree. Otherwise, it is taken as literal ACL
3913 text, complete with newlines, and parsed as such. In both cases, the ACL check
3914 is then run. This function uses an auxiliary function for acl_read() to call
3915 for reading individual lines of a literal ACL. This is acl_getline(), which
3916 appears immediately above.
3919 where where called from
3920 addr address item when called from RCPT; otherwise NULL
3921 s the input string; NULL is the same as an empty ACL => DENY
3922 user_msgptr where to put a user error (for SMTP response)
3923 log_msgptr where to put a logging message (not for SMTP response)
3925 Returns: OK access is granted
3926 DISCARD access is apparently granted...
3927 FAIL access is denied
3928 FAIL_DROP access is denied; drop the connection
3929 DEFER can't tell at the moment
3934 acl_check_internal(int where, address_item *addr, uschar *s,
3935 uschar **user_msgptr, uschar **log_msgptr)
3938 acl_block *acl = NULL;
3939 uschar *acl_name = US"inline ACL";
3942 /* Catch configuration loops */
3946 *log_msgptr = US"ACL nested too deep: possible loop";
3952 HDEBUG(D_acl) debug_printf_indent("ACL is NULL: implicit DENY\n");
3956 /* At top level, we expand the incoming string. At lower levels, it has already
3957 been expanded as part of condition processing. */
3961 if (!(ss = expand_string(s)))
3963 if (f.expand_string_forcedfail) return OK;
3964 *log_msgptr = string_sprintf("failed to expand ACL string \"%s\": %s", s,
3965 expand_string_message);
3971 while (isspace(*ss)) ss++;
3973 /* If we can't find a named ACL, the default is to parse it as an inline one.
3974 (Unless it begins with a slash; non-existent files give rise to an error.) */
3978 /* Handle the case of a string that does not contain any spaces. Look for a
3979 named ACL among those read from the configuration, or a previously read file.
3980 It is possible that the pointer to the ACL is NULL if the configuration
3981 contains a name with no data. If not found, and the text begins with '/',
3982 read an ACL from a file, and save it so it can be re-used. */
3984 if (Ustrchr(ss, ' ') == NULL)
3986 tree_node *t = tree_search(acl_anchor, ss);
3989 acl = (acl_block *)(t->data.ptr);
3992 HDEBUG(D_acl) debug_printf_indent("ACL \"%s\" is empty: implicit DENY\n", ss);
3995 acl_name = string_sprintf("ACL \"%s\"", ss);
3996 HDEBUG(D_acl) debug_printf_indent("using ACL \"%s\"\n", ss);
3999 else if (*ss == '/')
4001 struct stat statbuf;
4002 fd = Uopen(ss, O_RDONLY, 0);
4005 *log_msgptr = string_sprintf("failed to open ACL file \"%s\": %s", ss,
4010 if (fstat(fd, &statbuf) != 0)
4012 *log_msgptr = string_sprintf("failed to fstat ACL file \"%s\": %s", ss,
4017 acl_text = store_get(statbuf.st_size + 1);
4018 acl_text_end = acl_text + statbuf.st_size + 1;
4020 if (read(fd, acl_text, statbuf.st_size) != statbuf.st_size)
4022 *log_msgptr = string_sprintf("failed to read ACL file \"%s\": %s",
4023 ss, strerror(errno));
4026 acl_text[statbuf.st_size] = 0;
4029 acl_name = string_sprintf("ACL \"%s\"", ss);
4030 HDEBUG(D_acl) debug_printf_indent("read ACL from file %s\n", ss);
4034 /* Parse an ACL that is still in text form. If it came from a file, remember it
4035 in the ACL tree, having read it into the POOL_PERM store pool so that it
4036 persists between multiple messages. */
4040 int old_pool = store_pool;
4041 if (fd >= 0) store_pool = POOL_PERM;
4042 acl = acl_read(acl_getline, log_msgptr);
4043 store_pool = old_pool;
4044 if (!acl && *log_msgptr) return ERROR;
4047 tree_node *t = store_get_perm(sizeof(tree_node) + Ustrlen(ss));
4048 Ustrcpy(t->name, ss);
4050 (void)tree_insertnode(&acl_anchor, t);
4054 /* Now we have an ACL to use. It's possible it may be NULL. */
4059 int basic_errno = 0;
4060 BOOL endpass_seen = FALSE;
4061 BOOL acl_quit_check = acl_level == 0
4062 && (where == ACL_WHERE_QUIT || where == ACL_WHERE_NOTQUIT);
4064 *log_msgptr = *user_msgptr = NULL;
4065 f.acl_temp_details = FALSE;
4067 HDEBUG(D_acl) debug_printf_indent("processing \"%s\"\n", verbs[acl->verb]);
4069 /* Clear out any search error message from a previous check before testing
4072 search_error_message = NULL;
4073 cond = acl_check_condition(acl->verb, acl->condition, where, addr, acl_level,
4074 &endpass_seen, user_msgptr, log_msgptr, &basic_errno);
4076 /* Handle special returns: DEFER causes a return except on a WARN verb;
4077 ERROR always causes a return. */
4082 HDEBUG(D_acl) debug_printf_indent("%s: condition test deferred in %s\n", verbs[acl->verb], acl_name);
4083 if (basic_errno != ERRNO_CALLOUTDEFER)
4085 if (search_error_message != NULL && *search_error_message != 0)
4086 *log_msgptr = search_error_message;
4087 if (smtp_return_error_details) f.acl_temp_details = TRUE;
4090 f.acl_temp_details = TRUE;
4091 if (acl->verb != ACL_WARN) return DEFER;
4094 default: /* Paranoia */
4096 HDEBUG(D_acl) debug_printf_indent("%s: condition test error in %s\n", verbs[acl->verb], acl_name);
4100 HDEBUG(D_acl) debug_printf_indent("%s: condition test succeeded in %s\n",
4101 verbs[acl->verb], acl_name);
4105 HDEBUG(D_acl) debug_printf_indent("%s: condition test failed in %s\n", verbs[acl->verb], acl_name);
4108 /* DISCARD and DROP can happen only from a nested ACL condition, and
4109 DISCARD can happen only for an "accept" or "discard" verb. */
4112 HDEBUG(D_acl) debug_printf_indent("%s: condition test yielded \"discard\" in %s\n",
4113 verbs[acl->verb], acl_name);
4117 HDEBUG(D_acl) debug_printf_indent("%s: condition test yielded \"drop\" in %s\n",
4118 verbs[acl->verb], acl_name);
4122 /* At this point, cond for most verbs is either OK or FAIL or (as a result of
4123 a nested ACL condition) FAIL_DROP. However, for WARN, cond may be DEFER, and
4124 for ACCEPT and DISCARD, it may be DISCARD after a nested ACL call. */
4129 if (cond == OK || cond == DISCARD)
4131 HDEBUG(D_acl) debug_printf_indent("end of %s: ACCEPT\n", acl_name);
4136 HDEBUG(D_acl) debug_printf_indent("accept: endpass encountered - denying access\n");
4144 HDEBUG(D_acl) debug_printf_indent("end of %s: DEFER\n", acl_name);
4145 if (acl_quit_check) goto badquit;
4146 f.acl_temp_details = TRUE;
4154 HDEBUG(D_acl) debug_printf_indent("end of %s: DENY\n", acl_name);
4155 if (acl_quit_check) goto badquit;
4161 if (cond == OK || cond == DISCARD)
4163 HDEBUG(D_acl) debug_printf_indent("end of %s: DISCARD\n", acl_name);
4164 if (acl_quit_check) goto badquit;
4169 HDEBUG(D_acl) debug_printf_indent("discard: endpass encountered - denying access\n");
4177 HDEBUG(D_acl) debug_printf_indent("end of %s: DROP\n", acl_name);
4178 if (acl_quit_check) goto badquit;
4186 HDEBUG(D_acl) debug_printf_indent("end of %s: not OK\n", acl_name);
4187 if (acl_quit_check) goto badquit;
4194 acl_warn(where, *user_msgptr, *log_msgptr);
4195 else if (cond == DEFER && LOGGING(acl_warn_skipped))
4196 log_write(0, LOG_MAIN, "%s Warning: ACL \"warn\" statement skipped: "
4197 "condition test deferred%s%s", host_and_ident(TRUE),
4198 (*log_msgptr == NULL)? US"" : US": ",
4199 (*log_msgptr == NULL)? US"" : *log_msgptr);
4200 *log_msgptr = *user_msgptr = NULL; /* In case implicit DENY follows */
4204 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "internal ACL error: unknown verb %d",
4209 /* Pass to the next ACL item */
4214 /* We have reached the end of the ACL. This is an implicit DENY. */
4216 HDEBUG(D_acl) debug_printf_indent("end of %s: implicit DENY\n", acl_name);
4220 *log_msgptr = string_sprintf("QUIT or not-QUIT toplevel ACL may not fail "
4221 "('%s' verb used incorrectly)", verbs[acl->verb]);
4228 /* Same args as acl_check_internal() above, but the string s is
4229 the name of an ACL followed optionally by up to 9 space-separated arguments.
4230 The name and args are separately expanded. Args go into $acl_arg globals. */
4232 acl_check_wargs(int where, address_item *addr, const uschar *s,
4233 uschar **user_msgptr, uschar **log_msgptr)
4236 uschar * tmp_arg[9]; /* must match acl_arg[] */
4237 uschar * sav_arg[9]; /* must match acl_arg[] */
4243 if (!(tmp = string_dequote(&s)) || !(name = expand_string(tmp)))
4246 for (i = 0; i < 9; i++)
4248 while (*s && isspace(*s)) s++;
4250 if (!(tmp = string_dequote(&s)) || !(tmp_arg[i] = expand_string(tmp)))
4257 sav_narg = acl_narg;
4259 for (i = 0; i < acl_narg; i++)
4261 sav_arg[i] = acl_arg[i];
4262 acl_arg[i] = tmp_arg[i];
4266 sav_arg[i] = acl_arg[i];
4267 acl_arg[i++] = NULL;
4271 ret = acl_check_internal(where, addr, name, user_msgptr, log_msgptr);
4274 acl_narg = sav_narg;
4275 for (i = 0; i < 9; i++) acl_arg[i] = sav_arg[i];
4279 if (f.expand_string_forcedfail) return ERROR;
4280 *log_msgptr = string_sprintf("failed to expand ACL string \"%s\": %s",
4281 tmp, expand_string_message);
4282 return f.search_find_defer ? DEFER : ERROR;
4287 /*************************************************
4288 * Check access using an ACL *
4289 *************************************************/
4291 /* Alternate interface for ACL, used by expansions */
4293 acl_eval(int where, uschar *s, uschar **user_msgptr, uschar **log_msgptr)
4296 address_item *addr = NULL;
4299 *user_msgptr = *log_msgptr = NULL;
4300 sender_verified_failed = NULL;
4301 ratelimiters_cmd = NULL;
4302 log_reject_target = LOG_MAIN|LOG_REJECT;
4304 if (where == ACL_WHERE_RCPT)
4306 adb = address_defaults;
4308 addr->address = expand_string(US"$local_part@$domain");
4309 addr->domain = deliver_domain;
4310 addr->local_part = deliver_localpart;
4311 addr->cc_local_part = deliver_localpart;
4312 addr->lc_local_part = deliver_localpart;
4316 rc = acl_check_internal(where, addr, s, user_msgptr, log_msgptr);
4323 /* This is the external interface for ACL checks. It sets up an address and the
4324 expansions for $domain and $local_part when called after RCPT, then calls
4325 acl_check_internal() to do the actual work.
4328 where ACL_WHERE_xxxx indicating where called from
4329 recipient RCPT address for RCPT check, else NULL
4330 s the input string; NULL is the same as an empty ACL => DENY
4331 user_msgptr where to put a user error (for SMTP response)
4332 log_msgptr where to put a logging message (not for SMTP response)
4334 Returns: OK access is granted by an ACCEPT verb
4335 DISCARD access is granted by a DISCARD verb
4336 FAIL access is denied
4337 FAIL_DROP access is denied; drop the connection
4338 DEFER can't tell at the moment
4341 int acl_where = ACL_WHERE_UNKNOWN;
4344 acl_check(int where, uschar *recipient, uschar *s, uschar **user_msgptr,
4345 uschar **log_msgptr)
4349 address_item *addr = NULL;
4351 *user_msgptr = *log_msgptr = NULL;
4352 sender_verified_failed = NULL;
4353 ratelimiters_cmd = NULL;
4354 log_reject_target = LOG_MAIN|LOG_REJECT;
4356 #ifndef DISABLE_PRDR
4357 if (where==ACL_WHERE_RCPT || where==ACL_WHERE_VRFY || where==ACL_WHERE_PRDR)
4359 if (where==ACL_WHERE_RCPT || where==ACL_WHERE_VRFY)
4362 adb = address_defaults;
4364 addr->address = recipient;
4365 if (deliver_split_address(addr) == DEFER)
4367 *log_msgptr = US"defer in percent_hack_domains check";
4371 if ((addr->prop.utf8_msg = message_smtputf8))
4373 addr->prop.utf8_downcvt = message_utf8_downconvert == 1;
4374 addr->prop.utf8_downcvt_maybe = message_utf8_downconvert == -1;
4377 deliver_domain = addr->domain;
4378 deliver_localpart = addr->local_part;
4383 rc = acl_check_internal(where, addr, s, user_msgptr, log_msgptr);
4385 acl_where = ACL_WHERE_UNKNOWN;
4387 /* Cutthrough - if requested,
4388 and WHERE_RCPT and not yet opened conn as result of recipient-verify,
4389 and rcpt acl returned accept,
4390 and first recipient (cancel on any subsequents)
4391 open one now and run it up to RCPT acceptance.
4392 A failed verify should cancel cutthrough request,
4393 and will pass the fail to the originator.
4394 Initial implementation: dual-write to spool.
4395 Assume the rxd datastream is now being copied byte-for-byte to an open cutthrough connection.
4397 Cease cutthrough copy on rxd final dot; do not send one.
4399 On a data acl, if not accept and a cutthrough conn is open, hard-close it (no SMTP niceness).
4401 On data acl accept, terminate the dataphase on an open cutthrough conn. If accepted or
4402 perm-rejected, reflect that to the original sender - and dump the spooled copy.
4403 If temp-reject, close the conn (and keep the spooled copy).
4404 If conn-failure, no action (and keep the spooled copy).
4408 case ACL_WHERE_RCPT:
4409 #ifndef DISABLE_PRDR
4410 case ACL_WHERE_PRDR:
4413 if (f.host_checking_callout) /* -bhc mode */
4414 cancel_cutthrough_connection(TRUE, US"host-checking mode");
4417 && cutthrough.delivery
4418 && rcpt_count > cutthrough.nrcpt
4421 if ((rc = open_cutthrough_connection(addr)) == DEFER)
4422 if (cutthrough.defer_pass)
4424 uschar * s = addr->message;
4425 /* Horrid kludge to recover target's SMTP message */
4427 do --s; while (!isdigit(*s));
4428 if (*--s && isdigit(*s) && *--s && isdigit(*s)) *user_msgptr = s;
4429 f.acl_temp_details = TRUE;
4433 HDEBUG(D_acl) debug_printf_indent("cutthrough defer; will spool\n");
4437 else HDEBUG(D_acl) if (cutthrough.delivery)
4438 if (rcpt_count <= cutthrough.nrcpt)
4439 debug_printf_indent("ignore cutthrough request; nonfirst message\n");
4441 debug_printf_indent("ignore cutthrough request; ACL did not accept\n");
4444 case ACL_WHERE_PREDATA:
4446 cutthrough_predata();
4448 cancel_cutthrough_connection(TRUE, US"predata acl not ok");
4451 case ACL_WHERE_QUIT:
4452 case ACL_WHERE_NOTQUIT:
4453 /* Drop cutthrough conns, and drop heldopen verify conns if
4454 the previous was not DATA */
4456 uschar prev = smtp_connection_had[smtp_ch_index-2];
4457 BOOL dropverify = !(prev == SCH_DATA || prev == SCH_BDAT);
4459 cancel_cutthrough_connection(dropverify, US"quit or conndrop");
4467 deliver_domain = deliver_localpart = deliver_address_data =
4468 deliver_domain_data = sender_address_data = NULL;
4470 /* A DISCARD response is permitted only for message ACLs, excluding the PREDATA
4471 ACL, which is really in the middle of an SMTP command. */
4475 if (where > ACL_WHERE_NOTSMTP || where == ACL_WHERE_PREDATA)
4477 log_write(0, LOG_MAIN|LOG_PANIC, "\"discard\" verb not allowed in %s "
4478 "ACL", acl_wherenames[where]);
4484 /* A DROP response is not permitted from MAILAUTH */
4486 if (rc == FAIL_DROP && where == ACL_WHERE_MAILAUTH)
4488 log_write(0, LOG_MAIN|LOG_PANIC, "\"drop\" verb not allowed in %s "
4489 "ACL", acl_wherenames[where]);
4493 /* Before giving a response, take a look at the length of any user message, and
4494 split it up into multiple lines if possible. */
4496 *user_msgptr = string_split_message(*user_msgptr);
4497 if (fake_response != OK)
4498 fake_response_text = string_split_message(fake_response_text);
4504 /*************************************************
4505 * Create ACL variable *
4506 *************************************************/
4508 /* Create an ACL variable or reuse an existing one. ACL variables are in a
4509 binary tree (see tree.c) with acl_var_c and acl_var_m as root nodes.
4512 name pointer to the variable's name, starting with c or m
4514 Returns the pointer to variable's tree node
4518 acl_var_create(uschar * name)
4520 tree_node * node, ** root = name[0] == 'c' ? &acl_var_c : &acl_var_m;
4521 if (!(node = tree_search(*root, name)))
4523 node = store_get(sizeof(tree_node) + Ustrlen(name));
4524 Ustrcpy(node->name, name);
4525 (void)tree_insertnode(root, node);
4527 node->data.ptr = NULL;
4533 /*************************************************
4534 * Write an ACL variable in spool format *
4535 *************************************************/
4537 /* This function is used as a callback for tree_walk when writing variables to
4538 the spool file. To retain spool file compatibility, what is written is -aclc or
4539 -aclm followed by the rest of the name and the data length, space separated,
4540 then the value itself, starting on a new line, and terminated by an additional
4541 newline. When we had only numbered ACL variables, the first line might look
4542 like this: "-aclc 5 20". Now it might be "-aclc foo 20" for the variable called
4546 name of the variable
4547 value of the variable
4548 ctx FILE pointer (as a void pointer)
4554 acl_var_write(uschar *name, uschar *value, void *ctx)
4556 FILE *f = (FILE *)ctx;
4557 fprintf(f, "-acl%c %s %d\n%s\n", name[0], name+1, Ustrlen(value), value);