Интеграция с почтовыми серверами

Сервер Webim поддерживает интеграцию с почтовыми серверами для рассылки исходящих e-mail сообщений (администраторам, операторам и посетителям сайтов клиентов) и приёма входящих (поддержка e-mail как полноценного канала связи). В этой статье содержится описание SMTP-параметров конфигурационного файла [hosted-]main.ini для облачной и локальной сетевой конфигурации, а также описание режимов аутентификации для SMTP, поддерживаемых Webim.

NB:Для облачной и локальной конфигурации файл [hosted-]main.ini имеет несколько различий в параметрах. В частности, в облачной конфигурации некоторые параметры являются неизменяемыми. Они обозначены звёздочкой (*).

Содержание:

SMTP-параметры для облачной сетевой конфигурации (cloud mode)

Параметр Описание
smtp_server* Имя сервера SaaS-сервиса, к которому обращается сервер Webim
smtp_username "user@yourdomain.ru" - имя пользователя
smtp_password "your_password" - пароль пользователя
smtp_port* Порт подключения
smtp_encryption "TLS" - тип шифрования (если есть)
smtp_from_addr "noreply@address.ru" - адрес, с которого отправляются письма
smtp_auth_mode "login" - тип аутентификации. Также может быть "plain", "cram-md5" или пустое значение ("", None). NB: поддерживаются только указанные типы аутентификации; также, для корректной работы сервера Webim аутентификация почтового сервера обязательна
smtp_skip_ssl_checks Игнорирование проверки SSL/TLS сертификатов. Может принимать значение "true" или "false"
local_doamin Имя домена,к которому обращается сервер Webim для использования в команде EHLO

SMTP-параметры для локальной сетевой конфигурации (hosted mode)

Параметр Описание
hostedmode_smtp_server "smtp.yourdomain.com" - имя SMTP-сервера, к которому обращается сервер Webim
hostedmode_smtp_username "user@yourdomain.ru" - имя пользователя
hostedmode_smtp_password "your_password" - пароль пользователя
hostedmode_smtp_port "25" (могут быть и другие значения) - порт для подключения к SMTP-серверу
hostedmode_smtp_encryption Тип шифрования. Может быть "TLS", "SSL" или None (в зависимости от значения порта)
hostedmode_smtp_from_addr "noreply@address.ru" - адрес, с которого отправляются письма
hostedmode_smtp_auth_mode "login" - тип аутентификации. Также может быть "plain", "cram-md5" или пустое значение ("", None). NB: поддерживаются только указанные типы аутентификации; также, для корректной работы сервера Webim аутентификация почтового сервера обязательна

Описание поддерживаемых типов аутентификации

Сервер Webim поддерживает следующие типы аутентификации для SMTP:

  • "plain": логин и пароль пользователя отправляются одной строкой
  • "login": логин и пароль пользователя отправляются по очереди. В plain и login пароли предварительно передаются в открытом виде
  • "cram-md5": аутентификация вида "запрос-ответ", основанная на алгоритме HMAC-MD5 (используется сравнение хэшей)

Часто у клиентов с локальной сетевой конфигурацией (hosted-клиенты) возникает проблема при аутентификации вида: SMTP AUTH extension not supported by server. Как правило, она возникает в тех случаях, когда в параметре аутентификации указывают неподдерживаемый тип (например, "ntlm").