Предварительная настройка DSS для работы с аутентификацией по одноразовым паролям, отправляемым в СМС
Для использования данного метода вторичной аутентификации и подтверждения операций необходимо:
1. Включить метод аутентификации по одноразовым паролям, отправляемым в СМС.
Идентификатор метода аутентификации по одноразовым паролям, отправляемым в СМС: http://dss.cryptopro.ru/identity/authenticationmethod/otpviasms
Для включения данного метода необходимо использовать следующий командлет:
Enable-DssAuthenticationMethod -Uri http://dss.cryptopro.ru/identity/authenticationmethod/otpviasms
2. Зарегистрировать компонент для рассылки сообщений через СМС.
Вариант 1 Регистрация тестового СМС-плагина.
Сообщения, отправляемые через тестовый плагин, будут сохраняться в файлы в указанной при настройке директории. Данный пример демонстрирует настройку компонента оповещения через тестовый СМС-плагин.
# Директория для сохранения файлов с сообщениями
$SMSBaseDir = "C:\tempsms\"
Write-Host "Добавление плагина для отправки СМС-сообщений"
Add-DSSSignServerPlugin -PluginTypeName "CryptoPro.DSS.SmsService.StubPlugin.SmsStub,DSS.SmsService.StubPlugin" -PluginType SMS -Settings @{"WorkingDirectory" = $SMSBaseDir}
Write-Host "Добавление плагина для форматирования СМС-сообщений"
Add-DSSSignServerPlugin -PluginTypeName "CryptoPro.DSS.MessageFormatter.SMSFormatter,DSS.MessageFormatter" -PluginType Formatter -Settings @{Header="криптопро DSS."}
Write-Host "Добавление модуля оповещения для отправки СМС-сообщений"
Add-DSSSignServerNotifier -TransportPluginID 1 -FormatterPluginID 2 -NotifierType SMS -Settings @{"MinQueueSize"="0";"MaxQueueSize"="10000";"TimerInterval"="500";"TTL"="1";"MessageWindow"="50";"ThreadCount"="1";"Enabled"="true"}
Вариант 2 Регистрация стандартного плагина DSS.SmsService.SmppPlugin.
Данный плагин предназначен для работы со службой рассылки SMS по протоколу SMPP. Для его регистрации необходимо использовать командлет Add-DSSSignServerPlugin.
Тип плагина, указываемый при регистрации в параметре PluginTypeName: CryptoPro.DSS.SmsService.SmppPlugin.SmppPlugin,DSS.SmsService.SmppPlugin
Параметры плагина SMPP:
Параметр | Описание | Значение по умолчанию | Обязательный |
---|---|---|---|
ServiceAddress | Адрес SMPP сервера | Нет | Да |
ServicePort | Порт доступа к серверу SMPP | Нет | Да |
SystemId | Логин для доступа к сервису | Нет | Да |
SystemPassword | Пароль для доступа к сервису | Нет | Да |
Source | Адрес отправителя | null | Нет |
Вариант 3 Создание собственного СМС-плагина и его регистрация.
Модуль отправки коротких текстовых сообщений (СМС) должен представлять собой сборку .NET. Сборка должна содержать единственный публичный класс, реализующий интерфейс ISmsPlugin. Интерфейс ISmsPlugin описан в сборке CryptoPro.DSS.Common.dll. Интерфейс предоставляет метод SendSms, предназначенный для отправки SMS, определен следующим образом:
public interface ISmsPlugin : IDSSPlugin
{
void SendSms(string message, string phone);
}
Метод SendSms
принимает следующие параметры:
message
– текстовое сообщение;phone
– номер телефона; Список дополнительных параметров задается c помощью командлета Set DSSStsProperties. При возникновении ошибки в процессе выполнения методаSendSms
необходимо сгенерировать исключениеSmsException
.