GameParticles
Développeur

Comment décoder un JWT et lire ses revendications en toute sécurité

Décodez un JWT en séparant ses trois segments base64url, lisez les revendications iss, sub et exp, et voyez pourquoi décoder un jeton n'est pas le vérifier.

Mis à jour

Un JWT se compose de trois segments encodés en base64url et séparés par des points : l'en-tête, la charge utile et la signature. Pour lire les revendications (claims), découpez sur ., décodez les deux premiers segments en base64url et analysez le JSON obtenu. Le décodage ne demande aucune clé, mais il ne prouve rien non plus ; seule la vérification de la signature vous dit que le jeton est authentique.

Anatomie d'un jeton

Un JWT typique ressemble à eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0IiwibmFtZSI6IkFkYSIsImlhdCI6MTUxNjIzOTAyMn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c. Les trois parties sont :

  • L'en-tête : {"alg":"HS256","typ":"JWT"}. Il indique quel algorithme a signé le jeton et, éventuellement, un identifiant de clé (kid).
  • La charge utile : {"sub":"1234","name":"Ada","iat":1516239022}. Ce sont les revendications, c'est-à-dire les données qui vous intéressent réellement.
  • La signature : des octets produits en signant header.payload avec la clé de l'émetteur. Ce n'est pas du JSON, elle ne se décode donc en rien de lisible.

