Секция [POP3]

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

ServerAddress = {адрес}

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

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

ServerAddress = inet:pop3@localhost

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

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

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

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

ListenAddress = inet:5110@localhost

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

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

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

ServerTLSSettings =

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

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

Пример:

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

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

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

ClientTLSSettings =

IoTimeout = {время}

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

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

IoTimeout = 60s

ProcessingTimeout = {время}

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

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

ProcessingTimeout = 60s

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

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

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

MinFilterToMaildConnections = 2

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

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

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

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

MaxFilterToMaildConnections = 0

FilterToMaildKeepAliveTime = {время}

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

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

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

FilterToMaildKeepAliveTime = 30s

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

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

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

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

PoolOptions = auto

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

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

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

CallbackPoolOptions = auto

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

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

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

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

MaxConnections = 0

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

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

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

DoS_Blackhole = no

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

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

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

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

DisablePlainText = No

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

Ограничение на общее количество одновременных подключений с одного адреса.

Если указано значение 0, то ограничений нет.

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

MaxConnectionsPerIp = 0

MaxCommandLength = {размер}

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

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

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

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

MaxCommandLength = 1000b

OnFilterErrors = {действие}

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

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

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

OnFilterErrors = reject