Дополнительные настройки почты

Таблица дополнительных настроек почты позволяет производить тонкую настройку параметров отправки и получения почты. Каждый параметр определен Именем и Значением. Однако все параметры вносятся в форме строки, а Тип параметров в таблице ниже просто объясняет, как интерпретируется значение параметра. Например, если параметр логический, его строковое значение должно быть true или false.

В большинстве случаев достаточно использовать только базовые опции для должной настройки e-mail операций. Используйте дополнительные настройки только если ваши базовые настройки не работают, и вы знакомы с e-mail операциями.

Пример: Чтобы включить отправку почты через SSL SMTP сервер, установите следующие дополнительные опции:

mail.smtp.port=465

mail.smtp.auth=true

mail.smtp.starttls.enable=true

Пример: Чтобы включить отправку почты через сервер Google Mail (@gmail.com), используйте следующие дополнительные опции:

mail.smtp.port=587

mail.smtp.auth=true

mail.smtp.starttls.enable=true

mail.smtp.ssl.protocols=TLSv1.2

Пароль сервера исходящей почты @gmail генерируется через пароль для приложений и не является тем же паролем, который используется для входа в пользовательский интерфейс.

Общие параметры

Имя

Тип

Описание

mail.debug

Boolean

Предварительный режим отладки. По умолчанию false.

mail.from

String

Обратный e-mail адрес текущего пользователя.

mail.mime.address.strict

Boolean

Активирует точный разбор строк заголовков сообщений. По умолчанию true.

mail.host

String

Имя хоста почтового сервера по умолчанию. Используется, если свойство mail.protocol.host не задано.

mail.store.protocol

String

Определяет протокол доступа к сообщениям по умолчанию ("pop3", "pop3s", "imap" или "imaps").

mail.transport.protocol

String

Определяет протокол передачи сообщений по умолчанию ("smtp" или "smtps").

mail.user

String

Имя пользователя по умолчанию для подключения к почтовому серверу. Используется, если свойство mail.protocol.user не задано.

mail.password

String

Пароль по умолчанию для подключения к почтовому серверу. Используется, если свойство mail.protocol.password не задано.

mail.protocol.host

String

Имя хоста почтового сервера для определенного протокола. Переопределяет свойство mail.host.

mail.protocol.port

Integer

Номер порта почтового сервера для определенного протокола. Если протокол не определен, используется номер порта протокола по умолчанию.

mail.protocol.user

String

Имя пользователя для подключения к почтовым серверам по определенному протоколу. Переопределяет свойство mail.user.

mail.protocol.password

String

Пароль для подключения к почтовым серверам по определенному протоколу.  Переопределяет свойство mail.password.

SMTP параметры

Обратите внимание, что при использовании "smtps" протокола для доступа SMTP через SSL, все свойства будут носить имя "mail.smtps.*".

Имя

Тип

Описание

mail.smtp.port

Integer

Порт SMTP сервера для подключения. По умолчанию 25.

mail.smtp.connectiontimeout

Integer

Значение таймаута сокета соединения в миллисекундах. Бесконечный таймаут по умолчанию.

mail.smtp.timeout

Integer

Значение таймаута сокета ввода/вывода  в миллисекундах. Бесконечный таймаут по умолчанию.

mail.smtp.localhost

String

Имя локального хоста, используемого для SMTP команд HELO или EHLO. Обычно не требует настройки, если пространство имен сконфигурировано правильно.

mail.smtp.localaddress

String

Локальный адрес (имя хоста) для привязки при создании SMTP соединения. Обычно не требует настройки, но бывает полезным в случае многосетевых хостов, когда важно выбрать определенный локальный адрес для привязки.

mail.smtp.localport

Integer

Номер локального порта для привязки при создании SMTP соединения.

mail.smtp.ehlo

Boolean

Если false, не пытается войти с помощью команды EHLO. Значение по умолчанию true. Обычно, сбой команды EHLO приводит к использованию команды HELO; это свойство существует только для серверов, которые не выдают должным образом сбой команды EHLO или не реализуют должным образом команду EHLO.

