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 avecstartsWithsans séparateur laisse donc passer un répertoire voisin.- Décodage multiple
%2e%2edevient..après un décodage,%252e%252eaprè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.
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.