Se déconnecter des autres sessions
POST /fapi/v1/me/sessions:revoke-others · appelé depuis l'hôte de connexion de l'environnement
Met fin à toutes les sessions actives de l'utilisateur authentifié, à l'exception de celle qui effectue la requête, et révoque les jetons d'actualisation de l'utilisateur qui ne sont pas liés à cette session. Les jetons d'accès émis par les sessions terminées sont refusés, et les applications connectées par leur intermédiaire sont notifiées. 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. Sans autre session, la réponse est tout de même 204.
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>. |
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. |
Exemple
curl -X POST https://example.keenauth.app/fapi/v1/me/sessions:revoke-others \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt