POST/api/auth/sso/exchange

Останній крок входу через SSO (SAML/OIDC): обмінює одноразовий код із переспрямування на токен доступу та refresh-токен.

Після входу у провайдера ідентифікації Zentor App переспрямовує браузер назад з одноразовим кодом у query-параметрі `sso_code`. Надішліть цей код у полі `code`. Відповідь містить `token` і `refreshToken`, як при звичайному вході. Кожен код дійсний лише один раз і недовго. Уже використаний, застарілий або недійсний код призводить до коду 400 `SSO_EXCHANGE_INVALID`; у цьому разі користувач знову запускає вхід через SSO. Тому виклик не ідемпотентний.

Огляд

Виклик: POST /api/auth/sso/exchange. Цей ендпоінт належить до групи «Автентифікація» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: code (тіло). Задокументовані випадки помилок: 400 SSO_EXCHANGE_INVALID. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.

Автентифікація та захист

Автентифікація не потрібна

Ідемпотентний: Ні

Параметри

code(body, string, обов'язково)— Одноразовий код із переспрямування SSO

Приклад запиту

{"code":"<одноразовий код із переспрямування SSO-Callback>"}

Приклад відповіді

{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}

Коди помилок

400 SSO_EXCHANGE_INVALID — Код недійсний, уже використаний або застарілий.

Перевірена поведінка

Недійсний код повертає 400 `SSO_EXCHANGE_INVALID`. Успішний випадок передбачає повний вхід у налаштованого провайдера ідентифікації.

Автентифікація

Споріднені статті

← Автентифікація