Быстрый старт

Для корректной работы сервиса «Шлюз Единой системы идентификации и аутентификации» (услуга 1.19) необходим токен доступа (access token) пользователя, прошедшего аутентификацию через ЕСИА (услуга 1.13)
Cценарий работы с сервисом через сервис IAM:
  1. Пользователь отправляет запрос в прикладной сервис через шлюз безопасности IAM Proxy.
  2. Прикладной сервис отправляет запрос в шлюз ЕСИА и передает токен IAM в заголовке Authorization: Bearer.
  3. Шлюз ЕСИА производит в IAM обмен токена IAM на токен ЕСИА и отправляет запрос ЕСИА для получения данных.
  4. Шлюз ЕСИА возвращает данные.

Получение данных

Для получения данных используются методы API. Указывая в них токен доступа и различные скоупы, можно получить соответствующие данные.
Правила формирования запросов подробно описаны в Методических рекомендациях по использованию ЕСИА.
Примеры запросов приведены в разделах ниже.

Запрос на получение Id филиала

В качестве параметров запроса указываем следующее:
  • oid: 1000321922 (user esia_id);
  • provider (тип провайдера): prns (физ. лицо);
  • path: roles (информация об организациях, в которые включен пользователь).
Запрос type=sh
curl -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=sh
curl -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"
}
...
Предыдущий раздел
1.19 Шлюз Единой системы идентификации и аутентификации
Следующий раздел
Донастройка поставщика
Была ли страница полезной?