Дополнительные настройки почты
Таблица дополнительных настроек почты позволяет производить тонкую настройку параметров отправки и получения почты. Каждый параметр определен Именем и Значением. Однако все параметры вносятся в форме строки, а Тип параметров в таблице ниже просто объясняет, как интерпретируется значение параметра. Например, если параметр логический, его строковое значение должно быть true или false.
 | В большинстве случаев достаточно использовать только базовые опции для должной настройки e-mail операций. Используйте дополнительные настройки только если ваши базовые настройки не работают, и вы знакомы с e-mail операциями. |
 | Пример: Чтобы включить отправку почты через SSL SMTP сервер, установите следующие дополнительные опции: mail.smtp.port=465 mail.smtp.auth=true mail.smtp.ssl.enable=true |
| Пример: Чтобы включить отправку почты через сервер Google Mail (@gmail.com), используйте следующие дополнительные опции: mail.smtp.port=587 mail.smtp.auth=true mail.smtp.ssl.enable=true mail.smtp.ssl.protocols=TLSv1 |
Общие параметры
Имя | Тип | Описание |
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. |