Aller au contenu
Meubles Morinière

Les choix d’ingénierieDécisions d’architecture4 min de lecture

0011 · Better Auth, un seul rôle dans l’ERP

Une seule bibliothèque d’authentification, dans un paquet, avec deux fabriques : les clés d’accès pour le personnel, le code par e-mail pour les clients.

Statut : acceptée, remplace la décision du 23 août 2026, amendée le 3 novembre 2026 · Décidée : 18 octobre 2026 · Sources : ancien journal (23 août 2026), 90ccdfd846, 2eae7c30e5, README.md (« Authentification »)

Contexte

Au départ, on ouvrait l’ERP avec un mot de passe unique et une session signée. Il n’y avait pas de table d’utilisateurs. En octobre arrivent des comptes pour le personnel, un rôle vendeur et des comptes clients sur le site (90ccdfd846).

Contraintes

  • Plusieurs personnes utilisent l’ERP. Chacune a ses appareils, son second facteur et des sessions qu’on peut révoquer.
  • Les comptes clients sont facultatifs et sans mot de passe. Ils n’ouvrent jamais l’ERP.
  • Le paquet partagé ne doit pas importer le client Prisma d’une application (ADR 0005).
  • Les instances serverless ne partagent pas de mémoire où compter les tentatives.

Alternatives

  • Une authentification maison. Elle a été étudiée et retenue le 23 août, « tant qu’il n’y a qu’un seul opérateur ».
  • Un service hébergé (Clerk, Auth0). Les comptes sortiraient de la base, et ça ferait un fournisseur de plus. Rien ne dit qu’on l’a étudié.
  • Rien ne dit non plus qu’on a étudié Auth.js.

Décision

Better Auth est dans packages/auth. createAuth sert au personnel : une clé d’accès avec vérification de l’utilisateur, ou un mot de passe, suivi d’un code pour ceux qui en ont enregistré un. createCustomerAuth sert aux clients : un code à usage unique par e-mail. Chaque application passe son client Prisma. Les limites de débit sont dans Redis (packages/auth/src/rate-limit.ts). Un seul rôle ouvre l’ERP (ENABLED_SESSION_ROLES), et la garde refuse par défaut. Le proxy écarte un cookie non signé sans toucher à la base, puis chaque route, chaque page et chaque action revérifie la session (Comptes et sessions).

Raisons

Confirmées

  • Pas de bibliothèque ni de table User « tant qu’il n’y a qu’un seul opérateur » (ancien journal, 23 août 2026). Cette condition tombe le 18 octobre, avec les comptes du personnel et le rôle vendeur (90ccdfd846).
  • Il y a un seul niveau d’accès, l’administrateur : « Le propriétaire ne veut pas de rôles pour le moment » (2eae7c30e5, 3 novembre 2026).

Hypothèses

  • On préfère Better Auth à un service hébergé. Les comptes restent dans la base Postgres, sous les mêmes migrations. Les clés d’accès, le second facteur et l’administration des comptes arrivent sous forme de plugins. Le commit qui l’introduit ne donne pas de raison. Il décrit la migration comme le « travail en cours d’une session parallèle ».
  • On a pris Redis parce qu’un compteur en mémoire ne serait pas partagé entre les instances.

Compromis

  • Une dépendance est au cœur de la sécurité. Il faut relire chacune de ses montées de version.
  • Si on change l’adresse de l’ERP, les clés d’accès enregistrées ne sont plus valables (NEXT_PUBLIC_ERP_URL).
  • Les limites de débit ajoutent un service, Redis.
  • Sans rôles, tous les comptes du personnel voient tout et peuvent tout faire, et Fisher n’a plus de droit par geste (2eae7c30e5).

Conséquences

  • Le site ne peut importer aucune entrée d’authentification du personnel (ERP_AUTH_ENTRIES).
  • Les gestes les plus lourds (rembourser, émettre un avoir, effacer, exporter) demandent une connexion récente.
  • Si on rouvre des rôles, on repartira de la garde existante, qui est restée en refus par défaut (readAdminSession, requireAdminReader).

Risques résiduels

  • Comme il n’y a pas de rôles, un compte du personnel volé ouvre tout. La connexion récente protège les gestes sur l’argent et sur les données. Elle ne protège pas la lecture des fiches clients.
  • Le second facteur n’est pas obligatoire quand on se connecte par mot de passe (Comptes et sessions).
  • Un correctif de Better Auth attend un jour, comme toute dépendance qui n’est pas dans les exceptions du délai (ADR 0014). Pourtant, c’est Better Auth qui porte la sécurité des deux applications.

Quand la revoir

  • Des rôles arriveront dès qu’une personne ne devra pas pouvoir tout faire. La garde est restée en refus par défaut (readAdminSession, requireAdminReader). Le registre de Fisher n’a pas de champ de droit aujourd’hui, il faudra l’ajouter avec les rôles.
  • Le second facteur deviendra obligatoire dès qu’un compte du personnel se connectera d’habitude par mot de passe plutôt que par clé d’accès.
  • Si Better Auth n’était plus maintenu, on en changerait. Les comptes sont dans la base, sous les mêmes migrations, et il n’y aurait que packages/auth à réécrire.

Sur cette page