# Les secrets et les données

Secrets, entrées, envois, tâches planifiées, données personnelles.


Ce qui entre, ce qui sort et ce qui se garde : les règles qui protègent les données d'une société.

:::note[Exemples de code]
Les exemples utilisent un client générique `db` : ils illustrent la règle, pas un client précis.
:::

:::note[En bref]
- **SECRET-01** · [N'affichez jamais un secret](#secret-01--naffichez-jamais-un-secret)
- **SECRET-02** · [Ne commitez jamais un secret](#secret-02--ne-commitez-jamais-un-secret)
- **SECRET-03** · [Révoquez une clé exposée](#secret-03--révoquez-une-clé-exposée)
- **SECRET-04** · [Rangez le secret d'une société dans le coffre](#secret-04--rangez-le-secret-dune-société-dans-le-coffre)
- **SECRET-05** · [Validez chaque entrée par un schéma](#secret-05--validez-chaque-entrée-par-un-schéma)
- **SECRET-06** · [Ne croyez jamais un prix, un total ou un droit venu du navigateur](#secret-06--ne-croyez-jamais-un-prix-un-total-ou-un-droit-venu-du-navigateur)
- **SECRET-07** · [Contrôlez un fichier déposé côté serveur](#secret-07--contrôlez-un-fichier-déposé-côté-serveur)
- **SECRET-08** · [Ne laissez partir que les champs voulus](#secret-08--ne-laissez-partir-que-les-champs-voulus)
- **SECRET-09** · [Ne laissez pas une copie de travail envoyer](#secret-09--ne-laissez-pas-une-copie-de-travail-envoyer)
- **SECRET-10** · [Faites laisser une trace à une tâche planifiée, et ne la laissez rien vider](#secret-10--faites-laisser-une-trace-à-une-tâche-planifiée-et-ne-la-laissez-rien-vider)
- **SECRET-11** · [Donnez une durée à chaque donnée personnelle](#secret-11--donnez-une-durée-à-chaque-donnée-personnelle)
:::

## Les secrets

### SECRET-01 · N'affichez jamais un secret

:::tip[Règle]
Un secret ne s'affiche ni à l'écran, ni dans un journal, ni dans la sortie d'une commande. Un fichier d'environnement ne se lit pas pour être affiché.
:::

<div class="avant-apres">

```ts title="À éviter"
console.log("clé :", process.env.SERVICE_KEY);
```

```ts title="À faire"
console.log("clé de service présente :", Boolean(process.env.SERVICE_KEY));
```

</div>

<span class="puce relecture">Relecture</span> Aucun outil ne lit un journal à votre place.

### SECRET-02 · Ne commitez jamais un secret

:::tip[Règle]
Les fichiers d'environnement sont ignorés par git, sauf l'exemple sans valeurs. On ajoute les fichiers un par un et on relit ce qui est mis en attente.
:::

<div class="avant-apres">

```bash title="À éviter"
git add -A && git commit -m "wip"
```

```bash title="À faire"
git status
git add app/rappels/actions.ts
git diff --staged        # relu : ni secret, ni fichier d'une autre session
git commit -m "feat(rappels): pose un rappel"
```

</div>

<span class="puce outil">Outil</span> `.gitignore` écarte les fichiers d'environnement.

<span class="puce relecture">Relecture</span> Aucun script ne cherche un secret dans le contenu mis en attente.

### SECRET-03 · Révoquez une clé exposée

:::tip[Règle]
Une clé exposée est révoquée et remplacée, pas seulement retirée du dépôt : elle reste dans l'historique et dans les copies. Avant de déplacer ce qui dépend d'une clé, testez la clé.
:::

<span class="puce relecture">Relecture</span> Une clé jamais révoquée reste valable pour quiconque l'a copiée.

### SECRET-04 · Rangez le secret d'une société dans le coffre

:::tip[Règle]
Le secret d'une société va dans un coffre de la base, chiffré, qu'aucune fonction ouverte à un compte ne rend.
:::

<span class="puce outil">Outil</span> Les fonctions du coffre sont fermées aux comptes.

## Ce qui entre

### SECRET-05 · Validez chaque entrée par un schéma

:::tip[Règle]
Chaque action serveur et chaque route valident leur entrée par un schéma avant tout usage. Une entrée refusée rend son motif.
:::

<div class="avant-apres">

```ts title="À éviter"
export async function poser(formData: FormData) {
  await db.appeler("poser_un_rappel", { p_quoi: formData.get("quoi") });
}
```

```ts title="À faire"
const schema = z.object({ quoi: z.string().min(1).max(500) });

export async function poser(formData: FormData) {
  const lu = schema.safeParse(Object.fromEntries(formData));
  if (!lu.success) return { erreur: "Décrivez le rappel en 500 caractères au plus." };
  await db.appeler("poser_un_rappel", { p_quoi: lu.data.quoi });
}
```

</div>

<span class="puce relecture">Relecture</span> Les refus de la base sont rejoués, mais l'action serveur elle-même n'a pas de contrôle commun.

### SECRET-06 · Ne croyez jamais un prix, un total ou un droit venu du navigateur

:::tip[Règle]
Le serveur recalcule. Ce que le navigateur envoie n'est qu'une demande.
:::

<div class="avant-apres">

```ts title="À éviter"
await db.appeler("poser_la_facture", { p_total: formData.get("total") });
```

```ts title="À faire"
await db.appeler("poser_la_facture", { p_devis: devisId });  // le total est recalculé côté base
```

</div>

<span class="puce outil">Outil</span> Les fonctions de la base recalculent ; un relevé vérifie les droits.

<span class="puce relecture">Relecture</span> Les montants se relisent.

### SECRET-07 · Contrôlez un fichier déposé côté serveur

:::tip[Règle]
Un fichier déposé est contrôlé en type et en taille côté serveur, pas seulement par le champ du formulaire.
:::

<span class="puce relecture">Relecture</span> Il n'existe pas de contrôle serveur unique pour tous les dépôts de fichiers.

## Ce qui sort

### SECRET-08 · Ne laissez partir que les champs voulus

:::tip[Règle]
Ce qu'un lecteur ne doit pas voir ne part pas du serveur. Pour une API ou une page publique, on choisit les champs un par un.
:::

**Pourquoi.** Une donnée cachée à l'écran mais envoyée au navigateur se lit dans ses outils de développement.

<div class="avant-apres">

```sql title="À éviter"
select * from client where id = $1;  -- toute la ligne, moins « ce qui gêne »
```

```sql title="À faire"
select id, nom, ville from client where id = $1;  -- les champs publics, un par un
```

</div>

<span class="puce outil">Outil</span> Un test relit la réponse et vérifie qu'aucun champ interdit n'y figure.

<span class="puce relecture">Relecture</span> Les montants se ferment colonne par colonne.

### SECRET-09 · Ne laissez pas une copie de travail envoyer

:::tip[Règle]
Une copie de travail n'envoie ni courriel, ni notification, ni paiement réel. Un envoi se note avant de partir, avec une clé qui l'empêche de repartir. Tout envoi qu'une personne peut déclencher a un frein.
:::

<span class="puce outil">Outil</span> Une garde dans le code arrête tout envoi vers un client depuis un test, quelle que soit la configuration.

## Les tâches planifiées et les données personnelles

### SECRET-10 · Faites laisser une trace à une tâche planifiée, et ne la laissez rien vider

:::tip[Règle]
Une tâche note son passage et son erreur. On réessaie avant d'alerter. Une lecture vide, ou nettement plus courte que la précédente, garde ce qu'on avait et se signale. Une tâche qui ne passe plus prévient quelqu'un.
:::

<span class="puce outil">Outil</span> Chaque passage de nuit est noté, et un courriel part en cas d'échec ou d'absence de passage.

### SECRET-11 · Donnez une durée à chaque donnée personnelle

:::tip[Règle]
Chaque donnée personnelle a une durée de conservation et s'efface toute seule au bout. Aucune adresse électronique lisible dans le code d'une page publique. Un site montré avant d'être officiel ne s'indexe pas.
:::

<span class="puce relecture">Relecture</span> Les durées vivent dans un seul module, que lisent la tâche qui efface et le registre.

## Référence rapide

| Règle | À retenir | Tenue par |
| --- | --- | --- |
| **SECRET-01** | N'affichez jamais un secret | Relecture |
| **SECRET-02** | Ne commitez jamais un secret | Outil, Relecture |
| **SECRET-03** | Révoquez une clé exposée | Relecture |
| **SECRET-04** | Rangez le secret d'une société dans le coffre | Outil |
| **SECRET-05** | Validez chaque entrée par un schéma | Relecture |
| **SECRET-06** | Ne croyez jamais un prix, un total ou un droit venu du navigateur | Outil, Relecture |
| **SECRET-07** | Contrôlez un fichier déposé côté serveur | Relecture |
| **SECRET-08** | Ne laissez partir que les champs voulus | Outil, Relecture |
| **SECRET-09** | Ne laissez pas une copie de travail envoyer | Outil |
| **SECRET-10** | Faites laisser une trace à une tâche planifiée, et ne la laissez rien vider | Outil |
| **SECRET-11** | Donnez une durée à chaque donnée personnelle | Relecture |

## Voir aussi

- [La sécurité en grandes lignes](/securite/)
