Skip to content
Floskool

Chapter 2 · Protéger tes clés

Ranger tes clés dans un fichier .env

Free lesson 8 minGroup Claude Code & IA

Follow this course in your space: your progress is saved, and the community answers your questions.

Follow for free

Pourquoi c'est important

Une clé API est un mot de passe donné à un programme. Elle permet à ton site d'utiliser un service : envoi d'e-mails, paiement, IA, réseau social. Quiconque possède ta clé peut agir à ta place, et parfois à tes frais.

Exemple concret. Léa vend des formations en ligne. Sa clé de paiement est écrite dans un fichier JavaScript de son site. Ce type de fichier est envoyé au navigateur de chaque visiteur. Autrement dit, n'importe qui peut ouvrir le code de la page et lire la clé.

La règle à retenir : une clé ne s'écrit jamais dans le code. Elle vit dans un fichier à part, nommé .env, à la racine du projet. Le code va la chercher là.

Les trois fichiers à connaître

  • .env : contient tes vraies clés. Il ne quitte jamais ton ordinateur (ou ton serveur).
  • .gitignore : la liste de ce que Git doit ignorer. C'est lui qui empêche .env de partir dans tes sauvegardes en ligne.
  • .env.example : le même que .env, mais avec des valeurs bidon. Il sert de modèle sans rien révéler.

Le pas à pas

1. Crée le fichier .env

À la racine de ton projet, le fichier .env ressemble à ceci (avec tes vraies valeurs à la place) :

SERVICE_EMAIL_CLE=ta_cle_ici
MOT_DE_PASSE_BASE=ton_mot_de_passe_ici

2. Crée le fichier .env.example

Même contenu, mais uniquement avec des valeurs bidon explicites. Celui-là peut être partagé sans risque.

3. Exclus .env de Git

Dans le fichier .gitignore, ajoute au minimum ces trois lignes :

.env
.env.*
!.env.example

La première exclut .env. La deuxième exclut ses variantes (par exemple .env.local). La troisième, avec le point d'exclamation, garde quand même .env.example.

Fais-le avant ton premier commit. Sinon la clé reste dans l'historique de Git, même si tu l'effaces ensuite.

4. Vérifie avec Claude Code

Envoie ce prompt, qui ne modifie rien :

Vérifie la gestion des secrets de ce projet, sans rien modifier :
1. existe-t-il un fichier .env, et est-il bien ignoré par Git ?
2. le .gitignore contient-il .env et ses variantes ?
3. trouves-tu dans le code des clés, jetons ou mots de passe écrits en dur ?
   Pour chacun, donne le fichier et la ligne, mais n'affiche jamais la valeur
   (remplace-la par ****).
4. existe-t-il un .env.example avec des valeurs bidon ?
Rends une liste : point vérifié, état (OK ou à corriger), correction proposée.
Attends mon accord avant toute modification.

Pourquoi ce prompt marche : il couvre les quatre points qui comptent, la consigne « n'affiche jamais la valeur » évite que la clé finisse dans la conversation, et rien n'est modifié sans toi.

Si Claude trouve une clé écrite en dur, il te la montrera masquée, par exemple sk_****. C'est normal et c'est voulu.

5. Écris la règle dans CLAUDE.md

Ajoute cette phrase dans le fichier CLAUDE.md de chaque projet :

Les clés et mots de passe vivent dans .env, listé dans .gitignore.
Ne jamais les écrire dans le code ni les afficher.

Rappel : CLAUDE.md guide Claude, mais ne bloque rien. Pour interdire vraiment la lecture de .env, tu verras les règles de permission dans le chapitre 3.

Les erreurs à éviter

  • Écrire une clé dans le code « juste pour tester ». Le test d'aujourd'hui devient le commit de demain. Mets-la dans .env dès la première minute.
  • Créer le .gitignore après le premier commit. La clé est alors déjà dans l'historique.
  • Partager ton .env par e-mail, messagerie ou clé USB prêtée.
  • Mettre une vraie valeur dans .env.example « parce que c'est plus pratique ».

À toi de jouer

  1. Ouvre ton projet dans Claude Code, en mode Manuel.
  2. Envoie le prompt de vérification ci-dessus.
  3. Note le résultat dans ton fichier avancement.md : combien de points sont OK, combien sont à corriger.
  4. Valide les corrections une par une, en commençant par le .gitignore.