Indeed AM SMS Proxy

Indeed AM SMS Proxy (SMS Proxy) — это веб-приложение, которое работает на базе IIS. SMS Proxy напрямую подключается к SMPP-шлюзу и отправляет SMS, при этом Indeed AM Server не производит разрыв сессии с SMPP-шлюзом, и запросы отправляются в рамках одного подключения, а не в отдельных для каждого запроса.

Файлы для установки

Файлы для установки SMS Proxy расположены в папке Indeed AM <Номер версии>\Indeed AM SMS Proxy:

• <Номер версии>\IndeedAM.Proxies.SMS-<номер версии>.x64.ru-ru.msi — пакет для установки Indeed AM SMS Proxy x64 версии;
• <Номер версии>\IndeedAM.Proxies.SMS-<номер версии>.x86.ru-ru.msi — пакет для установки Indeed AM SMS Proxy x86 версии.

Установка

1. Установите роль IIS на сервере, на котором вы планируете устанавливать SMS Proxy, одним из следующих способов:
   • откройте Диспетчер серверов, выберите Локальный сервер и во вкладке Управление нажмите Добавить роли и компоненты;
   • с помощью скрипта \Misc\IISScripts\Indeed.Main.IIS.Install.MSServer.ps1.
2. Выполните установку Indeed AM SMS Proxy через запуск соответствующего пакета.
3. После завершения установки может потребоваться перезагрузка системы. Если программа установки предлагает выполнить перезагрузку, подтвердите данное действие.
4. Удаление/Восстановление продукта осуществляется стандартным для поддерживаемых ОС способом через меню Панель управления.

Редактирование конфигурационного файла

1. Откройте конфигурационный файл app-settings.Production.json из папки C:\inetpub\wwwroot\am\proxies\sms.

2. В секции Smpp заполните следующие параметры:

   • SystemId и Password — укажите данные аутентификации для подключения к серверу SMPP;
   • Host — укажите адрес подключения к серверу SMPP;
   • Port — укажите заданный порт для подключения к серверу SMPP;
   • SystemType — опциональный параметр входа в систему со стороны сервера SMPP, например, S1;
   • EsmeAddressTon — возможные значения: Unknown, International, National, NetworkSpecific, SubscriberNumber, Alphanumeric, Abbreviated;
   • EsmeAddressNpi — возможные значения: Unknown, ISDN, Data, Telex, LandMobile, National, Private, ERMES, IP;
   • LoggingPermissions — укажите параметр, отвечающий за отображение в логах информации об отправителе и получателе. Можно указатать значения через запятую. Возможные параметры:
     • Source— отправитель сообщения,
     • Destination— получатель сообщения,
     • None (значение по умолчанию) — скрываются значения всех логируемых полей,
     • All — показываются значения всех логируемых полей.

3. Поле Publication включает опциональный параметр DefaultSource, содержащий имя отправителя в запросах, например, Indeed-AM.

4. В поле Authentication": {"Certificate":} укажите отпечаток сертификата, по которому провайдер (SMS или Storage SMS) может быть аутентифицирован в SMS Proxy для отправки сообщений. По умолчанию используется конфигурация для аутентификации без сертификата "Certificate": {"Enabled": false, "Thumbprint": "" }.

   Примечание

   Рекомендуется сначала настроить систему без установки двустороннего TLS-соединения, то есть без использования сертификатов. При настройке политики SMS прокси оставьте значения отпечатков сертификатов пустыми.

5. Чтобы применить изменения в файле app-settings.Production.json, перезапустите сервер IndeedAM.Core.proxies.sms.

Пример конфигурационного файла

{
 "Smpp": {
    "SystemId": "smppclient1",
    "Password": "password",
    "Host": "am1.indeed.local",
    "Port": "2776",
    "EsmeAddressTon": "International",
    "EsmeAddressNpi": "ISDN",
    "ReconnectionDelay": "00:02:00",
    "LoggingPermissions": "Source"
    },
 "Publication": {
    "DefaultSource": "Indeed-Id"
    },
 "Documentation": {
    "Enabled": false
    },
 "Debug": {
    "ExceptionResponsesEnabled": false
    },
 "Authentication": {
    "Certificate": {
        "Enabled": false,
        "Thumbprint": "",
        "ForwardingHeader": "Proxy-Client-Certificate"
        }
    },
 "ReverseProxyIntegration": {
    "BasePath": "/am/proxies/sms"
    },
 "Localization": {
    "DefaultCulture": "ru-RU"
    }
}

Выбор типа подключения

Информация

Перед настройкой групповой политики добавьте шаблоны политик Indeed AM в список административных шаблонов. Файлы шаблонов политик входят в состав дистрибутива SMS Proxy и расположены в каталоге Misc.

