Мастер-Тур(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	Уведомление о новой агентской резервации	Администратор системы
2	Уведомление о персональном бронировании	Администратор системы, e-mail филиала
3	Сообщения для менеджера	Менеджер (филиал или страна в зависимости от настроек)
4	Уведомление об ошибке	Администратор системы
5	Уведомление для подагентства	Администратор системы (при активном параметре `SubAgency`)
6	Дополнительные уведомления	Указанные дополнительные адреса e-mail

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

№	Описание	Настройка
1	Отправка бронирований через агентства false – письма не отправляются true – письма отправляются	"SendAgencyReservation": true,
2	Отправка сообщений на персональную почту false – письма не отправляются true – письма отправляются	"SendPersonalEmail": true,
3	Определение приоритета проставления ведущего менеджера по путевке. partner – ведущий менеджер по партнеру; filial – ведущий менеджер по филиалу (при включенной настройке useFilialChoice); tour или пустое значение или отсутствие настройки — ведущий менеджер по туру.	"ManagerPriority": "filial",
4	Настройка, позволяющая частным лицам регистрироваться на сайте оператора и бронировать путевки в базу ПК «Мастер-Тур» true – частные лица могут регистрироваться и бронировать путевки в базу туроператора false или отсутствие настройки – возможность отключена	"PersonalBooking": true,
5	Настройка, включающая возможность расширенного выбора офиса продаж при бронировании путевок. В списке офисов продаж отображаются партнеры отмеченные как фирма-владелец и филиал фирмы владельца. true – возможность выбора офиса продаж false или отсутствие настройки — отключить возможность выбора офиса продаж	"AdvancedFilialChoise": false,
6	Настройка, определяющая необходимость отправки копии письма с примечанием по заявке на e-mail по стране true – отправлять копию письма с сообщением по заявке на e-mail по стране false или отсутствие настройки – письмо с сообщением по заявке на e-mail по стране не отправляется	"SendManagerMessagesToCountryEmail": false,
7	Включение использования субагентов true – использовать субагентов false – не использовать субагентов	"SubAgency": false,

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

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

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

 
"Mail": {
    "SendAgencyReservation": true,
    "SendPersonalEmail": true,
    "ManagerPriority": "filial",
    "PersonalBooking": true,
    "AdvancedFilialChoise": false,
    "SendManagerMessagesToCountryEmail": false,
    "SubAgency": false,
    "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 от имени администратора. При этом будут удалены правила для входящих подключений.