Быстрый старт
Для корректной работы сервиса «Шлюз Единой системы идентификации и аутентификации» (услуга 1.19) необходим токен доступа (access token) пользователя, прошедшего аутентификацию через ЕСИА (услуга 1.13)
Cценарий работы с сервисом через сервис IAM:
- Пользователь отправляет запрос в прикладной сервис через шлюз безопасности IAM Proxy.
- Прикладной сервис отправляет запрос в шлюз ЕСИА и передает токен IAM в заголовке Authorization: Bearer.
- Шлюз ЕСИА производит в IAM обмен токена IAM на токен ЕСИА и отправляет запрос ЕСИА для получения данных.
- Шлюз ЕСИА возвращает данные.
Для получения данных используются методы API. Указывая в них токен доступа и различные скоупы, можно получить соответствующие данные.
Правила формирования запросов подробно описаны в Методических рекомендациях по использованию ЕСИА.
Примеры запросов приведены в разделах ниже.
В качестве параметров запроса указываем следующее:
- oid: 1000321922 (user esia_id);
- provider (тип провайдера): prns (физ. лицо);
- path: roles (информация об организациях, в которые включен пользователь).
Запрос type=shcurl -X 'GET' \ 'http://<ingress_fqdn>/esia-gateway/api/data/plainrequest/getDataById?oid=1000475074&provider=prns&path=roles' \ -H 'accept: application/json' \ -H 'X-EsiaScopes: org_fullname org_orgn org_inn org_kpp' \ -H 'Authorization: Bearer
Ответ type=json... { "oid": 1000320866, "prnOid": 1000321922, "fullName": "ОРГАНИЗАЦИЯ 4932465577", "shortName": "ОРГАНИЗАЦИЯ 4932465577", "ogrn": 1024300822920, "type": "AGENCY", "branchName": "Главный Филиал 4932465577", "branchOid": 1000326290, "branchId": 7441024, "chief": false, "admin": true, "phone": "+7 (900) 111-11-12", "email": "esiatest022@mailforspam.com", "active": true, "hasRightOfSubstitution": false, "hasApprovalTabAccess": false, "isLiquidated": false }, ...
В качестве параметров запроса указываем следующее:
- oid: 1000320866 (organization oid);
- provider (тип провайдера): orgs (для организации);
- path: brhs/1000326290 (сведения о филиалах и id филиала, взятый ранее);
- X-EsiaScope: org_brhs.
Запрос type=shcurl -X 'GET' \ 'http://<ingress_fqdn>/esia-gateway/api/data/plainrequest/getDataById?oid=1000298922&provider=orgs&path=brhs%2F1000322105' \ -H 'accept: application/json' \ -H 'X-EsiaScopes: org_brhs' \ -H 'Authorization: Bearer
Ответ type=json... "response_status": "OK", "playload": { "stateFacts": [ "Identifiable" ], "brhOid": 1000326290, "name": "Главный Филиал 4932465577", "kpp": 888888888, "leg": "3001", "staffCount": 3, "tsd": false, "eTag": "D68FB4059504EB12FFA5BF6D6DBB05FDA2E37C59" } ...