POST/api/auth/sso/exchange

Dernière étape d'une connexion SSO (SAML/OIDC) : échange le code à usage unique issu de la redirection contre un jeton d'accès et un jeton de rafraîchissement.

Après la connexion chez le fournisseur d'identité, Zentor App redirige le navigateur avec un code à usage unique dans le paramètre de requête `sso_code`. Envoyez ce code dans le champ `code`. La réponse contient `token` et `refreshToken`, comme pour une connexion normale. Chaque code n'est valable qu'une seule fois et pour une courte durée. Un code déjà utilisé, expiré ou invalide entraîne 400 `SSO_EXCHANGE_INVALID` ; l'utilisateur redémarre alors la connexion SSO. L'appel n'est donc pas idempotent.

Vue d'ensemble

Appel : POST /api/auth/sso/exchange. Ce point de terminaison appartient au groupe « Authentification » de l'API de Zentor App. Il est accessible publiquement et ne nécessite aucune authentification. L'appel n'est pas idempotent : chaque appel réussi déclenche à nouveau l'action. Paramètres obligatoires : code (body). Cas d'erreur documentés : 400 SSO_EXCHANGE_INVALID. L'exemple de réponse ci-dessous montre la structure d'une réponse réussie au format JSON.

Authentification et sécurité

Aucune authentification requise

Idempotent: Non

Paramètres

code(body, string, requis)— Code à usage unique issu de la redirection SSO

Exemple de requête

{"code":"<code à usage unique issu de la redirection de callback SSO>"}

Exemple de réponse

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

Codes d'erreur

400 SSO_EXCHANGE_INVALID — Le code est invalide, déjà utilisé ou expiré.

Comportement vérifié

Un code invalide renvoie 400 `SSO_EXCHANGE_INVALID`. Le cas de succès nécessite une connexion complète chez le fournisseur d'identité configuré.

Authentification

Articles associés

← Authentification