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

Материал из Megatec
Перейти к: навигация, поиск

Введение

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.

MegatecMailService

  • Для удаления службы кэширования необходимо запустить скрипт _UnInstall.bat от имени администратора. При этом будут удалены правила для входящих подключений.
Источник — «http://wiki.megatec.ru/index.php?title=Мастер-Тур(15):MailService&oldid=32030»