Código

Guía del decodificador JWT: claims, fechas y resultados sin verificar

·

El decodificador JWT abre la cabecera y carga útil legibles de un token compacto de tres partes en tu navegador. Pega un ejemplo público o datos sintéticos, elige “Decodificar token” y examina JSON, algoritmo declarado, presencia de firma y campos numéricos de tiempo. “Copiar carga útil” copia lo mostrado cuando lo eliges deliberadamente.

Leer el token revela lo que dice su texto. Este espacio no verifica firmas, descifra tokens de cinco partes ni decide si una aplicación debe confiar en los claims. Las fechas usan el reloj del dispositivo; editar la entrada conserva el resultado anterior hasta otra decodificación. Estas diferencias importan al investigar autenticación.

Decodificador JWT

Empieza con un ejemplo público y decodifica explícitamente

El espacio empieza vacío. “Decodificar token” está desactivado con entrada vacía o solo espacios. “Probar un ejemplo” inserta y decodifica la muestra pública; aparecen cabecera HS256, carga útil John Doe e iat. Es demostración, no una credencial que debas desplegar en una cuenta.

Para una prueba controlada, pega el token compacto completo y pulsa “Decodificar token”. Lee la advertencia y revisa Cabecera y Carga útil. Ambas salidas son de solo lectura y de izquierda a derecha, también en páginas RTL. Editar no decodifica automáticamente.

  • Usa la muestra pública o datos sintéticos sin claims privados.
  • Pega el token, decodifica y confirma que la carga mostrada coincide con la entrada prevista.
  • Investiga estructura y tiempo; autentica en la aplicación que acepta el token.

Tres partes describen la entrada de este decodificador

Se espera header.payload.signature con exactamente dos puntos. Se recortan espacios externos y se elimina un prefijo inicial Bearer, sin distinguir mayúsculas, seguido de espacio en blanco. No se interpreta una línea Authorization: completa ni se quitan etiquetas, comillas o espacios internos arbitrarios. Mantén intacto el token.

Cabecera y carga útil deben decodificarse cada una como objeto JSON. El tercer segmento puede estar vacío. Cinco partes producen un mensaje de formato no admitido; esa cantidad no prueba un token cifrado válido. JWT incluye representaciones JWS y JWE, mientras esta herramienta ofrece una inspección más limitada de tres partes legibles.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónIETF RFC 7515: serialización JWS, Base64URL y validaciónIETF RFC 7516: serialización compacta JWE de cinco componentes

Base64URL, UTF-8 y JSON son comprobaciones separadas

Cabecera y carga útil aceptan Base64URL sin relleno: letras, cifras, - y _. Se rechazan un = final, caracteres ajenos y longitudes cuyo resto al dividir por 4 sea 1. Los bytes deben ser UTF-8 válido y el texto JSON válido. Esas comprobaciones no autentican el token.

Cada valor JSON decodificado debe ser objeto, no array, null, cadena o número. Un JWS genérico admite otros tipos de carga; aquí no todos se soportan. La decodificación UTF-8 estricta comprueba bytes, no garantiza que cada escape JSON sea un valor escalar Unicode. Un escape ASCII como \ud800 puede parsearse y seguir visible como escape.

IETF RFC 7515: serialización JWS, Base64URL y validaciónMDN: TextDecoder.decode y errores de decodificación estrictaMDN: JSON.parse y precisión numérica

Algoritmo y presencia de firma son datos no verificados

Algoritmo muestra la cadena de alg en la cabecera; ausente, vacía o de otro tipo da “No indicado”. HS256, RS256 o none son afirmaciones del propio token. No hay entrada de claves, lista de algoritmos permitidos, vínculo emisor-clave, verificación criptográfica ni aplicación de política de cabeceras críticas.

“Presente, sin verificar” solo indica tercer segmento no vacío con alfabeto permitido. No se decodifica ni se comprueban longitud, clave o datos de firma. Incluso un único carácter puede aparecer presente. “Ninguna” significa tercer segmento vacío, no que una aplicación deba admitir un token sin protección.

IETF RFC 7515: serialización JWS, Base64URL y validaciónIETF RFC 8725: algoritmos JWT, emisor y audiencia

