<spool_directory>/scan/<message_id>/<message_id>.eml

   Расширение “.eml” - дружелюбная подсказка вирусным сканерам, что они могут ожидать внутри файла структуру подобную MBOX. Файл создаётся при первом вызове средства контентного сканирования. Последующие вызовы условий контентного сканирования снова открывают тот же самый файл. Директория рекурсивно удаляется когда ACL “acl_smtp_data” завершает работу, если не установлена опция:


control = no_mbox_unspool

Когда ACL MIME декодирует файлы, они, по умолчанию, кладутся в тот же самый каталог.



41.1 Сканирование на вирусы

   Условие ACL “malware” позволяет вам подключить программу вирусного сканера к exim'y. Оно поддерживает “общий” (“generic”) интерфейс к сканерам, вызываемым через шелл, и специализированные интерфейсы для вирусных сканеров типа “daemon”, которые постоянно находятся в памяти и, поэтому, значительно быстрее.
   Вы можете установить опцию “av_scanner” в первой части конфигурационного файла exim, для задания используемого сканера, вместе с любыми необходимыми дополнительными опциями. Базовый синтаксис - следующий:


av_scanner = <scanner-type>:<option1>:<option2>:[...]

   Если вы не установите “av_scanner”, по дефолту она будет:


av_scanner = sophie:/var/run/sophie

   Если значение “av_scanner” начинается с символа доллара, оно раскрывается до использования. В этом релизе поддерживаются следующие типы сканеров:


Virus 'W32/Magistr-B' found in file ./those.bat

   Для триггерного выражения, мы можем использовать совпадение с фразой “found in file”. Для именного выражения, мы хотим извлечь строку “W32/Magistr-B”, таким образом, мы можем установить соответствие для одиночных кавычек - левой и правой. В целом, создаётся такая конфигурационная установка:


av_scanner = cmdline:\ /path/to/sweep -ss -all -rec -archive %s:\ found in file:'(.+)'

av_scanner = drweb:/var/run/drwebd.sock
av_scanner = drweb:192.168.2.20 31337

   Если вы опускаете этот параметр, используется дефолтовый путь - “/usr/local/drweb/run/drwebd.sock”. Спасибо Alex Miller, за внесение кода для этого сканера.



av_scanner = fsecure:/path/to/.fsav

   Если аргументов не задано, то значение по умолчанию - “/var/run/.fsav”. Спасибо Johan Thelmen, за внесение кода для этого сканера.



av_scanner = kavdaemon:/opt/AVP/AvpCtl

   Дефолтовый путь - “/var/run/AvpCtl”.



av_scanner = mksd:2

   Вы можете спокойно пропустить эту опцию (т.к. значение по умолчанию 1).



av_scanner = sophie:/tmp/sophie

   Путь по умолчанию - “/var/run/sophie”, так что если вы используете его, то можете опустить эту опцию.

   Когда “av_scanner” коректно установлена, вы можете использовать условие “malware” в DATA ACL. Отметьте: Вы не можете использовать условие “malware” в MIME ACL.
   Опция “av_scanner” раскрывается при каждом вызове “malware”. Это позволяет использовать различные сканеры. Смотрите ниже примеры использования. Условие “malware” кэширует свои результаты, таким образом, вы можете использовать его неоднократно для одного и того же сообщения, фактически, процесс сканирования выполняется лишь один раз. Однако, использование раскрываемых элементов в “av_scanner” отключает кэширование, и каждое использование условия “malware” вызывает новое сканирование сообщения.
   Условие “malware” берёт правый параметр, который раскрывается до использования. Он может быть одним из:


deny message = This message contains malware ($malware_name)
     demime = *
     malware = *

   Следующий пример принимает сообщения когда у сканера проблемы:


deny message = This message contains malware ($malware_name) demime = * malware = */defer_ok

   Следующий пример показывает как использовать переменную ACL для сканирования обоими - sophie и aveserver. Он предполагает, что вы установили:


av_scanner = $acl_m0

в главной конфигурации exim'a


deny message = This message contains malware ($malware_name) set acl_m0 = sophie malware = * deny message = This message contains malware ($malware_name) set acl_m0 = aveserver malware = *

41.2 Сканирование с SpamAssassin

   Условие ACL “spam” вызывает даемона “spamd” SpamAssassin’а для получения очков за спам и отчёта для сообщения. Вы можете получить SpamAssassin по адресу http://www.spamassassin.org, или, если у вас есть рабочая инсталляция Perl, вы можете использовать CPAN, путём запуска:


