Мастер-Тур(15):MailService

Введение

MailService – это сервис для отправки email-уведомлений и сообщений, которые требуется формировать в процессе бронирования туров. Сервис обеспечивает интеграцию с внешними почтовыми системами, логирование операций и управление настройками для различных типов сообщений.

Установка службы MailService

• Скопировать папку MailService из дистрибутива на сервер приложений.
• Указать настройки MailServiceUrl – адреса сервиса отправки почтовых сообщений в Megateс.TourSearchOwin.exe.config службы TourSearchOwin
• Включить MailServiceLogger – логгер функционала отправки почтовых сообщений в Megateс.TourSearchOwin.exe.config службы TourSearchOwin
• Перед установкой службы необходимо настроить конфигурационный файл appsettings.json.
  

Настройка службы MailService

В разделе Install конфигурационного файла задаются параметры установки и адреса службы MailService.

№	Описание	Настройка
1	Название службы. По умолчанию служба будет создана с названием MegatecMailService.	"ServiceName": "MegatecMailService"
2	Путь к службе MailService. По умолчанию служба отправки сообщений использует порт 7705. Рекомендуется использование порта по умолчанию. Внимание! При смене порта необходимо также изменить порт в установочном скрипте _Install.bat.	"ServiceAddress": [ "http://localhost:7705" ]
3	IP-адрес службы	"IPAddress": "IPAddress.IPv6Any"
4	Разрешенные хосты	"AllowedHosts": "*"

Пример конфигурации для установки службы

{
  "Install": {
    "ServiceName": "MegatecMailService",
    "ServiceAddress": [ "http://localhost:7705" ],
    "IPAddress": "IPAddress.IPv6Any"
  },
  "AllowedHosts": "*"
}

Убедитесь, что адреса и IP-адреса службы настроены правильно, а доступ к службе ограничен только необходимыми хостами для обеспечения безопасности.

Настройка отправки e-mail сообщений через MailService

Из системы бронирования через MailService отправляются следующие сообщения:

№	Сообщение	Получатели сообщения
1	Уведомление о новой агентской резервации	администратор системы, дополнительный email (настройка AddRcptTo), email ведущего менеджера (если указана настройка "ManagerPriority": "filial")
2	Уведомление о персональном бронировании	администратор системы, дополнительный email (настройка AddRcptTo), email ведущего менеджера (если указана настройка "ManagerPriority": "filial")
3	Сообщения для менеджера	email ведущего менеджера (если указана настройка "ManagerPriority": "filial")
4	Уведомление об ошибке	Почта для отправки ошибок и уведомлений AdminEmail

Основные параметры конфигурации для MailService

№	Описание	Настройка
1	Для отправки письма о бронировании покупателю, письмо отправляется на e-mail представителя, указанный в поле US_EMAIL из таблицы [DUP_USER] false – письма не отправляются true – письма отправляются	"SendAgencyReservation": true,
2	Настройка, включающая отправку письма о новом бронировании частному лицу. При включенной настройке частнику отправляется письмо из шаблона templates/personal order report.xml. false – письма не отправляются true – письма отправляются	"SendPersonalEmail": true,
3	Определение email почты ведущего менеджера по путевке. partner – ведущий менеджер по партнеру; filial – ведущий менеджер по филиалу (при включенной настройке useFilialChoice); tour или пустое значение или отсутствие настройки — ведущий менеджер по туру.	"ManagerPriority": "filial",
4	Настройка, определяющая необходимость отправки копии письма с примечанием по заявке на e-mail по стране true – отправлять копию письма с сообщением по заявке на e-mail по стране false или отсутствие настройки – письмо с сообщением по заявке на e-mail по стране не отправляется	"SendManagerMessagesToCountryEmail": false,

В таблице приведено описание почтовых настроек, которые должны быть заданы для работы MailService.