Las firmas vacías y formas cifradas necesitan contexto

RFC 7519 describe un JWT sin protección con alg igual a none y firma vacía. El decodificador admite el tercer segmento vacío independientemente del algoritmo declarado. No verifica conformidad de esa combinación ni idoneidad para la aplicación. Un resultado legible no establece un tipo de token aceptable.

La serialización compacta JWE tiene cinco componentes y aquí se rechaza, sin claves ni operación de descifrado. Tampoco se admite serialización JSON JWS, flujos con carga separada ni validación de tokens anidados. Siempre se decodifica la carga en Base64URL; la extensión JWS b64:false queda fuera de ese flujo y está prohibida en perfiles JWT.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónIETF RFC 7516: serialización compacta JWE de cinco componentesIETF RFC 7797: carga JWS sin codificar y restricciones JWT

JSON formateado es una vista de lectura

El formateador añade sangría, conservando literales numéricos y nombres duplicados en el texto. Por ejemplo, 1e3 sigue como 1e3, no se reescribe a 1000. Ayuda a revisar notación, pero el JSON formateado no es la entrada codificada original de la firma y no debe sustituirla al verificar.

Los datos resumidos usan JSON.parse de JavaScript: números convertidos a Number y última aparición de nombres duplicados. Una carga con "exp": 0 seguida de "exp": 1e100 muestra ambos campos, pero el diagnóstico usa el último valor parseado. Números grandes pueden perder precisión interpretada aunque el literal visible siga exacto. Los avisos del formateador no se muestran aquí.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónIETF RFC 7515: serialización JWS, Base64URL y validaciónMDN: JSON.parse y precisión numérica

Las filas de tiempo usan segundos numéricos finitos

NumericDate JWT usa segundos desde la época Unix, con fracciones permitidas. Se recogen iat, nbf y exp numéricos finitos, en ese orden, y se multiplican por 1000 para mostrar fechas. Una cadena numérica como "1516239022" no crea fila temporal. Tampoco un valor no finito, aunque el texto original permanezca en la carga.

No pongas milisegundos en un claim que espera segundos. Un valor alrededor de 1516239022000 segundos representa una fecha muy distinta de 1516239022 segundos. El decodificador no adivina otra unidad por la longitud, modifica el claim ni verifica requisitos de aplicación.

Las filas de tiempo usan segundos numéricos finitos
ClaimTema estándarVisualización aquí
iatEmisiónFecha local para número finito; sin etiqueta de política de edad.
nbfNo antes deFecha local; Aún no es válido mientras supere el reloj del dispositivo.
expCaducidadFecha local; Caducado cuando su valor es menor o igual al reloj del dispositivo; de lo contrario, Aún no ha caducado.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónMDN: JSON.parse y precisión numérica

Las fechas locales y etiquetas del reloj tienen límites

Las fechas usan idioma de página y zona horaria del navegador; pueden diferir entre dispositivos para el mismo claim. “Caducado” y “Aún no es válido” comparan el reloj local sin tolerancia de desfase, firma o política de emisor/audiencia. No hay cuenta atrás continua; volver a renderizar puede recalcular las etiquetas.

Un número finito puede superar el rango Date, incluso al desbordarse segundos por 1000. La carga formateada sigue legible y esa fila muestra “El valor de tiempo está fuera del intervalo de fechas admitido.” sin etiqueta temporal. Es un límite de visualización, no una decisión fiable de validez.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónMDN: Date de JavaScript y rango admitidoMDN: Intl.DateTimeFormat, idioma y zona predeterminada

Usa decodificar como un paso de diagnóstico

Un token legible puede estar falsificado, alterado, dirigido a otra audiencia, emitido por alguien inesperado o rechazado por política. iss, aud y sub se muestran, pero no se comprueban. Tampoco se solicitan claves nombradas en cabeceras ni se valida typ.

La aplicación receptora necesita comprobaciones de su perfil: algoritmo permitido, criptografía con clave confiable y reglas pertinentes de emisor, audiencia y tiempo. Compara esos resultados reales con el texto. Parseo correcto, algoritmo declarado o “Aún no ha caducado” no son una decisión de autorización.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónIETF RFC 8725: algoritmos JWT, emisor y audiencia

