Qu'est-ce qu'un JWT ? Structure, signature et usage sûr
Trois morceaux base64url séparés par des points : un en-tête, une charge utile et une signature. Apprenez ce que chaque partie prouve, ce qu'elle ne prouve pas, et les cinq erreurs qui transforment un JWT en faille de sécurité.
Ce que vous allez apprendre
- Lire un JWT et nommer ses trois parties
- Expliquer ce que prouve la signature — et ce qu'elle ne prouve pas
- Utiliser correctement les claims standard (exp, iss, aud, sub)
- Décider quand un JWT bat une session côté serveur (et quand il perd)
- Éviter les cinq erreurs de sécurité classiques des JWT
- Ce qu'est un JWT
- Anatomie : les trois parties
- Comment fonctionnent la signature et la vérification
- Les claims standard
- Quand utiliser un JWT — et quand ne pas le faire
- Erreurs fréquentes
- Essayez-le : décodeur JWT
- Questions fréquentes
Ce qu'est un JWT
A JSON Web Token (JWT) est une façon compacte et compatible URL de transmettre une revendication signée entre deux parties. Il ressemble à ceci :
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IlZhbGV2IiwiYWRtaW4iOnRydWUsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
Trois blocs, séparés par des points : header.payload.signature. Un serveur en crée un après votre connexion, vous le remet, et vous le renvoyez avec chaque requête — généralement dans un Authorization: Bearer <token> en-tête. Le serveur vérifie la signature et fait confiance aux revendications qu'il contient, sans rien chercher dans une base de données. Cette propriété « sans recherche » est tout l'intérêt — et, comme nous le verrons, aussi la principale faiblesse.
Anatomie : les trois parties
Chaque partie est du JSON encodé en base64url (base64 avec +// remplacé par -/_ et le remplissage supprimé, pour qu'il survive dans une URL). Décodez l'exemple ci-dessus et vous obtenez :
// Header — how the token is signed
{ "alg": "HS256", "typ": "JWT" }
// Payload — the claims (statements about the user)
{ "sub": "1234567890", "name": "Valev", "admin": true, "iat": 1516239022 }
// Signature — HMAC-SHA256 over header.payload, with a secret key| Partie | Contenu | Secret ? |
|---|---|---|
| En-tête | Algorithme de signature (alg) et type (typ) | Non — lisible par tout le monde |
| Charge utile | Revendications : qui vous êtes, ce que vous pouvez faire, quand il expire | Non — lisible par tout le monde |
| Signature | Hachage de l'en-tête + charge utile, avec une clé secrète | Oui — seul l'émetteur peut la créer |
Comment fonctionnent la signature et la vérification
Pour créer la signature, l'émetteur prend base64url(header) + "." + base64url(payload) et le signe :
HMAC-SHA256(secret, header + "." + payload) // HS256: shared secret RS256: sign with a private key, verify with a public key
La vérification est le même calcul à l'envers : le serveur recalcule la signature sur l'en-tête et la charge utile reçus, avec sa propre clé secrète, et compare. Si un seul caractère de la charge utile a été modifié — par exemple en changeant "admin": false en true — la signature ne correspond plus et le jeton est rejeté.
Deux familles d'algorithmes comptent. Symétrique (HS256) : un seul secret partagé signe et vérifie — simple, mais quiconque possède le secret peut forger des jetons, donc seul l'émetteur peut le détenir. Asymétrique (RS256/ES256) : une clé privée signe, une clé publique vérifie — le vérificateur peut être un autre service, c'est ainsi que fonctionne la fédération de type « connexion avec Google ».
Les claims standard
| Claim | Signification | Pourquoi c'est important |
|---|---|---|
iss | Émetteur — qui a créé le jeton | Rejeter les jetons d'inconnus |
sub | Sujet — à qui appartient ce jeton (ID utilisateur) | L'identité sur laquelle l'application agit |
aud | Audience — le service auquel le jeton est destiné | Empêche qu'un jeton d'une application soit réutilisé dans une autre |
exp | Expiration — temps Unix après lequel il n'est plus valide | Limite les dégâts d'un jeton volé |
iat | Émis le | Détecter les jetons créés avant un changement de mot de passe |
nbf | Pas avant | Jetons qui ne deviennent valides que plus tard |
En plus de ceux-ci, les applications ajoutent leurs propres revendications — rôles, permissions, nom d'affichage. Gardez la charge utile petite : le jeton est envoyé avec chaque requête, donc un jeton de 5 Ko est une taxe sur chaque appel.
Quand utiliser un JWT — et quand ne pas le faire
Les JWT brillent quand la vérification doit se faire sans aller-retour en base de données, ou entre des services qui ne partagent pas de magasin de session : API, microservices et authentification unique. Le vérificateur n'a besoin que de la clé.
Ils perdent sur un point important : on ne peut pas facilement en révoquer un. Une session côté serveur peut être supprimée dès qu'un utilisateur se déconnecte ou change de mot de passe ; un JWT reste valide jusqu'à son expiration, car il n'y a rien à supprimer. Les atténuations standard sont des durées d'expiration courtes (des minutes, pas des jours) plus des jetons de rafraîchissement — un jeton de longue durée envoyé uniquement au point de connexion pour émettre de nouveaux JWT de courte durée — ou une liste de révocation, qui réintroduit discrètement la recherche en base de données que le JWT devait éviter.
Règle générale : si vous avez une application et une base de données, un cookie de session classique est plus simple et plus sûr. Optez pour JWT quand vous avez beaucoup de services, ou quand le jeton doit franchir une limite de confiance.
Erreurs fréquentes
- Faire confiance à un jeton décodé côté client. Le décodage ne prouve rien — seule la vérification de la signature le fait. Le
admin: truedans une charge utile décodée est une revendication, pas un fait, tant que la signature n'est pas vérifiée. - Accepter
alg: none. Un jeton non signé doit être rejeté. Les bibliothèques qui l'acceptent encore sont la plus ancienne vulnérabilité JWT qui soit — et elle apparaît toujours. - Secrets faibles ou divulgués. HS256 avec le secret
secretest falsifiable en quelques secondes. Utilisez un secret long et aléatoire, renouvelez-le, et ne le commitez jamais. - Pas d'expiration (
exp). Un jeton volé fonctionne alors indéfiniment. Définissez une courteexpet utilisez des jetons de rafraîchissement. - Mettre des secrets dans la charge utile. Base64url n'est pas du chiffrement — n'importe qui peut le lire. Voir l'encadré ci-dessus.
- Stocker les jetons dans localStorage. Toute faille de cross-site scripting (XSS) permet à un attaquant de le lire. Les cookies HttpOnly sont le foyer le plus sûr pour les jetons de navigateur.
Essayez-le : décodeur JWT
Collez un jeton dans le décodeur JWT et regardez-le se diviser en en-tête, charge utile et dates lisibles — le moyen le plus rapide de voir la structure que ce guide décrit.
Pour aller plus loin
Questions fréquentes
Un JWT est-il chiffré ?
Non. Un JWT standard (JWS) est signé, pas chiffré — la charge utile est en base64url, que n'importe qui peut décoder. Le chiffrement est un format distinct, JWE, utilisé quand le contenu lui-même doit rester secret.
Comment révoquer un JWT quand un utilisateur se déconnecte ?
Vous ne pouvez pas le supprimer directement — il reste valide jusqu'à exp. Les réponses pratiques sont une expiration courte avec des jetons de rafraîchissement, ou une liste de refus côté serveur des ID de jetons révoqués (le claim jti) vérifiée sur les points sensibles.
JWT contre cookie de session — lequel choisir ?
Un cookie de session pour une seule application avec une base de données : plus simple, révocable instantanément. Un JWT pour les API et microservices où les vérificateurs ne peuvent pas partager de magasin de session, ou où les jetons franchissent des limites de service. Beaucoup de systèmes utilisent les deux : une session pour le navigateur, des JWT pour les appels de service à service.
Où stocker un JWT dans le navigateur ?
Dans un cookie HttpOnly, Secure, SameSite — JavaScript ne peut pas le lire, donc XSS ne peut pas le voler. localStorage est pratique mais lisible par n'importe quel script de la page, y compris un script injecté.
Puis-je décoder un JWT sans le secret ?
Oui — décoder l'en-tête et la charge utile ne demande aucune clé ; seule la vérification de la signature en demande une. C'est pourquoi l'outil décodeur JWT peut vous montrer instantanément le contenu d'un jeton, et pourquoi vous ne devez jamais mettre de secrets dans la charge utile.