№	Описание	Настройка
1	Адрес, с которого отправляются письма из системы бронирования, обязателен для заполнения	"MailFrom": "primer@Mail.com"
2	Адрес администратора системы, обязателен для заполнения	"RcptTo": "primer@Mail.com"
3	Дополнительный e-mail адрес, на которые приходят сообщения о новой регистрации и заявке на бронирование	"AddRcptTo": "primer@Mail.com"
5	Почта для отправки отчетов об ошибках, возникающих при работе системы	"AdminEmail": "primer@Mail.com"
7	Настройка, определяющая e-mail, на который будут оправляться копии писем о новом бронировании от частников	"AdditionalPersonalEmail": "primer@Mail.com"
7	Почтовый сервер SMTP, обязателен для заполнения	"SmtpServer": "smtp.yandex.ru"
8	SMTP порт почтового сервера (по умолчанию — 587), обязателен для заполнения	"SmtpPort": 587
9	Тип авторизации на сервере: None, Base64 или TLS/SSL, обязателен для заполнения	"Authentication": "TLS/SSL"
10	Имя пользователя для подключения к почтовому серверу, обязателен для заполнения	"SmtpUser": "primer@Mail.com"
11	Пароль пользователя почтового сервера, обязателен для заполнения	"SmtpPassword": "••••••••"
12	Активация протокола SSL (Нужно включить при использовании TLS/SSL авторизации.)	"EnableSSL": true

Пример почтовых настроек appsettings.json для использования почты Google Mail.

 
"Mail": {
    "SendAgencyReservation": true,
    "SendPersonalEmail": true,
    "ManagerPriority": "filial",    
    "Accounts": [
{
        "MailFrom": "primer@GoogleMail.com",
        "SmtpServer": "smtp.gmail.com",
        "SmtpPort": 25, //or 587
        "Authentication": "TLS/SSL",
        "SmtpUser": "GMailUser@GoogleMail.com",
        "SmtpPassword": "Pa$$w0rd",
        "DebugPurposeMail": "GMailDebugPurposeMail@GoogleMail.ru",
        "EnableSSL": true
      } 
], 
"Addressees": {
      "RcptTo": "primer@GMail.com",
      "AddRcptTo": "primer@GMail.com",
      "Visa": "primer@GMail.com",
      "Finance": "primer@GMail.com",
      "Manager": "primer@GMail.com",
      "AdminEmail": "primer@GMail.com",
      "AnkEmail": "primer@GMail.com",
      "AdditionalPersonalEmail": "primer@GMail.com"
    }
},

Внимание! Необходимо также настроить почтовый ящик Google Mail:

• Осуществить вход в почтовый ящик Google Mail
• Выбрать раздел "Мой аккаунт" в списке "Приложения Google"
• Перейти в раздел "Безопасность и вход", включить опцию Ненадежные приложения разрешены
  
  

Пример почтовых настроек appsettings.json для использования почты Yandex, если почта со своим доменным именем на yandex. MailFrom и smtpUser должны совпадать, smtpPort="587".

 
{
        "MailFrom": "primer@yandex.ru",
        "SmtpServer": "smtp.yandex.ru",
        "SmtpPort": 587, //or 587
        "Authentication": "TLS/SSL",
        "SmtpUser": "primer@yandex.ru",
        "SmtpPassword": "Pa$$w0rd",
        "DebugPurposeMail": "primerDebugPurposeMail@yandex.ru",
        "EnableSSL": true
      }

Пример почтовых настроек appsettings.json для использования почты Yandex, если почта на уandex без своего домена. В качестве smtpUser берется имя пользователя из mailFrom без @yandex.ru, smtpPort="587".

 
{
        "MailFrom": "primer@yandex.ru",
        "SmtpServer": "smtp.yandex.ru",
        "SmtpPort": 587, //or 587
        "Authentication": "TLS/SSL",
        "SmtpUser": "primer",
        "SmtpPassword": "Pa$$w0rd",
        "DebugPurposeMail": "primerDebugPurposeMail",
        "EnableSSL": true
      }

Пример почтовых настроек appsettings.json для использования почты Mail.ru.

 
{
        "MailFrom": "primer@mail.ru",
        "SmtpServer": "smtp.mail.ru",
        "SmtpPort": 587, //or 587
        "Authentication": "TLS/SSL",
        "SmtpUser": "primer@mail.ru",
        "SmtpPassword": "Pa$$w0rd",
        "DebugPurposeMail": "primerDebugPurposeMail@mail.ru",
        "EnableSSL": true
      }

Для корректной работы сервиса необходимо убедиться, что доступ к конфигурационному файлу ограничен.

• Установка осуществляется запуском скрипта _Install.bat от имени администратора.
• При установке в Брандмауэре Windows создаются правила для входящих подключений для открытия порта службы MailService (например TCP 7705 и UDP 7705)
• В Службах Windows добавляется служба MegatecMailService.
  

• Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.