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

Возможна настройка других почтовых сервисов. Для настройки необходимо в параметре 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. Пример:

    RESTORE_EMAIL_FRONTEND_URL=http://localhost:8080/
    RESTORE_EMAIL_ENABLED=true
    RESTORE_EMAIL_SERVER_HOST=smtp.yandex.ru
    RESTORE_EMAIL_SERVER_PORT=465
    RESTORE_EMAIL_SSL_ENABLE=true
    RESTORE_EMAIL_STARTTLS_ENABLE=false
    RESTORE_EMAIL_USERNAME=<Почта>
    RESTORE_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. Пример:

    RESTORE_EMAIL_FRONTEND_URL=http://localhost:8080/
    RESTORE_EMAIL_ENABLED=true
    RESTORE_EMAIL_SERVER_HOST=smtp.gmail.com
    RESTORE_EMAIL_SERVER_PORT=465
    RESTORE_EMAIL_SSL_ENABLE=true
    RESTORE_EMAIL_STARTTLS_ENABLE=false
    RESTORE_EMAIL_USERNAME=<Почта>
    RESTORE_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.

Примечания:

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

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

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

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

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