mail.smtp.auth

Boolean

Если true, пытается авторизовать пользователя с помощью команды AUTH. Значение по умолчанию false.

mail.smtp.auth.mechanisms

String

Если установлен, выдает список механизмов аутентификации для рассмотрения, а также порядок их рассмотрения. Используются только механизмы, поддерживаемые сервером и поддерживаемые текущей реализацией. По умолчанию LOGIN PLAIN DIGEST-MD5 NTLM, которое включает все механизмы аутентификации, поддерживаемые текущей реализацией.

mail.smtp.auth.login.disable

Boolean

Если true, предотвращает использование команды AUTH LOGIN. По умолчанию false.

mail.smtp.auth.plain.disable

Boolean

Если true, предотвращает использование команды AUTH PLAIN. По умолчанию false.

mail.smtp.auth.digest-md5.disable

Boolean

Если true, предотвращает использование команды AUTH DIGEST-MD5. По умолчанию false.

mail.smtp.auth.ntlm.disable

Boolean

Если true, предотвращает использование команды AUTH NTLM. По умолчанию false.

mail.smtp.auth.ntlm.domain

String

NTLM домен аутентификации.

mail.smtp.auth.ntlm.flags

Integer

Флажки, специфичные для NTLM протокола. Для более подробной информации см. http://curl.haxx.se/rfc/ntlm.html#theNtlmFlags.

mail.smtp.submitter

String

Отправитель, используемый в теге AUTH команды MAIL FROM. Обычно используется почтовым транслятором для передачи информации об оригинальном отправителе сообщения. Обычно не используется почтовыми клиентами.

mail.smtp.dsn.notify

String

Опция NOTIFY команды RCPT. Либо NEVER, либо комбинация из SUCCESS, FAILURE, и DELAY (разделенные запятыми).

mail.smtp.dsn.ret

String

Опция RET команды MAIL. Либо FULL, либо HDRS.

mail.smtp.allow8bitmime

Boolean

Если установлено в true, и сервер поддерживает расширение 8BITMIME, текстовые части сообщения, использующие кодировки "quoted-printable" или "base64", переводятся на использование кодировки "8bit", если они соответствуют правилам RFC2045 для 8-разрядного текста.

mail.smtp.sendpartial

Boolean

Если установлено в true, а сообщение содержит как верные, так и неверные адреса, производит отправку сообщения в любом случае, сообщая о частичном сбое с исключением. Если установлено в false (по умолчанию), сообщение не отправляется ни одному из получателей при наличии хотя бы одного неверного адреса.

mail.smtp.sasl.enable

Boolean

Если установлено в true, производит попытку использовать SASL для выбора механизма аутентификации при входе. По умолчанию false.

mail.smtp.sasl.mechanisms

String

Список имен SASL механизмов, разделенных пробелом или запятой, для возможного использования.

mail.smtp.sasl.authorizationid

String

ID авторизации для использования при SASL аутентификации. Если не установлено, используется ID аутентификации (имя пользователя).

mail.smtp.sasl.realm

String

Область, используемая при DIGEST-MD5 аутентификации.

mail.smtp.quitwait

Boolean

Если установлено в false, отправляется команда QUIT, и соединение немедленно отключается. Если установлено в true (по умолчанию), приводит к ожиданию передачей ответа на команду QUIT.

mail.smtp.ssl.enable

Boolean

Если установлено в true, использует SSL для соединения и SSL порт по умолчанию. По умолчанию false для протокола "smtp" и true протокола "smtps".

mail.smtp.ssl.checkserveridentity

Boolean

Если установлено в true, проверяет идентификацию сервера как указано RFC 2595. Эти дополнительные проверки на основе содержания сертификата сервера нацелены предотвратить атаки "перехватчика". По умолчанию false.

mail.smtp.ssl.trust

String

