MODULE 27 / 72
🔐
Sécurité API, secrets et gestion des clés
Les secrets sont la surface d'attaque n°1 en product building moderne. Clés API OpenAI, tokens Stripe, credentials BDD, webhooks secrets — chacun est une porte d'entrée si mal géré. Et contrairement aux bugs, une fuite de secret est souvent silencieuse jusqu'à ce que le damage soit fait.
Ne jamais mettre un secret dans le code : ni en dur dans le fichier, ni dans un commentaire, ni dans une variable d'environnement commitée. Les bots scannent GitHub en temps réel — une clé AWS commitée 10 secondes peut générer une facture de 50 000$ avant que vous la révoquiez. Solution : fichiers `.env` + `.gitignore` strict + gestionnaires de secrets (Vault, AWS Secrets Manager, Doppler, Infisical).
Rotation des secrets : toute clé doit avoir une durée de vie. Les API keys de production se changent régulièrement. En cas de doute sur une exposition : révoquer AVANT d'investiguer, pas après. La règle : il vaut mieux une heure de service dégradé qu'une fuite confirmée.
Scopes et permissions minimaux : une clé API pour envoyer des emails n'a pas besoin d'accéder aux contacts. Un token de lecture n'a pas besoin d'écriture. Chaque intégration reçoit exactement les permissions nécessaires et pas une de plus. Un attaquant qui vole une clé scopée ne peut faire que des dégâts limités.
Sécurité des webhooks : quand Stripe ou GitHub appelle votre endpoint, n'importe qui peut envoyer une fausse requête à cette URL. Toujours vérifier la signature HMAC fournie dans les headers. Sans ça, un attaquant peut déclencher des actions (marquer une commande comme payée sans paiement réel).
Variables d'environnement en production : sur Vercel, Railway, Fly.io, AWS — les secrets s'injectent comme variables d'environnement, jamais dans les fichiers déployés. Différencier les secrets par environnement (dev/staging/prod) — jamais les mêmes clés. Les logs ne doivent JAMAIS contenir de secrets (vérifier que votre logger ne sérialise pas les headers d'auth).
Sécurité spécifique aux LLMs : vos appels API aux LLMs contiennent potentiellement des données sensibles (documents clients, emails, code propriétaire). Vérifier les politiques de rétention des données de votre provider. Anthropic et OpenAI ont des options 'zero data retention' pour les entreprises. Pour les données ultra-sensibles : LLM local uniquement (voir module 38).
⚡ ANALOGIE — LES CLÉS DE VOTRE MAISON
Une clé API = une clé physique de votre maison. La commiter dans GitHub = la laisser sous le paillasson avec une pancarte. La rotation = changer les serrures régulièrement. Les scopes = donner au livreur une clé qui ouvre uniquement la boîte aux lettres, pas la maison entière. La vérification de signature webhook = demander une pièce d'identité avant d'ouvrir la porte, même si la personne prétend être votre facteur habituel. Gestionnaire de secrets = un trousseau sécurisé dans un coffre, pas les clés traînant sur le bureau.
📐 SCHÉMA
Secret dans le codecritique→ .env + gitignore + secret manager
Clé sans expirationhaute→ Rotation régulière + TTL
Permissions trop largeshaute→ Scopes minimaux par intégration
Webhook non vérifiécritique→ Vérification signature HMAC
Secrets dans les logshaute→ Sanitiser les logs, masquer les headers
Même clé dev/prodhaute→ Secrets séparés par environnement
💬 QUESTION INTERACTIVE
1/6
"Votre clé API OpenAI a été commitée par erreur sur GitHub public il y a 3 minutes. Que faites-vous ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Qu'est-ce que le 'secret sprawl' et comment l'éviter dans une organisation ?