Uso Básico

Esta guía le mostrará los pasos fundamentales para usar la herramienta JWT Parser y analizar JSON Web Tokens.

Paso 1: Acceder a la herramienta

Vaya a la herramienta JWT Parser desde la página principal de herramientas o acceda directamente mediante la URL /jwt-parser.

Paso 2: Introducir su token JWT

Método 1: Entrada manual

1. Haga clic en el área de texto "JWT Token"
2. Pegue o escriba su token JWT
3. La herramienta analizará el token automáticamente mientras escribe

Método 2: Cargar ejemplo

1. Haga clic en el botón "Load Example"
2. Se cargará automáticamente un token JWT de ejemplo
3. Esto es útil para hacer pruebas y aprender cómo funciona la herramienta

Paso 3: Revisar los resultados analizados

Una vez que introduzca un token JWT válido, verá tres secciones principales:

Información del encabezado

• Algoritmo: El algoritmo de firma utilizado (por ejemplo, HS256, RS256)
• Tipo: Tipo de token (normalmente "JWT")
• Claims adicionales: Cualquier otro claim del encabezado

Datos del payload

• Claims estándar: iss, sub, aud, exp, nbf, iat, jti
• Claims personalizados: Cualquier dato específico de la aplicación
• Expiración: Cuándo expira el token (si se especifica)

Firma

• Firma sin procesar: La firma codificada en base64url
• Nota de verificación: Recordatorio de que esta herramienta no valida firmas

Paso 4: Usar funciones adicionales

Copiar resultados

1. Haga clic en el botón "Copy Result"
2. La información analizada se copiará a su portapapeles
3. Péguela en su editor de texto o documentación preferidos

Limpiar contenido

1. Haga clic en "Clear All" para eliminar todo el contenido
2. Empiece de nuevo con un token nuevo

Ver historial

• Los tokens analizados anteriormente aparecen en la sección de historial
• Haga clic en cualquier elemento del historial para volver a cargar ese token
• Use "Clear History" para eliminar todos los tokens almacenados

Comprender la salida

Ejemplo de encabezado

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

Ejemplo de payload

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

Explicación de claims comunes

• sub (Subject): El sujeto del token
• iat (Issued At): Cuándo se emitió el token
• exp (Expiration): Cuándo expira el token
• aud (Audience): Destinatario previsto del token
• iss (Issuer): Quién emitió el token

Manejo de errores

Formato no válido

Si introduce un formato JWT no válido, verá este mensaje de error:

• "Invalid JWT format. JWT should have 3 parts separated by dots."

Errores de análisis

Si el token no se puede analizar, verá:

• "Failed to parse JWT token"

Problemas comunes

• Faltan puntos: El JWT debe tener exactamente 2 puntos que separen 3 partes
• base64 no válido: Cada parte debe ser una codificación base64url válida
• JSON mal formado: El encabezado y el payload deben ser JSON válidos

Buenas prácticas

Seguridad

• Use esta herramienta solo con tokens de prueba o tokens que le pertenezcan
• Nunca comparta tokens sensibles de producción
• Úsela únicamente en entornos seguros y privados

Flujo de trabajo de desarrollo

1. Genere tokens de prueba en su entorno de desarrollo
2. Analícelos para verificar la estructura y los claims
3. Use los resultados para depurar problemas de autenticación
4. Limpie el historial al cambiar de proyecto

Gestión de tokens

• Mantenga un registro de los tokens de prueba importantes
• Use la función de historial para los tokens que analiza con frecuencia
• Limpie el historial regularmente para mantener la privacidad

Siguientes pasos

Ahora que comprende lo básico, explore las funciones avanzadas para aprender patrones de uso más sofisticados y consulte las consideraciones de seguridad para manejar tokens de forma segura.