Рассылка по электронной почте

Возможна настройка других почтовых сервисов. Для настройки необходимо в параметре unidata.activiti.task.mailServerHost=smtp.yandex.ru указать другой хост, в unidata.activiti.task.mailServerPassword указать пароль почты, и выполнить настройки сервиса, аналогичные шагам 2 и 3 из инструкции по настройке "Яндекс Почты".

Настройка Яндекс Почты

Чтобы настроить рассылку для Яндекс Почты:

1. Воспользуйтесь "Яндекс Справкой". Перейдите в раздел "Настройка почтовых программ" > "Другие программы".

2. Выполните действия:

   • Откройте раздел "Почтовые программы" в настройках "Яндекс Почты".

   • Выберите опции "С сервера imap.yandex.ru по протоколу IMAP" и "Пароли приложений и OAuth-токены".

   • Сохраните изменения.

3. Необходима генерация нового пароля, так как в целях безопасности сервис требует различные пароли:

   • Откройте страницу "Пароли приложений" вашего аккаунта Яндекс ID и нажмите "Создать новый пароль".

   • Выберите тип приложения "Почта".

   • Придумайте название пароля, например укажите название приложения, для которого вы создаете пароль. С этим названием пароль будет отображаться в списке.

   • Нажмите кнопку Создать. Пароль приложения отобразится во всплывающем окне. Созданный пароль можно увидеть только один раз. Если вы ввели его неправильно и закрыли окно, удалите текущий пароль и создайте новый.

4. Полученный пароль используйте далее при настройке конфигурации.

5. Если система устанавливалась через Docker, то оптимальный способ конфигурирования - через файл .env. Пример:

   EMAIL_FRONTEND_URL=http://localhost:8080/
   EMAIL_ENABLED=true
   EMAIL_SERVER_HOST=smtp.yandex.ru
   EMAIL_SERVER_PORT=465
   EMAIL_SSL_ENABLE=true
   EMAIL_STARTTLS_ENABLE=false
   EMAIL_USERNAME=<Почта>
   EMAIL_PASSWORD=<Сгенерированный пароль>
   

6. Если система устанавливалась вручную из дистрибутива, то измените параметры в файле <UNIVERSE_CONF_DIR>/backend.properties. Пример:

   # Email notifications
   org.unidata.mdm.core.email.enabled=true
   org.unidata.mdm.core.email.templates_folder=file://${universe.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/
   

• Используйте один из способов сохранения параметров backend.properties:

  • Сохраните изменения в backend.properties и перезагрузите контейнер, не перезапуская сборку.

  • Или подложите через docker-compose уже настроенный backend.properties в запускающийся контейнер.

Шаблоны писем расположены в каталоге <TOMCAT_HOME>/conf/universe/templates. Используется процессор шаблонов Apache Velocity.

Настройка Google почты

Чтобы настроить рассылку для Google почты:

1. Войдите в Google-аккаунт. Включите двухэтапную аутентификацию, если это не было сделано ранее:

   • Откройте страницу "Аккаунт Google".

   • На панели навигации выберите "Безопасность".

   • В разделе "Вход в аккаунт Google" нажмите "Двухэтапная аутентификация" > "Начать".

   • Следуйте инструкциям на экране.

2. После завершения действий станет доступен пункт "Пароли приложений".

   • Если пункт недоступен, то см. "Примечания" в конце статьи.

3. Войдите в "Пароли приложений" и создайте пароль для приложения "Другое", вписав название приложения. Например, Universe. Полученный пароль используйте в следующем шаге.

4. Если система устанавливалась через Docker, то оптимальный способ конфигурирования - через файл .env. Пример:

   EMAIL_FRONTEND_URL=http://localhost:8080/
   EMAIL_ENABLED=true
   EMAIL_SERVER_HOST=smtp.gmail.com
   EMAIL_SERVER_PORT=465
   EMAIL_SSL_ENABLE=true
   EMAIL_STARTTLS_ENABLE=false
   EMAIL_USERNAME=<Почта>
   EMAIL_PASSWORD=<Сгенерированный пароль>
   

5. Если система устанавливалась вручную из дистрибутива, то измените параметры в файле <UNIVERSE_CONF_DIR>/backend.properties. Пример:

   # Email notifications
   org.unidata.mdm.core.email.enabled=true
   org.unidata.mdm.core.email.templates_folder=file://${universe.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/
   

• Используйте один из способов сохранения параметров backend.properties:

  • Сохраните изменения в backend.properties и перезагрузите контейнер, не перезапуская сборку.

  • Или подложите через docker-compose уже настроенный backend.properties в запускающийся контейнер.

Шаблоны писем расположены в каталоге <TOMCAT_HOME>/conf/universe/templates. Используется процессор шаблонов Apache Velocity.

Примечания:

Пункт "Пароли приложений" может быть недоступен, если:

• Двухэтапная аутентификация не настроена для вашего аккаунта;

• Двухэтапная аутентификация настроена только для электронных ключей;

• Вы вошли в рабочий, учебный или другой корпоративный аккаунт;

• В аккаунте включена "Дополнительная защита".