Email-уведомления

Модуль позволяет отправлять пользователям HTML-уведомления на электронную почту через любой SMTP-сервер. Письма формируются автоматически при наступлении событий в системе и доставляются на адрес, указанный в профиле пользователя.

Параметры конфигурации

Параметр	Обязательный	Значение по умолчанию	Пример	Описание
MAIL_ENABLED	да	false	true	Включить отправку email-уведомлений.
MAIL_HOST	да	-	smtp.example.com	Адрес SMTP-сервера.
MAIL_PORT	нет	587	465	Порт SMTP-сервера. Порт 587 — STARTTLS, порт 465 — прямой TLS (SMTPS).
MAIL_USERNAME	нет	-	vpn@example.com	Логин для аутентификации на SMTP-сервере. Если не задан — аутентификация не выполняется.
MAIL_PASSWORD	нет	-	secret	Пароль для аутентификации на SMTP-сервере.
MAIL_FROM	да	-	vpn@example.com	Адрес отправителя письма.
MAIL_FROM_NAME	нет	VPN Notifications	Корпоративный VPN	Отображаемое имя отправителя.
MAIL_TLS	нет	false	true	Режим TLS. false — STARTTLS (порт 587), true — прямой TLS / SMTPS (порт 465).
MAIL_EVENTS	нет	connect_success, request_approve, request_reject, send_token	connect_success,send_token	Список событий через запятую, при которых отправляются письма. Подробнее — в разделе События.

События

Параметр MAIL_EVENTS определяет, какие события инициируют отправку письма. По умолчанию включены все четыре события. Можно ограничить список, передав только нужные значения через запятую.

Событие	Когда отправляется	Тема письма
connect_success	Пользователь подключился к VPN	Уведомление о подключении к VPN: <IP>
request_approve	Администратор одобрил запрос на доступ к ресурсу	Запрос на доступ одобрен: <ресурс>
request_reject	Администратор отклонил запрос на доступ к ресурсу	Запрос на доступ отклонён: <ресурс>
send_token	Пользователю выдана одноразовая ссылка для первичного подключения	Ссылка для подключения к VPN

Заметка

Письмо отправляется только если в профиле пользователя указан email. Пользователи без адреса электронной почты пропускаются без ошибок.

---

Примеры конфигурации

STARTTLS (порт 587)

MAIL_ENABLED=true
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=vpn-notify@example.com
MAIL_PASSWORD=secret
MAIL_FROM=vpn-notify@example.com
MAIL_FROM_NAME=Корпоративный VPN
MAIL_TLS=false
MAIL_EVENTS=connect_success,request_approve,request_reject,send_token

SMTPS (порт 465)

MAIL_ENABLED=true
MAIL_HOST=smtp.example.com
MAIL_PORT=465
MAIL_USERNAME=vpn-notify@example.com
MAIL_PASSWORD=secret
MAIL_FROM=vpn-notify@example.com
MAIL_FROM_NAME=Корпоративный VPN
MAIL_TLS=true

Только безопасность

# Отправлять только алерты о подключениях и ссылки для входа
MAIL_ENABLED=true
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_FROM=vpn-notify@example.com
MAIL_EVENTS=connect_success,send_token

Без аутентификации

# Корпоративный relay без пароля
MAIL_ENABLED=true
MAIL_HOST=mail-relay.internal
MAIL_PORT=25
MAIL_FROM=vpn@corp.example.com
MAIL_FROM_NAME=VPN-сервис

---

Требования к профилю пользователя

Для получения уведомлений у пользователя должен быть заполнен email в профиле.

• Для локальных пользователей — задаётся в интерфейсе администратора при создании или редактировании пользователя.
• Для пользователей из LDAP/AD — синхронизируется автоматически из атрибута, настроенного через LDAP_MAP_EMAIL (см. конфигурацию LDAP).