Formations — 1 037 leçons en français

Accueil › Node.js › Les jetons en pratique

Les jetons en pratique

Authentification et autorisationintermediaire

Un jeton signé prouve qu'il n'a pas été modifié. Il ne cache rien.

Le contenu est public

const corps = jeton.split(".")[1];
console.log(JSON.parse(Buffer.from(corps, "base64url").toString()));
// { sub: "42", role: "membre", exp: 1770000000 }

Aucune clé n'a été nécessaire. Un jeton signé est de l'encodage plus une signature : jamais de mot de passe, de numéro, d'adresse ni de secret dedans.

Vérifier, ce n'est pas décoder

import { jwtVerify } from "jose";

const { payload } = await jwtVerify(jeton, cle, {
  issuer: "https://api.exemple.fr",
  audience: "application-web",
  clockTolerance: 5,
});

Une bibliothèque éprouvée vérifie la signature, l'algorithme attendu, l'expiration, la date de début, l'émetteur et l'audience. Décoder sans vérifier revient à faire confiance à ce que le client a écrit.

Où ranger le jeton côté client

res.cookie("acces", jeton, {
  httpOnly: true,     // aucun script ne le lit
  secure: true,       // jamais envoyé en clair
  sameSite: "lax",    // limite l'envoi depuis un autre site
  maxAge: 900_000,
});
Stockage Lisible par un script injecté Envoyé automatiquement
Cookie httpOnly non oui — d'où sameSite
Stockage local oui non

Le stockage local n'offre aucune protection contre un script injecté. Le cookie httpOnly protège de la lecture, pas de la requête forgée : les deux risques demandent deux défenses.

Les termes à connaître

Signé n'est pas chiffré

Un jeton signé garantit qu'il n'a pas été modifié. Son contenu reste lisible par tout le monde : c'est de l'encodage, pas du chiffrement.

Revendication

Un champ du jeton. Les revendications normalisées décrivent l'émetteur, le sujet, l'audience, l'expiration, la date de début et l'identifiant du jeton.

Audience

Le destinataire prévu du jeton. Sans cette vérification, un jeton émis pour un service est accepté par un autre.

Cookie httpOnly

Un cookie qu'aucun script de la page ne peut lire. Il protège d'une lecture par script injecté, pas d'une requête forgée.

sameSite

L'attribut de cookie qui limite son envoi depuis un autre site. C'est la défense principale contre la requête forgée inter-site.

Marge d'horloge

Quelques secondes de tolérance sur les dates du jeton, pour absorber le décalage entre deux machines.

Rotation du jeton de renouvellement

Chaque renouvellement remplace le jeton précédent. Réutiliser un jeton déjà consommé est le signal d'un vol.

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.