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

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

N.B.

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

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

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

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

Параметр	Описание
`hostedmode_smtp_server`	`smtp.yourdomain.com` – имя SMTP-сервера, к которому обращается Webim Server
`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`). При пустом значении способ аутентификации будет определяться автоматически, согласно ответу на EHLO от SMTP сервера. Поддерживаются только указанные типы аутентификации; также, для корректной работы Webim Server аутентификация почтового сервера обязательна.

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

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

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

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

N.B.

Интеграция Webim с почтовым сервером не поддерживает двухфакторную аутентификацию!