| |
39. Списки Контроля Доступа
Списки Контроля Доступа (Access Control Lists - ACL) заданы в отдельной секции рабочего конфигурационного файла, озаглавленной
“begin acl
”. Каждое определение ACL начинается с имени, завершённого двоеточием. Это - полная секция ACL, коотрая содержит лишь одну, очень маленькую ACL:
|
Вы можете иметь так много списков, как вы хотите в секции ACL, и порядок их появления не имеет значения. Списки заканчиваются автоматически.
“
Большинство ACL используются для контроля поведения exim`a, когда он получает определённые SMTP-команды. Это применяется к обоим - входящим TCP/IP соединениям, и, когда локальный процесс передаёт сообщения используя SMTP через задание опции
-bs
”. Самое обычное использование - для контроля каких получателей принимать во входящих сообщениях. Кроме того, вы можете задать ACL которые используются для проверки не-SMTP сообщений. Дефолтовый конфигурационный файл содержит примеры реалистичных ACL для проверки команд RCPT. Это обсуждается в главе 7.
39.1 Тестирование ACL
Опция командной строки
“
-bh
” - предоставляет способ тестирования вашей конфигурации ACL локально, путём запуска поддельной сессии SMTP, с которой вы взаимодействуете. Хост
“
relay-test.mail-abuse.org
” предоставляет сервис для проверки вашей релейной конфигурации (для получения дополнительных деталей, смотрите раздел 39.40).
39.2 Определение, когда используются ACL
Для использования ACL, вы должны назвать их в одной из релевантных опций, в главной части конфигурации. Эти опции:
|
Например, если вы устанавливаете
|
то небольшой ACL, определённый выше, используется каждый раз когда exim получает команду RCPT в диалоге SMTP. Большинство тестов политик для входящих сообщений может быть сделано по прибытии команды RCPT. Отклонение RCPT должно вызвать ошибку адреса получателя содержащегося в команде RCPT, тогда как отклонение в другой момент времени может вызвать дальнейшие попытки MTA доставить сообщение. Поэтому, рекомендуется, чтобы вы делали как можно больше тестов во время RCPT.
39.3 Не-SMTP ACL
Не-SMTP ACL применяется ко всем входящим неинтерактивным сообщениям, т.е. к пакетному SMTP он применяется также как и к не-SMTP сообщениям. Эта ACL работает лишь до функции
“
local_scan()
”. Любые виды отклонения сообщений рассматриваются как постоянные, поскольку нет способа послать код временнной ошибки для этих видов сообщений. Многие условия ACL (например, проверки хостов, и проверки состояния SMTP-соединения - типа шифрования и аутентификации) неуместны и запрещены в этой ACL.
39.4 ACL подключения
Проверка ACL заданная путём
“
acl_smtp_connect
” происходит после теста заданного
“
host_reject_connection
” (который, теперь, является аномалией) и любых сконфигурированных тестов TCP Wrappers.
39.5 ACL DATA
Две ACL ассоциированны с командой DATA, поскольку это - двухстадийная команда, с двумя ответами посылаемыми клиенту. Когда получена команда DATA, обрабатывается ACL заданная путём
“
acl_smtp_predata
”. Это даёт вам контроль после всех команд RCPT, но до получения самого сообщения. Этим даётся возможность дать отрицательный ответ на команду DATA до того, как переданы даные. Строки заголовков добавляемые путём MAIL или RCPT ACL невидимы в это время, но любые, которые тут заданы, видимы при работе ACL
“
acl_smtp_data
”.
Вы не можете проверить содержимое сообщения, например, для проверки адресов в заголовках во время RCPT, или когда получена команда DATA. Такие тесты должны быть в ACL которая работает после получения сообщения, до посылки финального ответа на DATA.
Для обоих этих ACL, невоозможно отклонить индивидуальных получателей. Ответ о ошибке отклоняет всё сообщение. К сожалению, известны MTA, которые некорректно обрабатывают жёсткий (5xx) ответ на команду DATA (до или после данных) - они пытаются оставить сообщение в своей очереди, и пробуют доставить его позже, но - это их проблема, хотя они впустую тратят ваши ресурсы.
39.6 ACL MIME
Опция
“
acl_smtp_mime
” доступна лишь когда exim собран с расширением контентного сканирования. Для деталей, обратитесь к главе 40.
39.7 ACL QUIT
ACL для SMTP-команды QUIT, является аномальной, результат ACL не затрагивает код ответа на QUIT, который всегда 221. Таким образом, фактически, ACL не управляет каким-либо доступом. Поэтому, разрешены лишь имена команд
“
accept
” и
“
warn
”.
“
Эта ACL может быть использована для задач типа специального логгинга конца SMTP-сессии. Например, вы можете использовать переменные ACL в другом ACL для подсчёта числа сообщений, получателей и т.п., и логгировать общее время QUIT используя один или более модификаторов
logwrite
” в команде
“
warn
”.
“
Предупреждение: Для этого могут использоваться лишь переменные
$acl_c
x
”, поскольку переменные
“
$acl_m
x
” сбрасываются после каждого входящего сообщения.
“
Вам не нужно ставить в конце
accept
”, но если вы так поступаете, вы можете использовать модификатор
“
message
”, для задания собственного текста, который посылается как часть 221 ответа на QUIT.
“
Эта ACL запускается лишь для нормального
” QUIT. Для определённых случаев катастрофических ошибок (например, ошибки открытия лог-файла, или когда exim паадет в результате катастрофической ошибки), все SMTP команды от клиента получают ответ о временной ошибке, пока не будет передана команда QUIT, или соединение не закроется. В этих специальных случаях, ACL QUIT не запускается.
39.8 Нахождение ACL для использования
Значение опции
“
acl_smtp_
xxx
” раскрывается перед использованием, таким образом, вы можете использовать различные ACL для разных ситуаций. Результирующая строка не должна бфть именем ACL в конфигурационном файле; есть другие возможности. Раскрыв строку, exim ищет ACL в следующим образом:
Если строка начинается со слэша, exim использует её как имя файла, и читает его содержимое как ACL. Строки обрабатываются таким же образом, как строки в конфигурационном файле exim`a. В частности, поддерживается продолжение строк, пустые строки игнорируются, как и строки, чей первый символ, не являющийся пробелом -
“#
”. Если файл не существует, или не может быть прочитан, происходит ошибка (типично - вызывается временная ошибка любой вызываемой для запуска ACL). Например:
|
В примере ищется используемый файл ACL на основе IP-адреса хоста, в случае неудачи поиска, используется дефолтовое значение. Если ACL успешно прочитана из файла, она сохраняется в памяти при работе процесса exim`a, таким образом, она может быть повторно использована, без необходимости перечитывать файл.
Если строка не начинается со слэша, и не содержит каких-либо пробелов, exim ищет секцию ACL в конфигурации ACL чьё имя совпадает со строкой.
Если имя ACL не найдено, или строка содержит пробелы, exim обрабатывает строку как ACL. Это может сэкономить ввод (в смысле - меньше букавок набирать - прим. lissyara) в случаях, когда вы хотите сделать что-то типа этого:
|
для разрешения свободного использования команды VRFY. Такая строка может содержать символы новой строки; она обрабатывается таким же способом, как и ACL читаемая из файла.
39.9 Коды возврата ACL
Исключая ACL QUIT, которая не затрагивает код возврата SMTP (смотрите выше, секцию 39.7), результат работы ACL - или
“accept
” или
“deny
”, или, проверка не может быть завершена (например, упала БД) -
“defer
”. Эти результаты вызывают использование кодов ответа
“2xx
”,
“5xx
”, и
“4xx
” в диалоге SMTP, соответственно. Четвёртое возвращаемое значение,
“error
”, происходит при ошибках, типа неправильного синтаксиса в ACL. Она также вызывает
“4xx
” код возврата.
“
Для не-SMTP ACL, defer
” и
“error
” - рассматриваются также как и
“deny
”, поскольку не существует механизма для передачи временных ошибок отправителям не-SMTP сообщений.
“
ACL, которые релевантны приёму сообщений, также могут вернуть discard
”. Это имеет тот же самый эффект что и
“accept
”, но, вызывает отбрасываение всего сообщения, или адреса отдельного отправителя. Другими словами - это, средство для органицации чёрной дыры (имеется ввиду - сообщения уходят вникуда - прим. lissyara). Используйте это с осторожностью.
“
Если ACL для MAIL возвращает discard
”, и все получатели отбрасываются, и для последующих команд RCPT не запускается никаких ACL. Эффект
“discard
” в ACL RCPT - отбрасывание лишь одного адреса получателя. Если не осталось получателей сообщения, когда получены данные сообщения, ACL DATA не запускается. Если
“discard
” возвращается из DATA, или не-SMTP ACL, - отбрасываются все получатели. Не разрещается возвращать
“discard
” для ACL
“
acl_smtp_predata
”.
“
Функция
local_scan()
” запускается всегда, даже если не осталось получателей; она может создать новых получателей.
39.10 Незаданные опции ACL
Дефолтовые действия, когда незадана любая из опций
“
acl_
xxx
” - не одинаковы для всех. Отметтьте: Эти умолчания применяются лишь когда релевантная ACL вообще не определена. Для любых определёных ACL, дефолтовое действие, когда контроль достигает конца утверждения ACL -
“deny
”.
“
Для
acl_not_smtp
”,
“
acl_smtp_auth
”,
“
acl_smtp_connect
”,
“
acl_smtp_data
”,
“
acl_smtp_helo
”,
“
acl_smtp_mail
”,
“
acl_smtp_mailauth
”,
“
acl_smtp_mime
”,
“
acl_smtp_predata
”,
“
acl_smtp_quit
” и
“
acl_smtp_starttls
”, действие при незаданной ACL -
“accept
”.
“
Для других (
acl_smtp_etrn
”,
“
acl_smtp_expn
”,
“
acl_smtp_rcpt
” и
“
acl_smtp_vrfy
”), действие, когда ACL не определена -
“deny
”. Это означает, что
“
acl_smtp_rcpt
” должна быть определена, для получения любых сообщений через SMTP-соединение. Для примера, смотрите ACL в дефолтовом конфигурационном файле.
39.11 Данные для ACL сообщений
Когда работают MAIL или RCPT ACL, или любые из DATA ACL, установлены переменные, которые содержат информацию о хосте и отправителе сообщения (например,
“
$sender_host_address
” и
“
$sender_address
”), и могут использоваться в утверждения ACL. В случае RCPT (но не MAIL или DATA),
“
$domain
” и
“
$local_part
” установлены из аргументов адреса. Полная команда SMTP доступна в
“
$smtp_command
”.
“
Когда работает ACL для параметра AUTH команды MAIL, переменные, которые содержат информацию о хосте - установлены, но
$sender_address
” ещё не установлена. Раздел 33.2 содержит обсуждение этого параметра и как его использовать.
“
Переменная
$message_size
” установлена в значение параметра SIZE, команды MAIL, во время MAIL, RCPT и до данных, или в
“-1
”, если параметр не был задан. Значение обновляется до истинного размера сообщения во время работы финальной ACL DATA (после получения сообщения).
“
Переменная
$rcpt_count
” увеличивается на единицу для каждой полученной команды RCPT. Переменная
“
$recipients_count
” увеличивается на единицу для каждой принятой команды RCPT, таким образом, когда обрабатывается RCPT ACL, она содержит число предыдущих принятых получателей. Во время DATA (для обоиз DATA ACL),
“
$rcpt_count
” содержит общее число команд RCPT, и
“
$recipients_count
” содержит общее число принятых получателей. (в данном абзаце - есть разница между числом принятых команд и числом принятых получателей, поскольку получатель может не существовать - тогда команда RCPT принята, а вот получатель - нет. - прим. lissyara)
39.12 Данные для ACL не-сообщений
Когда ACL работает для AUTH, EHLO, ETRN, EXPN, HELO, STARTTLS, или VRFY, оставшаяся строка SMTP-команды помещается в
“
$smtp_command_argument
”, и вся команда SMTP доступна в
“
$smtp_command
”. Эти переменные могут быть протестированы используя условие
“
condition
”. Например, вот - ACL для использования с AUTH, которая настаивает на том, чтобы сессия была или зашифрована, или использовался метод CRAM-MD5. Другими словами, она не разрешает аутентификационные методы, которые используют пароль в открытом виде для нешифрованных соединений.
|
(Иной способ применения этих ограничений - переделать аутентификаторы использующие пароли в открытом виде, чтобы о них не оповещалось, когда соединение не шифрованное. Для этого, вы можете использовать общую аутентификационную опцию
“
server_advertise_condition
”.)
39.13 Формат ACL
Индивидуальная ACL содержит множество утверждений. Каждое утверждение начинается с команды, опционально сопровождаемой множеством условий и
“модификаторов
” (
“modifiers
”). Модификаторы могут изменять работу команд, задавать сообщения о ошибках и логи, устанавливать переменные, вставлять задержки, и изменять обработку принятых сообщений.
“
Если выполняются все условия, выполняется команда. Одни и те же условия могут использоваться (с различными аргументами) более одного раза в одном и том же утверждении. Это предоставляет средство задания соединения and
” между условиями. Например:
|
Если нет условий, команда всегда выполняется. Exim останавливает оценку условия и модификаторов когда он достигает условия которое неуспешно. Что происходит потом, звисит от команды (и в одном случае, от специального модификатора). Не все условия имеют смысл в каждой тестируемой точке. Например, вы не можете проверить адрес отправителя в ACL которая запускается для команды VRFY.
39.14 Команды ACL
“
accept
”: Если все условия удовлетворяются, ACL возвращает
“accept
”. Если любое из условий не выполняется, происходящее зависит от того, есть ли среди условий
“
endpass
” (синтаксис смотрите ниже). Если неуспешное условие до
“
endpass
”, управление передаётся слудующему утверждению ACL; если оно после
“
endpass
”, ACL возвращает
“deny
”. Рассмотрите эо утверждение, используемое для проверки команды RCPT:
|
Если домен получателя не совпадает с условием
“
domains
”, управление передаётся следующему утверждению. Если оно совпадает, проверяется получатель, и команда принимается в случае успешной проверки. Однако, если проверка неудачна, ACL приводит к
“deny
”, поскольку неудачный кондишен после
“
endpass
”.
“
defer
”: Если все условия удовлетворяются, ACL возвращает
“defer
”, который вызывает в SMTP-сессии выдачу ответа
“4xx
”. Для не-SMTP ACL,
“defer
” - то же самое, что и
“deny
”, поскольку в этом случае нет способа дать временную ошибку. Для команды RCPT,
“defer
” - почти также использует роутер
“
redirect
” и
“:defer:
” при проверке, но команда
“defer
” может использоваться в любом ACL, и для получателя это может быть более простым подходом.
“
deny
”: Если все условия удовлетворяются, ACL возвращает
“deny
”. Если любое из условий не выполняется, управление передаётся следующему утверждению ACL. Например:
|
отклоняет команды от хостов, которые в чёрных списках DNS (блэк-листах).
“
discard
”: Эта команда ведёт себя также как и
“accept
”, исключая, что она возвращает из ACL
“discard
” вместо
“accept
”. Это разрешается только для ACL которые имеют отношение к получению сообщений, и они вызывают отказ от получателя. Если модификатор
“
log_message
” установлен при работе
“discard
”, его содержимое добаляется к строке, автоматически записываемой в лог.
Если
“
discard
” используется в ACL для RCPT, отказываются лишь от одного получателя; если используется для MAIL, DATA или в не-SMTP ACL, отказываются от всех получателей сообщения. Получатели, от которых отказались до DATA, не фигурируют в строках логов, когда установлен лог-селектор
“
log_recipients
”.
“
drop
”: Эта команда ведёт себя также как и
“
deny
”, исключая, что соединения SMTP принудительно закрываются после отсылки 5xx сообщения об ошибке. Например:
|
Нет никаких отличий между
“
deny
” и
“
drop
” во время ACL соединения. Соединения всегда разрываются после посыла ответа 550.
“
require
”: Если выполняются все условия, управление передаётся следующему утверждению ACL. Если любое из условий не выполняется, ACL возвращает
“
deny
”. Например, при проверке команды RCPT
|
управление передаётся следующему утверждению лишь если отправитель сообщения может быть проверен. Иначе, оно отклонит команду.
“
warn
”: Если все условия выполняются, во входящее сообщение добавляются строки заголовков, и/или в главный лог exim`a пишутся строки. Во всех случаях, управление передаётся следующему утверждению ACL. Текст добавляемый в заголовки, и строки логов, задаются путём модификаторов; если их нет, команда
“
warn
” лишь проверяет своё условие, и подчиняется любым
“immediate
” (
“непосредственным
”) модификаторам, типа
“
set
” и
“
logwrite
”. Дополнительная информация о добавлении строк заголовков в секции 39.19.
Если любое условие в утверждении
“
warn
” не может быть завершено (т.е. своего рода отсрочка), строки заголовков не добавляются, и сконфигурированные строки логов не записываются. Никакие дальнейшие условия или модификаторы в утверждении
“
warn
” не обрабатываются. Инцидент логгируется, но ACL продолжает обрабатываться, со следующего утверждения.
Если в ACL которая не тестирует входящее сообщение, в команде
“
warn
”, присутствует модификатор
“
message
”, он игнорируется и инцидент логгируется.
Утверждение
“
warn
” может использовать модификатор
“
log_message
” для записи строки в главный лог, когда условия утверждения верны. Если идентичную строку запрашивают несколько раз в одном сообщении, фактически, лишь одна копия пишется в лог. Если вы хотите принудительно записывать дубликаты, вместо этого, используйте модификатор
“
logwrite
”.
Когда одно из условий
“
warn
” - неудачная проверка адреса, текст сообщения о неудаче проверки находится в
“
$acl_verify_message
”. Если вы хотите его логгировать, вы должны установить это явно. Например:
|
В конце каждой ACL присутствует неявное, безоговорочное,
“
deny
”.
Как вы видели из примеров выше, условия и модификаторы пишутся в одну линию, на первом месте, в той же строке - команда, и последующие на дальнейших строках. Если у вас очень длинное условие, вы можете продолжить его на нескольких строках, путём обычного механизма обратного слэша. Обычно, условия выравниваются вертикально.
39.15 Переменные ACL
Есть некоторые специальные переменные, которые могут быть установлены в течение обработки ACL. Они могут использоваться для передачи информации между различными ACL`ами, различными вызовами одной и той же ACL в одном и том же SMTP-соединении, и между ACL и роутерами, транспортами, и фильтрами, которые используются для доставки сообщения. Есть два набота этих переменных:
Значения от
“
$acl_c0
” до
“
$acl_c19
” сохраняются в течение SMTP-сессии. Они никогда не сбрасываются. Таким образом, значение которое установлено при получении одного сообщения, остаётся доступным при получении следующего сообщения в том же SMTP-соединении.
Значения от
“
$acl_m0
” до
“
$acl_m19
” сохраняются лишь когда сообщение получается. После этого они сбрасываются. Также, они сбрасываются MAIL, RSET, EHLO, HELO, и после начала сессии TLS.
Когда сообщение принято, текущие значения всех переменных ACL сохраняются с сообщением, и впоследствии становятся доступными во время доставки. Переменные ACL устанавливаются путём модификатора назваемого
“
set
”. Например:
|
Отметтьте: Начальный символ доллара не используется при именовании устанавливаемой переменной. Если вы хотите установить переменную не предпринимая каких-либо действий, вы можете использовать команду
“
warn
” без любых других модификаторов или условий.
39.16 Обработка условий и модификаторов
Восклицательный знак предшествующий кондишену - отрицает его результат. Например:
|
заставляет ACL вернуть
“deny
”, если домен отправителя заканчивается на
“dom.example
” и адрес получателя не может быть проверен. Иногда отрицание может может использоваться на правой строне условия. Например, эти два утверждения эквивалентны:
|
Однако, для многих условий (
“
verify
” был хорошим примером), допустимо лишь левостороннее отрицание всего условия.
Аргументы условия и модификаторы раскрываются. Принудительный отказ раскрытия вызывает игнорирование условия, т.е. оно ведёт себя как будто условие истинно. Рассмотрите эти два утверждения:
|
Каждое пытается искать список приемлимых отправителей. Если поиск успешен, возврашённый список просматривается, но если поиск неудачен, поведение различается в этих двух случаях. В первом случае,
“
fail
” вызывает игнорирование условия, не рарешая никаких дальнейших кондишенов. Поэтому, команда
“
accept
” успешна. Однако, второе утверждение, генерит пустой список, когда поиск неудачен. Никакой отправитель не может совпасть с пустым списком, следовательно - условие неуспешно, и поэтому
“
accept
” также неудачен.
“
Модификаторы ACL кажутся смешанными с условиями в утверждениях ACL. Некоторые из них определяют действия, которые берутся как условия для проверки утверждений; другие определяют текст для сообщений, который используется при отказе в доступе, или при генерации предупреждения. Модификатор
control
” затрагивает способ обработки входящих сообщений.
“
Позиционирование модификаторов в утверждении ACL - важно, поскольку обработка команды прекрашается, как только известен её результат. В силу вступят лишь те модификаторы, которые успели вcтретиться. Например, рассмотрите использование модификатора
message
”:
|
Если проверка отправителя неудачна, exim знает, что результат утверждения -
“deny
”, следовательно, он не движется дальше. Был просмотрен первый модификатор, таким образом, его текст используется как сообщение о ошибке. Если проверка отправителя успешна, но проверка получателя - неудачна, используется второе сообщение. Если проверка получателя успешна,
“текущим
” становиться третье сообщение, но оно никогда не используется, поскольку больше нет условий способных вызвать отказ.
“
Для команды deny
”, с другой строны, всегда используется последний модификатор
“
message
”, поскольку все условия должны быть истины, для того, чтобы случилось отклонение получателя. Задание более чем одного модификатора
“
message
” не имеет смысла, и сообщение может быть определено даже после всех условий. Например:
|
Результат
“deny
” не происходит, пока не будет достигнут конец утверждения, по достижении которого, exim установит сообщение.
39.17 Модификаторы ACL
Модификаторы ACL таковы:
“
add_header
” = <text>
“
Этот модификатор задаёт одну или более строк заголовков которые должны быть добавлены во входящее сообщение, предполагая, разумеется, что сообщение в конечном счёте принято. Для деталей, смотрите раздел 39.19.
control
” = <text>
“
Этот модификатор затрагивает последующую обработку SMTP-соединения, или входящего сообщения, которое принято. Эффект первого типа управления длится для всей продолжительности соединения, тогда как эффект второго типа длится лишь пока не получено текущее соединение. Специфические для сообщения средства управления всегда применяются ко всему сообщению, не к индивидуальным получателям, даже если модификатор
control
” появляется в RCPT ACL.
“
Eсть довольно много средств управления которые могут быть применены, они описываются отдельно, в секции 39.18. Модификатор
control
” может использоваться несколькими различными способами. Например:
Он может быть в конце утверждения
“
accept
”:
|
В этом случае, управление применяется когда это условие приводит к
“accept
”, другими словами, когда все кондишены верны.
Он может быть в середине утверждения
“
accept
”:
|
Если первый набор условий истиннен, управление применяется, даже если утверждение не принимается поскольку одна из вторых установок условия - ложна. В этом случае, некоторое последующее утверждение должно уступить
“accept
” для релевантного управления.
Он может использоваться с
“
warn
”, для применения управления, оставляя решение о приёме или отказе следующей команде. Например:
|
Этот пример
“
warn
” не содержит
“
message
”,
“
log_message
” или
“
logwrite
”, таким образом, он ничего не добавляет к сообщению и не пишет логов.
Если вы хотите безоговорочно применить управление, вы можете использовать его с командой
“
require
”. Например:
|
“
delay
” = <time>
“
Этот модификатор заставляет exim ждать интервал времени до процедуры. Интервал даётся в обычной нотации exim`a. Этот модификатор может появиться в любой ACL. Задержка происходит срезу при обработке модификатора. Однако, когда exim тестируется с использование опции
-bh
”, задержка не применяется (вместо этого выводится соответствующее сообщение).
“
Как и
control
”,
“
delay
” может использоваться с
“
accept
” или
“
deny
”, например:
|
Задержка происходит если все услоия истинны, до возвращения
“deny
”. Сравните с:
|
которое ждёт 30s до обработки условия. Модификатор
“
delay
” также может быть использован с
“
warn
” и вместе с
“
control
”:
|
“
endpass
”
“
Этот модификатор, у которого нет аргументов, распознаётся лишь в утверждении
accept
”. Он отмечет границу между условием чья неудача вызвает передачу управления слудующему утверждению, и условием, чья неудача заставляет ACL вернуть
“deny
”. Смотрите описание
“
accept
”, выше.
“
log_message
” = <text>
“
Этот модификатор устанавливает сообщение, которое используется как часть сообщения лога, если ACL запрещает доступ, или утверждение
warn
” истинно. Например:
|
Модификатор
“
log_message
” добавляется к любому основному сообщению о ошибке, которое может существовать, поскольку условие - неудачно. Например, когда проверяется адрес получателя, перенаправление :fail: могло уже установить сообщение. Хотя, обычно, сообщение задано до условия к которому оно применяется, раскрытие не происходит, пока exim не решает, что в доступе надо отказать. Это означает, что любые переменные, которые установлены путём кондишена, доступны для включения в сообщение. Например, переменные
“
$dnslist_
<xxx>[/color]
”, установлены после того, как был успешный поиск в чёрных списках DNS. Если раскрытие
“
log_message
” - неудачно, или если результат - пустая строка, модификатор игнорируется.
“
Если вы хотите использовать утверждение
warn
” для логгирования результата проверки адреса, вы можете использовать
“
$acl_verify_message
” для включения сообщения о ошибке проверки.
“
Если
log_message
” используется с утверждением
“
warn
”, в начало логгируемого сообщения добавляется
“Warning:
”. Если тоже самое логгируемое предупреждающее сообщение запрашивается более одного раза при получении одного почтового сообщения, лишь одна копия логгируется. Если вы хотите логгировать все копии, используйте
“
logwrite
” вместо
“
log_message
”. При отсутствии обоих,
“
log_message
” и
“
message
”, ничего не логгируется для успешного утверждения
“
warn
”.
“
Если отсутствует
log_message
” и нет основного сообщения о ошибке (например, из неудачи проверки адреса), но присутствует
“
message
”, текст
“
message
” используется для логгинга отказа. Однако, если како-либо текст для логгинга содержит символы новой строки, лишь первая строка логгируется. При отсутствии обоих,
“
log_message
” и
“
message
”, для логгирования отклонения используется дефолтовое встроенное сообщение.
“
logwrite
” = <text>
“
Этот модификатор пишет сообщение в лог-файл, как только с ним сталкиваются при обработке ACL. (Сравните с
log_message
”, который, исключая случай
“
warn
”, используется лишь если утвердление ACL отказывает доступе.) Модификатор
“
logwrite
” может использоваться для логгирования особых инцидентов в ACL. Например:
|
По дефолту, сообщение пишется в главный лог. Однако, оно может начинаться с двоеточия, сопровождаемого списком имён логов, разделённых двоеточиями, и, затем, иным двоеточием, точно определяющим, который лог будет записан. Например:
|
“
message
” = <text>
“
Этот модификатор устанавливает текстовую строку, которая раскрывается, и используется как сообщение о ошибке, если текущее утверждение заставляет ACL отказать в доступе. Раскрытие происходит в то время, когда exim принимает решение об отказе в доступе, не во время обработки
message
”. Если раскрытие неудачно, или генерит пустую строку, модификатор игнорируется. Для ACL, которые вызываются путём SMTP-команд, сообщение возвращается как часть SMTP ответа об ошибке.
“
Текст является буквальным; любые кавычки берутся как опечатки, но, поскольку строка раскрывается, экранирование обратным слэшом так или иначе обрабатывается. Если сообщение содержит символы новой строки, оно увеличивается до многострочного SMTP-ответа. Как и
log_message
”, содержимое
“
message
” не раскрывается до тех пор, пока кондишен не стал неуспешным.
“
Если
message
” используется в утверждении которое проверяет адрес, заданное сообщение перезадаёт любое сообщение, которое сгенерено путём процесса проверки. Однако, оригинальное сообщение доступно в переменной
“
$acl_verify_message
”, таким образом, вы можете включить его в ваше сообщение, если вы этого желаете. В частности, если вы хотите текст из элемента :fail: в роутере
“
redirect
”, для возвращения обратно как части ответа SMTP, вы не должны использовать модификатор
“
message
”, или использовать
“
$acl_verify_message
”.
“
Для совместимости с предыдущими релизами exim`a, модификатор
message
”, который используется с командой
“
warn
”, ведёт себя подобно модификатору
“
add_header
”, но это применение сейчас устарело. Однако,
“
message
” действует лишь когда все условия истинны, везде где он появляется в команде ACL, тогда как
“
add_header
” действует как только с ним сталкиваются. Если
“
message
” используется с
“
warn
” в ACL которая не имеет отношения к получению сообщения, он не имеет эффекта.
“
message
” <acl_name> = <value>
Этот модификатор помещает значение в одну из переменных ACL (смотрите раздел 39.15).
39.18 Использование модификатора
“control
”
Модификатор
“
control
” поддерживает следующие установки:
“
control
” =
“
allow_auth_unadvertised
”
Этот модификатор позволяет клиентскому хосту использовать команду SMTP AUTH, даже когда о ней не оповещалось в ответе на HELO. Кроме того, поскольку есть некоторые очень кривые клиенты, exim принимает AUTH после HELO (а не EHLO), когда этот контроль установлен. Это должно использоваться лишь если вам это действительно необходимо, и вы должны ограничить его использование теми кривыми клиентами, которые без этого не работают. Например:
|
Обычно, когда сервер exim`a получает команду AUTH, он проверяет имя аутентификационного механизма который дан в команде на совпадение с механизмом о котором оповещалось. Когда эта установка установлена, проверка на оповещение о механизме обходится. Любые сконфигурированные механизмы могут быть использованы клиентом. Это управление разрешено лишь в соединениях и ACL`ах HELO.
“
control
” =
“
caseful_local_part
”
“
Смотрите ниже.
control
” =
“
caselower_local_part
”
“
Эти два средства управления разрешены лишь в ACL определённых путём
acl_smtp_rcpt
” (т.е. в течение обработки RCPT). По умолчанию, содержимое
“
$local_part
” приводится к нижнему регистру, до обработки ACL. Если задана
“caseful_local_part
”, любые заглавные буквы в оригинальной локальной части, восстановлены в
“
$local_part
” для остальной ACL, или пока не столкнётся с управлением установленным в
“caselower_local_part
”.
“
Эти средства управления применяются лишь к текущему получателю. Кроме того, они применяются лишь к обработке локальной части, которая имеет место непосредственно в ACL (например, как ключ в поисках). Если присутствует проверка получателя, регистрозависмая обработка локальной части, в процессе проверки, контролируется конфигурацией роутера (смотрите общую роутеров
caseful_local_part
”).
“
Это средство могло бы использоваться, например, для добавления спамерских очков к локальной части содержащей бувы верхнего регистра. Например, используя
$acl_m4
” для накопления спамерских очков:
|
Заметтьте, что мы возвращаем назад версию в нижнем регистре, предполагая, что это потребуется для последующих тестов.
“
control
” =
“
enforce_sync
”
“
Смотрите ниже.
control
” =
“
no_enforce_sync
”
“
Эти средства управления дают возможность селективной SMTP синхронизации. Глобальная опция
smtp_enforce_sync
” задаёт начальное состояние переключателя (оно истинно по умолчанию). Смотрите описание этой опции в части 14, для дополнительной информации о проверке SMTP синхронизации.
“
Эффект этих двух средств управления длится до конца SMTP соединения. Они могут появиться в любой ACL, кроме одной для не-SMTP сообщений. Самое верное место их размещения - в ACL заданной путём
acl_smtp_connect
”, которая запускается после входящего SMTP соединения, до первой проверки синхронизации. Ожидаемое использование - для отключения проверок синхронизации для плохо себя ведущих хостов, с которыми вам надо работать.
“
control
” =
“
fakedefer/<message>
”
“
Это средство управления работает точно также как и
fakereject
” (описано ниже), исключая, что оно вызывает 450 SMTP ответ после получения данных, вместо 550 ответа. При использовании
“
fakedefer
” вы должны учесть, что она вызвает повтор сообщений, при наступлении времени повтора у отправителя. Поэтому, вы не должны использовать
“
fakedefer
”, если сообщение нужно доставить обычным образом.
“
control
” =
“
fakereject/<message>
”
“
Это средство управления разрешено лишь для ACL MAIL, RCPT, и DATA, другими словами, лишь когда получается SMTP сообщение. Если exim принимает сообщение, вместо финального ответа 250, посылается 550 отклонение сообщения. Однако, exim продолжает нормальную доставку сообщения. Средство управления применяется лишь к текущему сообщению, но не к любым последующим, которые могут быть получены в том же самом SMTP-соединении.
Текст для 550 ответа берётся из модификатора
control
”. Если сообщения не предоставлено, используется следующее:
|
Это средство должно использоваться с черезвычайной осторожностью.
“
control
” =
“
freeze
”
“
Это средство управления разрешено лишь для ACL MAIL, RCPT, DATA, и не-SMTP ACL, другими словами, лишь когда получается сообщение. Если сообщение принято, оно помещается очередь exim`a и замораживается. Средство управления применяется лишь к текущему сообщению, а не к любым последующим, которые могут быть получены в том же самом SMTP соединении.
Этот модификатор может, опционально, сопровождаться /no_tell
”. Если установлена глобальная опция
“
freeze_tell
”, она игнорируется для текущего сообщения (т.е. никому не сообщается о заморозке), при условии, что все модификаторы
“
control=freeze
” для текущего сообщения имеют опцию
“/no_tell
”.
“
control
” =
“
no_mbox_unspool
”
“
Это средство управления доступно когда exim скомпилен с поддержкой расширения контекстного сканирования. Контекстное сканирование может требовать копию текущего сообщения, или чистей его, для записи в формате mbox format
” в файл спула, для передачи к сканеру на вирусы или спам. Обычно, такие копии удаляются, когда они более не нужны. Если это средство управления установлено, копии не удаляются. Средство управления применяется лишь к текущему сообщению, а не к любым последующим, которые могут быть получены в том же самом SMTP соединении. Оно предоставялет средство отладки и врятли будет полезно в продакшене.
“
control
” =
“
no_multiline_response
”
“
Это средство управления разрешено для любых ACL, кроме одной для не-SMTP сообщений. Кажется, что существуют кривые клиенты, которые при использовании не могут обрабатывать многострочные SMTP-ответы, несмотря на то, что фактически, RFC821 определил их более 20 лет назад.
Когда эта установка установлена, подавляются многострочные SMTP ответы, о отклонении, из ACL. Один способ сделать это, состоял бы в том, чтобы сделать эти ответы одной длинной строкой. Однако, RFC2821 определяет максимум - 512 байт на ответ (там сказано - use multiline responses for more
” - ха!), и некоторые из ответов могли бы перекрыть это. Так, это средство, в конечном счёте являющееся лишь подачкой для кривых клиентов, осуществляется путём дву простых вещей:
Дополнительная информация, которая обычно выводится как часть отклонения вызванного ошибкой проверки отправителя, опускается. Посылается лишь финальная строка (обычно,
“sender verification failed
”).
Если модификатор
“
message
” предоставляет многострочный ответ, выводится лишь первая строка.
Установка переключателя может, размеется, быть сделанной зависимой от вызывающего хоста. Его эффект длится до конца SMTP подключения.
“
control
” =
“
queue_only
”
Это средство управления разрешено лишь для ACL MAIL, RCPT, DATA, и не-SMTP ACL, другими словами, лишь когда получается сообщение. Если сообщение принято, оно помещается очередь exim`a и осталяется там для доставки обработчиком очереди. Немедленный процесс доставки не запускается. Другими словами, оно имеет эффект глобальной опции
“
queue_only
”. Однако, средство управления применяется лишь к текущему сообщению, а не к любым последующим, которые могут быть получены в том же самом SMTP соединении.
“
control
” =
“
submission/<options>
”
Это средство управления разрешено лишь для ACL MAIL, RCPT, и начального DATA ACL (последний - заданный путём
“
acl_smtp_predata
”). Его установка говорит exim`y, что текущее сообщение передано от локального MUA. В этом случае, exim работвает в
“режиме передачи
” (
“submission mode
”), и, при необходимости, применяет определённые исправления к сообщению. Например, он добавляет строку заголовков
“
Date:
”, если её нет. Это средство управления не разрешено в ACL
“
acl_smtp_data
”, поскольку она слишком поздно (сообщение уже создано).
Часть 43 описывает обработку, которую exim применяет к сообщениям. Раздел 43.1 охватывает обработку, которая происходит в режиме передачи; доступные для этого средства управления опции, описаны там. Средство управления применяется лишь для текущего сообщения, а не к любым последующим, которые могут быть получены в том же самом SMTP соединении.
“
control
” =
“
suppress_local_fixups
”
Это средство управления применяется к локально переданным (не TCP/IP) сообщениям, и это - дополнение к
“
control
” =
“
submission/<options>
”. Оно отменяет исправления, которые обычно применяются к локально переданным сообщениям. Конкретно:
Любые заголовки
“
Sender:
” оставляются как есть (в этом отношении, это - динамическая версия
“
local_sender_retain
”).
Не добавляются заголовки
“
Message-ID:
”,
“
From:
” и
“
Date:
”.
Нет проверки, что
“
From:
” соответствует фактическому отправителю.
Эта особенность может быть полезной когда принято удалённо порождённое сообщение, переданно какой-то сканирующей программе, и затем повторно передано для доставки
Все четыре возможные исправления для сообщений могут быть заданы:
Локально переданное, применяются исправления: по умолчанию.
Локально переданное, не применяются исправления: использование
“
control
” =
“
suppress_local_fixups
”
Удалённо переданное, не применяются исправления: по умолчанию.
Удалённо переданное, применяются исправления:
“
control
” =
“
submission
”.
39.19 Добавление строк заголовков в ACL`ах
Модификатор
“
add_header
” может быть использован для добавления одного или более дополнительных строк заголовков во входящее сообщение, как в этом примере:
|
Модификатор
“
add_header
” разрешается в MAIL, RCPT, PREDATA, DATA, MIME, и не-SMTP ACL (лругими словами, тех, которые имеют отношение к получению сообщения). Сообщение долюжно быть, в конечном счёте, принято, чтобы
“
add_header
” имел какой-то существенный эффект. Вы можете использовать
“
add_header
” с любыми ACL-командами, включая
“
deny
” (хотя, потенциално, это полезно лишь в ACL RCPT).
“
Если данные для модификатора
add_header
” содержат одну или более символов новой строки, которые не сопровождаются пустым местом или табами, предполагается, что это - несколько строк заголовков. Каждай из них проверена на правильность синтаксиса; в начале каждой строки не являющейся правильной строкой заголовка добавляется
“X-ACL-Warn:
”.
“
Добавленные строки накапливаются в течение ACL MAIL, RCPT и предданных. Они добавляются в сообщение до обработки ACL DATA и MIME. Однако, если идентичные строки запрошены более одного раза, фактически, в сообщение добавляется лишь одна копия. Последующие строки заголовков мгут быть накоплены в течение ACL DATA и MIME, после которых оди добавляются в сообщение, с такимже подавлением дубликатов. Таким образом, возможно добавить две идентичные строки в SMTP сообщение, но лишь если одна добавлена до DATA и одна - после. В случае не-SMTP сообщений, новые заголовки аккумулируются в течение не-SMTP ACL, и в конце добавляются в сообщение. Если сообщение отклоняется после DATA, или путём не-SMTP ACL. все добавленные строки заголовков включаются в запись производимую в лог отклонённых.
Строки заголовоков невидимы в раскрытии строк пока они не добавлены в сообщение. Из этого следует, что строки заголовоков заданные в ACL MAIL, RCPT и предданных не видимы до запуска DATA ACL и MIME ACL. Таким же образом, строки заголовков которые добавлены путём DATA или MIME ACL не видимы в этих ACL. Bp-pf этого ограничения, вы не можете использовать строки заголовков как способ передачи данных между (например) ACL MAIL и ACL RCPT. Если вы хотите это сделать, вы можете использовать переменные ACL, rfr описано в разделе 39.15.
Модификатор
add_header
” действует немедленно, как тока с ним столкнулись в процессе обработки ACL. Заметтьте различие между этими двумя случаями:
|
В первом случае, строки заголовоков всегда добавляются, вне завсимости от того, истинно условие или нет. Во втором случае, строки заголовков добавлятся лишь если условие истинно. Несколько
“
add_header
” могут быть в одном утверждении ACL. Все встречащиеся до неудачного условия - выполняются.
“
Для совместимости с предыдущими релизами exim`a, модификатор
message
” для команды
“
warn
” действует таким же образом как и
“
add_header
”, исключая что он вступает в силу лишь если все условия истинны, даже если он появляется до некоторых из них. Кроме того, выполянется лишь последнее появление
“
message
”. Это использование
“
message
”, теперь осуждается. Если в команде
“
warn
” представлены оба -
“
add_header
” и
“
message
”, оба обработаны согласно их спецификациям.
“
По умолчанию, новая строка заголовка добавляется в конце существующих строк. Однако, вы можете задать что любая особенная строка заголовка должна быть добавлена в начале (до всех строк
Received:
”), немедленно после первого блока строк
“
Received:
”, или немедленно до любой строки, которая не
“
Received:
” или
“
Resent-something:
”.
“
Это сделано путём определения :at_start:
”,
“:after_received:
”, или
“:at_start_rfc:
” (или, для завершения,
“:at_end:
”) до текста строки заголовка, соответственно. (Текст заголовка не может начинаться с двоеточия, поскольку вначале должно быть имя заголовка.) Например:
|
Если более в одном модификаторе
“
add_header
” предоставляется более одной строки заголовка, каждая рассматривается независимо, и может быть помещена по другому. Если вы добавляете более одной строки в начале, или после блока
“Received:
”, они завершаются в обратном порядке.
Предупреждение: Это средство, сейчас, применяется лишь к строкам заголовков которые добавлены в ACL. Оно НЕ работает для строк заголовков которые добавлены в системном фильте, или в роутере, или в транспорте.
39.20 Условия ACL
Некотрые условия, перечисленые в этой секции, доступны лишь если exim cскомпилен с поддержкой расширения контентного сканирования. Они кратко включены здесь, для завершённости. Более детальное описание может быть наёдено в обсуждении контентного сканирования в части 40.
“
Не все условия уместны во всех обстоятельствах. Например, проверка отправителей и получателей не имеет смысла в ACL, которая запускается как результат прихода команды ETRN, и проверки заголовков сообщения могут быть сделаны лишь в ACL заданной путём
acl_smtp_data
” или
“
acl_not_smtp
”. Вы можете использовать некоторые условия (с иными параметрами) более чем в одном утверждении ACL. Этим предоставляется способ определения соединения
“and
” (
“и
”). Условия таковы:
“
acl
” =
“
<name of acl or ACL string or file name >
”
Возможные значнеия аргумента - такие же как и для опций
“
acl_smtp_xxx
”. Запускается именованная или встроенная ACL. Если она возвращает
“accept
”, условие истинно; если она возвращает
“deny
”, условие ложно. Если она возвращает
“defer
”, текущая ACL возвращает
“defer
”, исключая условия в команде
“
warn
”. В этом случае, возврат
“defer
” делает условие ложным. Это означает, что дальнейшая обработка команды
“
warn
” прекращается, но обработка ACL продолжается.
Если вложенные
“
acl
” возвращают
“drop
”, и внешнее условие отказывает в доступе, соединеие рвётся. Если они возвращают
“discard
”, команда должна быть
“
accept
” или
“
discard
”, и действие предпринимается немедленно - никакие дальнейшие условия не проверяются.
ACL могут быть вложены до 20 уровней; предел существует лишь для поимки петель. Это условие разрешает вам использовать различные ACL в различных условиях. Например, различные ACL могут быть использованы для обработки команд RCPT для различных локальных пользователей, или различных локальных доменов.
“
authenticated
” =
“
<string list>
”
Если SMTP соединение не аутентифицировано, условие ложно. Иначе, имя аутентификатора сверяется со списком. Для тестирования аутентификации путём любого аутентификатора, вы можете задать
|
“
condition
” =
“
<string>
”
Эта возможность позвоялет вам создавать нестандартные условия. Если результат раскрытия - пустая строка, число ноль, или одна из строка -
“no
” или
“false
”, условие ложно. Если результат - ненулевое число, или одна из строк -
“yes
” или
“true
”, условие истинно. Для любых других значений, предполагается что произошла какая-то ошибка, и ACL возвращает
“defer
”.
“
decode
” =
“
<location>
”
Этот кондишен доступен лишь если exim собран с расширением контентного сканирования, и он разрешён лишь в ACL заданной путём
“
acl_smtp_mime
”. Он вызывает декодирование текущей части MIME в файл. Для дополнительных деталей, смотрите раздел 40.
“
demime
” =
“
<extension list>
”
Этот кондишен доступен лишь если exim собран с расширением контентного сканирования. Его использование описано в части 40.6.
“
dnslists
” =
“
<list of domain names and other data>
”
Это условие проверяет записи в чёрных списках DNS. Они также известны как
“RBL lists
”, после оригинального Realtime Blackhole List, но отметтьте, что это использование списков в
“
mail-abuse.org
” сейчас приносит большую нагрузку. Есть очень много различных вариантов этого кондишена, для краткого описания. Для деталей, смотрите разделы 39.21-39.29.
“
domains
” =
“
<domain list>
”
Это условие уместно лишь после команды RCPT. Оно проверяет, что домен получателя - в списке доменов. Если включена обработка символа процента, она производится до этого теста. Если проверка поиском удачна, результат поиска помещается в
“
$domain_data
”, до слеующего теста
“
domains
”.
“
encrypted
” =
“
<string list>
”
Если SMTP соединение нешифрованное, условие ложно. Иначе, имя метода шифрования используется для проверки по списку. Для тестирования на шифрование без тестирования на определённый метод шифрования, установите
|
“
hosts
” =
“
< host list>
”
Это условие проверяет, что вызывающий хост совпадает со списком хостов. Если вы производите поиски имени, или шаблонов имён хостов и IP адресов в одном и том же списке хостов, обычно, вы должны вначале поместить IP адрес. Например, у вас могло бы быть:
|
Причина этого - в обработке exim`ом списков слева направо. Он может тестировать IP адреса без поиска в DNS, но, когда он достигает пункта требующего имени хоста, он завершается с неудачей если не может найти имя хоста для сравнения с шаблоном. Если вышеупомянутый список даётся в обратном порядке, утверждение
“
accept
” неудачно для хоста, чьё имя не может быть найдено, даже если его IP - 10.9.8.7.
Если вам действительно нужно вначале проверять имена, и всё ещё распознавать IP адреса, даже если поиск неудачен, вы можете переписать ACL так:
|
Действие по умолчанию при провале попытки найти имя хоста - предположение, что хост не в списке, таким образом, первое утверждение
“
accept
” - неудачно. Тогда, второе утверждение может проверить IP адрес.
“
Если условие
hosts
” удовлетворяется путём поиска, результат поиска становится доступен в переменной
“
$host_data
”. Это позволяет вам, например, установить утверждение типа такого:
|
которое позволяет вам сделать персональное сообщение о ошибке для каждого отказанного хоста.
“
local_parts
” =
“
<local part list>
”
Это условие доступно лишь после команды RCPT. Оно проверяет что локальная часть адреса получателя находится в списке. Если включена обработка символа процента, она завершется до этого теста. Если проверка успешна путём поиска, результат поиска помещается в
“
$local_part_data
”, которая остаётся установленной до следующего теста
“
local_parts
”.
“
malware
” =
“
<option>
”
Это условие доступно лишь когда exim скомпилен с поддержкой расширения контентного сканирования. Оно вызывает сканирование входящего сообщения на вирусы. Для дополнительных деталей, смотрите раздел 40.
“
mime_regex
” =
“
<list of regular expressions>
”
Это условие доступно лишь когда exim скомпилен с поддержкой расширения контентного сканирования, и оно разрешено лишь для ACL заданной путём
“
acl_smtp_mime
”. Она вызывает сканирование текeщей MIME части на совпадение с любым регулярным выражением. Для дополнительных деталей, смотрите раздел 40.
“
ratelimit
” =
“
<parameters>
”
Это условие может быть использовано для ограничения частоты, с которой пользователь или хост посылают сообщения. Детали даны в разделе 39.30.
“
recipients
” =
“
<address list>
”
Это условие уместно лишь после команды RCPT. Она проверяет входящий адрес получателя по списку получателей.
“
regex
” =
“
<list of regular expressions>
”
Это условие доступно лишь когда exim скомпилен с поддержкой расширения контентного сканирования, и оно доступно лишь в DATA, MIME, и не-SMTP ACL. Оно вызывает сканирование входящего сообщения на совпадение с любым регулярным выражением. Для дополнительных деталей, смотрите раздел 40.
“
sender_domains
” =
“
<domain list>
”
Это условие тестирует домен отправителя сообщения с заданным списком доменов. Отметтьте: домен адреса отправителя -
“
$sender_address_domain
”. Он не помещается в
“
$domain
” в процессе тестирования этого условия. Это - исключение из общего правила тестирования списков доменов. Так сделано для того, чтобы если это условие используется в ACL для команды RCPT, домен получателя (который находится в
“
$domain
”), мог влиять на проверку отправителя.
Предупреждение: Плохая идея, использовать это условие как контроль релеинга, поскольку адреса отправителя легко, и обычно, подделываются.
“
senders
” =
“
<address list>
”
Это условие тестирует отправителя сообщения по данному списку. Для тестирования рикошетов, у которых пустой отправитель, установите:
|
Предупреждение: Плохая идея, использовать это условие как контроль релеинга, поскольку адреса отправителя легко, и обычно, подделываются.
“
spam
” =
“
<username>
”
Это условие доступно лишь когда exim скомпилен с поддержкой расширения контентного сканирования. Оно вызывает сканирование входящего сообщения с помощью SpamAssassin. Для дополнительных деталей, смотрите раздел 40.
“
verify
” =
“
certificate
”
Это условие истинно если SMTP-сессия шифрована, и клиент передал сертификат, и сертификат был проверен. Сервер запрашивает сертификат лишь если клиент совпадает с
“
tls_verify_hosts
” или
“
tls_try_verify_hosts
” (смотрите часть 38).
“
verify
” =
“
csa
”
Это условие проверяет, авторизован ли хост (клиент) посылать почту. Детали, как это работает, даны в разделе 39.37.
“
verify
” =
“
header_sender/<options>
”
Это условие уместно лишь в ACL, которая запускается после получения сообщения, т.е. в ACL заданной путём
“
acl_smtp_data
” или
“
acl_not_smtp
”. Оно проверяет наличие адреса поддающегося проверке по крайней мере в одном из заголовков
“
Sender:
”,
“
Reply-To:
” или
“
From:
”. Каждый адрес предполагается адресом отправителя (следовательно, именем теста). Однако, адрес появляющийся в одном из этих заголовков, не должен быть адресом, принимающим рикошеты; лишь адрес отправителя в конверте должен принимать рикошеты. Поэтому, если вы используете опцию обратного вызова в этой проверке, вы могли бы хотеть переделать её для непустого адреса в команде MAIL.
Детали проверки адреса и опции даны позднее, начиная с секции 39.31 (обратные вызовы описаны в разделе 39.32). Вы можете комбиировать эти условия с условием
“
senders
”, для ограничения его лишь рикошетами:
|
“
verify
” =
“
header_syntax
”
Это условие уместно лишь в ACL, которая запускается после приёма сообщения, т.е., в ACL заданных путём
“
acl_smtp_data
” или
“
acl_not_smtp
”. Она проверяет синтаксис всех строк заголовков, которые могут содержать адреса (
“
(Sender:
”,
“
From:
”,
“
Reply-To:
”,
“
To:
”,
“
Cc:
” и
“
Bcc:
”). Неквалифицированные адреса (локальные части без домена) разрешены лишь в локально-сгенерированных сообщениях и от хостов, которые совпадают с
“
sender_unqualified_hosts
” или
“
recipient_unqualified_hosts
”, соотвественно.
Отметтьте, что это условие - лишь проверка синтаксиса. Однако, обычная уловка спамеров - использовать для отправки синтаксически неверные заголовки, типа
|
и это условие может использоваться для отклонения таких сообщений, хотя они не очень часто используются.
“
verify
” =
“
helo
”
Это условие истинно, если команда HELO или EHLO была передана с клиентского хоста, и её содержимое было проверено. До него не было никаких попыток проверить содержимое HELO/EHLO, и оно выполняется как только встречаются с этим условием Смотрите описание опций
“
helo_verify_hosts
” и
“
helo_try_verify_hosts
”, для деталей о том, как запросить проверку незавсисмо от этого условия.
“
verify
” =
“
not_blind
”
Это условие проверяет, что в сообщении нет получателей скрытой копии (bcc). Каждый получатель конверта должен быть в строке заголовка
“
To:
” или в
“
Cc:
”, чтобы это условие было истинным. Локальная часть проверяется регистрозавсисмо; домен проверяется регистронезависимо. Если существуют строки
“
Resent-To:
” или
“
Resent-Cc:
”, они также проверяются. Это условие может использоваться лишь в DATA или не-SMTP ACL.
Конечно, есть множество законных сообщений, использующих скрытых получателей. Эта проверка не должна самостоятельно использоваться для блокировки сообщений.
“
verify
” =
“
recipient/<options>
”
Это условие уместно лишь после команды RCPT. Оно проверяет текущего получателя. Детали проверки адреса даны позднее, начиная с секции 39.31. После проверки получателя, значение
“
$address_data
” - последнее значение установленное прри роутинге адреса. Оно применяется даже если проверка была неуспешной. Когда проверенный адрес передаресован на один адрес, проверка продолжается с новым адресом, и в этом случае, последующее значение для
“
$address_data
” - значение дочернего адреса.
“
verify
” =
“
reverse_host_lookup
”
Это условие обеспечивает, что проверенное имя хоста было найдено из IP-адреса клиентского хоста. (Это, возможно уже случилось, если имя хоста необходимо для проверки списка хостов, или, если хост совпадает с
“
host_lookup
”.) Проверка обеспечивает, что имя хоста, полученное из обратного поиска DNS, или один из его алиасов, когда он самостоятельно ищется в DNS, действительно приводит к оригинальному IP-адресу.
Если это условие используется для логально сгенерированных сообщений (т.е. когда нет клиентского хоста), оно всегда успешно.
“
verify
” =
“
sender/<options>
”
Это условие уместно лишь после команды MAIL или RCPT, или после того, как сообщение было получено (ACL
“
acl_smtp_data
” или
“
acl_not_smtp
”). Если отправитель сообщения пустой (т.е. - это рикошет), условие истинно. Иначе, проверяется адрес отправителя.
Если есть данные в переменной конца роутинга
“
$address_data
”, её значение помещется в
“
$sender_address_data
” в конце проверки. Это значение может использовано в последующих условиях и модификаторах в том же самом утверждении ACL. Оно не сохраняется после окончания текущего утверждения. Если вы хотите сохранить значение надолго, вы можете сохранить его в переменной ACL.
Детали проверки адреса даны позднее, начиная с секции 39.31. Exim кэширует результат проверки отправителя, чтобы не делать его более одного раза на сообщение.
“
verify
” =
“
sender
” =
“
<address>/<options>
”
Это - вариант предыдущей опции, в котором модифицированный адрес проверен как отправитель.
39.21 Использование списков DNS
В самой его простой форме, условие
“
dnslists
” проверяет, находится ли вызывающий хост в по крайней мере одном из DNS списков, путём поиска инвертированного IP-адреса в одном или более DNS-домене. Например, если IP-адрес вызывающего хоста - 192.168.62.43, и утверждение ACL
|
ищется следующие записи:
|
Как только exim находит существующую запись DNS, обработка списка останавливается. таким образом, многочисленные записи в списке связаны союзом
“or
”. Если вы хотите тестировать хост более чем одним списком (и союзом
“and
”), вы можете использовать два раздельных условия:
|
Если происходит таймаут поиска в DNS, или иным образом невозможно дать окончательный ответ, exim ведёт себя, как будто хост не совпал с элементом списка, т.е., как будто запись DNS не существует. Если в списке DNS есть дальнейшие элементы, они обрабатываются.
“
Это - обычное необходимое действие, когда
dnslists
” используется с
“
deny
” (что является самым частым использованием), поскольку это препятствует ошибке DNS блокировать почту. Однако, вы можете изменить это поведение путём помещения одного из следующих специальных элементов в список:
|
Каждый из них применяется к любым последующим элементам списка. Например:
|
Тестирование списка доменов останавливается как только найдено соответствие.Если вы хотите предупреждать для одного списка и блокировать для другого, вы можете задать два различных утверждения:
|
Поиски в списках DNS кэшируются exim`ом на продолжительность сессии SMTP, таким образом, поиск основанный на IP адресе производится максимум один раз для любого входящего SMTP-соединения. Exim не разделяет информацию между несколькими входящими соединениями (но, ваш локальный кэширующий сервер имён должен быть активен).
39.22 Задание IP-адреса для поиска в списках DNS
По умолчанию, IP адрес, который используется в поиске по списку DNS - это IP-адрес вызывающего хоста. Однако, вы можете задать иной IP-адрес, путём перечисления его после доменного имени, отделённого слэшем. Например:
|
Эта особенность не очень полезна с явными IP-адресами; она предназначена для использования с искомыми IP-адресами, например, IP-адресами MX-хостов, или серверов имён почтового адреса отправителя. Для примеров, смотрите ниже, секцию 39.24.
39.23 DNS-списки основанные на именах доменов
Есть некоторые списки, которые основаны на доменных именах, вместо инвертированных IP-адресов (например, смотрите ссылку domain based zones на http://www.rfc-ignorant.org/). С этими листами реверсирования компонентов не используется. Вы можете изменить имя, которое ищется в списках DNS, путём внесения его после имени домена, отделённое слэшем. Например:
|
Этот специфический пример полезен лишь в ACL которые обрабтываются после команд RCPT или DATA, rjulf доступен адрес отправителя. Если (например) отправитель сообщения -
“
user@tld.example
”, имя искомое этим примером:
|
Одиночное условие
“
dnslists
” может содержать в себе оба вхождения - для имён и для IP-адресов. Например:
|
Первый элемент проверяет адрес отправляющего хоста; второй проверяет доменное имя. Всё условие верно, если успешен любой из поиков DNS.
39.24 Поиски в DNS основанные на нескольких ключах
Синтаксис описанный выше, для поиска в чёрных списках DNS по явно заданным значениям (или имени, или IP-адреса) - упрощение. В DNS-списке, после доменного имени сопровождаемого слэшом, фактически, может быть список элементов. Как и во всех списках exim`a, дефолтовый разделитель - двоеточие. Однако, поскольку это - подсписок в списке доменов чёрных списков DNS, необходимо удвоить разделители:
|
или изменить символ разделителя, например так:
|
Если элемент в списке - IP-адрес, он инвертируется до добавления области чёрного списка DNS. Если он - не IP-адрес, иныерсии не происходит.Рассмотрите это условие:
|
Происходящие поиски в DNS:
|
Как только найдена запись в DNS (которая совпадает с заданным возвращаемым IP-адресом, если задано - смотрите раздел 39.27), дальнейший поиск не производится. Если происходит временная ошибка поиска в DNS, пробуется остальная часть списка доменов/IP-адресов. Временная ошибка для всего элемента списка DNS происходит лишь если безуспешны поискаи по остальным DNS подспискам. Другими словами, успешный поиск для любого элемента подсписка отменяет временную ошибку для предыдущего элемента.
Способность подставлять список элементов после слэша, в некотором смысле - лишь синтаксическое удобство. Следующие два примера, имеют один и тот же эффект:
|
Однако, когда данные для списка получаются путём поиска, вторая форма, обычно, намного более удобна. Рассмотрите этот пример:
|
Отметтьте использование
“>|
” в поиске dnsdb, для задания сепаратора в нескольких DNS-записях. Внутриенний поиск dnsdb производит список хостов MX, и внешний dnsdb поиск находит IP-адреса этих хостов. Результат раскрытия условия мог бы быть чем-то вроде этого:
|
Таким образом, этот пример проверяет, действительно ли IP-адрес почтового сервера отправителя находится в чёрном списке Spamhaus.
39.25 Данные возвращаемые списками DNS
DNS списки построены с использованием записей в DNS. Оригинальный RBL использовал лишь адрес 127.0.0.1 на правой стороне каждой записи, но списки RBL+ и некоторые другие списки используют несколько значений с различными значениями. Значения используемые списками RBL+ таковы:
|
Некоторые списки DNS могут возвращать более одной адресной записи.
39.26 Переменные устанавливаемые из списков DNS
Когда в списке DNS найдено вхождение, переменная
“
$dnslist_domain
” содержит имя совпавшего домена,
“
$dnslist_text
” содержит содержимое ассоциированной TXT записи. Если поиском DNS возвращено более одной записи, все IP адреса включённые в
“
$dnslist_value
” разделяются запятыми и пробелами.
“
Вы можете использовать эти переменные в модификаторах
message
” и
“
log_message
” - хотя они появляются до условия в ACL, они не раскрываются пока не произойдёт неудача. Например:
|
39.27 Дополнительные совпадения условий для списков DNS
Вы можете добавить символ равно и IP-адрес после доменного имени
“
dnslists
”, для ограничения его действия DNS-записями с соответствующей правой стороной. Например,
|
отклоняет лишь те хосты, которые приводят к 127.0.0.2. Без этих дополнительных данных, любая адресная запись предполагается совпадающей. Если в списке найдено более одной записи, они все проверяются на соответствие правой строны.
“
Для проверки можно задать более чем один IP-адрес, используя двоеточие как разделитель. Они - альтернативы, если совпадает любой из них, условие
dnslists
” - истинно. Например:
|
Если вы хотите задать ограниченный список адресов, и, также, определить имена или IP-адреса для поиска, ограниченный список адресов должен быть задан первым. Например:
|
Если символ
“&
” используется вместо
“=
”, сравнение для каждого перечисленного IP-адреса завершается путём поразрядного
“and
” вместо теста равенства. Другими словами, перечисленные адреса используются как битовые маски. Сравнение истинно, если все биты в маске представлены в тестируемом адресе. Например:
|
совпадает с адресом
“
x.x.x.3
”,
“
x.x.x.7
”,
“
x.x.x.11
”, и т.д. Если вы хотите проверить, что представлен тот или иной бит (в противоположность представленным обоим), вы должны использовать несколько значений. Например:
|
совпадает, еслпи оследний компонент адреса - нечётное число, или удвоенное нечетное число.
39.28 Отрицательные условия сравнения DNS
Вы можете предоставлять отрицательный список IP-адресов, как часть условия
“
dnslists
”. Тогда как
|
средство
“запрет, если хост в чёрном списке домена a.b.c и IP-адрес приводит к списку в котором 127.0.0.2 или 127.0.0.3
”,
|
средство
“запрет, если хост в чёрном списке домена a.b.c и IP-адрес не приводит к списку в котором 127.0.0.2 и 127.0.0.3
”. Другими словами, результат тестирования - инвертирован, если восклицательный знак появляется перед символом
“=
” ( или
“&
”).
Отметтьте: Этот вид отрицания - не то же самое, что и отрицание домена, хостов, или списков адресов (почему и синтаксис различается).
Если вы используете только один список, синтаксис отрицания немного вам даст. Предыдущий пример эквивалентен:
|
Однако, если вы используете составные списки, синтаксис отрицания более ясен. Рассмотрите этот пример:
|
Используя только позитивные списки, это было бы так:
|
который менее ясен, и тяжелее поддерживать.
39.29 Списки DNS и IPv6
Если exim`a просят сделать поиск по списку DNS для адреса IPv6, он его инвертирует, и откусывает по кусочкам. Например, если адрес вызывающего хоста - 3ffe:ffff:836f:0a00:000a:0800:200a:c031, exim мог бы искать
|
(разбито на две строки, чтобы вписать в страницу). К сожалению, некоторые списки DNS содержат групповые записи, подразумевающие IPv4, плохо взаимодействующие с IPv6. например, DNS-запись
|
вероятно, предназначен для помещения записи 3.0.0.0/8 сети IPv4 в список. К сожалению, это также соответствует всем сетям 3::/4, для IPv6.
“
Вы можете исключить адреса IPv6 из DNS-поисков используя подходящее условие
condition
”, как в этом примере:
|
39.30 Ограничение нормы отправителей
Условие ACL
“
ratelimit
” может быть использовано для измерения и контроля частоты с которой клиент посылает электронную почту. Это более мощщное средство, чем опции
“
smtp_ratelimit_*
”, поскольку эти опции управляют частотой команд лишь в одной SMTP-сессии, тогда как условие
“
ratelimit
” работает для всех соединений (параллельных и последовательных) от того же самого хоста. Синтаксис условия
“
ratelimit
”, таков:
|
Если средний клиент, посылающий с частотой меньше
“
m
” сообщений за период времени
“
p
”, условие - ложно; иначе, оно истинно.
“
Как побочный эффект, условие
ratelimit
” устанавливает переменную раскрытия
“
$sender_rate
” в вычисленную частоту клиента,
“
$sender_rate_limit
” в сконфигурированное значение
“
m
”, и
“
$sender_rate_period
” в сконфигуриованное значение
“
p
”.
“
Параметр
p
” - постоянная временная константа, в форме интервалов времени exim`a, например, 8h - для восьми часов. Большее постоянное время, означает, что exim`y требуется большее время, чтобы забыть прошлое поведение клиента. Параметр
“
m
” - максимальное число сообщений, которые клиенту разрешено посылать в каждый интервал времени. Также, он определяет число сообщений рарешённых в быстром пакетном режиме. Путём увеличения обоих
“
m
” и
“
p
”, но оставляя неизменной константу
“
m/p
”, вы позволяете клиенту посылать больше сообщений в пактном режиме без изменения его общего предела посылки. Наоборот, если малы оба
“
m
” и
“
p
”, сообщения должны посылаться в пределах лимита.
“
Есть скрипт
util/ratelimit.pl
”, который извлекает частоту частоту отсылки из лог-файлов, помогая выбрать соостветствующие значения для
“
m
” и
“
p
”, при развёртывании условия ACL
“
ratelimit
”. Скрипт выводит инструкцию по использованию, когда он запускается без аргументов.
“
Для поиска данных, для вычисления средней частоты клиента посылки клиентом, используется ключ. Эти данные сохраняются в БД поддерживаемой exim`om в его спул-директории, наряду с другими БД подсказок. Дефолтовый ключ -
$sender_host_address
”, который применяет ограничения к каждому IP-адресу клиентского хоста. Путём изменения ключа, вы можете изменить то, как exim идентифицирует клиентов для ограничения частоты. Например, для ограничения частоты отсыла для каждого аутентифицированного пользователя, независимо от компьютера с которого отсылается, установите ключ в
“
$authenticated_id
”. Вы должны гарантировать, что ключ является значимым; например,
“
$authenticated_id
” - является значимым лишь если клиент аутентифицировался, и вы можете проверять его с условием ACL
“
authenticated
”.
“
Внутренне, exim включает сглаживание константы
p
”, и опции ключе поиска, поскольку они изменяют значение сохранённых данных. Это не истинно, для лимита
“
m
”, таким образом, вы можете изменять сконфигурированную максимальную частоту, и exim продолжает помнить предыдущее поведение клиента, но, если вы изменяете другие параметры частоты, exim забывает прошлое поведение.
“
Каждое условие
ratelimit
” может иметь до двух опций. Первая опция задаёт что exim считает мерой частоты, и вторая определяет как exim обрабатывает черезмерно быстрых клиентов. Опции разделены слэшами, как и другие параметры.
“
Опция
per_conn
” ограничивает частоту подключения клиента.
“
Опция
per_mail
” ограничиает частоту посылки сообщений клиентом. Это - значение по умолчанию, если на заданы опции
“
per_*
”.
“
Опция
per_byte
” ограничивает полосу пропускания электронной почты отправителя. Отметтьте, что её лучше использовать в DATA ACL; если это используется в более ранней ACL, она полагается на параметр SIZE в команде MAIL, которая может быть неточной, или вообще отсутствовать. Вы можете сопровождать лимит
“
m
” в конфигурации K, M, или G - для задания, соответственно, килобайт, мегабайт, или гигабайт.
“
Опция
per_cmd
” заставляет exim пересчитывать частоту при каждой обработке условия. Это может быть использовано для ограничения частоты команд SMTP. Альяс
“
per_rcpt
” предоставлен для использования в RCPT ACL вместо
“
per_cmd
”, для большей ясности, что эффект - ограничение частоты с которой принимаются получатели. Отметтьте, что в этом случае движок ограничения частоты будет видеть сообщения с несколькими получателями, как большой, высокоскоростной пакетный режим.
“
Если средняя частота клиента больше чем максимум, движок ограничения частоты может воздействтовать двумя возможными способами, зависящими от наличия опций
strict
” или
“
leaky
”. Это не завсит от других контрмер (типа отклонения сообщения), которые могут быть заданы путём остальной части ACL. Дефолтовый режим -
“
leaky
”, который избегает сверхагрессивной частоты повтора клиента, препятствуя отправке им любой почты.
“
Опция
strict
” означает, что клиентские записи частоты всегда обновляются. Эффект этого - что exim измеряет среднюю частоту клиента пытаться послать электронную почту, которая может быть значительно выше максимума. Если клиент превысит предел - он будет подвергнут контрмерам, пока он не замедлистся ниже максимальной частоты. Период сглаживания определяет время, которое требуется высокой частоте отсылки для экспоненциального снижения до 37% её пикового значения, что означает, что вы можете неработать время (число периодов сглаживания), что клиент подвергается контрмерам после резкого превышения лимита, по этой формуле:
|
Опция
“
leaky
” означает, что записи клиентской частоты не обновляются, если он превысил лимит. Эффект этого - что exim измеряет среднюю частоту успешного отсыла почты клиентом, которая не может быть больше максимума. Если клиент превышает лимит, он подвергнется контрмерам, но он всё ещё будет способен посылать почту с сконфигурированной максимальной частотой, вне зависимости от частоты его попыток. Это, в общем случае, - лучший выбор, если у вас есть клиенты с автоматическими повторами.
Другие средства ACL exim`a используются чтобы задать, какие контрмеры предпринимаются, когда превышен лимит частоты. Это может быть что-то из логгинга предупреждений (например, когда измеряется существующая частота отсылки для задания политики), через временные задержки, для замедления быстрых отправителей, до отклонения сообщений. Например:
|
Предупреждение: Если у вас нагруженный сервер, с большим количеством тестов
“
ratelimit
”, особенно с опцией
“
per_rcpt
”, вы можете пострадать от узкого места производительности, вызванного путём блокировок в БД подсказок ограничений частоты. Кроме создания мерее сложных ACL, вы можете уменьшить проблему, путём использования RAM диска для директории подсказок exim`a (обычно,
“
/var/spool/exim/db/
”). Однако, это означает, что exim потеряет все свои подсказки после перезагрузки (включая подсказки повторов, кэш обратного вызова, и данные ограничения частоты).
39.31 Проверка адресов
Несколько условий
“
verify
”, описанных в секции 39.20, вызывают проверку адреса. Эти условия могут сопровождаться опциями, которые моддифицируют процесс проверки. Опции отделены от ключевого слова, и друг от друга слэшами, и некоторые из них содержат параметры. Например:
|
Превая страдия проверки адреса, которая всегда происходит, - это запуск адреса через роутер, в
“режиме проверки
” (
“verify mode
”). Роутеры могут детектировать различие между проверкой и роутингом для доставки, и их действия могут быть множеством различных общих опций, типа
“
verify
” и
“
verify_only
” (смотрите часть 15). Если роутинг неудачен, проверка неудачна. Доступные опции таковы:
Если задана опция
“
callout
”, успешный роутинг к одному или более удалённых хостов сопровождается
“обратным вызовом
” (
“callout
”) к тем же хостам, как дополнительная проверка. Обратные вызовы и их субопции обсуждаются в следующей секции.
Если при проверке роутинга присходит ошибка отсрочки, ACL, обычно, возвращает
“defer
”. Однако, если вы включаете
“
defer_ok
” в опцию, вместо этого условие становится принудительно верным. Отметтьте, что это - главная проверочная опция, также как и субопции для обратных вызовов.
Опция
“
no_details
” охвачена в секции 39.35, в которой обсуждаются отчёты о неудаче проверки адреса отправителя.
Опция
“
success_on_redirect
” приводит к тому, что проверка всегда успешна, немедленно после успешного редиректа. По умолчанию, если редирект генерит лишь один адрес, этот адрес также проверяется. Дальнейшее обсуждение смотрите в разделе 39.36.
После неудачи проверки адреса,
“
$acl_verify_message
” содержит сообщение о ошибке, которое ассоциировано с ошибкой. Оно может быть сохранено, путём такого кодирования:
|
Если вы пишете ваше собственное сообщение о отклонении, или сообщение в логи, когда отказано в доступе, вы можете использовать эту переменную для включения информации о ошибке проверки.
“
В дополнение,
$sender_verify_failure
” или
“
$recipient_verify_failure
” (соответственно), содержат одно из следующих слов:
“
qualify
”: Адрес был дисквалифицированный (без домена), и сообщение не являлось локальным или прибывшим со свободного хоста.
“
route
”: Ошибка роутинга.
“
mail
”: Роутинг успешен, и была предпринята попытка обратного вызова; отклонение произошло до команды MAIL (т.е. в начале соединения, HELO или MAIL).
“
recipient
”: В обратном вызове была отклонена команда RCPT.
“
postmaster
”: В обратном вызове была выполнена проверка постмастера.
Как ожидается, основным использованим этих переменных будет различение между отклонением MAIL и RCPT в обратных вызовах.
39.32 Проверка обратным вызовом
Для нелокальных адресов, роутинг проверяет домен, но он неспособен сделать какую-либо проверку локальной части адреса. Есть ситуации, когда желательно какое-то средство проверки локальной части. Одним из способов это сделать, может быть создание SMTP
“
callback
”, к хосту доставки для адреса отправителя, или
“
callforward
” к последующему хосту для адреса получателя, чтобы увидеть, принимает ли хост адрес. Мы используем термин
“
callback
” для охвата обоих случаев. Отметтьте, что для адреса отправителя, обратный вызов - не к хосту клиента, который пытается доставить сообщение, а к одному из хостов, которые принимают входящую почту для домена отправителя.
“
Exim, по умолчанию, на производит обратных вызовов. Если вы хотите чтобы они происходили, вы должны запросить их, путём установки соответствующих опций, в условии
verify
”, как описано ниже. Это средство должно использоваться с осторожностью, поскольку оно может добавить много затрат ресурсов на проверку адреса. Однако, exim кэширует результаты обратных вызовов, что помогает уменьшить их стоимость. Детали о кэшировании даны в секции 39.34.
“
Обратные вызовы для получателей, обычно используются лишь между хостами, которыми управляет один и тот же администратор. Например, корпоративный шлюз может использовать обратные вызовы для проверки допустимости получателей на внутреннем почтовом сервере. Успешный обратный вызов не гарантирует, что реальная доставка на адрес была бы успешной; с другой стороны, неудачный обратный вызов гарантирует, что доставка была бы неудачной.
Если опция
callout
” представлена в условии проверяющем адрес, вторая стадия проверки происходит если адрес успешно сроучен к одному или более удалённым хостам. Обычный случай - роутинг путём роутера
“
dnslookup
” или
“
manualroute
”, где роутер определяет хосты. Однако, если роутер который не устанавливал маршруты хостов в транспорте
“
smtp
” с установкой
“
hosts
”, используются хосты транспорта. Если в транспорте
“
smtp
” установлена
“
hosts_override
”, всегда используются её хосты, вне зависимости, предоставлен или нет, роутером, список хостов.
Используемый порт берётся из транспорта, если он задан, и это - удалённый транспорт. (Для роутеров, которые лишь делают проверку, транспорт не нужно задавать.) Иначе, используется порт SMTP по умолчанию. Если удалённый транспорт задаёт исходящий интерфейс, используется он; иначе - интерфейс не определён.
Для проверки обратным вызовом отправителя, exim создаёт SMTP-соединение к удалённому хосту, для проверки, может ли быть доставлен на адрес отправителя рикошет. Посылаются следующие SMTP-команды:
|
Вместо HELO используется LHLO, если транспортная опция
“
protocol
” установлена в
“lmtp
”.
“
Проверка обратным вызовом получателя - подобна. По умолчанию, она также использует пустой адрес для отправителя. Такое значение по умолчанию выбрано потому, что большинство хостов не используют не используют адрес отправителя при проверка получателя. Использование тех же самых адресов - средство для использования одной записи в кэше для каждого получателя. Однако, некоторые сервера используют для проверки адрес отправителя. Они обслуживаются опциями
use_sender
” и
“
use_postmaster
”, описанными в следующей секции.
“
Если ответ на команду RCPT - код 2xx, проверка успешна. Если - 5xx, проверка неудачна. Для любых других обстоятельств, exim пробует следующий хост, если он есть. Если есть проблемы со всеми удалёнными хостами, ACL вернёт defer
”, если для опции
“
callout
” не дан параметр
“
defer_ok
”, в случае чего - условие принудительно успешно.
39.33 Дополнительные параметры для обратных вызовов
Опция
“
callout
” может сопровождаться символом равно и несколькими опциональными параметрами, разделёнными запятыми. Например:
|
Старый синтаксис, имевший
“
callout_defer_ok
” и
“
check_postmaster
” как отдельные опции проверки, оставлен для обратной совместимости, но его использование не приветствуется. Дополнительный параметры для
“
callout
” таковы:
“
<a time interval>
”
Этим определяется интервал, который применяется к попытке обратного вызова к каждому хосту. Например:
|
По умолчанию, он - 30 секунд. Таймаут используется для каждого ответа с удалённого хоста. Также он используется для инициации связи, если не перезадан путём параметра
“
connect
”
“
connect
” =
“
<time interval>
”
Этот параметр делает возможным установить различные (обычно, меньшие) таймауты для создания SMTP cоединения. Например:
|
Если незадано, то по умолчанию этот таймаут равен значению общего таймаута.
“
defer_ok
”
“
Когда этот параметр присутствует, ошибки соединения с любым хостом, или любые другие виды временных ошибок, обрабатываются как успех ACL. Однако, при таких обстоятельствех кэш не обновляется.
fullpostmaster
”
“
Эта опция работает как и опция
postmaster
” (смотрите ниже), но если проверка на
“
postmaster@domain
” неудачна, она пробует просто
“
postmaster
”, без домена, в соответствии с спецификацией RFC2821. RFC заявляет, что неквалифицированный адрес
“
postmaster
” должен быть принят.
“
mailfrom
” =
“
<email address>
”
“
Когда проверка адресов в строках заголовков использует проверочную опцию
header_sender
”, exim, по умолчанию, ведёт себя как будто адреса - адреса отправителя из конверта. Проверка обратным вызовом, поэтому, проверяет может ли быть доставлен рикошет, путём использования пустого адреса в команде MAIL. Однако, спорно, что эти адреса никогда бы не могли бы использоваться как отправители конверта, и поэтому рикошеты (с пустым отправителем) могли быть правомерно отклонены. Параметр обратного вызова
“
mailfrom
” позволяет вам определить, какой адрес использовать в команде MAIL. Например:
|
Этот параметр доступен лишь в опции
“
header_sender
”.
“
maxwait
” =
“
<time interval>
”
Этот параметр устанавливает полный таймаут для выпонения проверки обратным вызовом. Например:
|
По умолчанию, этот таймаут равен четырём таймаутам для индивидуальных SMTP-команд. Общий таймаут применяется когда существует более одного хоста для, который можно попробовать. Таймаут проверяется до того как пробуется следующий хост. Этот предотвращает очень большие задержки, если существует большое количество хостов, и у всех них таймаут (гапример, когда сетевой таймаут).
“
no_cache
”
“
Когда дан этот параметр, кэш обратных вызовов не читается и не обновляется.
postmaster
”
“
Когда установлен этот параметр, успешная проверка обратным вызовом сопровождается подобной проверкой на локальную часть
postmaster
”, для того же самого домена. Если этот адрес отклоняется, обратный вызов - неудачен (но, смотрите
“
fullpostmaster
”, выше). Результат проверки постмастера записывается в кэш; если она неудачна, это используется для неудачи следующего обратного вызова для домена, без создания соединения, пока не истечёт время записи в кэше.
“
postmaster_mailfrom
” =
“
<email address>
”
По умолчанию, проверка постмастера использует в команде MAIL пустой адрес отправителя. Вы можете использовать этот параметр для проверки с использованием иного адреса. Например:
|
Если представлены обе опции -
“
postmaster
” и
“
postmaster_mailfrom
”, отвергается самая правая. Параметр
“
postmaster
” эквивалентен этому примеру:
|
Предупреждение: Меры кэширования для проверки постмастера не принимают во внимание адрес отправителя. Предполагается, что будет использоваться пустой или фиксированный непустой адрес. Всё что exim запоминает - что проверка постмастера для домена успешна или неудачна.
“
random
”
“
Когда установлен этот параметр, до обычной проверки обратным вызовом, exim проверяет случайную
” локальную часть того же домена. Локальная часть, реально, не случайна - она задаётся путём раскрытия опции
“
callout_random_local_part
”, которая по умолчанию такова:
|
Идея состоит в том, чтобы попробовать определить, принимает ли удалённый хост все локальные части, без проверки. Если этот так, нет никакого смысла в выполнении обратного вызова для определённых локальных частей. Если проверка
“random
” успешна, результат сохраняется в записи кэша, и используется для принудительного успеха последующих проверок обратным вызовом, без создания соединения, до тех пор, пока не истечёт время жизни записи.
“
use_postmaster
”
Этот параметр применяется лишь к обратным вызовам проверки получателя. Например:
|
Он вызывает использование в команде MAIL непустого адреса при выполнении обратного вызова проверки получателя, и, также, для проверки
“random
”, если она сконфигурирована. Локальная часть адреса -
“
postmaster
”, и, домен - содержимое
“
$qualify_domain
”.
“
use_sender
”
Этот параметр применяется лишь к обратным вызовам проверки получателя. Например:
|
Он вызывает использование фактического адреса отправителя в команде MAIL, при проверке обратным вызовом, вместо пустого адреса. Нет необходимости использовать эту опцию, если вы не знаете, что вызываемые хосты используют отправителя при проверке получателя. Если её использовать неразборчиво, она уменьшает полноценность кэширования обратных вызовов.
“
Если вы используете любой параметр, который устанавливает непустого отправителя для команды MAIL (
mailfrom
”,
“
postmaster_mailfrom
”,
“
use_postmaster
” или
“
use_sender
”), вы должны подумать о возможных петлях. Проверка получателя, обычно, производится между двумя хостами, под одним и тем же управлением, и хост который получает обратный вызов - обычно не конфигурируется для непосредсвенного проведения обратного вызова. Поэтому, обычно, безопастно использовать
“
use_postmaster
” или
“
use_sender
” в этих случаях.
“
Однако, если вы используете непустой адрес отправителя для обратного вызова к произвольному хосту, есть вероятность, что удалённый хост сам инициирует обратный вызов к вашему хосту. Поскольку он проверяет отправителя сообщения, он, вероятно, будет использовать пустой адрес в MAIL, избегая петли обратных вызовов. Однако, в целях безопастности, лучше всего было бы настроить ваши собственные ACL, чтобы они не проводили проверку отправителя когда адрес получателя - адрес который вы используете для отправителя заголовка или проверки постмастера обратным вызовом.
Другая проблема, подумать при использовании непустых отправителей для обратных вызовов - кэширование. Когда вы устанавливаете
mailfrom
” или
“
use_sender
”, в записях кэша в качестве ключа используется комбинация отправитель/получатель; таким образом, для любого данного получателя выполянется намного больше обратных вызовов, чем когда используется пустой отправитель, или постмастер.
39.34 Кэширование обратных вызовов
Exim кэширует результаты обратных вызовов с целью уменьшить количество используемых ресурсов, если не задан параметр
“
no_cache
” с опцией
“
callout
”. База данных подсказок, называемая
“callout
”, используется для кэша. Используются два различных типа записей: первые типы записей - результат проверок обратным вызовом для специфических адресов, и другие информационные записи - которые применяются ко всему домену (например, что он принимает локальную часть
“
postmaster
”).
“
Когда оригинальный обратный вызов неудачен, дайтся детальное SMTP-сообщение о ошибке. Однако, для последующих ошибок, используются кэшированные данные, и это сообщение недоступно.
Время жизни для негативных и позитивных записей адресного кэша - независимы, и может быть установлено путём глобальной опции
callout_negative_expire
” (значение по умолчанию - 2 часа) и
“
callout_positive_expire
” (значение по умолчанию - 24 часа), соответственно.
Если хост даёт отрицательный ответ в SMTP-соединении, или отклоняет любую команду до и включительно
|
(но не включая команду MAIL с непустым адресом), любая попытка обратного вызова обязана стать неудачной. Exim помнит такие ошибки в записях кэша доменов, который используется для для неудачи обратных вызовов для домена, без создания нового соединения, пока не кончиться время жизни записи. Есть два отдельных времени окончания записей для кэша доменов:
“
callout_domain_negative_expire
” (значение по умолчанию - три часа) и
“
callout_domain_positive_expire
” (значение по умолчанию - семь дней).
“
Записи доменов истекают, когда достигается негативное время жизни, если обратный вызов не может быть сделан для домена, или если неудачна проверка постмастера. Иначе, они истекают по достижении времени истечения. Это гарантирует, например, что хост остановивший приём случайных
” локальных частей, в конечном счёте будет замечен.
Механизм кэширования обратных вызовов основан на домене проверяемого адреса. Если домен роутится к нескольким хостам, предполагается, что их поведение будет одинаковым.
39.35 Отчёты проверки адресов отправителя
Когда проверка отправителя неудачна в ACL, детали о ошибке даются как дополнительные строки до 550-го ответа на релевантную SMTP-команду (RCPT или DATA). Например, если используется обратный вызов отправителя, вы могли бы видеть:
|
Если таким же образом была неудачна более чем одна команда RCPT, делали даются лишь для первой из них. Однако, некоторые администраторы не хотят отсылать об этом слишком много информации. Вы можете подавить детализацию путём добавления
“/no_details
” к утверждению ACL которое запрашивает проверку отправителя. Например:
|
39.36 Перенаправление при проверке
Возникает дилемма, когда локальный адрес редиректится путём альясинга или форвардинга во время проверки: должны ли быть проверены сгенерённые адреса, или успешного раскрытия оригинального адреса достаточно, для подтверждения? По умолчанию, exim выбирает следующий прагматический подход:
Когда входящий адрес переадресован лишь к одному дочернему адресу, проверка продолжжается с дочерним адресом, и если проверка неудачна, оригинальная проверка также неудачна.
Когда входящий адрес переадресован более чем к одному дочернему адресу, проверка не продолжжается. Возвращается успешный результат.
Это кажется наиболее разумным поведением для общего использования альясинга, как способ редиректа различных локальных частей к тому же самому почтовому ящику. Это означает, например, что пара записей альясов формы
|
работает как ожидается, вызывая ошибку с обоими локальными частями. Когда редирект генерит более одного адреса, поведение больше походит список рассылки, где существования алиаса достаточно для успешности проверки.
“
Однако, возможно изменить дефолтовое поведение так, что все успешные редиректы считаются как успешная проверка, однако генерится много новых адресов. Это определено путём проверочной опции
success_on_redirect
”. Например:
|
В этом примере, проверка успешна, если роутер генерит новый адрес, и обратный вызов не происходит, поскольку никакой адрес не роутится на удалённый хост.
39.37 Клиентская SMTP-авторизация (CSA)
Клиентская SMTP-авторизация - система, которая позволяет чайту давать объявление, каким машинам можно, и каким нельзя посылать электронную почту. Это делается путём помещения специальной SRV записи в DNS; она ищется используя домен из HELO клиента. Во время записи (видимо - когда писался этот текст) - всё ещё черновик интернета. Клиентская SMTP-авторизация выполняется в exim`e путём условия ACL:
|
Оно неудачно, если клиент неавторизован. Если существует проблема в DNS, или не найдена действительная CSA SRV запись, или если клиент - авторизован, условие успешно. Эти три случая можно различить используя переменную раскрытия
“
$csa_status
”, которая может принимать одно из значений
“fail
”,
“defer
”,
“unknown
”, или
“ok
”. Условие, самостоятельно, не отсрочивает доставку, поскольку, вероятно, это вызвало бы проблемы для закооной почты.
“
Сообщения о ошибках производимые кодом CSA включают немного больше деталей. Если
$csa_status
” -
“defer
”, это может быть потому, что проблемы при поиске записи CSA SRV, или проблемы поиска целевой записи CSA. Есть четыре причины, чтобы
“
$csa_status
” был
“fail
”:
Клиентское имя хоста явно не разрешено.
IP адрес клиента не совпадает с какими-либо целевыми IP-адресами CSA.
Клиентское имя хоста авторизовано, но у него нет допустимых IP-адресов (например, целевые адреса - IPv6 и клиент использует IPv4).
Клиентское имя хоста не имеет записи CSA SRV, но родительский домен явно утверждает, что все субдомены должны быть явно разрешены.
Условие проверки CSA может принимать аргумент, являющейся доменом для использования в запроса DNS. Значение по умолчанию:
|
Это воплощение включает расширение к CSA. Если запрос домена - буквальный адрес, типа [192.0.2.95], или если это голый IP-адрес, exim ищет записи записи в обратных DNS, как юудто домен HELO был (например)
“
95.2.0.192.in-addr.arpa
”. Поэтому, это значит сказать:
|
Фактически, это проверка, выполянемая exim`ом если клиент не сказал HELO. Это расширение может быть отключено путём установки опции, в главной конфигурации,
“
dns_csa_use_reverse
”, в ложь.
“
Если непосредственно для домена не найдена запись CSA SRV, поиск выполянется через его родительские домены для записи, которая могла бы сделать утверждение о субдоменах. Максимальная глубина этого поиска ограничена используя опцию главной конфигурации
dns_csa_search_limit
”, которая по умолчанию равна 5. Exim не ищет CSA SRV в домене верхнего уровня, таким образом, дефолтовая установка обработки домена HELO - семь (
“
hostname.five.four.three.two.one.com
”). Это охватывает большинство легитимных доменов HELO.
“
Поиск
dnsdb
” также имеет поддержку для CSA. Хотя
“
dnsdb
”, также, поддерживает прямые поиски SRV, этого недостаточно из-за поведения высшего домена для для поиска CSA, и (как с поисками PTR)
“
dnsdb
” также превращает IP-адреса в поиске в обратном пространстве DNS. Результат успешного поиска, типа:
|
имеет два поля разделённых пробелами: Код авторизации, и имя целевого хоста. Авторизационный код может быть
“Y
” - для yes,
“N
” - для no,
“X
” - для явно требуемого разрешения, но отсутствия, или
“?
” - для неизвестного.
39.38 Проверка тега адреса рикошета
Проверка тега адреса рикошета (Bounce address tag validation - BATV), это схема, посредством которой отправители конверта исходящего сообщения имеют добавленный к ним
“tag
” - шифрованный, с меткой времени. Подлинные входящие рикошеты всегда должны быть адресованы получателям,, которые имеют действительный тег. Эта схема - способ детектировать нежелательные рикошеты, вызванные подделкой адреса (часто называемые
“сопутствующий спам
”), поскольку получатели таких сообщений не содержат в себе действительный тег.
“
Есть два элемента раскрытия для помощи в реализации схемы BATV prvs
” (частная подпись - private signature) в конфигурации exim`a. Эта схема подписывает оригинальный адрес отправителя конверта путём использования простого разделённого ключа для добавления хэша адреса и некоторой, основанной на времени рандомизированной информации. Элемент раскрытия
“
prvs
” создаёт подписанный адрес, и элемент раскрытия
“
prvscheck
” проверяет его. Синтаксис этих пунктов описан в разделе 11.5.
Как пример, предположим, что секретные ключи (по ключу на адрес) были сохранены в БД MySQL. Запрос для поиска ключа для адреса мог быть определён макросом типа этого:
|
Предположим, также, что отправители использующие BATV заданы списком адресов называемым
“
batv_senders
”. Тогда, в ACL для команд RCPT вы могли бы использовать это:
|
Первое утверждение отклоняет получателей для рикошетов, которые адресованы простым адресам отправителей BATV, поскольку известно, что отправители BATV не отсылают сообщения с открытым адресом отправителя. Второе утверждение отклоняет получателей которые подписаны prvs, но с неверными сигнатурами (или потому что неверный ключ, или произошёл таймаут сигнатуры).
“
Адреса, не подписанные prvs, не отклоняются вторым утверждением, поскольку раскрытие
prvscheck
” приносит пустую строку, если его первый аргумент не prvs-подписанный адрес, вызывая, таким образом, что условие
“
condition
” становится ложным. Если первый аргумент - синтаксически верный prvs-подписанный адрес, возвращается третья строка (в этом случае -
“1
”), независимо от успеха проверок шифрования и таймаута. Переменная
“
$prvscheck_result
” содержит результат проверок (пустая - для ошибки,
“1
” - для успеха).
Есть ещё две проблемы, которые вы должны рассмотреть при осуществлении prvs-подписей. Во-первых, вы должны гарантировать, что prvs-подписанный адрес не блокируется вашими ACL. Такие адреса содержат символы слэша, но дефолтовая конфигурация exim`a содержит это утверждение в ACL RCPT:
|
Это - консервативное правило, которое блокирует локальные части содержащие слэши. Вы должны удалить слэш в последней строке.
“
Во-вторых, вы должны гарантировать, что роутеры примут prvs-подписанные адреса, и корректно доставят их. Самый простой способ обработать их - использовать роутер
redirect
”, для удаления сигнатуры, с подобной конфигурацией:
|
Это работает потому, что если третий аргумент
“
prvscheck
” - пустой, результат раскрытия prvs-подписанного адреса - декодированное значение оригинального адреса. Этот роутер, вероятно, должен быть первым в ваших роутерах, которые обрабатывают локальные адреса.
Для создания BATV-подписанного адреса в первом месте, может использоваться транспорт такой формы:
|
Если для существующего пути возврата ключ не может быть найден, подписывания не происходит.
39.39 Использование ACL для упавления релеингом
MTA, как говорят, передает (relay) сообщение, если оно передаётся с некоторого хоста, и непосредственно доставляется на другой хост, как результат удалённого адреса содержавшегося в нём. Переадресация локальных частей через файл альясов или форвардов, и, затем, пеердача сообщения на другой хост - не релеинг, но редирект в результате обработки символа процента (
“percent hack
”) - да.
“
Существует два вида релеинга, которые называют incoming
” и
“outgoing
”. Хост, дейтвующий как шлюз, или резервный MX - имеет отношение ко входящему релеингу, от произвольных хостов к специфически установленным доменам. С другой стороны, хост, выступающий в роли умного хоста для множества клиентов, имеет отношение к исходящему релеингу от этих клиентов ко всему интернету. Часто, некоторые хосты выполняют обе функции, но, в принципе, эти два вида релеинга полностью независимы. То, что не требуется - передача почты с произвольного удалённого хоста через вашу систему к произвольным доменам.
Вы можете осуществить контроль релея путём подходящих утверждений ACL, которые выполняются для каждой команды RCPT. Для удобства, часто, самое лёгкое, использовать средство именованного списка exim`a, для задания вовлечённых зоменов и хостов. Например, предположим, что вы хотите следующее:
Доставлять множество доменов в почтовые ящики локального хоста (или локально обрабатывать их каким-то другим способом). Скажем, они -
“
my.dom1.example
” и
“
my.dom2.example
”.
Релеить почту для множества других доменов, для которых вы являетесь вторичным MX. Это могли бы быть
“
friend1.example
” и
“
friend2.example
”.
Релеить почту от хостов в вашей локальной LAN, к любым вовлечённым доменам. Предположим, ваша LAN - 192.168.45.0/24.
В главной части конфигурации, вы помещаете следующие определения:
|
Теперь вы можете использовать эти определения в ACL, работающих для каждой команды RCPT:
|
Первое утверждение принимает любую команду RCPT, которая содержит адрес в локальном или релейном домене. Для любых других доменов, управление передаётся второму утверждению, которое принимает команды, лишь если они приходят с релейных хостов. Практически, вы, вероятно, захотите создать свою, более сложную ACL чем эта, например, путём включения отправителя и проверки получателя. Дефолтовая конфигурация включает более всесторонний пример, который описан в части 7.
39.40 Проверка конфигурации релея
Вы можете проверить характеристики релея вашей конфигурации таким же образом, как и проверяете поведение любой ACL для входящих SMTP-подключений, путём использования опции
“
-bh
”, для запуска поддельной SMTP-сессии, с которой вы взаимодействуете.
“
Для особого тестирования на нежелательный релеинг, хост
relay-test.mail-abuse.org
” предоставляет полезный сервис. Если вы подключитесь по telnet на этот хост с хоста на котором запущен exim? используя обычный порт telnet, вы увидите обычное сообщение о соединении telnet, и, затем, довольно долгая задержка. Будте терпеливы. Удалённый хост создаёт SMTP-соединение обратно на ваш хост, и пробует множество обычных исследований на тестирование уязвимости - открытый релей. Результаты тестов, в конечном счёте, появятся на вашем терминале.
=============
Автор перевода: lissyara, оригинал: http://www.lissyara.su/?id=1200
Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру