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.
GuideDeveloper
- Duration
- 30 min
This page has not been translated yet and is shown in French.
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). -
POST /discover/start-loginavec ce nom d'hôte renvoie unekeycloakUrlqui commence parhttps://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é dansdomainest un hôte IAM actif de l'environnementprod, et la variableKEYCLOAK_URLde l'environnement vauthttps://auth.wakastart.app. - Chaque build envoie son propre nom d'hôte, lu dans
window.locationou l'en-têteHost: 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_URLpour la connexion par e-mail). -
POST /discover/start-loginreçoit toujourshost, sansappId;emailseulement si plusieurs clients partagent le nom d'hôte, et une réponse{ "ambiguous": true }affiche le choix du client. -
GET /discover/emailreçoit toujoursdomain: sans lui, seules les fiches de production sont trouvées, puis plus aucune une fois le refus activé. - Un nouveau
code_verifier, un nouveaustateet, si vous l'utilisez, un nouveaunoncesont tirés à chaque tentative ;stateest contrôlé au retour. - Discovery, Keycloak et l'API publique sont appelés depuis votre serveur, jamais depuis le navigateur.
- Une réponse
404de Discovery ou{ "users": [] }affiche un message neutre, qui ne révèle pas si un compte existe. - Une réponse
429dé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 danslocalStoragenisessionStorage. - 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). - 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 dePOST /api/auth/logout, erreur réseau comprise.
Droits et contexte
- Les autorisations reposent sur
profile.rightsdeGET /api/me, lu par votre serveur ; le front ne s'en sert que pour l'affichage. -
/api/meest rechargé après chaque rafraîchissement de session. - Le cas « aucun profil » (
profile.namevautDefault, 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).
- Les pages d'erreur de connexion renvoient vers votre support.