SmartFlow Host

Concepts

Variables d'environnement

Passez réglages et secrets à vos builds, par environnement, chiffrés.

Vous y mettez par exemple des clés d'API publiques, l'adresse d'un backend ou des identifiants. Elles se gèrent dans l'onglet Variables d'environnement du projet.

Environnements

Chaque variable vise un ou plusieurs environnements :

EnvironnementUtilisé par
ProductionLes builds de production (vercel build --prod).
PreviewLes builds de preview, donc toutes les branches autres que la production.
Développementvercel pull et vercel env pull depuis votre poste.

Un même nom peut exister une fois par environnement, avec une valeur différente : par exemple API_URL vers l'API de production en production, et vers l'API de test en preview.

Ajouter des variables

  1. Ouvrez Ajouter

    Donnez un nom, une valeur et les environnements visés. Une note facultative rappelle à quoi sert la variable.

  2. Ou collez un fichier .env

    Collez le contenu d'un fichier .env dans le champ du nom : chaque ligne devient une variable.

.env
PUBLIC_API_URL=https://api.exemple.ch
PUBLIC_ANALYTICS_ID=abc123

Règles

  • Nom : lettres, chiffres et _, sans commencer par un chiffre.
  • Les noms qui commencent par VERCEL_ ou AGENTHOST_ sont réservés à la plateforme.
  • Valeur : 64 Ko au plus. Note : 500 caractères au plus.

Variables sensibles

Une clé secrète ou un mot de passe se déclare sensible. Une variable sensible :

  • ne s'affiche plus jamais après l'enregistrement, ni dans la console ni par la CLI : on peut seulement la remplacer ;
  • vise la production ou la preview, jamais le développement ;
  • n'est livrée qu'au build du dépôt, par la clé limitée au projet que pose l'app GitHub. Un vercel pull depuis votre poste ne la télécharge pas.

Coffre, chiffrement et accès

Les valeurs vivent dans un coffre. Chaque équipe a sa propre clé de chiffrement (AES-GCM 256 bits), elle-même chiffrée par une clé maîtresse gardée hors de la base. Chaque valeur est liée à son projet : recopiée ailleurs, elle ne se déchiffre pas.

  • Les membres en lecture seule voient les noms, jamais les valeurs.
  • Les membres et propriétaires peuvent afficher une valeur non sensible.
  • Le journal du coffre, en bas de l'onglet, garde les 50 derniers gestes : qui a créé, modifié, affiché une valeur, quelle clé d'API les a téléchargées, quand Doppler les a synchronisées. Jamais une valeur.

Synchroniser depuis Doppler

Si vos secrets vivent déjà dans Doppler, reliez une config à un environnement du projet : Doppler reste la source de vérité, et chaque changement arrive ici tout seul. Voir Synchroniser depuis Doppler.

Récupérer les variables

Terminal
vercel --api https://api.host.hgdc.ch --token ah_… pull --environment=development

La CLI écrit les variables dans .vercel/.env.development.local. Une modification ne touche pas les déploiements existants : redéployez pour qu'elle s'applique.