# 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.

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 `HttpOnly` nommé `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 :

```bash
curl -s -X POST https://api.wakastart.app/api/auth/logout \
  -H "Content-Type: application/json" \
  -d "{\"refreshToken\": \"$REFRESH_TOKEN\"}"
```

Réponse attendue :

```json
{ "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 :

```ts
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` :

```ts
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

1. Connectez-vous, puis cliquez sur **Se déconnecter** dans votre application.
2. 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.

## Voir aussi

- [Rafraîchir la session](/v1.0/authentification/rafraichir-la-session).
- [Référence API : Authentification](/v1.0/reference-api/authentification-api#se-déconnecter).
