2026-10-13 · 4 min DE LECTURA

Qué es un JWT y cómo leerlo

Lee el encabezado y los campos de un JWT de prueba y comprende por qué el aviso de firma sin verificar limita lo que puedes concluir.

Por Othmane Annane · Actualizado el · Probar Decodificador JWT

Leer un token JWT. Cabecera y contenido → Firma sin verificar.

Qué significa «la firma no se ha verificado»

Al leer un token de demostración, compara el aviso final con las fechas y los nombres que se muestran. Se pueden leer campos de un JWT firmado sin demostrar quién lo emitió o si sigue vigente. Para documentar la estructura a un compañero, utiliza datos ficticios y evita compartir un token de sesión real.

Un JWT no es un mensaje cifrado por defecto

Un JSON Web Token suele aparecer como tres partes separadas por puntos. La primera describe el header, la segunda contiene el payload y la tercera representa la firma. Las dos primeras pueden codificarse en Base64URL, un formato de representación que no equivale a cifrado.

El Decodificador JWT de Nítido Tools sirve para leer un token de prueba o inspeccionar un valor que estás autorizado a revisar. Muestra header y payload como JSON y avisa expresamente de que no verifica la firma.

Cómo leer un token

Pega el token completo, incluidos sus tres bloques, y pulsa Procesar. Si el header o el payload no contienen JSON válido, la herramienta muestra un error. No elimines puntos ni añadas espacios dentro de las partes.

Un token de ejemplo puede revelar typ: JWT, un algoritmo y un campo sub. Eso solo te permite entender qué datos transporta. No demuestra que el servidor lo haya firmado, que no haya expirado o que el usuario tenga permisos.

La diferencia entre decodificar y verificar

Decodificar convierte una representación en texto legible. Verificar requiere comprobar la firma con la clave y el algoritmo correctos, además de revisar expiración, emisor, audiencia y las reglas de la aplicación. El navegador no puede inventar esas condiciones.

Por eso la herramienta muestra el aviso de firma no verificada. No utilices un payload visible como autorización para una acción. La decisión de seguridad debe pertenecer al servidor y a la biblioteca que controla la identidad.

Ejemplo de depuración

Si una API devuelve un error porque el usuario no tiene un rol esperado, puedes inspeccionar un token de prueba para ver si el campo role aparece. Esa observación orienta la depuración, pero debes revisar también cómo el backend valida ese campo.

Nunca pegues un token real de producción en una página que no controles. Para documentar un problema, genera un ejemplo sin datos personales y reemplaza identificadores por valores ficticios.

Errores y límites

La entrada debe tener exactamente tres partes. La herramienta no valida la firma, la expiración, el issuer, el audience ni el algoritmo. Tampoco descifra payloads cifrados ni interpreta permisos. Si el token usa una estructura distinta, la salida no debe considerarse fiable.

Un error de JSON puede proceder de un token truncado, de una codificación incorrecta o de una entrada que no sea JWT. Guarda el mensaje de error y vuelve a la fuente autorizada en lugar de intentar reparar el token manualmente.

Privacidad y uso responsable

El decodificado funciona localmente mediante Base64URL y TextDecoder. Eso evita una subida necesaria del token, pero no elimina el riesgo de que el equipo, el historial o la pantalla expongan información sensible.

Después de la lectura, cierra la página o limpia el campo si trabajas en un equipo compartido. Para autenticar, autorizar o aceptar una operación, usa siempre el sistema de seguridad que emitió el token.

Los campos iat y exp pueden ayudar a orientarte durante una depuración, pero la herramienta no convierte automáticamente sus números en fechas ni decide si están dentro de plazo. Interpreta esos datos según la documentación del emisor y nunca uses una lectura local para conceder acceso.

La lectura local también permite explicar un incidente sin entregar el token a un servicio de terceros, pero no elimina la obligación de proteger la pantalla y el historial del dispositivo. Sustituye correos, identificadores y valores reales por datos de prueba cuando redactes una incidencia o un tutorial.

La regla práctica es sencilla: usa el decodificador para entender una estructura, no para decidir si una identidad es auténtica. Esa separación evita convertir una herramienta de inspección en una falsa garantía de seguridad.

Preguntas frecuentes

¿Verifica la firma?

No. Solo decodifica header y payload y muestra un aviso de firma no verificada.

¿Base64URL es cifrado?

No. Es una codificación que puede revertirse si se dispone de la parte correspondiente.

¿Puedo confiar en el payload?

No. La legibilidad no demuestra autenticidad ni vigencia.

¿Qué token debo usar?

Uno de prueba o uno real que estés autorizado a inspeccionar, nunca un secreto ajeno.

También puede interesarte

Codificador Base64

Qué es Base64 y para qué sirve

Fuentes técnicas

RFC 7519 · JSON Web Token y campos registrados

Ir a Decodificador JWT