Decodificador JWT

Cómo decodificar un JWT

1. Pega el token en JSON Web Token. También sirve un valor Authorization: Bearer … completo: el prefijo Bearer y los saltos de línea se eliminan.
2. El token se decodifica mientras escribes (o al pulsar Decodificar). La Cabecera (header) y la Carga útil (payload) aparecen como JSON formateado, cada una con su propio botón Copiar.
3. Consulta la tabla Claims de tiempo: exp, nbf e iat se muestran con su valor bruto, la fecha en tu zona horaria, un tiempo relativo («dentro de 3 horas», «hace 2 días») y un estado como Expirado o Aún no válido.
4. Revisa los avisos que aparecen sobre los resultados, por ejemplo cuando alg vale none o cuando una fecha parece estar en milisegundos.
5. Para comprobar la firma, introduce la clave en Verificar la firma y pulsa Verificar firma.

Decodificar no es verificar

Un JWT son tres partes en Base64url separadas por puntos: header.payload.signature. La cabecera y la carga útil solo están codificadas, no cifradas: cualquiera que tenga el token puede leerlas, y esta herramienta decodifica cualquier token sin necesidad de clave. Eso también significa que una carga útil decodificada no demuestra nada, porque alguien podría haberla editado. Solo una firma válida prueba que el token lo emitió quien posee la clave y que no se ha modificado desde entonces. Por eso la línea de estado indica «Decodificado (firma no verificada)» hasta que lo verifiques.

Un token de cinco partes es un JWE (JWT cifrado): su contenido no se puede leer sin la clave de descifrado, y la herramienta te lo indica.

Verificar la firma

• HS256, HS384, HS512 (HMAC): introduce el Secreto compartido. Usa Formato del secreto para indicar si es texto plano (UTF-8) o Base64/Base64url, ya que algunos proveedores guardan los secretos en Base64. También puedes pegar un JWK de tipo oct. Si el secreto es más corto que la salida del hash (32 bytes para HS256), la herramienta avisa de que está por debajo del mínimo de la RFC 7518.
• RS256/384/512, PS256/384/512, ES256/384/512 y EdDSA: pega la Clave pública (PEM o JWK). Se aceptan los bloques PEM PUBLIC KEY, RSA PUBLIC KEY y CERTIFICATE (la clave se extrae del certificado X.509). También funciona un JWK o un JWK Set completo: se usa la clave cuyo kid coincide con el de la cabecera. Las claves privadas se rechazan, porque un verificador nunca las necesita. EdDSA admite Ed25519 en los navegadores cuyo Web Crypto lo implementa.

La verificación usa la API Web Crypto del navegador. Un resultado de «Firma no válida» significa que la clave es incorrecta o que el token se ha modificado. Ten en cuenta que el algoritmo se toma de la cabecera del token: un servidor real debe fijar el algoritmo esperado en su configuración; si no, un atacante puede elegirlo.

Notas de seguridad

• Los tokens son credenciales. Quien tenga un token de acceso válido suele poder actuar como su propietario hasta que expire. Esta herramienta decodifica y verifica todo en tu navegador y nunca envía el token ni la clave a ninguna parte. Aun así, evita pegar tokens de producción en herramientas que no puedas inspeccionar.
• alg: none significa que el token no está firmado. Cualquiera puede falsificarlo y un servidor debe rechazarlo. La herramienta muestra un aviso y se niega a «verificar» un token así.
• Las comprobaciones de tiempo usan el reloj de tu ordenador sin margen; los servidores suelen tolerar uno o dos minutos de desfase.
• Las fechas JWT (NumericDate) son segundos desde el 1 de enero de 1970 UTC. Un valor de 13 cifras probablemente está en milisegundos, un error muy habitual.