Cómo funciona
- Pega tu JWT.
- Lee el encabezado, los claims y el estado de caducidad.
- Si quieres, escribe un secreto o una clave pública para verificar la firma.
Por qué usarla
- Fechas legibles para exp, iat y nbf.
- Verifica firmas HMAC, RSA y ECDSA.
- Muestra avisos sobre algoritmos como none.
- Tu token nunca sale de la página.
Leer y comprobar JSON Web Tokens
Qué hay dentro de un token
Un JSON Web Token son tres trozos de texto Base64 unidos por puntos: una cabecera, una carga útil y una firma. La cabecera nombra el algoritmo de firma; la carga útil contiene los claims, como quién es el usuario y cuándo caduca el token; la firma demuestra que quien creó el token conocía la clave. Pega un token y los dos primeros trozos se decodifican y se muestran como JSON, con los claims estándar explicados con palabras sencillas:
| Claim | Significado |
|---|---|
iss | Emisor: el servicio que creó el token |
sub | Sujeto: normalmente el identificador del usuario |
aud | Audiencia: el servicio al que va destinado el token |
exp | Caducidad: después de este momento el token debe rechazarse |
nbf | No válido antes de este momento |
iat | Emitido: cuándo se creó el token |
Decodificar no es verificar
Cualquiera puede decodificar un JWT; la carga útil no está cifrada, solo codificada. Así que nunca pongas secretos en un token, y nunca confíes en los claims de un token hasta haber comprobado su firma. Para verificar uno aquí, pega la clave:
- HS256, HS384, HS512 usan un único secreto compartido, el mismo en ambos lados. Marca la opción Base64 si el secreto está guardado así.
- Los algoritmos RS, PS y ES usan un par de claves: el token se firma con una clave privada y se comprueba con la clave pública, que puedes pegar como clave PEM, certificado o JWK.
Un token firmado con alg: none no tiene ninguna firma, y el decodificador te avisa: un servidor que lo aceptara confiaría en cualquiera que edite la carga útil. Siempre hay que indicar a las bibliotecas qué algoritmos aceptar.
Mantén privados los tokens de producción
Un token válido es una llave: quien lo tiene puede actuar como ese usuario hasta que caduque. Por eso este decodificador funciona por completo en tu navegador, y por eso conviene tener cuidado con las herramientas en línea que envían el token a un servidor. Usa tokens de prueba cuando puedas, y considera filtrado cualquier token real que hayas pegado en un sitio público.
Crear tokens de prueba
La pestaña Codificar firma tokens con tu propia cabecera, carga útil y clave, usando cualquiera de los doce algoritmos. Puede añadir la hora de emisión y una caducidad un número elegido de minutos más adelante. Útil para probar cómo maneja una API los tokens caducados, las audiencias equivocadas o los claims que faltan, sin tocar un inicio de sesión real.
Si algo sale mal
- Dice que el token no es válido. Un JWT debe tener exactamente dos puntos. Comprueba que no se cortó nada al copiar; un
Beareral principio se quita por ti. - La firma no se verifica. La clave es incorrecta, el secreto debe leerse como Base64, o el token se modificó después de firmarlo.
- Dice que el token caducó, pero el servidor lo acepta. El servidor puede permitir cierto margen de reloj, o no comprobar la caducidad en absoluto, lo que conviene corregir.
Preguntas y respuestas
¿Es seguro pegar un token real?
La decodificación se hace en local y no se envía nada. Aun así, trata los tokens de producción como secretos y usa tokens de prueba cuando puedas.
¿Puede verificar una firma?
Sí, con el secreto compartido para HS256 o la clave pública para RS256 y ES256.
¿Por qué mi token aparece como caducado?
El claim exp es una hora Unix. La herramienta la compara con el reloj de tu dispositivo.