Skip to content

Принципал

Принципал пользователя приходит отдельным заголовком, подписанный Gateway.

ПараметрЗначение
ЗаголовокX-Norm-Principal
Алгоритм подписиES256
Путь к ключам/.well-known/norm-jwks.json (источник — адрес из утверждения iss)
Предельный срок жизни300 с
ПолеОбязательноТипЗначение
audдаstring
auth_methodдаstring
correlation_idдаstring
delegation_idдаstring
expдаinteger
iatдаinteger
issдаstring
jtiдаstring
provider_tokenнетstring
roleдаstring
scopesдасписок string
subдаstring
tenantдаstring

Проверка бизнесом идёт в два шага. Первый обязателен: подпись по ключам Gateway, совпадение aud со своим подключением, срок действия. Второй по выбору бизнеса: подтвердить у провайдера по auth_method и provider_token, что пользователь ещё действующий. Токен провайдера разрешён только для этой проверки, не для доступа к данным провайдера от имени пользователя; в журналах и отчётах он маскируется.