Настройки SMTP
Для доступа к разделу у пользователя должна быть роль Администратор
Данный раздел настроек предназначен настройки параметров SMTP-сервера для отправки электронной почты внутренними обработчиками приложения. Для настройки откройте раздел SMTP и уведомления на вкладке Настройки → SMTP.
SMTP используется для отправки писем с приглашениями и ссылками восстановления доступа сотрудникам, подтверждения адресов получателей, уведомлений о событиях учётных записей и безопасности, а также предупреждений о сроке действия HTTPS-сертификата приложения.
Если параметры SMTP не настроены, отправка писем электронной почты недоступна.
Какие события формируют отправку писем описано в разделе События и получатели. Состояние отправки писем смотрите в очереди уведомлений, сроки приглашений и восстановления доступа — в разделе Ссылки доступа.

Настройка
Раскройте Настройки SMTP-сервера, чтобы настроить параметры SMTP, наименование отправителя и параметры TLS-сертификата.
| Поле | Для чего оно нужно |
|---|---|
| Имя SMTP-сервера | Адрес SMTP-сервера, к которому приложение подключается для отправки писем. Укажите DNS-имя или IP-адрес без схемы (https://) и порта. Пустое поле оставляет SMTP ненастроенным. |
| Порт SMTP | Порт подключения: целое число от 1 до 65535, по умолчанию 587. При смене режима TLS порт автоматически не меняется. |
| Режим TLS | Определяет, как приложение устанавливает соединение: Обязательный STARTTLS (по умолчанию) требует включить шифрование перед отправкой; SSL/TLS шифрует соединение с самого начала; Открытая передача (plaintext relay) передаёт данные без шифрования. |
| Адрес отправителя | Один корректный адрес электронной почты без имени получателя. Поле обязательно, если задан SMTP-сервер; при неверном адресе сохранить настройки нельзя. |
| Имя отправителя | Отображаемое имя отправителя, которую увидит получатель. Это имя не используется для входа на SMTP-сервер. |
| CA сертификат PEM | Дополнительные доверенные сертификаты, с помощью которых приложение проверяет шифрование соединения с SMTP-сервером. Приложение также использует системные корневые сертификаты и проверяет, что сертификат является доверенным к имени хоста или IP-адресу сервера. |
Для CA сертификат PEM вставьте один или несколько PEM-блоков с границами BEGIN CERTIFICATE и END CERTIFICATE. Подойдут действующие сертификаты центра сертификации (CA) или самоподписанные сертификаты. Максимальный размер — 262144 байта (около 262 Кб). Такой сертификат может понадобиться для внутреннего SMTP-сервера с собственным центром сертификации.
Закрытый ключ указывать нельзя!
Кнопка Выбрать CA PEM только подставляет текст из выбранного файла в поле. Чтобы применить или удалить дополнительный сертификат, сохраните настройки, удаление начнёт действовать после перезапуска конкретных узлов.
Учётные данные SMTP
Учётные данные используются приложением для входа на SMTP-сервер. В разделе Учётные данные SMTP нажмите Изменить учётные данные: откроются пустые поля, т.к. сохранённые значения недоступны для просмотра в целях безопасности.
| Поле или состояние | Для чего оно нужно |
|---|---|
| ** Логин SMTP** | Имя учётной записи для подключения приложения к SMTP-серверу. Пустое поле оставляет сохранённый логин без изменений. |
| Пароль SMTP | Пароль для учётной записи под которой выполняется авторизация на SMTP-сервере. Пустое поле оставляет сохранённый пароль без изменений. |
| Учётные данные настроены | Показывает, что пароль сохранён. |
| Логин настроен / Логин не настроен | Показывает, сохранён ли логин; само значение не раскрывается. |
| Пароль настроен / Пароль не настроен | Показывает, сохранён ли пароль; само значение не раскрывается. |
При первой настройке укажите логин и пароль либо оставьте оба поля пустыми. Если учётные данные уже сохранены, можно заменить только логин или только пароль, оставив второе поле пустым. Нажмите Сохранить учётные данные. Кнопка Сохранить настройки учётные данные не сохраняет.
Чтобы удалить оба значения, нажмите Очистить учётные данные и подтвердите действие в окне Удалить логин и пароль SMTP?. Очистка доступна, только если пароль уже сохранён и учётные данные не заданы внешним источником. После подтверждения логин и пароль станут пустыми.
Если открыть административную панель по HTTP, при сохранении нового пароля появится предупреждение Соединение с сайтом использует HTTP. Новый пароль SMTP будет передан без шифрования. Продолжить?. Это относится к передаче пароля от браузера приложению, режим TLS SMTP на этот риск не влияет.
Доставка и очередь
Раскройте Доставка и очередь, чтобы задать общий предел одной попытки отправки, число попыток, интервалы повторов и срок хранения завершённых писем.
| Поле | Для чего оно нужно |
|---|---|
| Таймаут | Общий предел одной попытки отправки — по умолчанию 10s, от 1s до 1m. В него входят подключение, TLS, вход на сервер и передача письма, это не время ожидания одного ответа сервера. |
| Количество попыток | Предельное число попыток для одного письма в очереди: целое число от 1 до 100, по умолчанию 10. Постоянный отказ завершает обработку раньше. Ошибки TLS, входа или настроек приостанавливают обработчик и не расходуют попытку. |
| Минимальная задержка повтора | Начальная базовая пауза перед повтором: от 1m до 1h, по умолчанию 5m. Каждый следующий интервал увеличивается вдвое и меняется примерно на ±10%; фактическая пауза может быть немного короче заданного минимума. |
| Максимальная задержка повтора | Верхний предел фактической паузы между попытками. Значение должно быть не меньше минимальной задержки и не больше 1h; по умолчанию 1h. |
| Хранить письма в очереди, дней | Сколько дней сохранять завершённые записи со статусами Принято SMTP, Ошибка отправки или Отменено, считая со времени завершения. Целое число от 1 до 365, по умолчанию 14. Это не максимальное время ожидания письма и не срок действия ссылки. Очистка записей приложения не удаляет письма из почтовых ящиков. |
Для временных значений указывайте единицу: 10s — секунды, 5m — минуты, 1h — часы. Значение без единицы не принимается.
Сохранение
Основные настройки и учётные данные сохраняются отдельно. Общие правила и приоритет источников описаны в разделе Источники настроек и сохранение.
Поля, значения которых приходят из ENV, .env или YAML, недоступны для редактирования на этой странице. Основные параметры сохраните кнопкой Сохранить настройки, учётные данные — отдельной кнопкой Сохранить учётные данные. Очередь уведомлений начнёт использовать сохранённые значения после команды Перезапустить сервис на нужных узлах.
Определения действующих и сохранённых значений приведены в разделе Действующие и сохранённые значения. Порядок применения изменений описан в разделе Сохранение и применение, а перечитывание черновика — в разделе Перечитывание настроек.
Если администратор на другом узле сохранил изменения, приложение оставит черновик текущих настроек и сообщит о конфликте. Нажмите Перечитать настройки, чтобы заменить черновик сохранёнными значениями, затем внесите свои правки снова.
Версия настроек SMTP — номер сохранённой редакции, который позволяет обнаружить одновременные изменения. Узел — ответивший экземпляр приложения. Его значения показаны отдельно: Действующая конфигурация — настройки, используемые этим узлом сейчас; Будущая конфигурация после перезапуска — настройки, которые он получит после перезапуска, с учётом внешних источников. Сводка может показывать адрес сервера, порт, режим TLS, отправителя и наличие учётных данных, но не сами секреты.
Проверка
Состояние очереди уведомлений
Поле Состояние обработчика очереди показывает, готов ли общий обработчик принимать письма из очереди:
- Работает — обработчик готов обрабатывать письма. Это не подтверждает текущую отправку, доступность SMTP-сервера или доставку получателям.
- Приостановлен — обработчик остановил отправку. Для TLS и настроек экран показывает причину, при ошибке TLS, входа или настроек сохраните исправленные значения и перезапустите нужные узлы. Причина
configurationможет также означать ошибку задания, поэтому исправление настроек SMTP само по себе может не решить проблему. Если причина неясна, проверьте задание в очереди уведомлений и техническом логе узла. - Не настроен — в действующих настройках не все параметры SMTP-сервера настроены корректно.
- Состояние неизвестно — обработчик периодически сохраняет состояние в общей базе приложения. Если отметки нет или она старше 30 секунд, состояние показывается как неизвестное. Это само по себе не означает, что обработчик остановлен.
Писем в очереди — число ожидающих или отправляемых писем, а не история. Последнее принятие SMTP-сервером показывает время, когда SMTP-сервер подтвердил приём письма; это не подтверждение доставки в почтовый ящик.
Тестовое письмо
Тест использует будущие сохранённые настройки SMTP с учётом исходных значений ENV и .env. Он не использует несохранённый черновик и не меняет действующие настройки отправки писем через очередь. Поэтому тест можно отправить до перезапуска узлов. Сначала сохраните основные настройки кнопкой Сохранить настройки, а учётные данные — отдельно кнопкой Сохранить учётные данные.
- Введите один корректный адрес электронной почты без имени получателя в поле Адрес для тестового письма. При неверном адресе кнопка Отправить тест недоступна.
- Нажмите кнопку Отправить тест.
- Если результат неясен, сначала убедитесь, что указанный почтовый ящик корректный, прежде чем отправлять тест ещё раз.
Тест отправляется напрямую, задание для него в очереди уведомлений не создаётся. Для администратора повторный тест доступен через 5 секунд. Адрес теста не добавляется к получателям событий и не подтверждается этим письмом. Сообщение SMTP-сервер принял письмо. Это не подтверждает доставку в почтовый ящик. означает, что сервер принял письмо, но не подтверждает его получение адресатом.
Тема и текст письма соответствуют языку интерфейса, выбранному в момент нажатия Отправить тест.