Aller au contenu
Meubles Morinière

Le codeSécurité7 min de lecture

Comptes et sessions

Better Auth pour le personnel et pour les clients, avec deux connexions bien séparées, des sessions à durée limitée, des gardes que les tests imposent, et ce qu’il reste à durcir.

Les deux applications utilisent Better Auth, configuré une seule fois dans packages/auth : createAuth pour le personnel, dans l’ERP, et createCustomerAuth pour les clients, sur le site. Ce sont deux instances. Chacune a ses cookies, ses secrets et ses règles, et un compte n’ouvre jamais l’autre application.

RisqueProtectionCe qui la prouve
Un client ou un cookie du site ouvre l’ERPun rôle admis par instance, des cookies et des secrets différentsauth-access.test.ts, cookies-inventory.regression.test.ts (site)
Un mot de passe deviné, réutilisé, hameçonnéclé d’accès liée au domaine, plafonds par adresse et par comptepackages/auth/src/server.ts, password-account-limit.ts
Un point d’entrée de Better Auth oubliéune liste blanche, le reste répond 404auth-http-routes.regression.test.ts
Un cookie volé ou une session sans fincookies __Host- stricts, durée maximale, connexion récente exigéecookie-attributes.regression.test.ts, admin-session.ts
Une garde oubliée dans l’ERPchaque action, route et lecture relit la session, et un test le repèreadmin-guard, admin-routes, admin-reads

Deux connexions bien séparées

Le site est ouvert à tout le monde et il crée des comptes clients. L’ERP, lui, rembourse et exporte. Si un compte client, ou un cookie scellé par le site, passait pour une session du personnel, il ouvrirait tout.

  • Chaque instance n’accepte qu’un rôle. Il est vérifié à la création de la session (databaseHooks.session.create), puis relu à chaque requête. L’ERP refuse tout compte qui n’est pas administrateur (ENABLED_SESSION_ROLES, openAdminSession), et le site refuse tout compte qui n’est pas client (readCustomerSession). Dans les deux cas, un compte bloqué n’ouvre plus rien.
  • Les cookies ont des préfixes et des secrets différents. Le secret des sessions clients est dérivé de celui des cookies du site, uniquement pour cet usage (derivedSecret, apps/site/shared/server/customer-auth.ts). Du coup, un cookie de panier ne vaut pas une session, et une session client ne vaut rien pour l’ERP.
  • Une adresse du personnel ne reçoit jamais de code de connexion client. Le site répond comme si le code était faux, sans dire que l’adresse existe (isStaffEmail). D’ailleurs, il ne voit pas les comptes du personnel. Il pose la question à une fonction de la base, qui répond seulement oui ou non (Droits PostgreSQL).
  • Le lint interdit au site d’importer les entrées d’authentification du personnel (ERP_AUTH_ENTRIES).

C’est vérifié par auth-access.test.ts (ERP), par l’inventaire des cookies du site (cookies-inventory.regression.test.ts) et par la suite du rôle du site sur une vraie base (site-database-role.db.test.ts).

Le personnel : la clé d’accès d’abord

Un mot de passe deviné, réutilisé ailleurs ou saisi sur une fausse page ouvre l’ERP, et l’ERP rembourse.

  • La clé d’accès (WebAuthn) est la voie prévue. Elle est liée au domaine de l’ERP, donc elle ne marche pas sur une fausse page. La vérification de l’utilisateur (empreinte, visage ou code de l’appareil) est exigée à l’enregistrement et à chaque connexion (passkey, afterVerification).
  • Le mot de passe reste possible, avec une longueur minimale et maximale (minPasswordLength, maxPasswordLength). Chaque membre peut activer un second facteur à code (TOTP). Un code qui a déjà ouvert une session est refusé tant qu’il pourrait encore servir (totp-replay.ts). Et des échecs répétés verrouillent le second facteur pendant un temps (accountLockout).
  • Les tentatives sont plafonnées par adresse IP et par compte. Un mot de passe essayé depuis cent adresses compte donc cent fois pour ce compte (password-account-limit.ts). Les compteurs sont dans Redis (packages/auth/src/rate-limit.ts), et sans Redis un déploiement ne démarre pas.
  • Personne ne peut s’inscrire (disableSignUp). C’est un administrateur qui crée les comptes, et le premier se crée sur le poste avec pnpm auth:create-admin.

Les tests sont dans packages/auth/src/__tests__. Et admin-gate.regression.test.ts vérifie qu’un seul formulaire appelle la connexion par mot de passe et qu’aucun composant de la connexion ne nomme un secret.

Aujourd’hui, le second facteur n’est pas imposé à la connexion par mot de passe. La règle existe (isSecondFactorRequiredForPassword). Le test qui l’exigera sur tout déploiement est écrit, mais il est suspendu (admin-gate.regression.test.ts). Pour la rétablir, il suffit d’une ligne. En attendant, le mot de passe repose sur sa longueur et sur les plafonds de tentatives, et la clé d’accès couvre l’usage courant.

La porte HTTP

Better Auth expose des dizaines de points d’entrée : inscription, changement d’adresse, administration des comptes, liens magiques. Même si on ne s’en sert pas, chacun est une surface.

