Formations — 1 037 leçons en français

Accueil › Node.js › La traversée de répertoire

La traversée de répertoire

Fichiers et cheminsdebutant

Un serveur qui sert des fichiers reçoit un nom, et le colle sous un répertoire. C'est là que se trouve la faille.

app.get("/telecharger/:nom", async (req, res) => {
  const chemin = path.join("/srv/public", req.params.nom);   // ⛔
  res.send(await readFile(chemin));
});

Avec nom valant ../../etc/passwd, path.join normalise : le .. remonte vraiment, et le fichier servi est hors de /srv/public.

Le remède : résoudre, puis vérifier

import path from "node:path";

const RACINE = path.resolve("/srv/public");

function cheminSur(demande) {
  const cible = path.resolve(RACINE, demande);
  if (cible !== RACINE && !cible.startsWith(RACINE + path.sep)) {
    return null;                       // sortie de la zone : on refuse
  }
  return cible;
}

On ne raisonne pas sur l'écriture du chemin, on raisonne sur sa destination.

Ce qu'il ne faut pas faire

const nom = recu.replaceAll("..", "");   // ⛔ "....//" devient "../"

Filtrer des caractères est perdu d'avance. Il existe toujours une écriture de plus : ..%2f, ..\\, un double encodage, un lien symbolique.

Le piège du préfixe

"/srv/public-old" commence par "/srv/public". Un startsWith sans séparateur laisse donc passer un répertoire voisin. D'où le + path.sep, et le cas de la racine elle-même traité à part.

Si le nom doit être un simple nom

const nom = path.basename(recu);     // jette tout ce qui ressemble à un chemin

Pour un téléversement ou un identifiant, c'est la défense la plus simple : le nom n'a aucune raison de contenir un répertoire.

Les termes à connaître

Traversée de répertoire

Une entrée utilisateur qui fait sortir un chemin de la zone autorisée, le plus souvent avec ... La faille la plus classique d'un serveur qui sert des fichiers.

Racine autorisée

Le répertoire absolu et normalisé sous lequel tout chemin servi doit se trouver. On le calcule une fois, au démarrage, et on s'y compare ensuite.

Résoudre puis vérifier

Le seul remède correct — on normalise le chemin complet, puis on contrôle qu'il est bien sous la racine. On ne filtre jamais des caractères.

Liste noire

Interdire des motifs jugés dangereux — .., /, %2e. Approche vouée à l'échec : il existe toujours une écriture de plus, et le décodage se fait avant vous.

Piège du préfixe

"/srv/public-old" commence par "/srv/public". Comparer deux chemins avec startsWith sans séparateur laisse donc passer un répertoire voisin.

Décodage multiple

%2e%2e devient .. après un décodage, %252e%252e après deux. Chaque décodage supplémentaire recrée une séquence qu'un filtre antérieur ne voyait pas.

realpath

La résolution qui consulte réellement le disque et suit les liens symboliques. Nécessaire quand le contenu servi peut en contenir, et elle exige que le fichier existe.

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.