Se déconnecter d'une session
POST /fapi/v1/me/sessions/{session_id}:revoke · appelé depuis l'hôte de connexion de l'environnement
Met fin à l'une des autres sessions de l'utilisateur authentifié. Ses jetons d'actualisation sont révoqués, les jetons d'accès qu'elle a émis sont refusés, et les applications connectées par son intermédiaire sont notifiées. La session qui effectue la requête ne peut pas être terminée ici ; pour vous déconnecter depuis ce navigateur, utilisez le point de terminaison de déconnexion (/oauth2/logout), qui supprime également le cookie. Nécessite le cookie __Host-idp_session de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie 401 unauthenticated. Une application de première partie sur une autre origine peut à la place envoyer son jeton d'accès à l'API front (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès à l'API front). La session doit avoir été vérifiée au cours des 300 dernières secondes ; sinon, la réponse est 401 step_up_required avec un challenge WWW-Authenticate conforme à la RFC 9470 (max_age=300), et rien ne change. Reconnectez-vous (par exemple avec max_age=0 ou prompt=login) puis réessayez. Une session de l'utilisateur déjà terminée renvoie 204 et rien ne change.
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<sign-in host>. |
session_id : l'identifiant de session renvoyé par GET /fapi/v1/me/sessions (ses_…).
Aucun corps.
Réponse
204 No Content.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
La session a été vérifiée il y a plus de 300 secondes. |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 404 | not_found |
Aucune session de cet utilisateur ne correspond (un identifiant inconnu, mal formé ou appartenant à un autre utilisateur donne la même réponse). |
| 409 | conflict |
L'identifiant correspond à la session qui effectue la requête. |
Exemple
curl -X POST https://example.keenauth.app/fapi/v1/me/sessions/ses_01jbz6x8kq3m2n4p5r6s7t8v9w:revoke \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt