---
title: "Variables d'environnement et secrets en 2026 : hors du code et de l'IA"
url: https://while.sh/fr/guides/variables-et-secrets/
author: "Aloïs Oddon, cofondateur de Nextmap"
updated: 2026-11-19
---

# Les variables d'environnement et les secrets de votre appli, hors du code (2026)

Un identifiant dans le code ou dans un .env finit par fuiter. Sur while, votre IA règle les variables de votre appli par MCP, et vos secrets vivent dans un coffre chiffré : votre appli les reçoit, votre IA ne peut pas les relire.

> **Ce qu'il faut retenir.** Votre IA règle les variables de votre appli par MCP. Vos secrets, vous pouvez les saisir vous-même dans while : votre IA ne les voit jamais. Ce qui compte, comme supprimer une base, attend la validation d'une personne.

## Prérequis

- Une appli sur while, ou prête à l'être.
- Votre IA, connecté à while par MCP.

## Étape 1 : Demandez une variable à votre IA

> Vous, à votre IA : Ajoute la variable LOG_LEVEL=info.

Votre IA la pose par MCP, et elle arrive à votre appli à la mise en production suivante.

## Étape 2 : Gardez vos secrets pour vous

Pour un identifiant ou un mot de passe, collez la valeur vous-même dans les réglages de votre appli, dans while, à « Variables et secrets » : votre appli la reçoit, votre IA ne la voit jamais. Et un secret que votre IA pose par MCP, elle ne peut plus le relire.

## Ce que fait votre IA

Les secrets vivent dans un coffre chiffré, jamais dans while.yaml ni dans votre code, comme le veut la méthode des douze facteurs (source 1). Une variable sans secret, elle, peut s'écrire dans while.yaml. Ils arrivent à votre appli à chaque mise en production, en variable d'environnement, ou en fichier dans `/run/secrets/` pour les plus sensibles :

```js titre="server.js"
import { readFile } from 'node:fs/promises';

const cle = (await readFile('/run/secrets/CLE_API', 'utf8')).trim();
```

<figure class="illus"><img src="/illustrations/guide-fonction-garde-1200.webp" srcset="/illustrations/guide-fonction-garde-768.webp 768w, /illustrations/guide-fonction-garde-1200.webp 1200w" sizes="(min-width: 48rem) 46rem, 100vw" width="1536" height="1024" loading="lazy" decoding="async" alt="Les variables et les secrets avec while : les identifiants gardés hors de portée de l'IA, chaque appel noté dans l'historique, la validation d'une personne pour ce qui compte et la sauvegarde de chaque jour, en France" /><figcaption>Autour de chaque appli, while garde les identifiants, l'historique, les validations et les sauvegardes.</figcaption></figure>

## Utiliser un registre npm privé

> Vous, à votre IA : Notre registre npm privé demande un jeton.

Votre IA déclare un secret de construction, `NPM_TOKEN`, et un `.npmrc` qui le lit. Vous saisissez sa valeur : il sert à installer les paquets, jamais à votre appli, et ne reste pas dans l'image.

```yaml titre="while.yaml"
services:
  - name: web
    port: 3000
    build:
      secrets: [NPM_TOKEN]
```

## Une valeur différente en version de test

> Vous, à votre IA : Mets LOG_LEVEL=debug en version de test.

Chaque environnement a ses propres variables : la version de test parle davantage dans ses logs, la production reste sobre.

## Les adresses que votre appli reçoit d'office

> Vous, à votre IA : Quelles variables notre appli reçoit-elle ?

Votre IA vous les liste : `DATABASE_URL` pour la base, `REDIS_URL` pour le cache, les `S3_` du stockage, `SENTRY_DSN` pour les erreurs, et une adresse par API connectée.

## Revenir à la version d'avant

> Vous, à votre IA : Reviens à la version d'avant.

Dans les 30 minutes qui suivent une mise en production, la version d'avant revient en une seconde. Ensuite, en quelques secondes. Une fois la version d'avant revenue, votre IA lit ce qui a cassé dans les logs de while, corrige et remet en production.

## Prochaines étapes

- [Connecter Stripe ou Brevo sans identifiant dans le code](/fr/guides/api-sans-cle-dans-le-code/)
- [Appeler Claude ou GPT sans exposer l'identifiant](/fr/guides/ia-sans-exposer-la-cle/)
- [La sécurité de while](/fr/securite/)

## Sources

1. [La méthode des douze facteurs, la configuration](https://12factor.net/fr/config), 2026-11-02

## Questions

### Puis-je mettre mes secrets dans while.yaml ?

Pas un secret : while.yaml décrit l'appli, et les secrets vivent dans le coffre de while. Une variable sans secret, oui.

### Et le .env de mon dépôt ?

Il reste hors de la construction et de l'image : ses valeurs se posent dans while.

### Faut-il remettre en production après un changement ?

Oui : une variable changée arrive à votre appli à la mise en production suivante.

### Où tournent mon appli et ses données ?

En France, chez Nextmap. La base est sauvegardée chaque jour, avec un retour possible sur 14 jours, une fois qu'une personne a validé.

### Que se passe-t-il si une version casse quelque chose ?

Dans les 30 minutes qui suivent une mise en production, la version d'avant revient en une seconde, ensuite en quelques secondes.