Entrada editada y salida visible pueden ser distintas

Editar Token limpia avisos, pero mantiene resultado o error hasta otra acción “Decodificar token”. Pegar otro token y pulsar enseguida “Copiar carga útil” copia la salida anterior. Comprueba que el resultado corresponde a la entrada prevista antes de copiar o concluir.

Decodificar es asíncrono al cargar el formateador. Si se solapan acciones, solo la última puede entregar resultado o error. Vaciar habilitado invalida esas entregas; una operación anterior no restaura la carga borrada. Esto no detiene todo cálculo ni limpia memoria de forma segura; editar texto no inicia otra decodificación.

Vaciar limpia el espacio cuando está disponible

Vaciar quita entrada, resultado y error y muestra “Token borrado.”. Se habilita si hay entrada no vacía o resultado. Tras un error, vaciar manualmente la entrada deja un error que por sí solo no habilita el botón. Prueba el ejemplo o un nuevo fixture no vacío y decodifica para sustituirlo.

Recargar empieza vacío. Ni Vaciar ni recargar borran texto ya copiado al portapapeles o a otra aplicación. Retirar el estado visible no borra memoria de forma segura, revoca credenciales ni elimina copias externas.

La decodificación local y la copia tienen límites distintos

La operación lee el token en el navegador sin petición que lo contenga ni almacén persistente. El alojamiento, análisis y carga de código generales son distintos. Las expresiones históricas de decodificador online describen una página disponible, no que el token se suba a un servicio de validación.

Un token real puede contener credenciales y claims privados aun caducado. Base64URL es codificación, no cifrado; la fecha de caducidad no borra la carga. Prefiere muestra pública o datos sintéticos para demostraciones y problemas compartidos. No incluyas tokens privados en capturas, incidencias o ejemplos copiados.

IETF RFC 7519: claims JWT, NumericDate y formas sin protecciónIETF RFC 8725: algoritmos JWT, emisor y audiencia

Copiar carga útil copia el JSON visible formateado

“Copiar carga útil” escribe toda la carga visible formateada en el portapapeles y confirma el éxito. No copia el token compacto original ni la cabecera. La aplicación receptora obtiene otra copia; revisa destino y claims incluidos.

Si falla Clipboard, se indica que selecciones la carga para copiarla. La salida de solo lectura admite selección manual. No hay descarga, exportación de token, historial guardado o envío automático a otra herramienta. El aviso no verifica firmas ni borra después el portapapeles.

MDN: Clipboard.writeText y fallos de escritura

Tamaño de entrada y profundidad JSON son límites separados

Token limita la entrada a 100000 unidades de código UTF-16. Es un límite del control, no máximo JWT, permiso para cabeceras de red ni garantía de aceptación de otros servicios. Base64URL suele ser ASCII, pero el texto externo pegado sigue sujeto a las unidades del campo.

El formateo JSON admite profundidad 256. Una cabecera o carga más anidada puede parsearse y fallar luego en el formateador. No hay archivos, streaming, lotes ni ajuste de profundidad. Acorta datos sintéticos o usa un flujo adecuado; no atribuyas cualquier fallo a una firma incorrecta.

MDN: maxlength y unidades UTF-16 de entrada

Revisa la capa que indica el error

Cuenta las partes y revisa el error de cabecera, carga o firma. Base64URL, UTF-8, gramática JSON y forma de objeto son fases distintas. Un parseo correcto borra el error anterior; una decodificación fallida elimina la salida anterior y muestra el error actual.

El rechazo por la aplicación es distinto de un error del decodificador. Mantén el original en el entorno controlado de la aplicación y consulta sus registros de validación y política. Esta página no determina si son correctos clave, audiencia, emisor, revocación o autorización.

Revisa la capa que indica el error
SíntomaComprobaciónSiguiente paso
Cantidad incorrecta de partesForma compacta y texto externo pegadoUsa un fixture completo de tres partes; JWE compacto de cinco no se admite.
Error Base64URL o UTF-8Segmento codificado señaladoRevisa alfabeto sin relleno, bytes intactos y espacios accidentales.
Error JSON/objeto/profundidadContenido decodificado y anidamientoUsa objetos JSON en ambos segmentos legibles dentro del límite.
Token legible rechazado por la aplicaciónVerificador y política realesRevisa allí clave confiable, algoritmo, emisor, audiencia y comprobaciones temporales.

