Включение и настройка рассылки по электронной почте¶
Почтовый сервис Яндекс Почта¶
Чтобы настроить рассылку для Яндекс Почты:
Воспользуйтесь Яндекс Справкой. Перейдите в раздел Настройка почтовых программ > Другие программы.
Выполните пункт 1 со страницы:
Откройте раздел «Почтовые программы» в настройках Яндекс Почты.
Выберите опции «С сервера imap.yandex.ru по протоколу IMAP» и «Пароли приложений и OAuth-токены».
Сохраните изменения.
Выполните пункт 2 со страницы. Генерация нового пароля необходима, так как в целях безопасности сервис требует различные пароли.
Откройте страницу Пароли приложений вашего аккаунта Яндекс ID и нажмите Создать новый пароль.
Выберите тип приложения Почта.
Придумайте название пароля, например укажите название приложения, для которого вы создаете пароль. С этим названием пароль будет отображаться в списке.
Нажмите кнопку Создать. Пароль приложения отобразится во всплывающем окне. Созданный пароль можно увидеть только один раз. Если вы ввели его неправильно и закрыли окно, удалите текущий пароль и создайте новый.
Полученный пароль используйте в следующем шаге.
Измените параметры в файле <UNIDATA_CONF_DIR>/backend.properties. Пример:
# Email notifications
org.unidata.mdm.core.email.enabled=true
org.unidata.mdm.core.email.templates_folder=file://${unidata.conf}/templates
org.unidata.mdm.core.email.server_host=smtp.yandex.ru
org.unidata.mdm.core.email.server_port=465
org.unidata.mdm.core.email.username=<Почта>
org.unidata.mdm.core.email.password=<Сгенерированый пароль сервиса>
org.unidata.mdm.core.email.frontend_url=http://localhost:8080/unidata-frontend
Сохраните изменения в backend.properties и перезагрузите контейнер, не перезапуская сборку. Либо подложите через docker-compose уже настроенный backend.properties в запускающийся контейнер.
Шаблоны писем расположены в каталоге <TOMCAT_HOME>/conf/unidata/templates. Используется процессор шаблонов Apache Velocity.
Почтовый сервис Google почта¶
Чтобы настроить рассылку для Google: - Войдите в Google-аккаунт. Включите двухэтапную аутентификацию, если это не сделано ранее:
Откройте страницу Аккаунт Google.
На панели навигации выберите Безопасность.
В разделе “Вход в аккаунт Google” нажмите Двухэтапная аутентификация > Начать.
Следуйте инструкциям на экране.
После завершения действий станет доступен пункт Пароли приложений.
Если пункт недоступен, то см. примечание в конце статьи.
Войдите в Пароли приложений и создайте пароль для приложения “Другое”, вписав название приложения. Например, Unidata. Полученный пароль используйте в следующем шаге.
Измените параметры в файле <UNIDATA_CONF_DIR>/backend.properties. Пример:
# Email notifications
org.unidata.mdm.core.email.enabled=true
org.unidata.mdm.core.email.templates_folder=file://${unidata.conf}/templates
org.unidata.mdm.core.email.server_host=smtp.gmail.com
org.unidata.mdm.core.email.server_port=465
org.unidata.mdm.core.email.username=<Почта>
org.unidata.mdm.core.email.password=<Сгенерированый пароль >
org.unidata.mdm.core.email.frontend_url=http://localhost:8080/unidata-frontend
Сохраните изменения в backend.properties и перезагрузите контейнер, не перезапуская сборку. Либо подложите через docker-compose уже настроенный backend.properties в запускающийся контейнер.
Шаблоны писем расположены в каталоге <TOMCAT_HOME>/conf/unidata/templates. Используется процессор шаблонов Apache Velocity (http://velocity.apache.org/).
Пункт “Пароли приложений” может быть недоступен, если:
Двухэтапная аутентификация не настроена для вашего аккаунта;
Двухэтапная аутентификация настроена только для электронных ключей;
Вы вошли в рабочий, учебный или другой корпоративный аккаунт;
В аккаунте включена Дополнительная защита.
Возможна настройка других почтовых сервисов. Для настройки необходимо в параметре unidata.activiti.task.mailServerHost=smtp.yandex.ru указать другой хост, в unidata.activiti.task.mailServerPassword указать пароль почты, и выполнить настройки сервиса, аналогичные шагам 2 и 3 из инструкции по настройке Яндекс Почты.