Comment utiliser l’outil Décodeur JWT
- Collez votre jetonCollez un JWT dans la zone. Le préfixe « Bearer » et les sauts de ligne sont retirés automatiquement.
- Lisez le contenuL’en-tête et le payload sont décodés et colorés, chaque claim étant expliqué simplement.
- Vérifiez les datesExpiration (exp), émission (iat) et « pas avant » (nbf) sont converties en dates, avec un badge clair Expiré / Non expiré.
- Vérifiez la signaturePour les jetons HS256, HS384 ou HS512, saisissez le secret partagé pour confirmer que le jeton est authentique.
Fonctionnalités
- Décodage instantanéLes résultats s’affichent dès que vous collez. Ni bouton, ni attente.
- Claims lisiblesLes claims standard comme iss, sub, aud et exp sont nommés et expliqués.
- État d’expirationVoyez d’un coup d’œil si le jeton a expiré ou n’est pas encore valide.
- Contrôle de signatureVérifiez les jetons signés en HMAC avec WebCrypto, directement dans votre navigateur.
Qu'est-ce qu'un JWT ?
Un JSON Web Token (JWT) est un jeton compact utilisé pour l'authentification et l'échange d'informations entre services : connexion à une API, authentification unique (SSO), applications mobiles. Il est formé de trois parties en Base64 compatible URL, séparées par des points :
- L'en-tête : le type de jeton et l'algorithme de signature, par exemple HS256 ou RS256.
- Le contenu (payload) : les « claims », comme l'identifiant de l'utilisateur et la date d'expiration.
- La signature : prouve que le jeton a été créé par le détenteur de la clé et n'a pas été modifié.
Les claims standard
| Claim | Signification |
|---|---|
| iss | Émetteur : qui a créé le jeton |
| sub | Sujet : généralement l'identifiant de l'utilisateur |
| aud | Audience : pour quelle application ou API le jeton est prévu |
| exp | Expiration, en timestamp Unix (secondes) |
| nbf | Pas avant : le jeton n'est pas valide avant cette date |
| iat | Émis le : date de création du jeton |
| jti | Identifiant unique du jeton, pour empêcher sa réutilisation |
Les dates exp, nbf et iat sont affichées en heure lisible, et l'outil indique si le jeton est expiré. Les claims écrits en français ou avec accents, comme "nom": "Hélène", sont décodés correctement en UTF-8.
Décoder n'est pas vérifier
N'importe qui peut lire le contenu d'un JWT : il est seulement encodé, pas chiffré. Ne mettez donc jamais de mot de passe ou de donnée sensible dans le payload. Seule la signature garantit que le jeton est authentique, et votre serveur doit toujours la vérifier avant de lui faire confiance.
| Algorithmes | Fonctionnement |
|---|---|
| HS256, HS384 et HS512 | Un secret partagé signe et vérifie. Saisissez le secret pour vérifier ; le contrôle se fait avec l'API Web Crypto de votre navigateur |
| RS256, ES256, PS256 et similaires | Signés avec une clé privée et vérifiés avec une clé publique, que l'émetteur publie généralement à une adresse JWKS. Vérifiez-les sur votre serveur avec une bibliothèque |
Conseils de sécurité
- Donnez aux jetons d'accès une durée de vie courte (minutes, pas jours) et utilisez des jetons de rafraîchissement pour les sessions longues.
- Avec les algorithmes HMAC, utilisez un secret long et aléatoire ; un secret court ou devinable peut être cassé hors ligne.
- Refusez l'algorithme « none » et fixez la liste des algorithmes acceptés côté serveur.
- Ne collez des jetons de production que dans des outils qui s'exécutent localement, comme celui-ci : rien n'est envoyé.