[ Назначение сценария ] [ Требования к настройке ЕСИА ] [ Вызовы API ЕСИА ] [ Данные, передаваемые приложению ] [ Конфигурация провайдера ] [ Ограничения и особенности ] [ Проверка ] [ Полный пример конфигурации ]
Назначение сценария
Получить признак самозанятого, статус учётной записи (подтверждена, валидирована) и перечень активированных биометрий пользователя.
Требования к настройке ЕСИА
- Области доступа:
openid fullname usr_reg_cxt self_employed read_bio_type_exp(read_bio_type— без сроков действия) - Согласие: не требуется
- Система зарегистрирована в ЕСИА, сертификат загружен (подключение).
Вызовы API ЕСИА
GET /rs/prns/{oid} — признак самозанятого (selfEmployed.confirmed), trusted, status; GET /rs/prns/{oid}/bios_type_exp?embed=(elements) — активированные биометрии со сроками действия (/bios_type — только описания)
Данные, передаваемые приложению
trusted — подтверждённость учётной записи; status — Registered или Deleted; selfEmployed.confirmed и confirmDate — признак и дата обновления статуса самозанятого; перечень биометрий — в elements.
Конфигурация провайдера
Фрагменты конфигурации внешнего провайдера; полный пример — в конце страницы. Значения в <...> задаются при настройке: это параметры конкретной установки.
Шаги конвейера после проверки токена и is_trusted:
[
{
"t": 0,
"r": "person",
"m": "GET",
"u": "{{.extidp_details.baseUrl}}/rs/prns/{{printf \"%.0f\" .id_token_claims.sub}}",
"h": {
"Authorization": "Bearer {{.token.access_token}}"
}
},
{
"t": 0,
"r": "bios",
"m": "GET",
"u": "{{.extidp_details.baseUrl}}/rs/prns/{{printf \"%.0f\" .id_token_claims.sub}}/bios_type_exp",
"h": {
"Authorization": "Bearer {{.token.access_token}}"
},
"d": {
"embed": "(elements)"
}
}
]
Обработка ответа (JavaScript-шаг):
{
"self_employed": "person && person.selfEmployed && person.selfEmployed.confirmed ? \"yes\" : \"no\";",
"account_status": "person && person.status ? person.status : \"\";",
"bio_types": "r = \"\"; if (bios && bios.elements) { for (i = 0; i < bios.elements.length; i++) { n = bios.elements[i].name || bios.elements[i].type; if (n) { r += (r ? \",\" : \"\") + n; } } } r;",
"bio_count": "bios && bios.elements ? bios.elements.length : 0;"
}
Отображение в атрибуты:
{
"fn": "{{.person.firstName}}",
"ln": "{{.person.lastName}}",
"mn": "{{.person.middleName}}",
"un": "",
"e": "",
"p": "",
"l": "",
"xid": "",
"rid": "state",
"x": {
"trusted": "{{.person.trusted}}",
"self_employed": "{{.self_employed}}",
"account_status": "{{.account_status}}",
"bio_count": "{{.bio_count}}"
}
}
Ограничения и особенности
- Изображение пользователя (область
usr_avt, методы/avt/circleи/avt/square) возвращается бинарным ответом и в атрибуты адаптера не передаётся. - Выход из ЕСИА настраивается параметрами
logoutUriиlogoutFormпровайдера; приложение вызывает/oauth2/logoutадаптера. - Подробные категории самозанятого и доходы самозанятых — Цифровой профиль, раздел 8.7.4.
Проверка
- Провайдер включить (
isActive: true) на тестовом стенде. - Пройти вход тестовой учётной записью ЕСИА.
- Проверить
/health/readyи атрибуты пользователя в приложении. - При ошибке смотреть журнал
LOG_LEVEL=debug(диагностика).
Полный пример конфигурации
Файл конфигурации внешнего провайдера (extidp.json) целиком. Значение typeDetails — строка с JSON; значения в <...> задаются при настройке.
[
{
"id": "<UUID_ПРОВАЙДЕРА>",
"redirectMethod": 0,
"authorizeUri": "{{.extidp_details.baseUrl}}/aas/oauth2/v2/ac",
"logoutRedirectMethod": 0,
"logoutUri": "{{.extidp_details.baseUrl}}/aas/oauth2/api/logout",
"logoutForm": {
"redirect_url": "https://<адрес-после-выхода>",
"client_id": "{{ .extidp_details.clientID }}"
},
"type": "esia",
"name": "case12-additional-data",
"synonym": "esia",
"typeDetails": "{\n \"baseUrl\": \"https://esia-portal1.test.gosuslugi.ru\",\n \"clientCertHash\": \"<ХЕШ_СЕРТИФИКАТА_ГОСТ_Р_34.11-2012_256>\",\n \"clientID\": \"<MNEMONIC_ИС_В_ЕСИА>\",\n \"cryptoProvider\": {\n \"name\": \"cprocsp_raw\",\n \"details\": {\n \"certPath\": \"/opt/esia-adapter/certs/<сертификат_ИС>.cer\",\n \"containerName\": \"<ИМЯ_КОНТЕЙНЕРА>\",\n \"containerPIN\": \"<PIN_КОНТЕЙНЕРА>\",\n \"sha1Thumbprint\": \"<SHA1_ОТПЕЧАТОК>\",\n \"hashAlg\": \"GOST3411_2012_256\"\n }\n },\n \"scope\": \"openid fullname usr_reg_cxt self_employed read_bio_type_exp\",\n \"scopeOrg\": \"\"\n}",
"redirectForm": {
"response_type": "code",
"client_id": "{{ .extidp_details.clientID }}",
"redirect_uri": "{{ .extidp_request.CallbackURI }}",
"scope": "{{ .extidp_details.scope }}",
"client_secret": "{{ $ts := timeFormat \"2006.01.02 15:04:05 Z0700\" .process_started }}{{ $clientSecretRaw := join .extidp_details.clientID .extidp_details.scope $ts .extidp_request.ID .extidp_request.CallbackURI }}{{ cryptoSign .context $clientSecretRaw .extidp_details.cryptoProvider | base64 }}",
"client_certificate_hash": "{{ .extidp_details.clientCertHash }}",
"timestamp": "{{ timeFormat \"2006.01.02 15:04:05 Z0700\" .process_started }}",
"state": "{{ .extidp_request.ID }}",
"access_type": "offline",
"code_challenge_method": "{{ .extidp_details.cryptoProvider.details.hashAlg }}",
"code_challenge": "{{ cryptoHashSum .context .code_verifier .extidp_details.cryptoProvider }}"
},
"userInfoPipeline": [
{
"t": 1,
"d": {
"state": "{{ guid }}"
}
},
{
"t": 0,
"r": "token",
"m": "POST",
"u": "{{.extidp_details.baseUrl}}/aas/oauth2/v3/te",
"d": {
"client_certificate_hash": "{{.extidp_details.clientCertHash}}",
"client_id": "{{.extidp_details.clientID}}",
"client_secret": "{{$ts := timeFormat \"2006.01.02 15:04:05 Z0700\" .process_started}}{{$clientSecretRaw := join .extidp_details.clientID .extidp_details.scope $ts .state .extidp_request.CallbackURI .code}}{{ cryptoSign .context $clientSecretRaw .extidp_details.cryptoProvider | base64 }}",
"code": "{{.code}}",
"grant_type": "authorization_code",
"redirect_uri": "{{.extidp_request.CallbackURI}}",
"scope": "{{.extidp_details.scope}}",
"state": "{{.state}}",
"timestamp": "{{timeFormat \"2006.01.02 15:04:05 Z0700\" .process_started}}",
"token_type": "Bearer",
"code_verifier": "{{ .code_verifier }}"
}
},
{
"t": 1,
"d": {
"verify_id_token": "{{ cryptoVerifyJWT .context .token.id_token .extidp_details.cryptoProvider }}"
}
},
{
"t": 2,
"d": {
"id_token_claims": "jwt(token.id_token)"
}
},
{
"t": 1,
"d": {
"is_trusted": "{{ with index .id_token_claims \"urn:esia:sbj\" \"urn:esia:sbj:is_tru\" }}{{ if not . }}{{ fail \"user is not trusted\" }}{{ end }}{{ end }}"
}
},
{
"t": 0,
"r": "person",
"m": "GET",
"u": "{{.extidp_details.baseUrl}}/rs/prns/{{printf \"%.0f\" .id_token_claims.sub}}",
"h": {
"Authorization": "Bearer {{.token.access_token}}"
}
},
{
"t": 0,
"r": "bios",
"m": "GET",
"u": "{{.extidp_details.baseUrl}}/rs/prns/{{printf \"%.0f\" .id_token_claims.sub}}/bios_type_exp",
"h": {
"Authorization": "Bearer {{.token.access_token}}"
},
"d": {
"embed": "(elements)"
}
},
{
"t": 2,
"d": {
"self_employed": "person && person.selfEmployed && person.selfEmployed.confirmed ? \"yes\" : \"no\";",
"account_status": "person && person.status ? person.status : \"\";",
"bio_types": "r = \"\"; if (bios && bios.elements) { for (i = 0; i < bios.elements.length; i++) { n = bios.elements[i].name || bios.elements[i].type; if (n) { r += (r ? \",\" : \"\") + n; } } } r;",
"bio_count": "bios && bios.elements ? bios.elements.length : 0;"
}
}
],
"attrMapping": {
"fn": "{{.person.firstName}}",
"ln": "{{.person.lastName}}",
"mn": "{{.person.middleName}}",
"un": "",
"e": "",
"p": "",
"l": "",
"xid": "",
"rid": "state",
"x": {
"trusted": "{{.person.trusted}}",
"self_employed": "{{.self_employed}}",
"account_status": "{{.account_status}}",
"bio_count": "{{.bio_count}}"
}
},
"isActive": false
}
]