POST/api/auth/sso/exchange

Ultimo passaggio di un accesso SSO (SAML/OIDC): scambia il codice a uso unico del reindirizzamento con un token di accesso e un refresh token.

Dopo l'accesso presso l'identity provider, Zentor App reindirizza il browser con un codice a uso unico nel parametro di query `sso_code`. Inviate questo codice nel campo `code`. La risposta contiene `token` e `refreshToken`, come per un normale accesso. Ogni codice è valido solo una volta e per breve tempo. Un codice già usato, scaduto o non valido comporta 400 `SSO_EXCHANGE_INVALID`; l'utente riavvia quindi l'accesso SSO. La chiamata non è quindi idempotente.

Panoramica

Chiamata: POST /api/auth/sso/exchange. Questo endpoint appartiene al gruppo «Autenticazione» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata non è idempotente: ogni chiamata riuscita attiva nuovamente l'azione. Parametri obbligatori: code (body). Casi di errore documentati: 400 SSO_EXCHANGE_INVALID. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.

Autenticazione e sicurezza

Nessuna autenticazione richiesta

Idempotente: No

Parametri

code(body, string, obbligatorio)— Codice a uso unico dal reindirizzamento SSO

Richiesta di esempio

{"code":"<codice monouso dal Redirect callback SSO>"}

Risposta di esempio

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

Codici di errore

400 SSO_EXCHANGE_INVALID — Il codice non è valido, è già stato utilizzato o è scaduto.

Comportamento verificato

Un codice non valido restituisce 400 `SSO_EXCHANGE_INVALID`. Il caso di successo presuppone un accesso completo presso l'identity provider configurato.

Autenticazione

Articoli correlati

← Autenticazione