Accueil › React › Variables d'environnement et secrets
Variables d'environnement et secrets
Mise en productionavance
# .env.local — jamais versionné
VITE_API_URL=https://api.exemple.fr
CLE_STRIPE_PRIVEE=sk_live_… # pas de préfixe : reste côté serveur
import.meta.env.VITE_API_URL // "https://api.exemple.fr"
import.meta.env.CLE_STRIPE_PRIVEE // undefined — et c'est voulu
Le point essentiel
Tout ce qui porte le préfixe
VITE_finit en clair dans le fichier JavaScript produit.
Vite ne lit rien à l'exécution : il remplace l'expression par la valeur littérale pendant la construction.
// dans dist/assets/index-a3f9.js
fetch("https://api.exemple.fr/clients")
Ouvrir les outils de développement et chercher la chaîne suffit à la retrouver. Le préfixe n'est pas une convention de nommage : c'est une barrière qui vous force à déclarer ce que vous publiez.
Ce qui peut être public
| Valeur | Public ? |
|---|---|
| URL de l'API | oui |
Clé publique Stripe (pk_) |
oui, elle est conçue pour |
| Identifiant de projet, de mesure d'audience | oui |
| Clé d'API privée, jeton de service | non |
| Mot de passe de base de données | non |
L'architecture correcte pour un secret
Navigateur → votre point d'accès → API tierce
(détient la clé)
Le navigateur n'appelle jamais l'API tierce directement. Votre point d'accès détient la clé, vérifie qui appelle, et relaie.
Si une clé a fuité
Révoquez-la. Elle a été servie à chaque visiteur ; la retirer du code ne la rend pas secrète à rétroactivement.
Les termes à connaître
- Variable d'environnement
Une valeur fournie au moment de la construction ou de l'exécution, pour qu'une même base de code serve plusieurs environnements.
- Préfixe VITE_
Seules les variables ainsi préfixées sont exposées au code client. Le préfixe est une barrière volontaire, pas une convention de nommage.
- Remplacement à la construction
Vite ne lit pas les variables à l'exécution : il remplace
import.meta.env.VITE_Xpar sa valeur littérale dans le fichier produit.- Secret
Une valeur qui ne doit jamais atteindre le navigateur : clé d'API privée, mot de passe de base, jeton de service. Sa place est côté serveur.
- .env.local
Le fichier des valeurs propres à votre machine. Il n'est jamais versionné, et
.env.exampledocumente les clés attendues.- Fuite de clé
Un secret publié dans le paquet ou dans l'historique Git. Le retirer ne suffit pas : il faut la révoquer, car elle a été lue.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.