Secrets et défense en profondeur

Les credentials des intégrations : chiffrés au repos

Les mots de passe IMAP, tokens OAuth, clés d'ERP des tenants vivent en base — chiffrés Fernet (AES-CBC + HMAC, via cryptography) :

• chiffré au write path (à l'enregistrement de l'intégration), déchiffré juste avant usage (au moment du poll IMAP, de l'export SFTP) — jamais en clair au repos ni dans une réponse d'API (le read path ne renvoie jamais les secrets) ;
• la clé maîtresse vit dans l'environnement (ENCRYPTION_KEY, injectée depuis le Secrets Manager en prod), résolue au boot avec fail loud si absente — l'app refuse de démarrer plutôt que de tourner sans chiffrement ;
• pourquoi ce niveau applicatif alors que le disque est déjà chiffré ? Parce qu'un dump SQL, un backup, un accès en lecture à la base ne suffisent plus à récolter les secrets des clients — la clé est ailleurs.

L'hygiène : gitleaks aux deux portes

Le secret le plus dangereux est celui qui entre dans git (l'historique n'oublie jamais). gitleaks tourne deux fois : en pre-commit (scan du diff — le secret n'entre pas) et en CI sur l'historique complet (GIT_DEPTH: 0 — ce qui serait passé est détecté), avec une allowlist explicite (.env.example, fixtures, locks). Deux portes, car le pre-commit se contourne (--no-verify) — la CI, non.

Les headers : l'API durcie par défaut

Le SecurityHeadersMiddleware pose sur chaque réponse : X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Referrer-Policy: no-referrer, HSTS un an — et le plus élégant : Content-Security-Policy: default-src 'none'. Une API qui ne sert que du JSON n'a besoin de rien charger : la CSP maximale ne coûte rien et neutralise toute une classe d'exploitation si un navigateur affiche une réponse.

La doctrine : ADR-0015, le substrat fail-closed

L'ADR qui lie tout le module : la défense multi-tenant repose sur un substrat qui échoue fermé — la RLS (module 3). Pas sur des validations runtime, pas sur la vigilance des devs. Les autres couches (sql_safety qui re-qualifie l'AST du SQL généré par le LLM, la whitelist de tools, le Redactor Langfuse, les clés Redis scopées) sont des couches complémentaires : chacune peut faillir, l'isolation tient. Le principe de conception à retenir : identifier LE mécanisme qui doit être infaillible, le rendre structurel (base, pas code), puis empiler le reste comme du confort.