Перейти к содержанию

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

Сервер Webim поддерживает интеграцию с почтовыми серверами для рассылки исходящих Email сообщений (администраторам, операторам и посетителям сайтов клиентов) и приёма входящих (поддержка Email как полноценного канала связи). В этой статье содержится описание 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 с почтовым сервером не поддерживает двухфакторную аутентификацию!