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,$2en 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,$3en PostgreSQL ;?en MySQL ;:nomchez 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.
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.