Уведомление потребителей запроса согласий

Вы можете получать уведомления о событиях на платформе согласий. В уведомлениях передаются данные о событии, включая:

• Идентификатор согласия;

• Идентификатор пользователя ЕСИА, связанный с согласием.

Уведомления можно получать двумя способами:

1. Через СМЭВ;
2. Через REST-сервис вашей внешней системы.

Если настроить оба способа, уведомление придет дважды

Типы событий платформы согласий ЕСИА в виде символьной мнемоники-кода события:

PermissionOperationEnum.claimPermission	Запрос согласия
PermissionOperationEnum.issuePermission	Выдача гражданином согласия
PermissionOperationEnum.refusePermission	Отказ гражданина от выдачи согласия
PermissionOperationEnum.revokePermission	Отзыв гражданином согласия

1. Получение уведомлений через СМЭВ

Платформа согласий может отправлять уведомления о событиях через СМЭВ.

Что нужно сделать:

1. Получите доступ к виду сведения "Отправка в организацию уведомления о событии платформы согласий ЕСИА" как ответчик, указав в коде маршрутизации мнемонику системы
2. Уполномоченный сотрудник вашей организации должен указать мнемонику СМЭВ вашей ИС для приёма уведомлений. Это делается в технологическом портале.

Требования к учётной записи сотрудника:

• Сотрудник должен быть руководителем организации или администратором профиля организации в ЕСИА;

• Сотрудник должен быть включён в группу доступа «Технологический портал».

Примечание:

Настройки выполняются в профиле организации в ЕСИА. Руководитель может назначить администратором и включить в группу доступа любого сотрудника организации.

Как настроить:

1. Перейдите в технологический портал.
2. Выберите: Сервисы → Оповещения → Информационная система для приёма уведомлений от платформы согласий.
 
В выпадающем списке выберите ИС, на которую будут отправляться уведомления, и нажмите кнопку справа для сохранения.

2. Получение уведомлений через REST-сервис

Платформа согласий может отправлять запросы на REST-сервисы (методы) вашей ИС в соответствии с моделью данных, которая описывает атрибутивный состав события платформы согласий.

Представленный атрибутивный состав события платформы согласий определяет структуру JSON-тела запроса на REST-сервис вашей ИС:

eventType : string	Источник события, для платформы согласий всегда равен permissionsevent
opType : string	Тип события платформы согласий
oid : string	Идентификатор (OID) учётной записи пользователя ЕСИА
sessionId : string	Идентификатор сессии, необязательный атрибут события
issPrmId : integer	Идентификатор согласия в реестре согласий

Пример JSON-тела запроса

{ "eventType": "permissionsEvent", "opType": "PermissionOperationEnum.issuePermission", "oid": "1000031415", "sessionId": "9979b075-43dd-41c2-bec4-0db0452243ba", "issPrmId": 27 }

Для получения уведомлений в описанном выше формате:

1.  Для вашей ИС реализуйте REST-метод, удовлетворяющий условиям:

• публичный доступ, т.е. метод доступен для запроса со стороны внешний ИС (например, доступен для использования извне со стороны внешнего балансировщика ИС);
• тип HTTP запроса – POST;
• URL метода – произвольный, на усмотрение владельца ИС организации, например, https://yoursysdomain/permissions/notify;
• приём в теле запроса JSON;
• ответ на запрос метода: с HTTP кодом 200 OK.

Взаимодействие между платформой согласий и REST-сервисом вашей ИС осуществляется по протоколу HTTPS. В вашей ИС должен быть установлен SSL-сертификат, удовлетворяющий требованиям:

• сертификат выпущен одним из доверенных Центров Сертификации на рынке SSL-сертификатов. Использование самовыпущенных SSL-сертификатов не допускается;
• алгоритм шифрования RSA.

2.  Уполномоченный сотрудник вашей организации должен указать URL-адрес REST-сервиса вашей ИС для приёма уведомлений от платформы согласий. Это делается в технологическом портале.

Требования к учётной записи сотрудника:

• Сотрудник должен быть руководителем организации или администратором профиля организации в ЕСИА;

• Сотрудник должен быть включён в группу доступа «Технологический портал».

Примечание:

Настройки выполняются в профиле организации в ЕСИА. Руководитель может назначить администратором и включить в группу доступа любого сотрудника организации.

Как настроить:

1. Перейдите в технологический портал.
2. Выберите: Сервисы → Оповещения → Адрес сервиса для приёма уведомлений от платформы согласий.

Введите URL-адрес REST-сервиса (метода), реализованного в вашей ИС, и нажмите кнопку справа для сохранения.

       

3. Отключение уведомлений 

Нажмите на кнопку с корзиной в строке системы/URL, чтобы отключить уведомления.