Formations — 1 037 leçons en français

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_X par 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.example documente 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.

Lire l'explication détaillée et faire le quiz →

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.