Avant de commencer, la limite : ce guide ne fait pas de toi un développeur. Il couvre les trois erreurs qu'on retrouve le plus souvent quand une boîte fait coder son app par une IA sans relire. Il ne remplace pas un audit, et il ne te dira pas si ton architecture tient la charge. Il t'évite juste de mettre les données de tes clients en libre accès sur internet.
Les trois règles sont dans l'ordre d'importance. Si tu n'en appliques qu'une, prends la troisième.
Règle 1 — Tes clés d'API ne touchent jamais ton code
Le problème : Claude Code écrit vite. Quand il a besoin d'une clé pour faire marcher une intégration, il la met là où c'est le plus simple — en clair, dans un fichier. Et ce fichier part sur GitHub au commit suivant. Une clé Stripe ou une clé service Supabase publique, c'est l'accès à ta facturation et à ta base clients.
Ce que tu fais
1. Un .gitignore avant la première ligne de code.
.env
.env.local
.env.*.local
*.pem
.claude/settings.local.json
2. Toutes les valeurs sensibles dans des variables d'environnement. Dans ton code, on ne lit que process.env.STRIPE_SECRET_KEY. Jamais la valeur.
3. En production, tes secrets vivent chez ton hébergeur, pas dans ton repo. Sur Vercel : Settings → Environment Variables, ou en ligne de commande.
vercel env add STRIPE_SECRET_KEY production
4. Tu fais la différence entre les deux familles de clés.
| Type | Exemple | Où elle peut aller |
|---|---|---|
| Clé publique | NEXT_PUBLIC_SUPABASE_ANON_KEY |
Côté navigateur, c'est fait pour |
| Clé secrète | SUPABASE_SERVICE_ROLE_KEY, STRIPE_SECRET_KEY |
Serveur uniquement, jamais dans un composant client |
Toute variable préfixée NEXT_PUBLIC_ est visible par n'importe qui ouvre l'inspecteur de son navigateur. Si tu as mis une clé secrète derrière ce préfixe, elle est déjà publique.
Si c'est déjà parti sur GitHub
Dans l'ordre, et le premier point d'abord :
- Révoque la clé chez le fournisseur (Stripe, Supabase, OpenAI, Anthropic…) et génère-en une nouvelle. Une clé exposée est une clé morte, même une minute, même sur un repo privé.
- Retire le fichier du suivi Git :
git rm --cached .env
git commit -m "remove env from tracking"
- Sache que le commit reste dans l'historique. Nettoyer l'historique est possible, mais inutile si tu as fait l'étape 1 correctement.
Règle 2 — Tes webhooks et tes routes API sont protégés, même ceux que personne ne connaît
C'est celle que presque tout le monde oublie. Une URL de webhook, c'est une porte ouverte sur internet. « Personne ne connaît l'adresse » n'est pas une protection : les URLs se retrouvent dans les logs, dans les historiques de navigateur, dans un screenshot partagé en call.
Un secret par webhook
Le principe : celui qui appelle ton webhook doit prouver qu'il a le droit. Deux manières.
Pour tes propres webhooks (n8n qui appelle ton app, ton app qui appelle n8n) : un en-tête partagé.
x-webhook-secret: <une chaîne aléatoire longue, stockée en variable d'environnement>
Côté réception, tu compares et tu refuses tout le reste.
const secret = req.headers.get('x-webhook-secret')
if (secret !== process.env.WEBHOOK_SECRET) {
return new Response('Unauthorized', { status: 401 })
}
Pour les webhooks des services tiers (Stripe, par exemple) : tu vérifies la signature avec leur SDK. Ne réécris jamais cette vérification à la main, et ne la désactive pas « juste pour tester ».
Des rate limits, même en interne
Une route qui part sur un appel LLM ou qui écrit en base doit avoir une limite. Sans ça, un script qui boucle te vide ton quota Anthropic ou te remplit ta base en quelques minutes. Fixe une limite par IP et par utilisateur sur :
- toutes les routes d'authentification (login, reset de mot de passe)
- toutes les routes qui appellent une IA
- toutes les routes d'envoi d'email
- tous les formulaires publics
Le réflexe de base
Chaque route API répond d'abord à deux questions, dans cet ordre : qui appelle ? puis a-t-il le droit sur CET objet-là ? La deuxième est celle qu'on saute. Un utilisateur connecté qui change l'id dans l'URL ne doit pas voir la facture du voisin.
Règle 3 — Le RLS actif sur toutes tes tables
Si tu n'en retiens qu'une, c'est celle-là.
Le RLS (Row Level Security), c'est la sécurité au niveau de la base : chaque ligne sait qui a le droit de la lire. Sans RLS, ta clé publique Supabase — celle qui est dans le navigateur de tous tes visiteurs — permet de lire toute la table. Toute. Tes clients, leurs emails, leurs montants.
Ce que tu fais
1. Tu actives le RLS sur chaque table, sans exception. Y compris les tables internes, y compris celles qui « ne contiennent rien de sensible ». Pas d'exception, sinon tu oublieras laquelle.
alter table public.projects enable row level security;
2. Tu écris une policy par opération. Activer le RLS sans policy bloque tout : c'est le bon point de départ, tu ouvres ensuite au cas par cas.
-- Un utilisateur ne lit que ses propres lignes
create policy "read own projects"
on public.projects for select
using (auth.uid() = user_id);
-- Et il ne peut créer que des lignes à son nom
create policy "insert own projects"
on public.projects for insert
with check (auth.uid() = user_id);
3. Tu vérifies à la main, pas en demandant à l'IA si c'est bon. Connecte-toi avec deux comptes de test différents et essaie de lire les données de l'autre. C'est le seul test qui vaut quelque chose.
4. Tu gardes la clé service role côté serveur. Elle ignore le RLS par construction. Elle n'a rien à faire dans un composant client, jamais.
Règle bonus — L'IA ne travaille pas sur tes vraies données
Pendant le développement, Claude Code n'a pas besoin de la base de production. Il a besoin d'une base de dev avec des données factices qui ont la même forme. Le jour où une commande efface une table, il n'y a rien à perdre.
Concrètement : deux projets Supabase, deux jeux de variables d'environnement, et l'URL de prod qui ne traîne nulle part dans ton environnement local.
La checklist avant chaque mise en ligne
Fais-la à voix haute, elle prend quatre minutes.
-
git statusne montre aucun.env, et.gitignoreles couvre tous - Aucune clé secrète derrière un préfixe
NEXT_PUBLIC_ - Les secrets de prod sont dans les variables d'environnement de l'hébergeur
- Chaque webhook vérifie un secret ou une signature
- Rate limit sur l'auth, les appels IA, l'envoi d'email et les formulaires publics
- RLS activé sur toutes les tables, policies écrites
- Test croisé avec deux comptes : le compte A ne voit rien du compte B
- La clé service role n'apparaît dans aucun fichier exécuté côté navigateur
- L'IA de dev pointe sur la base de dev, pas sur la prod
Le fichier à coller dans ton projet
Le plus efficace, c'est que Claude applique ces règles tout seul au lieu que tu les vérifies après coup. Prends le fichier securite-claude-code.md joint, mets-le à la racine de ton projet, et référence-le dans ton CLAUDE.md avec une ligne du type :
## Sécurité
Lis et applique `securite-claude-code.md` avant d'écrire du code qui touche
aux secrets, aux routes API, aux webhooks ou à la base de données.
À partir de là, il te proposera les variables d'environnement et les policies de lui-même, au lieu de coller une clé en dur parce que c'était plus rapide.












