Настройка SMTP
С версии Idea Hub 25.5 в систему предустановлены модули SMTP и primo_smtp, которые позволяют отправлять электронные письма пользователям через SMTP-сервер. SMTP обеспечивает надежную доставку, повышая вероятность того, что электронные письма попадут в почтовые ящики получателей, а не в спам.
Функциональность поддерживает аутентификацию SMTP и подключение к SMTP-серверам по протоколам шифрования SSL или TLS. Они используются, чтобы защитить такую конфиденциальную информацию из писем, как данные для входа в систему, восстановленные пароли и т.п. Для использования шифрования SSL вам необходим сертификат SSL.
Модули не поддерживают отправку почты по другим протоколам или API, отличным от SMTP.
Для настройки SMTP вы должны знать параметры вашего SMTP-сервера. На данный момент сконфигурировать SMTP возможно только с помощью переменных окружения.
Настройка переменных окружения
Основные переменные
В этом разделе описывается установка ключевых переменных для настройки SMTP. Чтобы выполнить настройки, войдите в систему под пользователем, из-под которого запускается Idea Hub.
Ниже приведены команды, которые позволяют протестировать настройки — эти данные сбросятся при перезагрузке веб-сервера.
-
Обязательно включите модуль SMTP:
export SMTP_ON=1
-
Добавьте адрес SMTP-сервера для исходящей почты. Текстовые значения оборачивайте в парные кавычки (“текст”):
export SMTP_HOST="mailhog"
-
Укажите порт SMTP. Порт без шифрования — 25. Если он заблокирован, попробуйте 80. В качестве порта с шифрованием многие серверы используют порт 465.
export SMTP_PORT=25
Для установки остальных переменных используется такой же синтаксис команд.
Остальные переменные
-
SMTP_PROTOCOL. Протоколы безопасности SMTP. Возможные значения:
standard
,ssl
,tls
. Значение по умолчаниюstandard
— без шифрования. -
SMTP_TLS. Включает шифрование TLS, если сервер его поддерживает, даже если в протоколе не установлено значение
tls
. Возможные значения:0
— TLS выключен;1
— TLS включен.
-
SMTP_TIMEOUT. Количество секунд, в течение которых команды SMTP будут выполняться до истечения времени ожидания. Значение по умолчанию
30
. -
SMTP_USER. SMTP-пользователь указывается, если сервер требует аутентификации.
-
SMTP_PASS. SMTP-пароль указывается, если сервер требует аутентификации. На данный момент пароль не шифруется с помощью утилит типа pass. Поэтому для безопасности он хранится в переменных окружения.
Установка переменных на постоянной основе
После того, как вы успешно протестировали конфигурацию SMPT, добавьте все необходимые переменные в файл /etc/environment
. Этот способ устанавливает переменные на постоянной основе для всей системы: всех пользователей и процессов.
Пример указания в файле переменной, которая включает модуль SMPT:
SMTP_ON=1
По умолчанию включенный модуль будет поддерживать отправку писем в формате HTML.
Адрес отправителя уведомлений
Адрес отправителя автоматических уведомлений настраивается в Основных настройках сайта в параметре E-mail адрес.
Вы также можете его переопределить в разделе Конфигурация > Настройки учётной записи для всех уведомлений, связанных с событиями учетной записи. Там же настраиваются шаблоны писем для различных сценариев: письма при создании учетных записей, сброса пароля и т.п. Для некоторых шаблонов есть возможность отключить рассылку уведомлений с помощью переключателей.
Уведомления, связанные с необходимостью одобрить идею или с заключением по предложенной идее, настраиваются отдельно с помощью этой инструкции. В ней описывается, как настроить шаблоны соответствующих писем и способы настройки адреса отправителя.