Если установлено в "*", доверяет всем хостам. Если настроен на разделенный пробелами список хостов, доверяет всем этим хостам. В противном случае, доверие хостам зависит от сертификата сервера.

mail.smtp.ssl.socketFactory.port

Integer

Определяет порт для подключения при использовании SSL. Если не задано, используется порт по умолчанию.

mail.smtp.ssl.protocols

String

Определяет SSL протоколы, которые будут активированы для SSL подключения. Значение свойства  - разделенный пробелами список токенов. Допустимые значения SSLv3 и TLSv1.

mail.smtp.ssl.ciphersuites

String

Определяет наборы шифров SSL, которые будут активированы для SSL соединения. Значение свойства  - разделенный пробелами список токенов.

mail.smtp.mailextension

String

Строка расширения для присоединения к команде MAIL. Строка расширения может использоваться для определения стандартных расширений сервиса SMTP, а также расширений, специфичных для производителя. Например, RFC 1869 и другие расширения RFC, которые определяют специфичные расширения.

mail.smtp.starttls.enable

Boolean

Если true, активирует использование команды STARTTLS (если поддерживается сервером) для переключения соединения на TLS защищенное соединение до выдачи каких-либо команд авторизации. Обратите внимание, что соответствующее хранилище сертификатов должно быть сконфигурировано, чтобы клиент доверял сертификату сервера.  По умолчанию false.

mail.smtp.starttls.required

Boolean

Если true, требует использовать команду STARTTLS. Если сервер не поддерживает команду STARTTLS, или если команда выдает сбой, метод подключения также выдаст сбой. По умолчанию false.

mail.smtp.userset

Boolean

Если установлено в true, использует команду RSET вместо команды NOOP для проверки состояния соединения. В некоторых случаях отправка почты будет отвечать медленно после многократного применения команд NOOP. Избежать этой проблемы с отправкой почты помогает использование RSET. По умолчанию false.

mail.smtp.noop.strict

Boolean

Если установлено в true (по умолчанию), требует кода ответа 250 от команды NOOP для индикации успешного выполнения. Команда NOOP используется для определения, сохранилось ли соединение подключенным. Некоторые более старые серверы возвращают неверный код ответа при успешном выполнении, некоторые серверы вообще не осуществляют команду NOOP и всегда возвращают код отказа. Установите это свойство в false для работы с серверами с подобными недочетами. Обычно, когда время соединения с сервером истекает, сервер посылает код ответа 421, который становится видимым клиенту как ответ на следующую производимую команду. Некоторые серверы отправляют неверный код ответа на отказ, когда истекает время соединения. Не устанавливайте это свойство в false для работы с серверами с подобными недочетами

POP3 параметры

Обратите внимание, что при использовании  "pop3s" протокола для доступа POP3 через SSL, все свойства будут носить имя "mail.pop3s.*".

Имя

Тип

Описание

mail.pop3.port

Integer

Порт сервера POP3 для подключения. По умолчанию 110.

mail.pop3.connectiontimeout

Integer

Значение таймаута сокета соединения в миллисекундах. Бесконечный таймаут по умолчанию.

mail.pop3.timeout

Integer

Значение таймаута сокета ввода/вывода  в миллисекундах. Бесконечный таймаут по умолчанию.

mail.pop3.rsetbeforequit

Boolean

Посылает POP3 команду RSET при закрытии папки до отправки команды QUIT. Полезно для POP3 серверов, которые отмечают все прочитанные сообщения как удаленные. Предотвращает такие сообщения от удаления и стирания без запроса клиента. По умолчанию false.

mail.pop3.localaddress

String

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

mail.pop3.localport

Integer

Номер локального порта для привязки при создании POP3 сокета.

mail.pop3.apop.enable

Boolean

Если установлено в true, использует APOP вместо USER/PASS для авторизации на POP3 сервере, если POP3 сервер поддерживает APOP. APOP посылает хэш пароля, а не открытый текст пароля. По умолчанию false.

mail.pop3.ssl.enable

