Skip to content

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