IETF RFC 7515: serialización JWS, Base64URL y validaciónIETF RFC 8725: algoritmos JWT, emisor y audienciaMDN: TextDecoder.decode y errores de decodificación estricta

El codificador y decodificador Base64 ayuda con segmentos individuales si eliges alfabeto e interpretación de bytes adecuados. JWT ya realiza sus propias comprobaciones Base64URL y UTF-8. Decodificar fuera no valida firmas ni establece aceptación del token completo.

El formateador JSON permite examinar objetos públicos o sintéticos por separado; el conversor de timestamps compara unidades y fechas. Son flujos independientes, sin entrega automática del token o claims. Mantén credenciales privadas fuera de ejemplos compartidos y verifica autenticación en la aplicación receptora.

Preguntas frecuentes

¿Verifica la firma JWT?

No. Lee cabecera y carga, muestra algoritmo declarado y señala tercer segmento no vacío. No hay claves, verificación criptográfica ni decisión de aceptación.

¿Presente, sin verificar significa firma válida?

Solo texto no vacío con el alfabeto permitido. No se decodifica ni se valida criptografía, longitud o coherencia con el algoritmo.

¿Puedo leer un token sin firma?

Se admite tercer segmento vacío si cabecera y carga pasan las comprobaciones de objeto legible. RFC 7519 usa alg igual a none sin protección; aquí no se exige esa combinación ni se decide si aceptarla.

¿Por qué rechaza cinco partes?

Corresponden a la forma compacta JWE no soportada. No hay descifrado o claves; la cantidad no demuestra datos cifrados válidos.

¿Puedo pegar un token Bearer?

Sí. Se recorta espacio externo y un prefijo inicial Bearer seguido de espacio sin distinguir mayúsculas. Una línea Authorization: completa o más envoltorios no se interpretan como cabecera HTTP.

¿exp, nbf e iat son segundos o milisegundos?

NumericDate usa segundos desde época Unix y permite fracciones. Se multiplican números finitos por 1000 para fechas del navegador; no se adivinan unidades ni se convierten cadenas numéricas.

¿Por qué no hay fila para un claim que parece número?

Un número entre comillas es cadena; se omiten valores parseados no finitos. El texto sigue visible. Números finitos fuera de Date tienen diagnóstico sin etiqueta temporal.

¿Aún no ha caducado significa que se acepta?

No. Compara el valor con el reloj del dispositivo. No hay cuenta atrás, firma, política de desfase, validación de emisor/audiencia o autorización.

¿Por qué hay claims duplicados pero solo una fecha?

La vista conserva campos repetidos; JavaScript usa la última aparición para los datos y la fecha. La aplicación necesita sus reglas de parseo y validación.

¿Por qué una entrada editada muestra el resultado o error antiguo?

Editar no es Decodificar token. Se conserva el estado hasta otra acción. Copiar carga útil usa la salida visible, que puede ser de una entrada anterior.

¿Qué pasa al vaciar durante la decodificación?

Si está habilitado, Vaciar limpia el espacio e invalida entregas pendientes; no vuelven resultados o errores anteriores por esa vía. No cancela todo cálculo, borra el portapapeles ni limpia memoria de forma segura.

¿Es seguro compartir un token caducado?

Caducar no cifra ni borra claims privados y puede seguir siendo sensible. Usa muestra pública o datos sintéticos al compartir demostraciones e incidencias.

¿Qué copia Copiar carga útil?

Todo el JSON visible formateado, sin cabecera ni token original. Si Clipboard falla, se ofrece seleccionar manualmente. Vaciar no borra copias externas.

¿Qué tamaño o profundidad se admite?

Entrada de usuario hasta 100000 unidades UTF-16 y formateo hasta 256 niveles. No son límites universales JWT, HTTP o de aplicaciones receptoras. No hay lotes ni archivos.

Fuentes y lecturas recomendadas

Ponlo en práctica.

Guías relacionadas