Boolean

Если установлено в true, использует SSL для соединения и SSL порт по умолчанию. По умолчанию false для "pop3" протокола и true для "pop3s" протокола.

mail.pop3.ssl.checkserveridentity

Boolean

Если установлено в true, проверяет идентификацию сервера как указано RFC 2595. Эти дополнительные проверки на основе содержания сертификата сервера нацелены предотвратить атаки "перехватчика". По умолчанию false.

mail.pop3.ssl.trust

String

Если установлено в "*",  доверяет всем хостам. Если настроен на разделенный пробелами список хостов, доверяет всем этим хостам. В противном случае, доверие хостам зависит от сертификата сервера.

mail.pop3.ssl.socketFactory.port

Integer

Определяет порт для подключения при с использованием SSL. Если не задано, используется порт по умолчанию.

mail.pop3.ssl.protocols

String

Определяет SSL протоколы, которые будут активированы для SSL подключения. Значение свойства  - разделенный пробелами список токенов.

mail.pop3.ssl.ciphersuites

String

Определяет наборы шифров SSL, которые будут активированы для SSL соединения. Значение свойства  - разделенный пробелами список токенов.

mail.pop3.starttls.enable

Boolean

Если true, активирует использование команды STLS (если поддерживается сервером) для переключения соединения на TLS защищенное соединение до выдачи каких-либо команд авторизации. Обратите внимание, что соответсвующее хранилище сертификатов должно быть сконфигурировано, чтобы клиент доверял сертификату сервера. По умолчанию false.

mail.pop3.starttls.required

Boolean

Если true, требует использовать команду STLS. Если сервер не поддерживает команду STLS, или если команда выдает сбой, метод подключения также выдаст сбой. По умолчанию false.

mail.pop3.disabletop

Boolean

Если установлено в true, POP3 команда TOP не будет использоваться для извлечения заголовков сообщений. Используется для POP3 серверов, которые не осуществляют должным образом команду TOP, либо предоставляют неверную информацию в результатах команды TOP. По умолчанию false.

mail.pop3.disablecapa

Boolean

Если установлено в true, POP3 команда CAPA не будет использоваться для получения возможностей сервера. Полезно для  POP3 серверов, которые  не реализуют должным образом команду CAPA, или предоставляют неверную информацию в результатах команды CAPA. По умолчанию false.

mail.pop3.forgettopheaders

Boolean

Если установлено в true, заголовки, которые могли быть извлечены с использованием POP3 команды TOP, будут забыты и заменены заголовками, извлеченными как часть POP3 команды RETR. Некоторые серверы, например, некоторые версии Microsft Exchange и IBM Lotus Notes, будут возвращать слегка измененные заголовки каждый раз при использовании команд TOP или RETR. Чтобы POP3 провайдер мог корректно осуществлять разбор содержания сообщения, возвращенного командой RETR, необходимо использовать заголовки, также возвращенные командой RETR. Установка этого свойства в true приведет к использованию таких заголовков, даже если они отличаются от заголовков, возвращенных ранее в результате использования команды TOP. По умолчанию false.

mail.pop3.filecache.enable

Boolean

Если установлено в true, POP3 провайдер будет кэшировать данные сообщений во временный файл, а не в память. Сообщения добавляются в кэш только при доступе к содержанию сообщения. Заголовки сообщений всегда кэшируются в память (по требованию). Файловый кэш удаляется при закрытии папки или остановке сервера. По умолчанию false.

mail.pop3.filecache.dir

String

При активации файлового кэша, данное свойство можно использовать для переопределения директории, используемой по умолчанию для временных файлов.

mail.pop3.keepmessagecontent

Boolean

Содержание сообщения кэшируется при первом извлечении. Обычно закэшированное содержимое стирается при недостатке памяти и при необходимости извлекается повторно. Если данное свойство установлено в true, все кэшированное содержание останется нетронутым, и память не будет использоваться повторно до закрытия папки. По умолчанию false.