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

Подключение к SMTP через релей

Webim Server умеет авторизоваться на SMTP-сервере только механизмами login, plain и cram-md5. Если у целевого сервера нет ни одного из этих механизмов (типичный пример — Microsoft Exchange Server с NTLM или GSSAPI), прямое подключение из Webim невозможно. Подробнее о поддерживаемых типах аутентификации см. в статье Интеграция с почтовыми сервисами.

В такой ситуации между Webim Server и целевым SMTP ставят релей/relay (шлюз):

Webim Server  →  SMTP-релей (Postfix)  →  целевой SMTP-сервер
  • Webim Server отправляет письма на релей по SMTP из доверенной сети (в типовой hosted-установке — из Docker-подсети). Релей принимает эту почту способом, совместимым с Webim.

  • Релей уже от своего имени доставляет письма на целевой сервер: с логином и паролем, которые тот принимает, либо как доверенный узел по IP — в зависимости от политики почтового сервера.

Релей не входит в поставку Webim. Ниже приведён рабочий пример на базе Postfix для hosted-инсталляции на Debian, когда Webim Server запущен в Docker. Тот же принцип применим и к другому MTA: задача релея — принять почту способом, совместимым с Webim, и передать её на целевой SMTP.

N.B.

Релей помогает, когда не совпадают механизмы SMTP AUTH. Он не заменяет двухфакторную аутентификацию и OAuth2 (Exchange Online). Если целевой сервер принимает от релея только OAuth2, этой схемы недостаточно — нужна учётная запись или коннектор, которые допускают парольную аутентификацию или релей по IP.

Когда нужен релей

Настраивайте релей, если выполняется хотя бы одно из условий:

  • целевой SMTP в ответе EHLO предлагает только механизмы, которых нет у Webim (например, NTLM или GSSAPI);

  • при прямой отправке в логах Webim появляется SMTP AUTH extension not supported by server, а указать ntlm в smtp_auth_mode нельзя: этот тип Webim Server не поддерживает;

  • корпоративный Exchange Server разрешает исходящую почту только с выделенных внутренних узлов (Receive Connector), а не напрямую из приложения.

Если целевой сервер уже поддерживает login, plain или cram-md5, релей не нужен: задайте параметры SMTP в main.ini по статье Интеграция с почтовыми сервисами.

Что понадобится

В командах ниже замените плейсхолдеры на значения Вашей инфраструктуры.

Плейсхолдер Пример Назначение
<SMTP_HOST> smtp.mail.example.local Имя или IP целевого SMTP-сервера
<SMTP_PORT> 25 Порт целевого SMTP (25, 587 или 465)
<SMTP_USER> webim@mail.example.local Учётная запись на целевом SMTP (если сервер требует AUTH)
<SMTP_PASSWORD> пароль этой учётной записи Пароль на целевом SMTP
<RELAY_LISTEN_IP> 172.16.0.1 IP, на котором Postfix принимает почту от Webim
<RELAY_NETWORK> 172.16.0.0/28 Подсеть, из которой Webim шлёт почту на релей

В типовой Docker-сборке Webim подсеть задаётся параметром docker_sub_net (по умолчанию 172.16.0.0/28, шлюз — 172.16.0.1). Если у Вас другая подсеть, подставьте её шлюз в <RELAY_LISTEN_IP> и CIDR в <RELAY_NETWORK>. См. главные файлы настроек.

Квадратные скобки вокруг имени хоста в Postfix отключают MX-запрос: почта идёт именно на указанный хост, а не на MX-запись его домена.

Установка Postfix

Команды рассчитаны на Debian 12.5 — ОС из требований к программному обеспечению. Пакет libsasl2-modules нужен, чтобы Postfix как клиент мог авторизоваться на целевом SMTP.

sudo apt-get update
sudo apt-get install -y postfix libsasl2-modules

При интерактивной установке выберите тип Satellite system или Internet with smarthost. Последующие команды postconf перезапишут эти ответы, поэтому достаточно любого из двух вариантов.

Postfix устанавливается на хост, где работают контейнеры Webim, а не внутрь контейнера: так релей слушает IP шлюза Docker-сети и доступен сервисам Webim.

Учётные данные для целевого SMTP

