Skip to Content

Настройка SMTP

С версии Idea Hub 25.5 в систему предустановлены модули SMTP и primo_smtp, которые позволяют отправлять электронные письма пользователям через SMTP-сервер. SMTP обеспечивает надежную доставку, повышая вероятность того, что электронные письма попадут в почтовые ящики получателей, а не в спам.

Функциональность поддерживает аутентификацию SMTP и подключение к SMTP-серверам по протоколам шифрования SSL или TLS. Они используются, чтобы защитить такую конфиденциальную информацию из писем, как данные для входа в систему, восстановленные пароли и т.п. Для использования шифрования SSL вам необходим сертификат SSL.

⚠️

Модули не поддерживают отправку почты по другим протоколам или API, отличным от SMTP.

Для настройки SMTP вы должны знать параметры вашего SMTP-сервера. На данный момент сконфигурировать SMTP возможно только с помощью переменных окружения.

Настройка переменных окружения

Основные переменные

В этом разделе описывается установка ключевых переменных для настройки SMTP. Чтобы выполнить настройки, войдите в систему под пользователем, из-под которого запускается Idea Hub.

Ниже приведены команды, которые позволяют протестировать настройки — эти данные сбросятся при перезагрузке веб-сервера.

  1. Обязательно включите модуль SMTP:

    export SMTP_ON=1
  2. Добавьте адрес SMTP-сервера для исходящей почты. Текстовые значения оборачивайте в парные кавычки (“текст”):

    export SMTP_HOST="mailhog"
  3. Укажите порт SMTP. Порт без шифрования — 25. Если он заблокирован, попробуйте 80. В качестве порта с шифрованием многие серверы используют порт 465.

    export SMTP_PORT=25

Для установки остальных переменных используется такой же синтаксис команд.

Остальные переменные

  1. SMTP_PROTOCOL. Протоколы безопасности SMTP. Возможные значения: standard, ssl, tls. Значение по умолчанию standard — без шифрования.

  2. SMTP_TLS. Включает шифрование TLS, если сервер его поддерживает, даже если в протоколе не установлено значение tls. Возможные значения:

    • 0 — TLS выключен;
    • 1 — TLS включен.
  3. SMTP_TIMEOUT. Количество секунд, в течение которых команды SMTP будут выполняться до истечения времени ожидания. Значение по умолчанию 30.

  4. SMTP_USER. SMTP-пользователь указывается, если сервер требует аутентификации.

  5. SMTP_PASS. SMTP-пароль указывается, если сервер требует аутентификации. На данный момент пароль не шифруется с помощью утилит типа pass. Поэтому для безопасности он хранится в переменных окружения.

Установка переменных на постоянной основе

После того, как вы успешно протестировали конфигурацию SMPT, добавьте все необходимые переменные в файл /etc/environment. Этот способ устанавливает переменные на постоянной основе для всей системы: всех пользователей и процессов.

Пример указания в файле переменной, которая включает модуль SMPT:

SMTP_ON=1

По умолчанию включенный модуль будет поддерживать отправку писем в формате HTML.

Адрес отправителя уведомлений

Адрес отправителя автоматических уведомлений настраивается в Основных настройках сайта в параметре E-mail адрес.

Вы также можете его переопределить в разделе Конфигурация > Настройки учётной записи для всех уведомлений, связанных с событиями учетной записи. Там же настраиваются шаблоны писем для различных сценариев: письма при создании учетных записей, сброса пароля и т.п. Для некоторых шаблонов есть возможность отключить рассылку уведомлений с помощью переключателей.

Уведомления, связанные с необходимостью одобрить идею или с заключением по предложенной идее, настраиваются отдельно с помощью этой инструкции. В ней описывается, как настроить шаблоны соответствующих писем и способы настройки адреса отправителя.