POST/api/auth/sso/exchange

Ostatni krok logowania SSO (SAML/OIDC): wymienia jednorazowy kod z przekierowania na token dostępu i refresh token.

Po zalogowaniu u dostawcy identyfikacji Zentor App przekierowuje przeglądarkę z jednorazowym kodem w parametrze zapytania `sso_code`. Wyślij ten kod w polu `code`. Odpowiedź zawiera `token` i `refreshToken`, podobnie jak przy zwykłym logowaniu. Każdy kod jest ważny tylko raz i tylko krótko. Już wykorzystany, wygasły lub nieprawidłowy kod skutkuje kodem 400 `SSO_EXCHANGE_INVALID`; użytkownik wtedy ponownie zaczyna logowanie SSO. Wywołanie nie jest więc idempotentne.

Przegląd

Wywołanie: POST /api/auth/sso/exchange. Ten endpoint należy do grupy „Uwierzytelnianie” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: code (body). Udokumentowane przypadki błędów: 400 SSO_EXCHANGE_INVALID. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.

Uwierzytelnianie i zabezpieczenia

Uwierzytelnianie nie jest wymagane

Idempotentny: Nie

Parametry

code(body, string, wymagane)— Jednorazowy kod z przekierowania SSO

Przykładowe żądanie

{"code":"<kod jednorazowy z przekierowania SSO callback>"}

Przykładowa odpowiedź

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

Kody błędów

400 SSO_EXCHANGE_INVALID — Kod jest nieprawidłowy, już wykorzystany lub wygasły.

Zweryfikowane zachowanie

Nieprawidłowy kod zwraca 400 `SSO_EXCHANGE_INVALID`. Przypadek sukcesu wymaga pełnego zalogowania u skonfigurowanego dostawcy identyfikacji.

Uwierzytelnianie

Powiązane artykuły

← Uwierzytelnianie