Ontoom

JWT encode / decode

Decodifica y valida tokens JWT, o genera uno con HS256 — en el navegador.

Con secreto, valida la firma HS256.

Importante: La firma HS256 usa Web Crypto localmente. No pegues secretos de producción.

Qué es un JWT

Un JSON Web Token (JWT), definido en la RFC 7519, es una forma compacta de transportar datos (claims) entre sistemas y aparece en casi todos los flujos de login y llamadas a APIs. Un JWT firmado tiene tres partes separadas por puntos: header.payload.signature. El header y el payload son objetos JSON codificados en Base64URL, una variante de Base64 apta para URLs que cambia + por -, / por _ y quita el relleno =.

Lo esencial: el payload no está cifrado. Cualquiera que tenga el token puede leerlo, que es justo lo que hace esta herramienta. La firma solo demuestra que nadie sin la clave lo modificó. Nunca pongas contraseñas ni datos personales en el payload de un JWT.

Qué hace esta herramienta

Los tokens firmados con algoritmos asimétricos como RS256 o ES256 se pueden decodificar, pero aquí no se verifica su firma, porque para eso hace falta la clave pública del emisor.

  • Decode: separa el token, decodifica las partes Base64URL y muestra el header y el payload como JSON formateado.
  • Comprobación HS256: si indicas el secreto, recalcula el HMAC-SHA256 con la Web Crypto API del navegador y te dice si la firma coincide.
  • Avisos de tiempo: marca los tokens cuyo claim exp ya pasó o cuyo nbf todavía está en el futuro.
  • Encode: crea un token nuevo a partir de un header y un payload JSON, firmado con HS256 o sin firma (alg none) para pruebas.

Cómo usarla

  1. En la pestaña Decode / validar, pega el token. Si viene de un header Authorization, quita el prefijo Bearer.
  2. Revisa el header (algoritmo y tipo) y el payload (claims como sub, iat y exp).
  3. Para comprobar una firma HS256, escribe el secreto y pulsa Decode y validar.
  4. Para crear un token de prueba, cambia a Encode, edita el header y el payload, indica un secreto y pulsa Generar JWT.

Claims registrados que verás

  • iss (issuer) y aud (audience): quién creó el token y para quién es.
  • sub (subject): normalmente el ID del usuario.
  • iat (emitido en), nbf (no antes de) y exp (expira): marcas de tiempo en segundos desde el 1 de enero de 1970 UTC, no en milisegundos.
  • jti: identificador único del token, útil para listas de revocación.

Ejemplo de payload

Aquí iat corresponde al 1 de enero de 2026 a las 00:00 UTC y exp a una hora después. Un error clásico es calcular exp con Date.now() de JavaScript, que va en milisegundos, y acabar con un token válido durante decenas de miles de años.

{
  "sub": "usuario-prueba-123",
  "role": "qa",
  "iat": 1767225600,
  "exp": 1767229200
}

Errores de seguridad frecuentes

  • Aceptar alg none en producción. El servidor debe fijar el algoritmo esperado y rechazar cualquier otro.
  • Usar un secreto HS256 corto o fácil de adivinar. Usa al menos 32 bytes aleatorios; para entornos de prueba sirve el generador de contraseñas.
  • No comprobar exp, aud e iss en el backend. Decodificar no es validar.
  • Guardar datos sensibles en el payload pensando que quedan ocultos.

Preguntas frecuentes

¿Decodificar un JWT es lo mismo que validarlo?
No. Cualquiera puede decodificar un JWT. Validar significa comprobar la firma con la clave correcta y revisar claims como exp, aud e iss.
¿Puedo pegar aquí un token de producción?
La herramienta funciona en tu navegador y no envía el token a Ontoom, pero lo prudente es no pegar tokens ni secretos reales en ninguna web. Usa tokens de prueba o de staging.
¿Por qué no se verificó la firma?
O el token usa un algoritmo distinto de HS256, como RS256, o no indicaste el secreto. La verificación aquí cubre solo HMAC-SHA256.
¿Qué significa el aviso de token expirado?
El claim exp es anterior a la hora de tu ordenador. Revisa también que tu reloj esté bien, porque unos minutos de desfase bastan para que aparezca.
¿Un JWT está cifrado?
Un JWT firmado (JWS), el tipo habitual, no. Los JWE sí están cifrados, pero tienen cinco partes y esta herramienta no los procesa.

Escrito por Orlando Alves · revisado el · Política editorial

Ver también