perl -MCPAN -e 'install Mail::SpamAssassin'

   SpamAssassin обладает собственным набором конфигурационных файлов. Пожалуйста, посмотрите его документацию, чтобы узнать, как вы можете его настроить. Однако, и дефолтовая инсталляция работает хорошо.
   Установив и настроив SpamAssassin, запустите даемон “spamd”. По умолчанию, он слушает 127.0.0.1, TCP порт 783. Если вы используете иной хост или порт для “spamd”, вы должны установить лпцию “spamd_address” в глобальной части конфигурации exim'a, следующим образом (например):


spamd_address = 192.168.99.45 387

   Вам нет нужды устанавливать эту опцию, если вы используете значение по умолчанию. Для версии 2.60, “spamd” также поддерживает коммуникацию через UNIX-сокеты. Если вы хотите их использовать, установите “spamd_address” в абсолютный путь до сокета, вместо пары адрес/порт:


spamd_address = /var/run/spamd_socket

   У вас может быть несколько серверов “spamd”, для улучшения масштабируемости. Они могут находиться на других железках, доступных по сети. Для задания нескольких серверов “spamd”, установите в опцию “spamd_address” несколько пар адрес/порт, разделённых двоеточиями:


spamd_address = 192.168.2.10 783 : \ 192.168.2.11 783 : \ 192.168.2.12 783

   Поддерживается вплоть до 32 серверов “spamd”. Сервера запрашиваются случайным образом. Когда сервер не в состоянии ответить на попытку подключения, пробуются все другие сервера, пока какой-либо не будет успешным. Если ни один сервер не ответил, условие “spamd” задерживается.
   Предупреждение: Невозможно использовать соединение через UNIX-сокет с несколькими серверами “spamd”.

   Переменная “spamd_address” раскрывается до её использования, если она начинается с символа доллара. В этом случае, раскрытие может вернуть строку которая используется как список, таким образом, результатом раскрытия может быть несколько серверов spamd.



41.3 Вызов SpamAssassin из ACL exim'a

   Вот - простой пример использования условия “spam” в DATA ACL:


deny message = This message was classified as SPAM spam = joe

   Правая сторона условия “spam” определяет имя пользователя. Это релевантно если у вас настроены многочисленные профили SpamAssasin. Если вы не хотите использовать сканирование конкретного пользователя, а хотите использовать профиль SpamAssassin как дефолтовый профиль системы, вы можете сканировать для неизвестного пользователя, или просто использовать “nobody”. Однако, вы должны поместить что-то в правую строну.
   Имя позволяет вам использовать антиспамовый профили на домен, или на пользователя, но, на практике это не просто, поскольку сообщение может иметь нескольких получателей, не обязательно всех в одном домене. Поскольку условие “spam” должно быть вызывано из ACL DATA, чтобы оно могло прочесть содержимое сообщения, переменные “$local_part” и “$domain” не установлены.
   Правая сторона раскрывается до использования, таким образом, в неё вы можете поместить поиск или условие. Когда правая строна вычисляется в “0” или “false”, сканирования не происходит, и условие немедленно неуспешно.
   Сканирование с помощью SpamAssassin использует много ресурсов. Если вы сканируете каждое сообщение, большие сообщения могут вызывать существенное ухудшение производительности. Поскольку, большинство спама - маленькие сообщения, рекомендуется, чтобы вы не просматривали большие. Например:


