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 SSORichiesta 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
POST /api/auth/loginAutentica un utente con indirizzo e-mail o nome utente e password, ed emette un token di accesso (JWT) e un refresh token.POST /api/auth/refreshScambia un refresh token valido con una nuova coppia di token di accesso e refresh token.POST /api/auth/forgot-passwordAvvia il ripristino di una password: se esiste un account con l'indirizzo e-mail indicato, riceve un'e-mail con un link per il ripristino.POST /api/auth/reset-passwordImposta una nuova password con il token di ripristino dall'e-mail di ripristino.