Aller au contenu

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.

GuideDéveloppeur
Durée
30 min
Voir en Markdown

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-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).
  • 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).
  • Les pages d'erreur de connexion renvoient vers votre support.

Voir aussi