# Sécurité avant mise en prod — checklist

> À déposer à la racine du projet. Claude Code peut la lire et s'en servir comme référence.
> Repasser dessus à chaque nouvelle table et chaque nouvelle route.

## 1. Secrets

- [ ] `git ls-files | grep -iE "\.env|secret|credential|\.pem"` ne renvoie rien
- [ ] `.gitignore` contient : `.env`, `.env.local`, `.env.*.local`, `*.pem`, `*.key`, `secrets/`
- [ ] Toute clé déjà poussée dans l'historique a été RÉGÉNÉRÉE (la supprimer du repo ne suffit pas)
- [ ] Aucune variable exposée au navigateur ne contient un secret
- [ ] Clé `service_role` Supabase utilisée côté serveur uniquement
- [ ] Les secrets de prod sont dans les variables d'environnement de l'hébergeur, pas dans le code

Commandes :

```bash
git ls-files | grep -iE "\.env|secret|credential|\.pem"
git rm --cached .env
grep -rn "NEXT_PUBLIC_" .env*
```

## 2. Row Level Security

- [ ] Aucune table publique sans RLS
- [ ] Chaque table activée a une policy SELECT et une policy INSERT/UPDATE
- [ ] Test croisé fait : le compte A ne lit pas les lignes du compte B
- [ ] Vues et fonctions `security definer` vérifiées

```sql
-- tables non protégées
select tablename
from pg_tables
where schemaname = 'public'
  and rowsecurity = false;

-- activation
alter table public.ma_table enable row level security;

-- policy type
create policy "un user lit ses lignes"
on public.ma_table
for select
using (auth.uid() = user_id);
```

## 3. Endpoints

- [ ] Un secret distinct par webhook
- [ ] Secret passé en header, jamais dans l'URL
- [ ] Rejet en 401 AVANT tout traitement si signature absente ou fausse
- [ ] Comparaison à temps constant (`timingSafeEqual`)
- [ ] Rate limit par IP et par utilisateur sur toute route payante (LLM, mail, SMS)
- [ ] Taille maximale de payload définie
- [ ] Timeout sur les appels sortants
- [ ] Alerte de budget active chez chaque fournisseur payant

```js
import crypto from "crypto";

const received = req.headers["x-webhook-secret"] ?? "";
const expected = process.env.WEBHOOK_SECRET ?? "";

const ok =
  received.length === expected.length &&
  crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

if (!ok) return res.status(401).json({ error: "unauthorized" });
```

## 4. Prompt d'audit (à coller dans Claude Code)

```
Tu fais un audit de sécurité de ce projet avant une mise en production.
Tu ne modifies aucun fichier : tu produis un rapport.

1. SECRETS
- Fichiers suivis par git contenant des secrets.
- Clés en dur dans le code.
- Variables exposées au client qui ne devraient pas l'être.
- Usage de la clé service_role côté client.

2. BASE DE DONNÉES
- Requêtes utilisant une clé admin là où une clé utilisateur suffirait.
- Tables manipulées par le code sans policy d'accès dans les migrations.

3. ENDPOINTS
- Toutes les routes API et webhooks exposés.
- Pour chacune : authentification ou vérification de signature avant traitement ? oui/non
- Pour chacune : rate limit et limite de taille de payload ? oui/non
- Routes déclenchant un appel payant sans protection.

Rends un tableau : fichier, ligne, problème, gravité (bloquant / à corriger / confort),
correction exacte. Commence par les bloquants.
```