Кейсы получения сведений из ЕСИА

ESIA-Adapter : 8. Кейсы получения сведений из ЕСИА


[ Состав раздела ] [ Способы получения данных ] [ Порядок запроса с согласием ] [ Условия подключения (ЕСИА) ] [ Особенности работы с Цифровым профилем ]

Готовые сценарии настройки адаптера под задачи получения данных. На каждой странице приведены фрагменты конфигурации внешнего провайдера, а в конце — полный пример файла extidp.json. Раздел покрывает сведения о пользователе из методических рекомендаций ЕСИА (приложения А.2, А.4–А.6, Б.4) и все виды сведений Цифрового профиля.

Состав раздела

РазделЧто получаемСпособ
8.1 Персональные данныеФИО, СНИЛС, ИНН, дата и место рождения, пол, контакты, статус УЗклассический REST ЕСИА
8.2 Документы пользователяпаспорт, ВУ, загранпаспорт, ОМС, свидетельства о рожденииклассический REST ЕСИА
8.3 Адрес регистрации и проживанияадреса регистрации, временной регистрации, проживанияклассический REST ЕСИА (API v2)
8.4 Организации пользователя и данные организацииорганизации пользователя; организация, филиалы, сотрудники, группыклассический REST ЕСИА
8.5 Дети и документы детейдети пользователя и их данныеклассический REST ЕСИА
8.6 Дополнительные сведениясамозанятость, статус УЗ, биометрияклассический REST ЕСИА
8.7 Цифровой профиль ФЛвсе виды сведений из ведомств (МВД, ЗАГС, СФР, ФНС, Росреестр и др.)Цифровой профиль, согласие

Способы получения данных

1. Классический REST ЕСИА (/rs/prns/{oid}/...). Права — области доступа (scope) в запросе авторизации. Если ЕСИА ограничивает область доступа с персональными данными для информационной системы, применяются согласия (способ 2).

2. Цифровой профиль (/digital/api/public/{version}/pso/{oid}/doc/{тип}). Права — согласие пользователя, запрашиваемое параметром permissions в запросе авторизации. Порядок работы описан в разделе 8.7.

Порядок запроса с согласием

  1. Адаптер отправляет пользователя на /aas/oauth2/v2/ac со scope=openid и параметром permissions (JSON-массив согласий в Base64).
  2. Пользователь в ЕСИА утверждает согласие.
  3. Адаптер меняет код на токен на /aas/oauth2/v3/te (без permissions). Маркер доступа несёт информацию о согласии.
  4. Адаптер вызывает методы Цифрового профиля с этим маркером. Альтернатива: коммерческий метод /digital/api/public/commercial/{version}/... с параметром permissionId.

Условия подключения (ЕСИА)

  • Заявка на sd@sc.digital.gov.ru с перечнем областей доступа; тестовый контур, затем промышленный.
  • Сертификат ИС с ОГРН организации загружен в Технологический портал.
  • Согласие запрашивается только у пользователей с подтверждённой УЗ, по умолчанию старше 18 лет.
  • Запросы к REST API Цифрового профиля направляются через защищённый канал СМЭВ.
  • Страница аутентификации ЕСИА не отображается во фрейме сайта информационной системы.
  • Расхождение системного времени сервера более минуты вызывает ошибки.
  • Тестовые URL: https://esia-portal1.test.gosuslugi.ru; параметр test=N возвращает тестовые ответы для методов, где он предусмотрен (например, PASSPORT_HISTORY).

Особенности работы с Цифровым профилем

  • Данные приходят не сразу. Ведомственные данные запрашиваются асинхронно: первый ответ может содержать только requestId, statusDoc: NO_CONSENT или ошибку. Адаптер выполняет конвейер один раз за вход и не ждёт, поэтому для документов предусматривается повторный запрос приложения или отдельный сценарий.
  • Любой ответ не 2xx прерывает вход. 403 от ЕСИА означает, что доступ к REST API для коммерческой организации ограничен и снимается заявкой.
  • Данные пользователя. В атрибуты рекомендуется передавать только необходимые значения. Документы целиком адаптер не хранит; данные пользователя кэшируются на время USERINFO_TTL.
  • Нагрузка. Каждый запрос документа добавляет один HTTP-запрос к ЕСИА на вход.

Обсуждение