Projets & développement
Gérer les secrets d'une équipe dev : clés d'API hors du code, révocation en cas de fuite
Intermédiaire | 4 pages de tableau blanc · Tableau des tâches à 5 colonnes (4 tâches parentes, 12 sous-tâches)
Intermédiaire : Les noms des méthodes apparaissent, mais l'essentiel est expliqué sur le tableau blanc. Appuyez-vous sur les exemples de remplissage et complétez en réfléchissant à votre propre situation.
Ce modèle aide une équipe de dev à garder clés d'API, mots de passe et clés privées hors du code, du chat et des tickets. Il fixe un seul emplacement par environnement et la procédure pour révoquer puis remplacer. La page 2 vérifie trois pièges, la valeur restée dans les anciens commits, vue en partage d'écran ou dans un journal, ou laissée sur un poste personnel. Une valeur commitée est tenue pour divulguée et révoquée chez l'émetteur avant de réécrire l'historique. Les causes sont creusées avec les 5 Pourquoi, les secrets classés par impact et facilité de remplacement, puis on fixe la règle de ne rien écrire en clair, l'outil de gestion et le garde-fou avant commit. Un calendrier de remplacement précise comment vérifier ce qui s'arrête, pour ne pas garder une vieille clé par peur de casser. Un mot de passe de connexion se change après une fuite ou un doute, pas à date fixe. Le tableau blanc a 4 pages, le tableau de tâches 5 colonnes, 4 tâches parentes et 12 sous-tâches.
Avec un compte gratuit, vous pouvez copier ce modèle depuis le marché
Aperçu du tableau blanc
Lire le texte du tableau blanc
Gestion des secrets de l'équipe dev
Mode d'emploi (4 pages) : ① Inventorier les secrets et noter où ils traînent (zones①–⑤) → ② Choisir les emplacements et vérifier les pièges (zones⑥–⑨) → ③ Creuser les causes et choisir les garde-fous (zones⑩–⑭) → ④ Écrire la procédure de fuite et le calendrier (zones⑮–⑰)
1/4 Inventorier les secrets
① But et périmètre (à remplir en premier)
- But ex. Retirer clés d'API et mots de passe du code et du chat, et pouvoir arrêter une fuite en moins de 30 minutes
- Périmètre ex. Paiement, envoi d'e-mails et base de données, sur 2 dépôts
- Durée et coordination ex. 2 semaines. Le chef d'équipe coordonne, les contrôles sont répartis entre tous
② Liste des secrets (une ligne par secret, jamais la valeur elle-même)
| Où il sert | Emplacement actuel | Responsable | Dernier remplacement | |
|---|---|---|---|---|
| Clé d'API de paiement | ex. Traitement des commandes en production | ex. Variable d'environnement du serveur | ex. Chef d'équipe | ex. Inconnu (aucune trace) |
| Mot de passe de la base | ex. Applications de production et de test | ex. Écrit en dur dans la configuration | ex. Responsable infrastructure | ex. Il y a plus d'un an |
| Clé privée de certificat | ex. Serveur web de production | ex. Fichier sur le serveur | ex. Responsable infrastructure | ex. Renouvelé avant l'échéance précédente |
| Clé d'envoi d'e-mails | ex. Envoi des e-mails de notification | ex. Resté collé dans le chat | ex. Pas décidé | ex. Jamais changé depuis sa création |
③ Dispersion : code et configuration
- ex. Une clé d'API écrite en dur dans le code de test
- ex. L'exemple de fichier de configuration contient de vraies valeurs
- Notez où vous l'avez vu sous la forme « fichier, type de valeur »
④ Dispersion : chat et tickets
- ex. Un mot de passe écrit dans le ticket d'une procédure
- ex. Une valeur collée dans le chat avec « utilise cette clé »
- Notez où et à peu près quand
⑤ Dispersion : postes personnels
- ex. Un fichier de clé de certificat téléchargé, resté sur le bureau
- ex. Le mot de passe du certificat dans une application de notes
- Notez à qui est le poste et quelle valeur s'y trouve
2/4 Choisir les emplacements
⑥ Règles par environnement (où déplacer les secrets de ②)
| Développement | Test | Production | |
|---|---|---|---|
| Emplacement | ex. Fichier de configuration du poste (valeurs de développement seulement) | ex. Outil de gestion des secrets | ex. Outil de gestion des secrets |
| Qui peut lire | ex. Toute l'équipe de développement | ex. Équipe de développement et testeurs | ex. Deux personnes de l'exploitation et l'application |
| Transmission | ex. Chacun la récupère dans l'outil de gestion | ex. Chargée automatiquement au déploiement | ex. Chargée à l'exécution, jamais montrée |
| Où ne pas l'écrire | ex. Code, chat, tickets | ex. Code, chat, tickets | ex. Code, chat, tickets, postes personnels |
⑦ Piège : une valeur commitée reste dans l'historique
- Ce qui arrive : ex. Même supprimée du fichier, la valeur reste dans les anciens commits et toute personne qui voit le dépôt peut la lire
- Comment vérifier : ex. Chercher dans le dépôt ou avec l'outil de détection de secrets si un secret de ② a déjà été commité
- Parade : ex. Traiter toute valeur commitée comme divulguée et la révoquer chez l'émetteur puis la remplacer avant de réécrire l'historique
- Résultat : ex. 2 dépôts contrôlés, 1 cas trouvé → remplacé avec la procédure ⑮
⑧ Piège : visible à l'écran et dans les journaux
- Ce qui arrive : ex. Partage d'écran, capture, journal d'erreurs ou sortie de débogage affichent la valeur telle quelle
- Comment vérifier : ex. Contrôler dans les réglages et dans la sortie des journaux que les champs secrets sont masqués
- Parade : ex. Masquer avant d'écrire dans les journaux et fermer les fichiers de configuration avant un partage d'écran
- Résultat : ex. Le mot de passe apparaissait dans le journal d'erreurs avec l'hôte de la base → masquage ajouté
⑨ Piège : configuration sur un poste personnel
- Ce qui arrive : ex. Une valeur de production reste dans la configuration d'un poste personnel et sert encore après une perte ou un départ
- Comment vérifier : ex. Demander aux propriétaires des postes de ⑤ et aux responsables de ② s'ils ont mis une valeur de production dans un fichier de développement, et regarder nom, note et journal d'usage de la clé dans la console de l'émetteur (les champs visibles varient selon le service)
- Parade : ex. Ne garder que des valeurs de développement sur les postes et lire celles de production depuis l'outil de gestion à l'exécution
- Résultat : ex. 2 postes avec une clé de production → supprimée et clé remplacée
3/4 Creuser les causes
⑩ 5 Pourquoi (choisir un cas parmi ③ à ⑤ et ⑦ à ⑨, creuser cinq fois)
- Pourquoi 1 ex. Pourquoi le mot de passe de la base de production est-il écrit en dur dans la configuration ? → Pour tout lancer vite en local
- Pourquoi 2 ex. Pourquoi l'écrire en dur pour lancer vite ? → On n'avait pas décidé où lire la valeur
- Pourquoi 3 ex. Pourquoi ne l'avait-on pas décidé ? → Les emplacements n'étaient pas séparés par environnement
- Pourquoi 4 ex. Pourquoi pas séparés ? → Au début, on développait seul et cela ne gênait pas
- Pourquoi 5 ex. Pourquoi ne pas avoir revu quand l'équipe a grandi ? → Personne n'était chargé des secrets
- Cause racine ex. Pas de règle d'emplacement ni de transmission, et personne n'en est responsable
⑪ Classer les secrets de ② (impact d'une fuite × facilité de remplacement)
Axe vertical : Impact d'une fuite (plus haut = plus grave) / Axe horizontal : Facilité de remplacement (gauche = difficile, droite = facile)
- Fort impact, difficile à remplacer D'abord, prévoir un remplacement sans interruption ex. Mot de passe de la base (beaucoup d'applications l'utilisent)
- Fort impact, facile à remplacer Déplacer vite vers l'outil de gestion et remplacer ex. Clé d'API de paiement (nouvelle clé émise depuis la console)
- Faible impact, difficile à remplacer Planifier et déplacer un par un ex. Mot de passe de connexion d'un vieil outil interne
- Faible impact, facile à remplacer Déplacer au prochain remplacement ex. Clé d'envoi d'e-mails de développement
⑫ Règle d'écriture
- ex. Ne jamais écrire de valeur dans le code, le chat ou les tickets, seulement où elle se trouve
- ex. Mettre des valeurs factices dans l'exemple de fichier de configuration
- Notez le responsable de la règle et la date de début
⑬ Outil de gestion
- ex. Choisir un seul outil de gestion des secrets et y regrouper les emplacements
- ex. Répartir les droits de lecture par rôle et limiter la production à 2 personnes
- Notez le responsable de l'outil et la date de début
⑭ Garde-fou avant commit
- ex. Lancer sur tous les postes un outil qui détecte les secrets avant chaque commit
- ex. Ajouter « pas de valeur en dur ? » aux points de la revue de code
- Notez le responsable du garde-fou et la date de début
4/4 Poser outils et procédure
⑮ Les 5 étapes en cas de fuite (à tester sur un secret à fort impact en ⑪)
- Prévenir La personne qui s'en aperçoit prévient aussitôt ex. Écrire au contact choisi par l'équipe quoi et où, sans chercher de coupable
- Révoquer Arrêter l'ancienne valeur chez l'émetteur ex. Désactiver la clé divulguée dans la console du service de paiement
- Remplacer Émettre une nouvelle valeur et changer l'emplacement ex. Mettre la nouvelle clé dans l'outil de gestion et recharger la production
- Vérifier les traces Chercher d'éventuels usages ex. Contrôler dans l'historique d'usage et la facturation de l'émetteur toute utilisation inconnue
- Garder la cause Noter pourquoi et réinjecter dans les règles ex. Creuser en ⑩ et ajouter des règles en ⑫ à ⑭
⑯ Calendrier de remplacement (en commençant par le haut à droite et à gauche de ⑪)
| Prochain remplacement | Comment vérifier ce qui s'arrête | Responsable | |
|---|---|---|---|
| Clé d'API de paiement | ex. 2e semaine de ce mois | ex. Faire tourner l'ancienne et la nouvelle clé côte à côte, voir passer les commandes, puis arrêter l'ancienne | ex. Chef d'équipe |
| Mot de passe de la base | ex. 1re semaine du mois prochain | ex. Compter dans ② les applications concernées, remplacer d'abord en test puis en production | ex. Responsable infrastructure |
| Clé privée de certificat | ex. 1 mois avant l'échéance | ex. Compter dans ② les serveurs concernés, remplacer en test et vérifier la connexion avant la production | ex. Responsable infrastructure |
| Clé d'envoi d'e-mails | ex. Ce mois-ci (avancé, car la clé était collée dans le chat) | ex. Vérifier en test que l'e-mail de notification arrive | ex. Un membre de l'équipe dev |
⑰ Mot aux nouveaux arrivants (à remettre le premier jour)
- Où ne pas écrire, où ranger ex. Ne jamais écrire de valeur dans le code, le chat ou les tickets, la lire depuis l'emplacement de ⑥
- Piège : laisser une vieille clé par peur de tout casser Ce qui arrive : ex. Une vieille clé reste utilisée des années et une fuite passe inaperçue Comment vérifier : ex. Regarder si responsable et date de ⑯ sont remplis Parade : ex. Faire tourner l'ancienne et la nouvelle côte à côte avant d'arrêter l'ancienne
- Si vous pensez qu'une valeur est divulguée ex. Personne n'est blâmé, prévenez tout de suite le contact de la première étape de ⑮
Contenu du tableau des tâches
À faire 16 éléments
Lister les secrets
Sur la page 1, notez le but et le périmètre, puis listez les secrets et les endroits où ils traînent. Cette liste sert de base aux pages suivantes pour choisir les emplacements et chercher les causes. Tapez « 3/4 » dans la recherche Ctrl+F (⌘F sur Mac) pour aller à la page 3.
Recopier les clés
Dans la console de chaque service externe (paiement, envoi d'e-mails, cloud), ouvrez la liste des clés d'API et recopiez nom et usage dans les lignes de la zone ②. Comptez environ 15 minutes, et c'est terminé dès que trois noms figurent. N'écrivez jamais la valeur elle-même.
Écrire but et cible
Dans la zone ①, notez le but, les services et dépôts visés, la durée et la personne qui coordonne. Terminé quand les trois notes sont remplies.
Noter où ça traîne
Dans les zones ③ à ⑤, notez où se trouvent les secrets, à savoir code et fichiers de configuration, chat et tickets, postes personnels. Terminé quand chaque encadré compte au moins un cas réel.
Choisir où ranger
Sur la page 2, décidez où ranger chaque secret de la zone ② selon l'environnement, puis vérifiez les trois pièges. Un seul emplacement par secret facilite le choix des garde-fous à la page 3.
Règles dev/test/prod
Dans le tableau de la zone ⑥, notez pour le développement, le test et la production l'emplacement, qui peut lire, comment le transmettre et où ne jamais l'écrire. Terminé quand les 12 cases sont remplies.
Historique et logs
Dans les zones ⑦ et ⑧, vérifiez qu'aucune valeur ne reste dans d'anciens commits ni n'apparaît à l'écran ou dans les journaux, puis notez le résultat sur la note de contrôle.
Vérifier les postes
Dans la zone ⑨, à partir des postes notés en ⑤, demandez à leurs propriétaires si une valeur de production traîne dans un fichier de développement, et notez le résultat. Si oui, remplacez cette clé avec la procédure de la zone ⑮.
Creuser les causes
Sur la page 3, creusez pourquoi les secrets finissent dans le code ou le chat, puis choisissez les secrets prioritaires et les garde-fous. Ces choix servent de base à la procédure et au calendrier de la page 4.
Poser 5 Pourquoi
Dans la zone ⑩, choisissez un cas parmi ③ à ⑤ et ⑦ à ⑨, répétez cinq fois pourquoi il est arrivé là, et écrivez la cause racine à la dernière étape.
Classer les secrets
Dans la zone ⑪, classez les secrets de ② en quatre groupes selon l'impact d'une fuite et la facilité de remplacement. Ceux placés en haut à droite et en haut à gauche passent en premier.
Fixer 3 garde-fous
Dans les zones ⑫ à ⑭, fixez une règle d'écriture, un outil de gestion et un garde-fou avant commit. Terminé quand chacun a un responsable et une date de début.
Outils et procédure
Sur la page 4, préparez la procédure de révocation et de remplacement, le calendrier de rotation et le mot d'accueil des nouveaux. Recopiez le résultat dans les documents de l'équipe et faites-le relire via la colonne À vérifier.
Écrire les 5 étapes
Dans les 5 étapes de la zone ⑮, notez qui prévenir, où révoquer et quoi vérifier. Testez-les sur un secret à fort impact en ⑪, et c'est terminé s'il ne reste aucune hésitation.
Caler les rotations
Dans le tableau de la zone ⑯, notez pour chaque secret la prochaine date de remplacement, le moyen de vérifier ce qui s'arrête et le responsable. Terminé quand chaque ligne a une date.
Note aux nouveaux
Dans la zone ⑰, écrivez où ne pas écrire un secret, où le ranger, pourquoi ne pas laisser une vieille clé et qui prévenir en cas de doute. Terminé quand elle est assez courte pour être lue en entier le premier jour.