The code8 min read
Sécurité
Ce que le logiciel protège, contre quoi, et où chaque garantie se vérifie, pour les comptes, la base, les prestataires et les échanges entre les applications.
Not translated yet
Je décris ici les choix, leurs raisons et leurs limites. Les secrets et les procédures d’exploitation restent dans le dépôt. Chaque garantie cite le fichier, le symbole ou le test qui l’impose. Et quand je donne une durée ou un seuil, la référence, c’est le symbole cité à côté.
Ce qu’il faut protéger
- L’argent : on encaisse le montant dû et seulement lui, on ne rembourse que si le personnel le décide, et on ne retouche pas une vente encaissée.
- Les données des clients (identités, adresses, commandes, factures). Un client les confie pour être livré, et la loi oblige parfois à les garder.
- L’ERP, qui rembourse, émet des avoirs et exporte la comptabilité comme les données personnelles. C’est la surface la plus puissante.
- La continuité : le site doit continuer d’encaisser et la base doit rester cohérente, même quand un prestataire tombe.
Les surfaces
| Surface | Exposée à | Ce qu’elle peut atteindre |
|---|---|---|
| Le site | tout Internet, sans connexion | en lecture, le catalogue et les colonnes nommées des commandes et des factures. En écriture, ses commandes en attente de paiement et les comptes clients. Le tout avec un rôle Postgres limité |
| L’ERP | le personnel connecté | toute la base, le compte Stripe, les stockages, Fisher |
| Les routes machine | Stripe, la tâche planifiée, l’autre application | un seul geste chacune, avec son propre secret |
| Les prestataires | ce qu’on leur envoie | le paiement, l’e-mail, les erreurs, les questions posées à Fisher |
Les principes
- Par défaut, tout est refusé. Une session, une requête ou un rôle qui n’est pas explicitement admis n’ouvre rien.
- Les gardes s’empilent. Le proxy écarte ce qui est clairement invalide. Ensuite, chaque route, chaque page et chaque geste revérifie lui-même. Et en dernier, la base refuse ce qu’aucune application ne doit pouvoir faire.
- Chacun n’a que les droits dont il a besoin. Le site n’a ni la clé de paiement complète, ni l’écriture dans le stockage, ni les droits du propriétaire sur la base.
- Une garantie ne repose pas sur une consigne. C’est un test, un contrôle de la vraie base ou une validation au démarrage qui l’impose et qui la vérifie.
- Un échec se signale. Une signature refusée, une suppression de compte non livrée ou un paiement qui ne correspond pas à sa commande déclenchent une alerte.
En un coup d’œil
| Risque | Protection | Ce qui la prouve | Détail |
|---|---|---|---|
| Un mot de passe du personnel deviné ou hameçonné | clé d’accès liée au domaine, plafonds par adresse et par compte, sessions à durée limitée | packages/auth/src/server.ts, password-account-limit.ts | Comptes et sessions |
| Une page, une action ou une route sans garde | chacune relit la session, et un test repère l’oubli | admin-guard, admin-routes, admin-reads (apps/erp/test) | Comptes et sessions |
| Une faille du site | rôle Postgres limité par colonne, par ligne et par trigger | database-grants.ts, site-database-role.db.test.ts | Droits PostgreSQL |
| Une vente encaissée ou une écriture comptable retouchée | des triggers qui refusent, des encaissements chaînés, la vraie base relue | pnpm db:invariants, CASH_CHAIN_STEP | Droits PostgreSQL |
| Des données personnelles gardées ou envoyées en trop | durées écrites une seule fois, purge chaque matin, masquage vers les prestataires | data-retention.ts, checkout-ip-retention.db.test.ts | Données personnelles |
| Un montant payé qui n’est pas le montant dû | prix recalculés par le serveur, session rapprochée de sa commande par l’ERP | reconcileSession (webhook-session.service.ts) | Stripe et Resend |
| Une clé du site volée | clé Stripe restreinte imposée au démarrage, aucune clé de l’ERP sur le site | schéma d’environnement du site, check:vercel-env | Stripe et Resend |
| Un faux webhook ou un message rejoué | signature sur les octets bruts, horodatage, inscription par identifiant | webhook-raw-body.regression.test.ts, site-events.ts | Webhooks et échanges |
| Un e-mail usurpé ou un HTML injecté | SPF, DKIM et DMARC contrôlés, HTML tiré du texte et échappé | check-email-dns.mts, email-layout.ts | Stripe et Resend |
Les secrets
Les secrets ne sont pas dans le dépôt. Ils sont dans les variables des projets Vercel, en type « sensible ». Le contrôle des variables signale un secret enregistré en simple configuration, parce qu’on pourrait le lire dans le tableau de bord (vercelEnvFaults, packages/infra/src/vercel-env-table.ts). Tant que la prod est en construction, ce n’est qu’un avertissement, et ça ne bloque qu’avec --strict. Dans le hook pre-push, gitleaks fouille chaque commit poussé, et ce contrôle est obligatoire.
Ils sont validés au démarrage. Chaque application lit son environnement à travers un schéma. Ce schéma refuse un déploiement sans ses secrets, un secret trop court ou une clé Stripe complète sur le site (apps/*/shared/schemas/env.schema.ts). Avant chaque push sur main, pnpm check:vercel-env compare ce schéma aux variables vraiment enregistrées.
Ils sont aussi cloisonnés. Le projet du site ne reçoit aucune clé de l’ERP (ADR 0002). Les identifiants qui servent à créer le premier administrateur ne sont que sur le poste, et le contrôle refuse un projet qui les contiendrait (RETIRED_CREDENTIALS). La clé qui chiffre les sauvegardes ne doit pas être sur Vercel, et le contrôle le signale (NOT_ON_VERCEL).
Quand c’est possible, on les change sans coupure. Les secrets de session, le secret des cookies du site et celui du webhook Stripe acceptent l’ancienne valeur le temps d’une rotation (versionedSecrets). Par contre, les secrets des canaux entre applications se changent dans les deux projets en même temps (Webhooks et échanges).
Le navigateur
Les deux applications mettent les mêmes en-têtes de sécurité sur toutes leurs réponses (packages/infra/src/security-headers.ts) : HSTS, nosniff, aucun encadrement (sauf les PDF de l’ERP, que l’ERP encadre lui-même), isolation de l’origine (COOP, CORP), et une Permissions-Policy qui coupe la caméra, le micro, la géolocalisation et le reste. Chacune ajoute sa propre politique de contenu (CSP), limitée à ce qu’elle charge. Le site n’ouvre que l’hôte public des photos du catalogue. Il ne charge aucun script de paiement, et il n’envoie un formulaire qu’à lui-même ou au paiement hébergé de Stripe. L’ERP n’est pas indexé (noindex-header.regression.test.ts). Cette doc ne l’est pas non plus tant que DOCS_PUBLISHED=1 n’est pas posée sur son projet (apps/docs/next.config.ts, apps/docs/app/robots.ts).
Il y a un compromis : la CSP accepte les scripts en ligne ('unsafe-inline'). Avec une politique par nonce, il faudrait un rendu dynamique de chaque page, et le site perdrait sa coquille statique mise en cache (Site public). Du coup, on se protège de l’injection en amont. React échappe tout texte rendu. Les seuls HTML bruts sont des scripts constants du code et les données structurées, dont < est échappé (apps/site/shared/components/json-ld.tsx).
Les règles du pare-feu de Vercel sont écrites dans le dépôt. Un script les pose en brouillon (pnpm firewall:apply, pnpm site:firewall:apply), et elles ne sont publiées qu’avec --publish. Et un test exige qu’une action publique qui journalise l’adresse du visiteur ait sa règle (waf-rules.regression.test.ts).
La chaîne de dépendances
- Une version publiée depuis moins de 24 heures est refusée à l’installation (
minimumReleaseAge,pnpm-workspace.yaml). Une exception se déclare. - Les versions communes sont écrites une seule fois, dans le catalogue de
pnpm-workspace.yaml. La version de l’API Stripe est épinglée et comparée au SDK installé (pinned-sdk-versions.regression.test.ts). - Les licences des dépendances sont contrôlées à chaque vérification (
check-licenses.mjs). - Le site n’embarque ni le rendu PDF, ni le SDK d’IA, ni le client du stockage.
Les limites assumées
Chaque limite est un choix. Sa page l’explique avec son contexte.
- Un seul rôle ouvre l’ERP. Tout membre connecté peut tout y faire, et une connexion récente protège les gestes d’argent et de données (Comptes et sessions).
- Aujourd’hui, le second facteur n’est pas imposé à la connexion par mot de passe (Comptes et sessions).
- L’ERP se connecte avec les droits du propriétaire de la base. Contre un trigger désactivé, il n’y a pas de barrière. C’est la détection qui joue ce rôle (Droits PostgreSQL).
- Anthropic garde les échanges avec Fisher jusqu’à 30 jours, sans s’en servir pour entraîner ses modèles (Données personnelles).
- Les événements entre applications partent une fois, sans file d’attente. Quand un échec compte, il déclenche une alerte (Webhooks et échanges).
- Il n’y a pas de CI hébergée. Avant la prod, la seule porte, c’est le hook
pre-pushdu poste (Contrôles Git).
- Comptes et sessions(in French)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.
- Droits PostgreSQL(in French)Les deux rôles qui partagent la base, ce que chacun peut lire et écrire, ce que la base refuse quel que soit le rôle, et comment on vérifie ces droits sur la vraie base.
- Données personnelles(in French)Ce qu’on collecte et combien de temps on le garde, ce qui part chez les prestataires, et comment un effacement survit à une restauration.
- Stripe et Resend(in French)Ce que le paiement et l’e-mail reçoivent, quelle clé les pilote et avec quels droits, et ce que les applications revérifient derrière eux.
- Webhooks et échanges(in French)Les appels de machine à machine (Stripe, la tâche planifiée, le site vers l’ERP et l’ERP vers le site), comment chacun prouve qui l’envoie, ce qu’un message rejoué peut faire, et ce qui se passe quand l’appel échoue.