La route /api/auth de l’ERP ne répond qu’à une liste blanche (AUTH_HTTP_ROUTES, toRestrictedNextJsHandler) : la connexion, le second facteur et les clés d’accès. Le reste répond 404 au navigateur. On ne peut l’appeler que depuis le serveur, derrière la garde de l’ERP. auth-http-routes.regression.test.ts compare la liste blanche à ce que la route sert.

Les cookies et les sessions

Il faut se protéger d’un cookie volé, d’un envoi forgé depuis un autre site et d’une session oubliée ouverte sur un poste partagé.

  • Les cookies du personnel sont httpOnly, Secure, SameSite=Strict et préfixés __Host- en HTTPS. Aucun script ne les lit et aucun sous-domaine ne peut les poser. Ceux des clients sont en SameSite=Lax. Comme ça, un retour depuis un e-mail ou depuis le paiement garde la session.
  • Les envois de formulaire venus d’un autre site sont refusés. Next.js compare l’origine des Server Actions à l’hôte, et les routes du site qui reçoivent un formulaire font le même contrôle (isCrossSiteSubmission, apps/site/shared/server/same-origin.ts).
  • Une session expire après un temps d’inactivité. Celle du personnel expire aussi au bout d’une durée maximale, quelle que soit l’activité (SESSION_IDLE_SECONDS, SESSION_ABSOLUTE_MS).
  • Les gestes lourds (rembourser, émettre un avoir, effacer ou exporter des données) demandent en plus une connexion récente (assertRecentAdminSignIn). Une session restée ouverte ne suffit donc pas.
  • Se reconnecter ferme la session précédente du même navigateur (previous-session.ts). Chacun peut fermer ses sessions sur les autres appareils, et un administrateur peut bloquer un compte.

C’est vérifié par cookie-attributes.regression.test.ts (ERP), cookies-inventory.regression.test.ts (site) et proxy.test.ts.

Des gardes en couches

Une page, une action ou une route peut oublier de vérifier la session. Dans un ERP de plusieurs centaines de fichiers, c’est l’erreur la plus probable.

  1. Le proxy (apps/erp/proxy.ts) vérifie la signature HMAC du cookie sans toucher la base, et il renvoie vers la connexion. C’est un tri rapide. Ce n’est pas une garde, parce qu’il ne sait pas si la session a été révoquée.
  2. Chaque page, action et route relit la session dans la base (readAdminSession, requireAdminReader). La session ne doit pas être révoquée, le rôle doit être admis, le compte ne doit pas être bloqué et la durée maximale ne doit pas être dépassée.
  3. Les lectures d’administration gardent elles-mêmes leur session, et elles ne s’importent que depuis les pages de l’ERP.

Trois tests parcourent le code et refusent un oubli. Le premier vérifie que chaque Server Action commence par refuser sans session, sans aucune exception publique (admin-guard.regression.test.ts). Le deuxième vérifie que chaque gestionnaire de route appelle sa garde, nommée route par route (admin-routes.regression.test.ts, photo-upload-route.regression.test.ts). Le troisième fait pareil pour chaque lecture (admin-reads.regression.test.ts). En plus, chaque action valide son entrée par un schéma, et c’est la seule frontière de confiance (action-validation.regression.test.ts).

Un seul rôle ouvre l’ERP, donc tout membre connecté peut tout y faire. Pour un magasin de quelques personnes, des rôles fins coûteraient plus à maintenir qu’ils ne protégeraient. À la place, il y a la connexion récente exigée sur les gestes d’argent et de données.

Les clients : un code, pas de mot de passe

Un compte client volé expose des adresses, des commandes et des factures. Une base de mots de passe clients serait une cible. Et un mot de passe réutilisé ailleurs suffirait pour entrer.

  • Il n’y a pas de mot de passe. Le client reçoit par e-mail un code à usage unique, valable peu de temps, avec un nombre d’essais limité. Le code est gardé haché (emailOTP, storeOTP: "hashed").
  • L’envoi des codes et les connexions sont plafonnés par adresse IP et par adresse e-mail (apps/site/shared/constants/rate-limits.ts). Les clés de ces compteurs sont des empreintes, donc Redis ne voit aucune adresse IP en clair (rateLimitKey).
  • Une session illisible ne fait pas échouer la page. Elle passe en invité (readCustomerSession).
  • Le compte est facultatif, on peut commander sans.

Du coup, la sécurité du compte, c’est celle de la boîte e-mail du client. C’est le prix à payer pour n’avoir aucun mot de passe à retenir, à réinitialiser ou à protéger en base.

Quand Redis ne répond pas

Les plafonds de tentatives dépendent de Redis. S’il ne répond pas, la plupart des demandes passent, pour que le site continue d’encaisser et que l’ERP reste utilisable. Par contre, trois gestes sont refusés : la connexion par mot de passe (les clés d’accès restent ouvertes), les gestes de Fisher et l’envoi des codes de connexion clients (failOpenExceptPasswordAndFisher dans l’ERP, isRefusedWhenUnavailable sur le site). Chaque bascule est journalisée.

Sur cette page