Déconnecter un utilisateur
Fermer la session Keycloak avec le refresh token, puis toujours la session de votre application, même si la plateforme répond en erreur.
- Durée
- 10 min
Supprimer le cookie de votre application ne suffit pas : la session Keycloak resterait ouverte, et le prochain clic sur Se connecter reconnecterait l'utilisateur sans lui demander son mot de passe. Une déconnexion complète ferme d'abord la session Keycloak, puis la session locale. La session locale se ferme dans tous les cas : une erreur de la plateforme ne doit jamais laisser l'utilisateur dans une session impossible à quitter.
Avant de commencer
- Votre serveur conserve le refresh token de la session, par exemple dans un cookie
HttpOnlynommérefresh_token. - Le navigateur ne peut pas lire ce cookie : la déconnexion passe donc par une route de votre serveur, puis par le bouton côté navigateur.
Fermer la session Keycloak
Envoyez le refresh token à l'API publique, depuis votre serveur :
curl -s -X POST https://api.wakastart.app/api/auth/logout \
-H "Content-Type: application/json" \
-d "{\"refreshToken\": \"$REFRESH_TOKEN\"}"Réponse attendue :
{ "success": true }L'API retrouve dans le jeton l'instance Keycloak, le realm et le client de votre application, puis ferme la session. Vous n'avez pas à envoyer l'identifiant client : il est lu dans le jeton (claim azp). Si vous l'envoyez quand même dans clientId, il doit être celui du jeton, sinon la réponse est 400.
Un refresh token déjà expiré renvoie { "success": true, "message": "Session already terminated" } : la session était déjà terminée. Si Keycloak est injoignable, la réponse est { "success": false, … }.
Ajouter la route serveur
Ajoutez à votre application une route /api/logout. Elle lit le refresh token, appelle l'API, puis supprime les cookies dans un bloc finally, quelle que soit la réponse. Exemple avec un route handler Next.js :
import { cookies } from "next/headers";
export async function POST() {
const cookieStore = await cookies();
const refreshToken = cookieStore.get("refresh_token")?.value;
try {
if (refreshToken) {
await fetch(`${process.env.WAKASTART_API_URL}/api/auth/logout`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ refreshToken }),
});
}
} catch {
// Erreur réseau : l'utilisateur est déconnecté quand même.
} finally {
// Succès, success: false, 4xx, 5xx ou erreur réseau : on ferme la session locale.
cookieStore.delete("keycloak_token");
cookieStore.delete("wakastart_token");
cookieStore.delete("refresh_token");
}
return new Response(null, { status: 204 });
}WAKASTART_API_URL vaut https://api.wakastart.app, sans /api.
Brancher le bouton
Le bouton Se déconnecter appelle cette route, puis vide le sessionStorage et renvoie vers la page de connexion, là aussi dans un finally :
async function logout() {
try {
await fetch("/api/logout", { method: "POST" });
} catch {
// Erreur réseau : l'utilisateur est déconnecté quand même.
} finally {
sessionStorage.removeItem("login_realm");
sessionStorage.removeItem("login_client_id");
sessionStorage.removeItem("pkce_verifier");
window.location.assign("/login");
}
}Résultat : l'utilisateur arrive sur votre page de connexion, non connecté, même si la plateforme a répondu en erreur.
Note
Le jeton d'accès déjà émis reste valide jusqu'à son expiration, 5 minutes au plus par défaut. Ne le conservez nulle part après la déconnexion.
Vérifier le résultat
- Connectez-vous, puis cliquez sur Se déconnecter dans votre application.
- Cliquez de nouveau sur Se connecter.
Résultat attendu : la page de connexion Keycloak demande l'identifiant et le mot de passe. Si l'utilisateur est reconnecté sans saisie, la session Keycloak n'a pas été fermée : vérifiez que la route serveur envoie bien le refresh token courant.