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

📂 Essentiels développeur ⏱ Environ 11 minutes 📶 Intermédiaire 🛠️ Associé à : décodeur JWT

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
Dans ce guide
  1. Ce qu'est un JWT
  2. Anatomie : les trois parties
  3. Comment fonctionnent la signature et la vérification
  4. Les claims standard
  5. Quand utiliser un JWT — et quand ne pas le faire
  6. Erreurs fréquentes
  7. Essayez-le : décodeur JWT
  8. 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
PartieContenuSecret ?
En-têteAlgorithme de signature (alg) et type (typ)Non — lisible par tout le monde
Charge utileRevendications : qui vous êtes, ce que vous pouvez faire, quand il expireNon — lisible par tout le monde
SignatureHachage de l'en-tête + charge utile, avec une clé secrèteOui — seul l'émetteur peut la créer
La charge utile est encodée, pas chiffrée. Quiconque obtient le jeton peut le décoder et lire chaque revendication — votre ID utilisateur, votre e-mail, votre drapeau admin. Ne mettez jamais de mots de passe, de secrets ou de données personnelles sensibles dans un JWT. Si la charge utile doit rester secrète, il vous faut JWE (JWT chiffré), pas un JWT ordinaire.

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

ClaimSignificationPourquoi c'est important
issÉmetteur — qui a créé le jetonRejeter les jetons d'inconnus
subSujet — à qui appartient ce jeton (ID utilisateur)L'identité sur laquelle l'application agit
audAudience — le service auquel le jeton est destinéEmpêche qu'un jeton d'une application soit réutilisé dans une autre
expExpiration — temps Unix après lequel il n'est plus valideLimite les dégâts d'un jeton volé
iatÉmis leDétecter les jetons créés avant un changement de mot de passe
nbfPas avantJetons 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: true dans 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 secret est 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 courte exp et 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.

Ouvrir le décodeur JWT →

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.