Файл /etc/postfix/sasl_passwd хранит логин и пароль, с помощью которых Postfix авторизуется на целевом сервере (это не учётная запись Webim).

  1. Создайте файл /etc/postfix/sasl_passwd с одной строкой:

    [<SMTP_HOST>]:<SMTP_PORT>    <SMTP_USER>:<SMTP_PASSWORD>
    

    Пример:

    [smtp.mail.example.local]:25    webim@mail.example.local:YOUR_SMTP_PASSWORD
    
  2. Защитите файл и постройте хеш-карту:

    sudo chmod 600 /etc/postfix/sasl_passwd
    sudo postmap hash:/etc/postfix/sasl_passwd
    

N.B.

Если Exchange Server принимает письма с IP-адреса релея без аутентификации (отдельный Receive Connector), файл sasl_passwd и параметры smtp_sasl_* ниже не нужны. Пропустите этот шаг и не включайте smtp_sasl_auth_enable.

Карта маршрутизации

Карта транспорта отправляет всю исходящую почту на целевой SMTP, а не пытается доставлять её напрямую по MX.

  1. Создайте файл /etc/postfix/transport:

    *    smtp:[<SMTP_HOST>]:<SMTP_PORT>
    

    Пример:

    *    smtp:[smtp.mail.example.local]:25
    
  2. Постройте хеш-карту:

    sudo postmap hash:/etc/postfix/transport
    

Настройка Postfix

Выполните команды на хосте с Postfix. Они задают релей, а не полноценный почтовый сервер организации: локальная доставка отключена, слушать интернет Postfix не должен. Подставьте свои <SMTP_HOST>, <SMTP_PORT>, <RELAY_NETWORK> и <RELAY_LISTEN_IP>. Значение myhostname замените на уникальное имя этого хоста.

Пример для типовой Docker-сети Webim и SMTP на порту 25:

sudo postconf -e "myhostname = smtp-relay.example.local"
sudo postconf -e "mydestination ="
sudo postconf -e "maillog_file = /var/log/mail.log"
sudo postconf -e "mynetworks = 127.0.0.0/8, 172.16.0.0/28"
sudo postconf -e "inet_interfaces = 127.0.0.1, 172.16.0.1"
sudo postconf -e "smtpd_relay_restrictions = permit_mynetworks, permit_sasl_authenticated, defer_unauth_destination"
sudo postconf -e "smtpd_sender_restrictions ="
sudo postconf -e "smtpd_discard_ehlo_keywords ="
sudo postconf -e "relayhost = [smtp.mail.example.local]:25"
sudo postconf -e "transport_maps = hash:/etc/postfix/transport"
sudo postconf -e "smtp_sasl_auth_enable = yes"
sudo postconf -e "smtp_sasl_security_options = noanonymous"
sudo postconf -e "smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd"

Смысл ключевых параметров:

  • inet_interfaces — Postfix принимает соединения только на localhost и на шлюзе Docker, а не на публичном IP.

  • mynetworks — из этой подсети релей принимает почту без SMTP AUTH. Сюда должна входить подсеть контейнеров Webim. Без этой строки контейнеры, как правило, получат отказ в ретрансляции (Relay access denied).

  • mydestination пустой — хост не считает себя конечным получателем писем и только пересылает их дальше.

  • smtp_sasl_* — аутентификация Postfix как клиента на целевом SMTP. Префикс smtpd_ относится к входящим соединениям (от Webim), префикс smtp_ — к исходящим (на целевой сервер).

  • smtpd_discard_ehlo_keywords пустой — Postfix не скрывает расширения EHLO от клиентов. Не путайте с одноимённым параметром без d (smtp_discard_ehlo_keywords): тот влияет на диалог с целевым сервером.

  • relayhost и transport_maps задают один и тот же smarthost. Карта транспорта имеет приоритет; relayhost остаётся запасным маршрутом.

Важно

Не указывайте inet_interfaces = all на сервере с публичным IP-адресом и не расширяйте mynetworks до 0.0.0.0/0. Иначе Postfix станет открытым релеем.

Если целевой сервер требует STARTTLS (часто порт 587), дополнительно задайте:

sudo postconf -e "smtp_tls_security_level = encrypt"
sudo postconf -e "smtp_tls_CAfile = /etc/ssl/certs/ca-certificates.crt"

