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 SSOExemple 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
POST /api/auth/loginConnecte un utilisateur avec une adresse e-mail ou un nom d'utilisateur et un mot de passe, et délivre un jeton d'accès (JWT) ainsi qu'un jeton de rafraîchissement (refresh token).POST /api/auth/refreshÉchange un jeton de rafraîchissement valide contre une nouvelle paire de jeton d'accès et de jeton de rafraîchissement.POST /api/auth/forgot-passwordDémarre la réinitialisation d'un mot de passe : si un compte existe avec l'adresse e-mail indiquée, il reçoit un e-mail avec un lien de réinitialisation.POST /api/auth/reset-passwordDéfinit un nouveau mot de passe à l'aide du jeton de réinitialisation provenant de l'e-mail de réinitialisation.