Comment utiliser le décodeur
- Collez le jeton. Un préfixe « Bearer » est retiré automatiquement.
- Lisez l’en-tête, la charge utile et les claims. Les trois parties du jeton sont colorées.
- Vérifiez le statut : expiration, début de validité et algorithme.
- Vérifiez la signature : secret (HS) ou clé publique PEM (RS, PS, ES).
Comment un JWT est-il construit ?
Un JSON Web Token (RFC 7519) se compose de trois parties séparées par des points : l’en-tête, la charge utile et la signature. L’en-tête et la charge utile sont des objets JSON encodés en Base64 compatible URL. L’en-tête indique l’algorithme, par exemple HS256 ou RS256, et la charge utile contient les claims, c’est-à-dire des informations sur l’utilisateur et la validité. La signature garantit que personne n’a modifié le jeton. Important : la charge utile n’est pas chiffrée. Quiconque possède le jeton peut la lire. Ne placez donc jamais de mots de passe ni de données sensibles dans un JWT.
Les principaux claims
| Claim | Signification |
|---|---|
iss | émetteur du jeton |
sub | sujet, généralement l’identifiant de l’utilisateur |
aud | audience à laquelle le jeton est destiné |
exp | date d’expiration (horodatage Unix) |
nbf | pas valide avant cette date |
iat | date d’émission |
jti | identifiant unique du jeton |
D’autres claims courants comme name, email, role, scope ou azp sont également expliqués. Les claims propres à votre application sont signalés comme « personnalisé ».
Expiration et validité
Les horodatages des JWT sont exprimés en secondes depuis le 1er janvier 1970 (UTC). Le décodeur les convertit dans votre heure locale et affiche aussi la forme ISO en UTC. Une ligne d’état indique si le jeton a expiré, combien de temps il reste valide ou s’il ne deviendra valide que plus tard. Lors du débogage d’une connexion, c’est un gain de temps considérable : une erreur 401 Unauthorized vient souvent d’un jeton expiré ou d’une horloge serveur déréglée.
Vérifier la signature
Pour les algorithmes symétriques (HS256, HS384, HS512), saisissez le secret partagé, éventuellement encodé en Base64. Pour les algorithmes asymétriques (RS, PS, ES), collez la clé publique au format PEM, qui commence par -----BEGIN PUBLIC KEY-----. La vérification utilise l’interface Web Crypto du navigateur. Si la signature est valide, le jeton a été signé avec la bonne clé et n’a pas été modifié. Un jeton d’exemple, signé avec un secret de démonstration, permet d’essayer immédiatement.
Conseils de sécurité
- Jetons non signés : le décodeur signale clairement
alg: none. Un serveur ne doit jamais les accepter. - Jetons JWE : à cinq parties, ils sont chiffrés ; seul le détenteur de la clé peut lire leur contenu.
- Jetons de production : ne les collez pas dans des outils qui envoient les données à un serveur. Ce décodeur fonctionne entièrement en local, mais révoquez ou laissez expirer les vrais jetons après le débogage.
- Secrets HS256 : ils doivent compter au moins 256 bits et être aléatoires.
Erreurs fréquentes lors du débogage
Si une API renvoie 401 malgré le jeton, vérifiez dans le décodeur : le jeton a-t-il expiré, sa durée de vie étant souvent de 5 à 60 minutes ? L’audience (aud) correspond-elle à l’API appelée ? L’émetteur (iss) vient-il du bon environnement, test ou production ? L’horloge du serveur est-elle juste, sans quoi nbf ou iat semblent dans le futur ? Les droits nécessaires figurent-ils dans scope ou role ? Ces points expliquent la plupart des refus avant même d’ouvrir le code.
Questions fréquentes
Le contenu d’un JWT est-il chiffré ?
Non, l’en-tête et la charge utile sont seulement encodés en Base64 et lisibles par tous. Seule la signature empêche les modifications.
Puis-je décoder un jeton sans le secret ?
Oui, la lecture ne nécessite aucun secret. Il ne sert qu’à vérifier la signature.
Quels algorithmes sont vérifiés ?
HS256/384/512, RS256/384/512, PS256/384/512 et ES256/384/512.
Que signifie exp ?
La date d’expiration en horodatage Unix. Après cette date, le jeton doit être refusé.
Mon jeton est-il enregistré ou envoyé ?
Non, tout est traité dans votre navigateur.