Для SMTPS на порту 465:

sudo postconf -e "smtp_tls_security_level = encrypt"
sudo postconf -e "smtp_tls_wrappermode = yes"

Для Microsoft Exchange с NTLM Postfix использует этот механизм через libsasl2-modules, если сервер предлагает его в EHLO. Имя пользователя часто указывают в виде DOMAIN\user или user@mail.example.local — уточните формат у администраторов почты.

Запуск Postfix

После изменения inet_interfaces нужен полный перезапуск, а не reload. К этому моменту Docker-мост с адресом <RELAY_LISTEN_IP> уже должен существовать, иначе Postfix не сможет занять сокет.

sudo systemctl restart postfix
sudo systemctl enable postfix

Проверьте, что служба слушает нужный адрес:

ss -lntp | grep ':25'

В выводе должен быть <RELAY_LISTEN_IP>:25 (для типовой сети — 172.16.0.1:25).

Настройка Webim Server

Webim Server должен отправлять почту на релей, а не на целевой SMTP напрямую.

В main.ini для hosted-режима:

hostedmode_smtp_server = 172.16.0.1
hostedmode_smtp_port = 25
hostedmode_smtp_encryption = ""
hostedmode_smtp_auth_mode = ""
hostedmode_smtp_username = ""
hostedmode_smtp_password = ""
hostedmode_smtp_from_addr = noreply@mail.example.local

В этой схеме контейнеры входят в mynetworks, поэтому Postfix не требует AUTH от Webim. Логин и пароль целевого SMTP живут только в /etc/postfix/sasl_passwd. Адрес в hostedmode_smtp_from_addr должен быть разрешён политикой целевого сервера, иначе он отвергнет письмо после приёма релеем.

После изменения main.ini перезапустите сервисы Webim.

Для канала электронной почты через IMAP/SMTP в форме канала укажите тот же хост и порт релея (например, 172.16.0.1 и 25), без шифрования. Поля логина и пароля SMTP в канале оставьте пустыми, если релей принимает почту по mynetworks.

N.B.

Если Webim Server отказывается подключаться к релею без AUTH, включите на Postfix SASL для входящих соединений (smtpd_sasl_auth_enable) с механизмами LOGIN/PLAIN и укажите эти учётные данные в hostedmode_smtp_*. Это отдельная настройка smtpd, её не следует путать с smtp_sasl_* для исходящей авторизации на целевом SMTP.

Проверка

  1. С хоста релея отправьте тестовое письмо:

    printf "Subject: Webim SMTP relay test\n\nRelay test\n" | sudo sendmail -v -f noreply@mail.example.local recipient@example.local
    
  2. Смотрите журнал:

    sudo tail -f /var/log/mail.log
    

    Успешная цепочка выглядит так: письмо принято от 127.0.0.1 или из <RELAY_NETWORK>, затем ушло на [<SMTP_HOST>]:<SMTP_PORT> со статусом sent.

  3. Повторите проверку из сценария Webim (уведомление оператору, ответ в почтовом канале).

Если что-то пошло не так

Симптом Что проверить
Relay access denied / 454 4.7.1 IP контейнера Webim не входит в mynetworks. Сверьте docker_sub_net и <RELAY_NETWORK>.
Connection refused из Webim Postfix не слушает <RELAY_LISTEN_IP> или Docker-мост ещё не создан. Смотрите ss -lntp и inet_interfaces.
SASL authentication failed в сторону целевого SMTP Неверные <SMTP_USER>/<SMTP_PASSWORD>, несовпадение порта в sasl_passwd и relayhost, либо целевой сервер не принимает выбранный механизм. После правки файла снова выполните postmap и перезапустите Postfix.
SMTP AUTH extension not supported при подключении Webim к релею Webim пытается выполнить AUTH, а smtpd Postfix его не предлагает. Либо оставьте hostedmode_smtp_auth_mode пустым, либо включите SASL на smtpd.
Письмо принято релеем, но отвергнуто Exchange Адрес отправителя, TLS или права Receive Connector. Смотрите ответ целевого сервера в /var/log/mail.log.

Не публикуйте содержимое /etc/postfix/sasl_passwd в тикетах и переписке: после postmap достаточно журнала Postfix и параметров postconf -n.