Disconnetti le altre sessioni
POST /fapi/v1/me/sessions:revoke-others · chiamato dall'host di accesso dell'ambiente
Termina ogni sessione attiva dell'utente autenticato tranne quella che effettua la richiesta, e revoca i refresh token dell'utente che non sono legati a quella sessione. I token di accesso emessi dalle sessioni terminate vengono rifiutati, e le applicazioni con cui si era effettuato l'accesso tramite tali sessioni ricevono una notifica. Richiede il cookie __Host-idp_session dell'utente autenticato; se il cookie manca, è scaduto o è stato revocato, restituisce 401 unauthenticated. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso API front (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso API front). La sessione deve essere stata verificata negli ultimi 300 secondi; altrimenti la risposta è 401 step_up_required con una sfida WWW-Authenticate secondo RFC 9470 (max_age=300) e non cambia nulla. Accedi di nuovo (ad esempio con max_age=0 o prompt=login) e riprova. Se non esistono altre sessioni, la risposta è comunque 204.
Richiesta
Header:
| Header | Obbligatorio | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<host di accesso>. |
Nessun corpo.
Risposta
204 No Content.
Errori
| Stato | Codice | Quando |
|---|---|---|
| 401 | unauthenticated |
Nessun cookie di sessione valido. |
| 401 | step_up_required |
La sessione è stata verificata più di 300 secondi fa. |
| 403 | origin_not_allowed |
Origin manca o è errato. |
Esempio
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