# Liste de contrôle de mise en production de l'authentification

> Les vérifications à faire avant d'ouvrir la connexion de votre wakapp à vos clients en production.

Passez cette liste en revue avant d'ouvrir la connexion de votre application en production, puis à chaque changement de nom d'hôte ou de framework.

## Configuration de l'environnement de production

- [ ] Le nom d'hôte de production est un hôte IAM **actif** de l'environnement `prod`, et lui seul (voir [Déclarer les hôtes IAM et les redirect URIs](/v1.0/authentification/declarer-les-hotes-et-redirect-uris)).
- [ ] `POST /discover/start-login` avec ce nom d'hôte renvoie une `keycloakUrl` qui commence par `https://auth.wakastart.app/`.
- [ ] La redirect URI déclarée est exactement `https://<nom d'hôte>/api/auth/callback`, en HTTPS, et votre application y répond.
- [ ] Aucune redirect URI personnalisée inutile ne subsiste dans la section **Redirect URIs Keycloak**.
- [ ] Si vous utilisez `GET /discover/email` : le nom d'hôte envoyé dans `domain` est un hôte IAM actif de l'environnement `prod`, et la variable `KEYCLOAK_URL` de l'environnement vaut `https://auth.wakastart.app`.
- [ ] Chaque build envoie son propre nom d'hôte, lu dans `window.location` ou l'en-tête `Host` : aucun build de dev ou de staging n'envoie le nom d'hôte de production.

## Code de connexion

- [ ] Votre code ne contient ni URL Keycloak, ni realm, ni identifiant client : ils viennent de la réponse de Discovery (ou de `KEYCLOAK_URL` pour la connexion par e-mail).
- [ ] `POST /discover/start-login` reçoit toujours `host`, sans `appId` ; `email` seulement si plusieurs clients partagent le nom d'hôte, et une réponse `{ "ambiguous": true }` affiche le choix du client.
- [ ] `GET /discover/email` reçoit toujours `domain` : sans lui, seules les fiches de production sont trouvées, puis plus aucune une fois le refus activé.
- [ ] Un nouveau `code_verifier`, un nouveau `state` et, si vous l'utilisez, un nouveau `nonce` sont tirés à chaque tentative ; `state` est contrôlé au retour.
- [ ] Discovery, Keycloak et l'API publique sont appelés depuis votre serveur, jamais depuis le navigateur.
- [ ] Une réponse `404` de Discovery ou `{ "users": [] }` affiche un message neutre, qui ne révèle pas si un compte existe.
- [ ] Une réponse `429` déclenche une nouvelle tentative différée, pas une boucle.

## Jetons et sessions

- [ ] Les jetons sont stockés côté serveur. Le navigateur ne porte qu'un cookie `HttpOnly`, `Secure`, `SameSite=Lax`. Aucun jeton dans `localStorage` ni `sessionStorage`.
- [ ] Les sessions sont dans un stockage partagé si votre service a plusieurs réplicas.
- [ ] Le jeton d'accès est rafraîchi avant son expiration, une seule fois à la fois, et le dernier refresh token remplace le précédent.
- [ ] Un refus du refresh token renvoie vers la connexion, sans nouvelle tentative.
- [ ] Les jetons reçus d'un autre client que votre front sont vérifiés : signature, émetteur, expiration et `azp` (voir [Vérifier un jeton côté serveur](/v1.0/authentification/verifier-un-jeton-cote-serveur)).
- [ ] La déconnexion ferme la session Keycloak, pas seulement le cookie local.
- [ ] La session locale (cookies, `sessionStorage`) est fermée quelle que soit la réponse de `POST /api/auth/logout`, erreur réseau comprise.

## Droits et contexte

- [ ] Les autorisations reposent sur `profile.rights` de `GET /api/me`, lu par votre serveur ; le front ne s'en sert que pour l'affichage.
- [ ] `/api/me` est rechargé après chaque rafraîchissement de session.
- [ ] Le cas « aucun profil » (`profile.name` vaut `Default`, sans droit) affiche une page d'aide.
- [ ] Les comptes de recette ont accès à l'application **dans l'environnement de production**, avec le profil attendu.

## Exploitation

- [ ] Vos journaux ne contiennent ni jeton, ni code d'autorisation, ni adresse e-mail en clair.
- [ ] Si un client utilise un SSO d'entreprise, sa connexion a été testée en production (voir [Liste de contrôle du SSO](/v1.0/sso/liste-de-controle)).
- [ ] Les pages d'erreur de connexion renvoient vers votre support.

## Voir aussi

- [Résoudre les problèmes de connexion](/v1.0/authentification/depannage).
- [Référence de l'authentification](/v1.0/authentification/reference).
