"ДБО BS-Client. Частный Клиент" v.2.5
Рассылка SMS сообщений. Взаимодействие с «Сервером Нотификации 2.0»
Версия 2.5.0.0
1. Аннотация
Настоящий документ содержит информацию, актуальную на момент его составления. не гарантирует отсутствия ошибок в данном документе. оставляет за собой право вносить изменения в документ без предварительного уведомления.
Данный документ предназначен для администраторов системы.
Документ содержит информацию о принципах взаимодействия с «Сервером Нотификации 2.0».
СОДЕРЖАНИЕ:
1. Аннотация. 2
2. Рассылка сообщений. 4
2.1. Отправка информационных сообщений. 4
3. Настройки связи с «Сервером Нотификации 2.0» в ЧК. 4
4. Взаимодействие с «Сервером Нотификации 2.0». 5
2. Рассылка сообщений
В ЧК с помощью Сервера Нотификации 2.0. реализована рассылка следующих видов сообщений, отправляемых Клиенту:
· Информационные сообщения:
o SMS-код для подписи документов (при подписи документов и при дополнительной авторизации по SMS-паролю).
o Логин и пароль, при самостоятельной регистрации клиента.
o Сообщение об успешной авторизации на сайте ИК.
o Сообщение о неуспешной авторизации на сайте ИК.
· Оповещение по статусам документов.
Отправка информационных сообщений через СН 2.0. настраивается администратором системы через справочник «Типы сообщений Сервера Нотификации 2.0» в приложении C-Bank посредством флага «Активен». Отключение / включение сообщения выполняется для всех клиентов системы.
Оповещения по статусам документов через СН 2.0. настраиваются отдельно в справочнике «Оповещение клиентво по статусам документов» (подробнее описание приведено в документе Руководство администратора. doc).
2.1. Отправка информационных сообщений
Для рассылки информационных сообщений используется таблица NotifyMessages, информация в которой обрабатывается авто-процедурой «Отправка информационных сообщений». Авто-процедура выполняется периодически раз в 30 сек и по умолчанию отключена. Формирование информационных сообщений инициируется из системы ЧК в следующих случаях:
· При отправке SMS-кода;
· При отправке логина и пароля;
· При успешной авторизации в системе;
· При ошибочном вводе пароля клиента в систему;
3. Настройки связи с «Сервером Нотификации 2.0» в ЧК
Для уведомления клиента о событиях по SMS с помощью «Сервера Нотификации 2.0» необходимо активизировать соответствующие типы запросов из справочника «Типы запросов сервера нотификации 2.0» и указать директорию, куда будут выгружаться файлы запросов.
Для активизации запроса:
· Выберите пункт меню «Настройки -> Рассылка сообщений -> Типы сообщений Сервера Нотификации 2.0».
· Выберите из списка тип запроса и дважды кликните на нем левой кнопкой мыши.
ð При этом откроется диалоговое окно редактирования выбранного типа (Рис. 3‑1)
Рис. 3‑1 Диалоговое окно «Тип сообщения Сервера Нотификации 2.0»
· Установите галку в поле «Активен».
Для указания пути выгрузки файлов с запросами:
· Выберите пункт меню «Настройки -> Рассылка сообщений -> Параметры Сервера Нотификации 2.0».
ð При этом откроется диалоговое окно редактирования выбранного типа (Рис. 3‑2)
Рис. 3‑2 Диалоговое окно «Параметры Сервера Нотификации 2.0»
· Задайте путь к директории, где будут содержаться файлы с запросами, предназначенными для сервера нотификации.
4. Взаимодействие с «Сервером Нотификации 2.0»
Взаимодействие с СН 2.0 происходит посредством обмена файлами в формате XML, которые складываются в указанную директорию и обрабатываются далее уже самим СН.
Все реализуемые сообщения перед отправкой добавляются в таблицу NotifyMassages (информационные сообщения) или SMSCode (рассылка SMS паролей). Далее рассылка осуществляется соответствующей авто-процедурой. Способ отправки, через СН 2.0 или через smpp протокол, определяется при обработке конкретного сообщения в зависимости от настроек системы для каждого сообщения.
Каждому типу сообщений соответствует запись в справочнике «Типы запросов сервера нотификации 2.0» со следующими параметрами.
Тип запроса | Описание | Код сообщения СН | Модуль обработки запроса |
CUSTINFO | Синхронизация данных клиента | 100 | axSNCustInfo. BLL |
SMSPASS | Отправка sms-паролей | 304 | axSNSMSPass. BLL |
AUTHINFO | Отправка логина и пароля | 305 | axSNAuth. BLL |
AUTHOK | Успешная авторизация | 301 | axSNAuth. BLL |
AUTHERR | Ошибочная авторизация | 302 | axSNAuth. BLL |
Если необходимо реализовать другой вид сообщения обратитесь в службу технической поддержки «Банк Софт Системс».
Для работы с сервером нотификации обязательно должен быть активизирован запрос CUSTINFO, предназначенный для синхронизации данных клиента и включена автопроцедура «Синхронизация информации о подписке клиента с СН 2.0». В зависимости от типа сообщения должны быть активизированы автопроцедуры «Отправка SMS паролей» (для отправки sms-паролей) и «Отправка информационных сообщений» (остальные сообщения).
Подробная информация о работе и настройке автопроцедур содержится в документе «Руководство администратора».
Информация о сообщениях и их отработке в системе хранится в журналах «Информационные сообщения для отправки» и «Монитор проверки SMS кодов» (Безопасность -> Мониторинг действий пользователя).
XML формат файла информационного сообщения
Данный формат используется для следующих видов информационных сообщений с СН 2.0:
· AUTHOK – информация о входе клиента в систему
· AUTHERR – информация об ошибочной авторизации
<?xml version="1.0" encoding="WINDOWS-1251"?>
<inMessage code="301">
<params>
<param Name="EVENTDATE">08.02.2010</param>
<param Name="EVENTTIME">11:08:30</param>
</params>
<clients>
<client code="2"/>
</clients>
</inMessage>
Param – параметры для формирования сообщения в СН.
EVENTDATE – дата наступления события в формате ДД. ММ. ГГГ.
EVENTTIME – время наступления события в формате ЧЧ:ММ:СС.
Client в атрибуте Code содержится идентификатор клиента в системе ЧК.
XML формат файла с SMS паролем
Данный формат используется для следующих видов информационных сообщений с СН 2.0:
· SMSPASS – отправка sms пароля.
<?xml version="1.0" encoding="WINDOWS-1251"?>
<inMessage code="304">
<params>
<param name="EVENTDATE">08.02.2009</param>
<param name="EVENTTIME">11:12:44</param>
<param name="PASSWORD"></param>
<param name="SMSCOUNTER">1</param>
</params>
<clients>
<client code="100008"/>
</clients>
</inMessage>
Param – параметры для формирования сообщения в СН.
EVENTDATE – дата наступления события в формате ДД. ММ. ГГГ.
EVENTTIME – время наступления события в формате ЧЧ:ММ:СС.
PASSWORD – пароль, передаваемый клиенту.
SMSCOUNTER – Счетчик пароля sms.
Client в атрибуте Code содержится идентификатор клиента в системе ЧК.
Шаблон сообщения в СН 2.0: %MESSAGETEXT%
В СН 2.0 сообщение c паролем отправляется с кодом 304
XML формат файла с данными клиента
Данный формат используется для следующих видов сообщений с СН 2.0:
· CUSTINFO – синхронизация данных клиента.
<?xml version="1.0" encoding="WINDOWS-1251"?>
<InMessage Code="100">
<Params>
<Param Name="Name">ФИО</Param>
<Param Name="DateBorn">01.01.1980</Param>
<Param Name="Passport">АК</Param>
<Param Name="AddrReg"></Param>
<Param Name="AddrReal"></Param>
<Param Name="SUBSCRIPTION">SMS;304,301,302,305;</Param>
</Params>
<Clients>
<Client Code="100008"/>
</Clients>
</InMessage>
Param – параметры для формирования сообщения в СН.
Name – полное ФИО клиента.
DateBorn – дата рождения
Passport – паспортные данные клиента
AddrReq – адрес регистрации
AddrReal – адрес проживания
SUBSCRIPTION – содержит информацию о подписке Клиента (через запятую перечисляются все активные типы сообщений), номер телефона, на который клиенту будут передаваться сообщения
Обязательными параметрами являются: Name, Passport, SUBSCRIPTION
Client в атрибуте Code содержится идентификатор клиента в системе ЧК.
