Секция [IMAP]

В этой секции находятся настройки модуля drweb-imap (компонент IMAP filter, используемый для перехвата писем по протоколу IMAP при работе с почтовыми клиентами):

ServerAddress = {адрес}

Адрес, по которому следует подключаться к серверу IMAP.

Значение по умолчанию:

ServerAddress = inet:imap@127.0.0.1

ListenAddress = {список адресов}

Список адресов сокетов, на которых следует ожидать подключений клиентов.

Допустимы адреса вида inet: или inet-ssl: (если вы используете TLS/SSL шифрование). Последний требует от фильтра задействовать протокол IMAPS.

Значение по умолчанию:

ListenAddress = inet:5200@0.0.0.0

ServerTLSSettings = {настройки TLS/SSL}

Настройки TLS/SSL, используемые для подключений в качестве сервера.

Подключения в качестве TLS/SSL сервера возможны, только если заданы сертификат (certificate) и  закрытый ключ (private_key_file), а адрес для подключения указан с типом сокета inet-ssl.

Пример:

ServerTLSSettings = use_sslv2 no, private_key_file /path/to/pkey, certificate  /path/to/certificate

Обратите внимание, что пользователь, с правами которого работает IMAP-фильтр (обычно drweb), должен иметь права на чтение файла сертификата.

Кэширование SSL-сессий в текущей версии не поддерживается.

Значение по умолчанию:

ServerTLSSettings =

ClientTLSSettings = {настройки TLS/SSL}

Настройки TLS/SSL, используемые для подключений в качестве клиента.

Пример:

ClientTLSSettings = use_sslv2 no, private_key_file /path/to/pkey, certificate /path/to/certificate

Обратите внимание, что пользователь, с правами которого работает IMAP-фильтр (обычно drweb), должен иметь права на чтение файла сертификата.

Кэширование SSL-сессий в текущей версии не поддерживается.

Значение по умолчанию:

ClientTLSSettings =

IoTimeout = {время}

Максимальное время ожидания для любых операций ввода и вывода с сокетом клиента для уже начавшейся операции.

Значение по умолчанию:

IoTimeout = 60s

ProcessingTimeout = {время}

Максимально допустимое время обработки письма модулем drweb-maild.

Значение по умолчанию:

ProcessingTimeout = 60s

MinFilterToMaildConnections = {числовое значение}

Минимальное число соединений между фильтром IMAP и drweb-maild.

Значение по умолчанию:

MinFilterToMaildConnections = 2

MaxFilterToMaildConnections = {числовое значение}

Максимальное число соединений между фильтром IMAP и модулем drweb-maild.

При значении 0 количество соединений не ограничено.

Значение по умолчанию:

MaxFilterToMaildConnections = 0

FilterToMaildKeepAliveTime = {время}

Максимальное время удержания неактивных соединений между фильтром IMAP и drweb-maild сверх минимального количества соединений.

Для обращения к drweb-maild фильтр поддерживает несколько соединений с ним, каждое из которых может обслуживать одну операцию. Если свободных соединений нет, создаются новые, пока их число не достигнет порогового значения, указанного в параметре MaxFilterToMaildConnection. При простое свободных соединений в течение времени, заданного в параметре FilterToMaildKeepAliveTime, они закрываются, но общее их число не снижается ниже значения MinFilterToMaildConnections.

Значение по умолчанию:

FilterToMaildKeepAliveTime = 60s

CallbackPoolOptions = {настройки пула}

Настройки дополнительного пула потоков, обрабатывающих сигналы от drweb-maild об окончании обработки письма.

Значение по умолчанию:

CallbackPoolOptions = auto

PoolOptions = {настройки пула}

Настройки основного пула потоков, обрабатывающих подключения клиентов.

На каждое подключение требуется новый поток, иначе некоторые клиенты будут ожидать появления потока неподключенными.

Значение по умолчанию:

PoolOptions = auto

MaxConnections = {числовое значение}

Максимальное количество входящих соединений.

Если указано значение 0, то количество входящих соединений не ограничено.

Значение по умолчанию:

MaxConnections = 0

MaxConnectionsPerIp = {числовое значение}

Максимальное количество одновременных соединений, разрешенных для одного IP-адреса (клиента).

Если указано значение 0, то количество входящих соединений для одного IP-адреса не ограничено.

Значение по умолчанию:

MaxConnectionsPerIp = 0

DisablePlainText = {логический}

Запретить клиенту передачу имени и пароля в незашифрованном виде.

Требует предварительной настройки OpenSSL.

Значение по умолчанию:

DisablePlainText = no

DoS_Blackhole = {логический}

Обрывать соединение, если с одного IP приходит слишком много запросов на подключение, не возвращая клиенту сообщение о причине ошибки.

Значение по умолчанию:

DoS_Blackhole = no

MaxCommandLength = {размер}

Максимальный размер команды для протокола IMAP.

Команда - это строка, которую посылает клиент серверу. Максимальный размер команды, которую клиент может послать - около 1000 байт согласно действующему RFC.

Обратите внимание, что если значение параметра установить равным нулю или очень маленьким (до 10 байт), то команды клиентов не будут восприниматься.

Значение по умолчанию:

MaxCommandLength = 1000b

MaxCachedHeadersPerMail = {размер}

Максимальное количество памяти, которое можно выделять для сохранения часто используемых заголовков.

Фильтр IMAP кэширует основные заголовки сообщений в оперативной памяти для ускорения доступа к ним.

Если указано значение 0, то размер выделяемой для сохранения заголовков памяти не регулируется (ограничен лишь размером доступной памяти).

Значение по умолчанию:

MaxCachedHeadersPerMail = 64k

MaxLettersPerUser = {числовое значение}

Максимальное количество писем, которые следует кэшировать в течение одной сессии.

Фильтр IMAP содержит кэш проверенных писем, поскольку протокол IMAP позволяет клиенту совершать множество частичных запросов к одному сообщению.

В большинстве случаев запросы идут последовательно, но если пользователь будет обращаться к нескольким записям, то потребуется кэшировать более одного сообщения.

Если значение данного параметра установить в 0 (что настоятельно не рекомендуется), то это будет означать отсутсвие ограничений по количеству кэшируемых писем.

Значение по умолчанию:

MaxLettersPerUser = 6

MaxDiskPerUSer = {размер}

Максимальный размер места на диске, отведенного под кэшированные письма.

Значение по умолчанию:

MaxDiskPerUSer = 10m

OnFilterErrors = {список действий}

Действие, применяемое к письму при ошибке, возникшей до отправки письма модулю drweb-maild.

Возможные значения: reject или pass.

Значение по умолчанию:

OnFilterErrors = reject