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.
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.