Formations — 1 037 leçons en français

Accueil › Node.js › Requêtes paramétrées

Requêtes paramétrées

Parler à une base de donnéesintermediaire

// ⛔ La faille la plus exploitée du métier
const sql = `SELECT * FROM clients WHERE email = '${email}'`;

// ✅ Un marqueur dans le texte, la valeur à part
const { rows } = await pool.query(
  "SELECT * FROM clients WHERE email = $1",
  [email],
);

Ce qui se passe vraiment

La valeur n'est pas interpolée dans le texte, ni par le pilote, ni par la base. Le protocole PostgreSQL transporte le texte dans un message et les valeurs dans un autre. La requête est analysée et planifiée avant que les valeurs ne la rejoignent.

Conséquence : une valeur ne peut pas devenir du code. Il n'y a pas de texte à refermer, donc pas d'apostrophe à échapper, donc rien à oublier d'échapper.

const email = "'; DROP TABLE clients; --";

// Cherche un client dont l'email est cette chaîne. N'en trouve aucun.
await pool.query("SELECT * FROM clients WHERE email = $1", [email]);

Ce qui ne peut pas être un paramètre

Un nom de table ou de colonne. La base en a besoin pour comprendre la requête, donc avant les valeurs. ORDER BY $1 est accepté mais trie par une constante : il ne trie rien.

const COLONNES = { nom: "nom", date: "cree_le" };

const colonne = COLONNES[req.query.tri] ?? "cree_le";
await pool.query(`SELECT * FROM clients ORDER BY ${colonne}`);

La liste blanche n'est pas un échappement : c'est un ensemble fermé de valeurs écrites dans votre code. Tout le reste est rejeté.

Les termes à connaître

Requête paramétrée

Un texte de requête contenant des marqueurs — $1, $2 en PostgreSQL — et un tableau de valeurs envoyé à part. La base reçoit les deux séparément et ne confond jamais une valeur avec du code.

Injection SQL

Faire interpréter comme du code une valeur fournie par l'utilisateur. Conséquence : lecture, modification ou destruction de données que l'application n'autorisait pas. C'est la faille applicative la plus durablement exploitée.

Concaténation

Insérer une valeur dans le texte de la requête. C'est la cause de l'injection. Aucun échappement écrit à la main n'est une parade fiable — le seul correctif est le paramètre.

Marqueur numéroté

$1, $2, $3 en PostgreSQL ; ? en MySQL ; :nom chez certains outils. L'ordre des marqueurs doit correspondre à l'ordre du tableau de valeurs.

Requête préparée

Une requête analysée et planifiée une fois côté serveur, puis exécutée plusieurs fois avec des valeurs différentes. Avec pg, on l'obtient en nommant la requête.

Identifiant

Un nom de table ou de colonne. Il ne peut pas être un paramètre : la base en a besoin pour analyser la requête. On le valide contre une liste blanche.

Liste blanche

L'ensemble fermé des valeurs admises, écrit dans le code. La seule façon correcte de laisser l'utilisateur choisir une colonne de tri ou un sens d'ordre.

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.