deny message = This message was classified as SPAM condition = ${if < {$message_size}{10K}} spam = nobody

   Условие “spam” возвращает истину, если происходит соответствие или превышение заданному в пользовательском профиле SpamAssassin`a. Если вы хотите использовать условие “spam” для его стронних эффектов (смотрите ниже, переменные), вы можете заставить его всегда возвращать “true”, путём добавления к имени пользователя “:true”.
   Когда выполняется условие “spam”, оно устанавливает множество пеерменных раскрытия. За исключением
“$spam_score_int”, они доступны лишь внутри ACL; их значения не сохраняются с сообщением, и, таким образом, не могут быть использованы во время доставки.


deny message = This message was classified as SPAM
     spam    = joe/defer_ok

   Это вызывает приём сообщения, даже если существуют проблемы со “spamd”.
   Вот - более длинный, прокомментированный пример использования условия “spam”:


# put headers in all messages (no matter if spam or not) warn spam = nobody:true add_header = X-Spam-Score: $spam_score ($spam_bar) add_header = X-Spam-Report: $spam_report # add second subject line with *SPAM* marker when message # is over threshold warn spam = nobody add_header = Subject: *SPAM* $h_Subject: # reject spam at high scores (> 12) deny message = This message scored $spam_score spam points. spam = nobody:true condition = ${if >{$spam_score_int}{120}{1}{0}}

41.4 Сканирование частей MIME

   Глобальная опция “acl_smtp_mime” определяет ACL которая вызывается для каждой MIME части SMTP сообщения, включая типы состоящие из нескольких частей (multipart), в последовательности их позиций в сообщении. Точно также, опция “acl_not_smtp_mime” определяет ACL, которая используется для MIME частей не-SMTP сообщений. Эти опции могут обе относиться к одной и той же ACL если вы хотите одну и ту же обработку в обоих случаях.
   Эти ACL вызываются (возможно, несколько раз) лишь до ACL “acl_smtp_data”, в случае сообщения SMTP, или лишь до приёма не-SMTP сообщений, или, просто до ACL “acl_not_smtp”, в случае не-SMTP сообщения. Однако, MIME ACL вызывается лишь если сообщение содержит строку заголовка “MIME-Version:”. Когда вызов MIME ACL не приводит к “accept”, обработка ACL прерывается, и клиенту посылается соответствующий код результата. В случае SMTP-сообщения, ACL “acl_smtp_data” не вызывается когда это происходит.
   Вы не можете использовать условия “malware” или “spam” в MIME ACL; они могут использоваться лишь в DATA или не-SMTP ACL. Однако, вы можете использовать условие “mime_regex” для сравнения с декодированной MIME-частью (смотрите секцию 41.5).
   В начале MIME ACL, множество переменных устанавливаются из информации заголовков для релевантной части MIME. Это описано ниже. По умолчанию, содержимое части MIME не декодируется в файл на диске, исключая части MIME чей тип содержимого - “message/rfc822”. Если вы хотите декодировать часть MIME в файл на диске, вы можете использовать условие “decode”. Общий синтаксис таков:


decode = [/<path>/]<filename>

   Правая строна раскрывается до использования. После раскрытия значение может быть:
1. “0” или “false”, в случае чего декодирования не происходит.
2. Строка “default”. В этом случае, файл кладётся во временную “дефолтовую” директорию “<spool_directory>/scan/<message_id>/” с последующим именем файла, состоящим из идентификатора сообщения и последующего номера. Полный путь и имя доступны в “$mime_decoded_filename” после декодирования.
3. Полный путь с именем начинается со слэша. Если полное имя - существующая директория, она используется как замена для дефолтовой директории. Имя файла добавляется последовательно. Если путь не существует; он используется как полный путь и имя файла.
4. Если строка не начинается со слэша, она используется как имя файла, и используется дефолтовый путь.
   Условие “decode”, обычно, успешно. Оно ложно лишь для синтаксических ошибок или в необычных обстоятельтвах, типа нехватки памяти. Вы можете легко расшифровать с его оригинальным, предполагаемым именем, используя


decode = $mime_filename

   Однако, вы должны иметь ввиду, что “$mime_filename” может содержать что угодно. Если вы помещаете файлы вне пути дефолтового пути, они не удаляются автоматически.
   Для вложений RFC822 (сообщений вложенных в сообщения, с типом содержимого “message/rfc822”), ACL вызывается снова, таким же самым образом как для первичного сообщения, лишь если установлена переменная раскрытия “$mime_is_rfc822” (смотрите ниже). Приложенные сообщения всегда декодируются на диск до проверки, и файлы удаляются после завершения проверки.
   ACL MIME поддерживает условия “regex” и “mime_regex”. Они могут использоваться для сравнения регулярного выражения с сырыми и декодированными частями MIME, соответственно. Они описаны в секции 41.5.
   Следующий список описывает все переменные раскрытия, которые доступны в ACL MIME:


us-ascii
gb2312 (Chinese)
iso-8859-1

   Пожалуйста, отметьте, что это значение не нормализовано, таким образом, вы должны его сравнивать регистронезависимо.


text/plain
text/html
application/octet-stream
image/jpeg
audio/midi

   Если часть MIME не имеет заголовка “Content-Type:”, эта переменная содержит пустую строку.


41.5 Сканирование с регулярными выражениями

   Вы можете задать ваши собственные регулярные сообщения, совпадающие с полным телом сообщения, или индивидуальными частями MIME.
   Условие “regex” получает одно или более регулярное выражение как аргумент, и сравнивает его с полным сообщением (при вызове в DATA ACL), или сырой частью MIME (при вызове в MIME ACL). Условие “regex” сравнивается построчно, с максимальной длинной строки в 32k символов. Это означает, что вы не можете получить многострочные сравнения с условием “regex”.
   Условие “mime_regex” может быть вызывано лишь в ACL MIME. Оно сравнивается вплоть до 32k декодированного содержимого (всё содержимое сразу, не построчно). Если часть не была декодирована с модификатором “decode” ранее в ACL, она автоматически декодируется при выполнении “mime_regex” (используя дефолтовый путь и значение имени файла). Если декодированные данные более 32k, проверяются лишь первые 32k.
   Регулярные выражения передаются как список разделённый двоеточиями. Для включения символа двоеточия, вы должны его удвоить. Так как правая строка раскрыватся до использования, вы, также, должны экранировать символ доллара и обратные слэши обратными слэшами, или используя средство “\N”, для отключения раскрытия. Вот - простой пример, который содержит два регулярных выражения:


deny message = contains blacklisted regex ($regex_match_string) regex = [Mm]ortgage : URGENT BUSINESS PROPOSAL

   Условие возвращает истину, если совпадает любое регулярное выражение. Тогда устанавливается переменная раскрытия “$regex_match_string”, и содержит соответтсвующее регулярное выражение.
   Предупреждение: С большими сообщениями, это условие может быть довольно ресурсоёмким.



41.6 Условие “demime”

   Условие ACL “demime” предоставляет распаковку MIME, проверяя корректность и блокируемые расширения файлов. Оно может использоваться лишь в DATA и не-SMTP ACL. Условие “demime” использует более простой интерфейс к декодированию MIME, чем функциональность MIME ACL, но не предоставляет никаких дополнительных средств. Пожалуйста, отметьте, что это условие устарело, и оставлено лишь для обратной совместимости. Вы должны установить опцию WITH_OLD_DEMIME в “Local/Makefile” во время сборки, для возможности использовать условие “demime”.
   Условие “demime” распаковывает в сообщении контейнеры MIME. Оно детектирует ошибки в MIME контейнерах, и может сравнивать расширения файлов найденные в сообщении со списком. Использование этого средства приводит к файлам содержащим распакованные части MIME сообщения во временной директории сканирования. Если вы производите сканирование антивирусом, рекомендуется использовать условие demime до условия антивируса (“malware”).
   В правой строне условия “demime” вы можете поместить список, разделённый двоеточиями, расширений файлов, с которыми оно будет сравниваться. Например:


deny message = Found blacklisted file attachment demime = vbs:com:bat:pif:prf:lnk

   Если найдено одно из расширений файлов, условие истинно, иначе - ложно. Если при демимизации происходит временная ошибка (например, “disk full”), условие задержано, и сообщение временно отклоняется (если только в условии не стоит команда “warn”).
   Правая строна раскрывается до использования как списка, таким образом, вы можете использовать в ней поиск. Если раскрытие приводит к пустой строке, “false”, или нулю (“0”), демимизации не происходит и условие неудачно.
   Условие “demime” устанавливает следующие переменные:
“$demime_errorlevel” - Когда в контейнере MIME детектируется ошибка, эта переменная содержит серьёзность ошибки, как целое число. Чем выше значение, тем более серьёзная ошибка (текущее максимальное значение - 3). Если эта переменная незадана, или нулевая, ошибок не было.
“$demime_reason” - Когда “$demime_errorlevel” более нуля, эта переменная содержит удобочитаемую текстовую строку описывающую встреченную ошибку MIME.
“$found_extension” - Когда условие “demime” истинно, эта переменная содержит найденное расширение файла.
   Обе, “$demime_errorlevel” и “$demime_reason” устанавливаются при первом вызове условия “demime”, и не изменяются при последующих вызовах.
   Если вы не хотите проверять расширения файлов, а использовать условие “demime” для распаковки или с целью проверки ошибок, поместите “*” в правую строну. Вот - более сложный пример использования этого средства:


# Reject messages with serious MIME container errors deny message = Found MIME error ($demime_reason). demime = * condition = ${if >{$demime_errorlevel}{2}{1}{0}} # Reject known virus spreading file extensions. # Accepting these is pretty much braindead. deny message = contains $found_extension file (blacklisted). demime = com:vbs:bat:pif:scr # Freeze .exe and .doc files. Postmaster can # examine them and eventually thaw them. deny log_message = Another $found_extension file. demime = exe:doc control = freeze

=============
translated by lissyara
verifying by Gerk