Подготовка к интеграции
Прежде чем начинать процедуру интеграции необходимо проверить:
- наличие подключения к тестовому/промышленному контуру ЕСИА/ЕБС/ЦПГ;
- наличие необходимых scope (областей доступа) в заявке на подключение;
- загружен ли сертификат на технологический портал тестовой/промышленной ЕСИА;
- выбран ли на технологическом портале тестовой/промышленной ЕСИА алгоритм подписания запросов GOST3410_2012_256;
- указаны ли на технологическом портале тесторой/промышленной ЕСИА URL'ы возврата шлюза.
Протокол взаимодействия
Взаимодействие клиентской системы с сервисами шлюза, обеспечивающими идентификацию пользователей через ЕСИА, происходит через стандартный протокол OAuth 2.0/OpenID Connect. Авторизация в ЕСИА происходит, в данном случае, как обычная OAuth авторизация.
Для работы с данным протоколом имеются готовые открытые реализации под большинство популярных программных платформ.
Чтобы начать работу с ЕСИА Шлюзом необходимо интегрировать в целевую информационную систему одно из готовых средств, реализующих работу с протоколом OAuth 2.0.
Доступ к сервисам шлюза
Для доступа к сервисам шлюза необходимо с помощью функциональных инструментов его административной панели создать КИС, указав в её параметрах «Пути возврата» - URL-адрес(а) клиентской ИС (потребителя идентификации), на которые шлюз будет отвечать после выполнения авторизации.
Для доступа к сервисам шлюза потребуются следующие реквизиты:
- адрес шлюза (например, адрес демо стенда RNDSOFT https://demo.gate.esia.pro/);
- идентификатор клиента (например, a4fb804bfdf54df4f4da7faae24375e6);
- секрет клиента (например, 6cd6a2bd732bb66fed6ff7fd7ca2442ccc316a8e6764cbea4e8ad589407a4c28);
- страница с конфигурацией OАuth https://demo.gate.esia.pro/.well-known/openid-configuration
Значение идентификатора и секрета для КИС берутся из её параметров в административной панели шлюза.
ЕСИА Шлюз не занимается валидацией скоупов, переданных клиентской системой. Скоупы просто передаются в ЕСИА. Поэтому .well-known/openid-configuration содержит пустой массив в scopes_supported.