L'en-tête de tout JWT commence par eyJ, car c'est ce que donne {" une fois encodé en Base64. Si vous voyez eyJ, vous avez presque certainement affaire à un JWT.

Décoder à la main

Les segments utilisent base64url, et non le Base64 standard : - à la place de +, _ à la place de /, et pas de remplissage =. La plupart des décodeurs acceptent l'alphabet adapté aux URL, mais certains exigent le remplissage. Pour décoder dans un outil strict, remplacez les caractères et ajoutez des = jusqu'à ce que la longueur soit un multiple de quatre. Décodez ensuite, et vous obtenez du texte JSON.

En JavaScript, la version rapide est JSON.parse(atob(token.split(".")[1].replace(/-/g,"+").replace(/_/g,"/"))). En Python, base64.urlsafe_b64decode(seg + "=" * (-len(seg) % 4)) s'occupe du calcul du remplissage à votre place. En ligne de commande, cut -d. -f2 | base64 -d fonctionne une fois le remplissage corrigé.

Si vous voulez simplement voir ce qu'il y a dedans sans écrire de code, collez le jeton dans le décodeur JWT. Il sépare les segments, décode l'en-tête et la charge utile, explique chaque revendication standard et affiche un compte à rebours jusqu'à l'expiration.

Pour inspecter vous-même les octets d'un seul segment, déposez-le dans le décodeur Base64 après avoir corrigé le remplissage ; la sortie est le texte JSON brut.

Les revendications que vous rencontrerez

Les revendications enregistrées sont des noms courts définis dans la RFC 7519. Les plus courantes :

  • iss (issuer, l'émetteur) : qui a créé le jeton, généralement une URL telle que https://accounts.example.com.
  • sub (subject, le sujet) : l'utilisateur ou l'entité que concerne le jeton.
  • aud (audience, le destinataire) : à qui le jeton est destiné. Votre API doit rejeter les jetons dont aud ne lui correspond pas.
  • exp (expiration) : horodatage Unix en secondes au-delà duquel le jeton n'est plus valide.
  • nbf (not before, pas avant) : le jeton n'est pas valide avant ce moment.
  • iat (issued at, émis le) : le moment où il a été créé.
  • jti : identifiant unique du jeton, utilisé pour empêcher le rejeu.

Tout le reste est personnalisé : email, roles, scope, tenant_id et ainsi de suite. Les revendications personnalisées signifient ce que l'émetteur décide qu'elles signifient : consultez donc la documentation de votre fournisseur d'identité plutôt que de deviner.

Les horodatages sont en secondes, pas en millisecondes. 1516239022 correspond au 18 janvier 2018. Une valeur comme 1516239022000 est un bug du côté de l'émetteur, et tout validateur correct la lira comme une date située à des dizaines de milliers d'années.

Décoder n'est pas vérifier

C'est le point sur lequel on se trompe. N'importe qui peut fabriquer un jeton avec {"sub":"admin","roles":["superuser"]} dans la charge utile et une chaîne quelconque à l'emplacement de la signature. Il se décode parfaitement. Il ne vaut pourtant rien tant que la signature n'est pas validée avec la clé de l'émetteur.

La vérification dépend de alg :

  • HS256, HS384, HS512 : HMAC avec un secret partagé. Le vérificateur a besoin du même secret que celui utilisé par l'émetteur. La signature est un condensé HMAC-SHA de header.payload ; un générateur de hachages montre à quoi ressemble un simple condensé SHA-256, mais HMAC y mêle aussi la clé : la vérification a donc sa place dans une bibliothèque, sur votre serveur.
  • RS256, ES256, PS256 : asymétrique. L'émetteur signe avec une clé privée ; vous vérifiez avec la clé publique, généralement récupérée auprès d'un point de terminaison JWKS tel que /.well-known/jwks.json et identifiée par kid.
  • none : pas de signature. Rejetez ces jetons d'emblée.

Utilisez une bibliothèque maintenue (jsonwebtoken ou jose pour Node, PyJWT pour Python, java-jwt sur la JVM) et transmettez-lui la liste des algorithmes attendus, l'émetteur et le destinataire. Ne laissez jamais l'en-tête alg du jeton décider lui-même de la manière dont il est vérifié ; c'est l'origine de plusieurs contournements observés en conditions réelles.

Décodez pour déboguer. Vérifiez pour faire confiance. Une revendication décodée est un indice de ce que voulait l'émetteur, pas la preuve de quoi que ce soit, tant que la signature n'a pas été vérifiée côté serveur.

Manipuler les jetons avec prudence pendant le débogage

Un JWT est un identifiant au porteur : quiconque le détient peut l'utiliser jusqu'à son expiration. Ne collez des jetons que dans des outils qui s'exécutent dans le navigateur et ne les transmettent pas. Préférez des jetons expirés ou issus d'un environnement de préproduction quand vous en partagez dans des tickets. Retirez le segment de signature avant de publier un jeton dans une messagerie ; les deux premiers segments montrent toujours les revendications et le jeton n'est plus utilisable.

D'autres outils de décodage et d'inspection se trouvent dans la catégorie développeur.

Essayez

Collez un jeton dans le décodeur JWT pour voir l'en-tête, chaque revendication accompagnée d'une courte explication, l'algorithme de signature et le temps restant avant exp. Rien ne quitte votre navigateur.

Outils de ce guide

Questions fréquentes

Pourquoi tous les JWT commencent-ils par eyJ ?

Parce que l'en-tête est du JSON qui commence par une accolade et un guillemet double, et que les caractères {" donnent eyJ une fois encodés en Base64. Le même préfixe apparaît généralement aussi au début du segment de la charge utile.

Puis-je vérifier la signature d'un JWT dans le navigateur ?

Vous ne pouvez vérifier un jeton RS256 ou ES256 que si vous disposez de la clé publique de l'émetteur. Les jetons HS256 nécessitent le secret partagé, qui ne devrait jamais se trouver dans un navigateur. En pratique, vérifiez côté serveur avec une bibliothèque maintenue.

La revendication exp est-elle en secondes ou en millisecondes ?

En secondes depuis l'epoch Unix, conformément à la RFC 7519. Une valeur à 13 chiffres est un horodatage en millisecondes et révèle un bug du côté de l'émetteur.

Est-il sûr de coller un JWT dans un décodeur en ligne ?

Seulement si le décodeur s'exécute côté client et n'envoie rien à un serveur. Même dans ce cas, préférez des jetons expirés ou de préproduction, car un JWT actif est un identifiant au porteur qui fonctionne pour quiconque le détient.

Plus de guides pour développeurs

Formateur JSON
Développeur · Formatez, validez et minifiez du JSON avec coloration syntaxique.
↵
Encoder / décoder en Base64
Développeur · Encodez un texte en Base64 ou décodez du Base64 en texte brut.
↵
Encodeur / Décodeur d'URL
Développeur · Encodez ou décodez des composants d'URL et des chaînes de requête.
↵
Générateur de hash
Développeur · Générez des hashs MD5, SHA-1, SHA-256 et SHA-512.
↵
Générateur d'UUID
Développeur · Générez des UUID v4 (aléatoires) en masse en un clic.
↵
Testeur de regex
Développeur · Testez des expressions régulières sur du texte avec surbrillance des correspondances en direct.
↵
Compteur de mots
Texte · Comptez les mots, caractères, phrases, paragraphes et le temps de lecture.
↵
Convertisseur de casse
Texte · Convertissez un texte en MAJUSCULES, minuscules, Titre, camelCase, snake_case, etc.
↵
Trieur de listes
Texte · Triez, inversez, dédoublonnez et mélangez des listes de texte.
↵
Aperçu Markdown
Texte · Écrivez du Markdown et voyez l'aperçu rendu en direct, côte à côte.
↵
Calculateur de pourcentage
Nombres · Calculez pourcentages, hausses, baisses et le % d'un nombre par rapport à un autre.
↵
Convertisseur de couleurs
Couleurs · Convertissez instantanément des couleurs entre HEX, RGB, HSL et HSV.
↵
Snake
Arcade · Mangez, grandissez, évitez les murs. Un classique indémodable.
↵
2048
Réflexion · Faites glisser les tuiles et fusionnez-les pour atteindre la légendaire tuile 2048.
↵
Word Grid
Réflexion · Devinez le mot caché de cinq lettres en six essais grâce aux indices de couleur.
↵
Sudoku
Réflexion · Remplissez la grille 9x9 par la logique. Quatre niveaux, de facile à expert.
↵
Démineur
Stratégie · Servez-vous des chiffres pour déminer le terrain. Logique classique, trois niveaux.
↵
Breakout
Arcade · Cassez toutes les briques avec la raquette et la balle. Bonus, combos, niveaux sans fin.
↵
Entraînement dactylo
Détente · Améliorez MPM et précision : exercices de 30 secondes à 5 minutes. Repérez vos touches faibles.
↵
TypeRunner
Arcade · Course de dactylographie multijoueur. Défiez vos amis par lien, battez l'ordinateur ou poursuivez votre fantôme.
↵
Typing Blocks
Arcade · Tapez chaque mot avant que son bloc de bois ne se pose. Ratez, et la pile grimpe vers la ligne.
↵
Bubble Shooter
Arcade · Visez, jouez avec les murs et éclatez des groupes de trois bulles ou plus.
↵
Road Rush
Arcade · Affrontez sept rivaux dans le trafic et prenez la tête à coups de poing.
↵