Через GPO

Политика Выбор типа подключения для провайдера применяется к серверам Indeed AM и предназначена для выбора Sender провайдера SMS OTP.

1. Откройте политику Выбор типа подключения для провайдера. Политика расположена по следующему пути: Административные шаблоны→Indeed-ID→Id Providers→SMS OTP.
2. Установите значение политики Включено.
3. В параметрах выберите опцию SMS Прокси для SMS Proxy.

В реестре

1. Откройте редактор реестра на сервере Indeed AM.
2. Откройте раздел HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Indeed-ID\BSPs\SMSOTP.
3. Создайте параметр SmsSenderType с типом DWORD со значением 5.

Настройки SMS прокси

Через GPO

Политика применяется к серверам Indeed AM и определяет настройки для сервиса отправки SMS.

Включите политику Настройки SMS прокси и укажите необходимые параметры:

• URL — адрес подключения к SMS Proxy. Например: https://am1.indeed.local/am/proxies/sms.
• Отправитель — имя отправителя, которое будет отображаться при получении SMS.
• Дополнительный текст перед отправкой OTP — произвольный текст сообщения, предшествующий одноразовому паролю.
• Отпечаток сертификата клиента (необязательный параметр) — сертификат провайдера, указанный в настройках конфигурационного файла SMS Proxy app-settings.Production.json (поле Authentication": {"Certificate": {"Thumbprint": "" } }). Этот сертификат будет добавлен в список сертификатов клиента при запросе к SMS Proxy.
• Отпечаток сертификата сервера — сертификат SMS Proxy для работы по протоколу HTTPS (настраивается в IIS).

В реестре

1. Откройте редактор реестра на сервере Indeed AM.
2. Откройте раздел HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Indeed-ID\BSPs\SMSOTP\SMSProxy.
3. Создайте следующие параметры:
   • ServerUrl — адрес подключения к SMS Proxy. Например: https://am1.indeed.local/am/proxies/sms.
   • From (REG_SZ) — имя отправителя, которое будет отображаться при получении сообщения.
   • messageOTP (REG_SZ) — произвольный текст сообщения, предшествующий одноразовому паролю.
   • ClientCertificateThumbprint (REG_SZ) — сертификат провайдера, указанный в настройках конфигурационного файла SMS Proxy app-settings.Production.json (поле Authentication": {"Certificate": {"Thumbprint": "" } }).
   • ServerCertificateThumbprint (REG-SZ) — сертификат SMS Proxy для работы по протоколу HTTPS (настраивается в IIS).

Двустороннее TLS-соединение

Чтобы установить двустороннее TLS-соединение между серверами Indeed AM Core и Indeed AM SMS Proxy, выполните следующие действия:

1. Для сервера SMS Proxy (сервер) сгенерируйте сертификат серверной аутентификации (по шаблону Веб-сервер).

2. Для сервера AM Core (клиент) сгенерируйте сертификат клиентской аутентификации (например, по шаблону Компьютер в доменном центре сертификации Windows).

3. Экспортируйте в файл сертификат клиента и установите его на сервере SMS Proxy в Сертификаты компьютера/Личные.

4. В конфигурационном файле SMS Proxy укажите следующие параметры.

   "Authentication": {
      "Certificate": {
         "Enabled": true,
         "Thumbprint": "отпечаток_сертификата_клиента"
         }
       }

   В таблице приведены возможные параметры для поля Authentication": {"Certificate":}.

   Параметр	Описание
   Authentication:Certificate:Enabled	По умолчанию true. Включает использование двустороннего TLS-соединения
   Authentication:Certificate:ForwardingEnabled	По умолчанию true. Включает поддержку пересылки сертификата клиента от прокси сервера в HTTP-заголовке Authentication:Certificate:ForwardingHeader
   Authentication:Certificate:ForwardingHeader	Ожидается закодированный Base64 сертификат. При интеграции с IIS вне процесса, сертификат передается в "MS-ASPNETCORE-CLIENTCERT", который будет автоматически использован. Пример: Proxy-Client-Certificate
   Authentication:Certificate:Thumbprint	Пример: 380854EA27F2BAED041A941CAC73337E27D0BA6A
   Authentication:Certificate:RevocationMode	По умолчанию NoCheck. Возможные значения: NoCheck, Online, Offline
   Authentication:Certificate:ValidateCertificateUse	По умолчанию true. Определяет необходимость проверки EKU.
   Authentication:Certificate:ValidateValidityPeriod	По умолчанию true. Определяет необходимость проверки времени действия сертификата

5. Добавьте отпечаток сертификата в политику Настройки SMS прокси на сервере АМ core.