Formations — 1 037 leçons en français

Accueil › Node.js › Stocker un mot de passe

Stocker un mot de passe

Authentification et autorisationintermediaire

Un mot de passe ne se chiffre pas, ne s'encode pas : il se hache avec une fonction lente et paramétrable.

La bonne fonction

import { hash, verify, argon2id } from "argon2";

const condensat = await hash(motDePasse, { type: argon2id });
// $argon2id$v=19$m=65536,t=3,p=4$<sel>$<condensat>

Argon2id de préférence, bcrypt acceptable sur un code existant. Ces fonctions sont lentes exprès : chaque vérification coûte des dizaines de millisecondes, ce qui est invisible pour un utilisateur et ruineux pour qui voudrait tester un dictionnaire de millions de mots.

Le sel est déjà là

La chaîne produite contient l'algorithme, ses paramètres et le sel. Vous n'avez aucune colonne supplémentaire à gérer, aucun sel à générer vous-même. C'est aussi ce qui permet de vérifier un ancien condensat après avoir durci les paramètres : ils sont écrits dedans.

Vérifier

const utilisateur = await trouverParEmail(email);
const valide = utilisateur
  ? await verify(utilisateur.condensat, motDePasse)
  : false;

On ne déchiffre rien. On redonne la saisie à la fonction, qui relit le sel et les paramètres dans le condensat, recalcule, et compare en temps constant.

Ce qu'il ne faut pas faire

// ⛔ rapide : des milliards d'essais par seconde sur un GPU
const mauvais = createHash("sha256").update(motDePasse).digest("hex");

// ⛔ synchrone : bloque le fil unique pendant 100 ms ou plus
const bloquant = bcrypt.hashSync(motDePasse, 12);

SHA-256 et SHA-512 sont d'excellentes fonctions de hachage — pour l'intégrité. Leur vitesse, qui est une qualité ailleurs, est exactement le défaut à éviter ici.

Les termes à connaître

Hachage

Une transformation à sens unique. On vérifie un mot de passe en rehachant la saisie et en comparant, jamais en déchiffrant quoi que ce soit.

Fonction de dérivation lente

Argon2id, scrypt, bcrypt, PBKDF2. Volontairement coûteuses en temps, en mémoire ou les deux, et paramétrables pour suivre le matériel.

Sel

Une valeur aléatoire propre à chaque mot de passe. Elle empêche de casser deux comptes d'un coup, et elle est intégrée dans la chaîne produite.

Poivre

Un secret commun à l'application, gardé hors de la base. Complément facultatif du sel : il ne remplace rien, et il complique la rotation.

Comparaison en temps constant

Comparer deux secrets sans que la durée dépende du nombre d'octets identiques. Le comparateur d'égalité de JavaScript n'offre pas cette garantie.

Coût paramétrable

Le facteur de travail stocké avec le condensat. Il permet de durcir les nouveaux enregistrements sans toucher aux anciens.

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.