Funciones avanzadas

Esta guía explica las funciones avanzadas y las capacidades del JWT Parser para usuarios avanzados y desarrolladores.

Gestión del historial

Seguimiento automático del historial

La herramienta guarda automáticamente los tokens analizados en el almacenamiento local del navegador:

• Almacenamiento persistente: el historial permanece incluso después de reiniciar el navegador
• Privacidad primero: los datos solo permanecen en su navegador
• Limpieza automática: se limita a los 50 tokens más recientes

Operaciones del historial

• Cargar desde el historial: haga clic en cualquier elemento para volver a cargar ese token
• Borrar historial: elimine todos los tokens almacenados de una vez
• Carga selectiva: elija tokens específicos para analizarlos de nuevo

Información del historial

Cada entrada del historial muestra:

• Algoritmo: el algoritmo de firma utilizado
• Expiración: cuándo expira el token
• Marca de tiempo: cuándo se analizó el token
• Vista previa del token: los primeros 50 caracteres

Funciones de análisis de tokens

Detección de algoritmos

La herramienta identifica y muestra automáticamente:

• Algoritmos simétricos: HS256, HS384, HS512
• Algoritmos asimétricos: RS256, RS384, RS512, ES256, ES384, ES512
• Algoritmo none: tokens no protegidos (solo para desarrollo)

Análisis de expiración

• Hora de expiración: convierte la marca de tiempo Unix en una fecha y hora legibles
• Zona horaria: muestra los valores en su zona horaria local
• Tokens expirados: indica claramente si el token ya expiró

Análisis de claims

• Claims estándar: identifica automáticamente los claims estándar de RFC 7519
• Claims personalizados: muestra claims específicos de la aplicación
• Objetos anidados: maneja estructuras de payload complejas

Funciones de copia y exportación

Copia estructurada

Cuando copia los resultados, obtiene una salida estructurada como esta:

Header:
{
  "alg": "HS256",
  "typ": "JWT"
}

Payload:
{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

Signature:
SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Casos de uso al copiar

• Documentación: incluirlo en la documentación de la API
• Depuración: compartir el análisis con miembros del equipo
• Pruebas: usarlo en escenarios de pruebas automatizadas
• Informes: incorporarlo en informes de auditoría de seguridad

Manejo de errores y validación

Validación de formato

La herramienta realiza comprobaciones completas de formato:

• Validación de estructura: garantiza exactamente 3 partes separadas por puntos
• Validación Base64URL: verifica que cada parte sea un base64url válido
• Validación JSON: asegura que el header y el payload sean JSON válidos

Mensajes de error

Se proporcionan mensajes claros y accionables:

• Formato no válido: orientación específica sobre la estructura del JWT
• Errores de análisis: detalles sobre los fallos al analizar
• Problemas de codificación: ayuda para resolver errores de base64url

Patrones de integración

Integración en el flujo de desarrollo

1. Pruebas de API: analizar tokens provenientes de respuestas de API
2. Depuración de autenticación: analizar tokens durante el desarrollo
3. Revisión de código: verificar la estructura del token en pull requests
4. Documentación: generar ejemplos para la documentación de la API

Integración en pruebas

• Pruebas unitarias: usar datos analizados en las aserciones
• Pruebas de integración: verificar la estructura del token en escenarios de prueba
• Pruebas de seguridad: analizar tokens en busca de posibles riesgos

Consideraciones de rendimiento

Procesamiento del lado del cliente

• Sin llamadas de red: todo el análisis ocurre en el navegador
• Procesamiento rápido: resultados inmediatos para la mayoría de los tokens
• Uso eficiente de memoria: consumo mínimo de memoria
• Capacidad sin conexión: funciona sin conexión a Internet

Manejo de tokens grandes

• Límites de tamaño: maneja tokens hasta el límite de memoria del navegador
• Rendimiento: optimizado para tamaños típicos de JWT
• Manejo de errores: trata de forma estable los tokens demasiado grandes

Compatibilidad de navegadores

Navegadores compatibles

• Chrome: compatibilidad completa (recomendado)
• Firefox: compatibilidad completa
• Safari: compatibilidad completa
• Edge: compatibilidad completa

Funciones requeridas

• Local Storage: para la función de historial
• Clipboard API: para la función de copia
• JSON Parsing: para el análisis de tokens

Buenas prácticas de seguridad

Manejo de tokens

• Nunca registre tokens: evite escribir tokens sensibles en logs
• Entorno seguro: úselo solo en entornos seguros y privados
• Limpieza regular: borre el historial con frecuencia
• Control de acceso: asegúrese de que solo usuarios autorizados accedan a la herramienta

Privacidad de los datos

• Solo almacenamiento local: no se envían datos a servidores externos
• Aislamiento del navegador: los datos permanecen en su navegador
• Limpieza por cambio de contexto: elimine los datos al cambiar de contexto

Solución de problemas

Problemas comunes

1. El token no se analiza: revise el formato y la codificación
2. El historial no se guarda: verifique que el navegador admita almacenamiento local
3. La copia no funciona: compruebe los permisos del portapapeles
4. Problemas de visualización: pruebe a recargar la página

Consejos de depuración

• Revise la consola: busque errores de JavaScript
• Verifique el formato: asegúrese de que la estructura del token sea correcta
• Pruebe con ejemplos: use el token de ejemplo integrado
• Limpie la caché: vacíe la caché del navegador si es necesario

Referencia de API

Estructura del token

interface ParsedJWT {
  header: string; // Cadena JSON con formato
  payload: string; // Cadena JSON con formato
  signature: string; // Firma sin procesar
}

interface JWTInfo {
  algorithm: string; // Algoritmo de firma
  type: string; // Tipo de token
  expires: string; // Hora de expiración
}

Estructura del historial

interface HistoryRecord {
  id: string; // Identificador único
  token: string; // Token JWT completo
  algorithm: string; // Algoritmo de firma
  expires: string; // Hora de expiración
  timestamp: number; // Momento del análisis
}

Siguientes pasos

Consulte Consideraciones de seguridad para conocer pautas importantes, o revise los Ejemplos para ver escenarios reales de uso.