06 - Login con JWT

El login con JWT mantiene la idea del par de tokens: un token de acceso de vida corta y un refresh token de vida larga. La diferencia está en el token de acceso: es autocontenido y verificable sin conservar estado en el servidor.

Se asume conocido el flujo con tokens opacos: par acceso/refresh, rotación, Principal y filtro Servlet que deja la identidad en el contexto de la petición.

Un token opaco es una cadena aleatoria sin significado para el cliente; el servidor lo valida consultando su estado. Un JWT es un token con contenido firmado: el servidor lo valida comprobando la firma y la caducidad, sin consultar la base de datos.

Aspecto Token opaco JWT de acceso
Contenido Aleatorio, sin datos legibles Identidad y claims firmados
Validación Búsqueda en el almacén de tokens Verificación de firma, emisor y caducidad
Estado en servidor Necesario para cada petición No necesario para autenticar
Revocación Revocable marcando su estado No revocable sin estado adicional
Tamaño Corto Más largo, viaja en cada petición
El carácter stateless se refiere solo a la autenticación con el JWT de acceso. El refresh token sigue siendo opaco y stateful: se almacena su hash, su caducidad y su estado de revocación o rotación.

Un JWT tiene tres partes unidas por puntos: cabecera, carga útil y firma. Cada parte se codifica en Base64URL:

Partes de un JWT: cabecera, carga útil y firma codificadas en Base64URL; flechas hacia sus ejemplos y explicación.

La cabecera contiene metadatos sobre el token y su firma:

Campo Presencia Función
alg Obligatorio en un JWS firmado Algoritmo usado para firmar y verificar, por ejemplo HS256
typ Opcional Tipo de contenido; en este caso, JWT
JOSE (JavaScript Object Signing and Encryption) es el conjunto de estándares que define cómo firmar o cifrar objetos JSON y cómo representar claves. Además de typ, la cabecera puede incluir parámetros opcionales como kid (identificador de la clave), cty (tipo del contenido, por ejemplo un JWT anidado) y crit (parámetros críticos que el receptor debe entender).

La carga útil contiene los claims: afirmaciones sobre el usuario o el propio token.

Claim Significado
iss Emisor esperado del token
sub Sujeto, normalmente el id del usuario
roles Roles necesarios para autorizar, por ejemplo ROLE_USER
iat Momento de emisión
exp Momento de caducidad

La firma no es un objeto JSON ni tiene campos: es el tercer segmento del token y permite comprobar que la cabecera y la carga no se han modificado.

Elemento Qué representa
Entrada firmada Los segmentos codificados de cabecera y carga, unidos por un punto: cabecera64.carga64
Clave en HS256 Secreto compartido por quien firma y quien verifica; no forma parte del JWT
Segmento de firma Resultado de HMAC-SHA256 codificado en Base64URL
La carga útil va solo firmada, no cifrada. Cualquiera puede decodificar el Base64 y leerla. No incluir contraseñas, datos personales sensibles ni información interna en los claims.

Al iniciar sesión, el servidor valida las credenciales y emite un par con naturalezas distintas:

Token Naturaleza Vida típica
Acceso JWT Autocontenido y firmado Corta, de 5 a 15 minutos
Refresh token Opaco, aleatorio, almacenado como hash Larga, días o semanas

ClienteServidorAlmac.n de refreshClienteServidorAlmacén de refreshClienteServidorAlmacén de refreshcredencialesautentica y firma JWTregistra hash del refreshJWT de acceso + refresh opaco

La generación firma los claims con el emisor, el sujeto, los roles y las fechas de emisión y caducidad:

String generateAccessToken(User user, Instant issuedAt, Instant expiresAt) {
    return Jwts.builder()
            .issuer(issuer)
            .subject(user.id().toString())
            .claim("roles", user.roles().stream().sorted().toList())
            .issuedAt(Date.from(issuedAt))
            .expiration(Date.from(expiresAt))
            .signWith(secretKey)
            .compact();
}

El refresh token se genera con un generador criptográficamente seguro y se almacena su hash, nunca el valor reutilizable ni en logs. Su rotación y la detección de reuso siguen las mismas reglas que con tokens opacos.

En cada petición protegida, el filtro extrae el JWT de la cabecera Authorization con el esquema Bearer, verifica firma, emisor y caducidad, y construye el Principal solo con los claims. No consulta la base de datos:

ClienteFiltroServidorClienteFiltroServidorClienteFiltroServidorpetición + Bearer JWTverifica firma, emisor y caducidadcontinúa con Principal de los claimsautoriza la operaciónresultado o acceso denegado

Optional<AuthenticatedPrincipal> parseAccessToken(String token) {
    try {
        Claims claims = Jwts.parser()
                .verifyWith(secretKey)
                .requireIssuer(issuer)
                .build()
                .parseSignedClaims(token)
                .getPayload();
        return Optional.of(new AuthenticatedPrincipal(
                Long.valueOf(claims.getSubject()), extractRoles(claims)));
    } catch (JwtException | IllegalArgumentException exception) {
        return Optional.empty();
    }
}

La autenticación delega en ese parseado. Si el token falta, está mal formado, tiene otra firma, otro emisor o ha caducado, no hay identidad autenticada:

Optional<AuthenticatedPrincipal> authenticate(String accessToken) {
    if (accessToken == null || accessToken.isBlank()) {
        return Optional.empty();
    }
    return parseAccessToken(accessToken);
}

El filtro deja el resultado en el contexto de la petición y lo limpia al finalizar, como en el filtro de tokens opacos. Las rutas públicas continúan sin Principal. Los roles usados para autorizar son los congelados en el claim roles. Si una operación necesita datos actuales —perfil completo, habilitación o permisos—, esa lectura es una consulta aparte a la BBDD.

Antes de aceptar un token, el servidor debe comprobar que la firma es válida con la clave y el algoritmo esperados, que iss coincide con el emisor de confianza y que exp no ha pasado. No basta con leer alg del token y confiar en él. Un token con alg: none no lleva firma: si se aceptara, cualquiera podría cambiar claims como sub o roles y el servidor no detectaría la modificación.

Como el filtro no consulta la base de datos, todo cambio posterior a la emisión queda invisible hasta que el token caduca:

Problema Por qué ocurre Mitigación
Roles modificados Los roles quedan congelados en el token - TTL corto (5-15 min).
- Consultar la BBDD en operaciones críticas
Usuario deshabilitado o eliminado El JWT anterior sigue aceptado hasta exp - TTL corto.
- El refresh sí es revocable y cierra la sesión futura
Token robado No hay revocación sin guardar estado - TTL corto.
- Rotar el refresh ante sospecha.
- Denylist solo si se acepta perder stateless
Datos sensibles en claims La carga es legible por cualquiera - Incluir solo id y roles.
- Nunca secretos ni datos personales
Secreto comprometido o rotado La misma clave verifica todos los tokens - Clave de al menos 256 bits externalizada.
- Rotación planificada
Relojes desincronizados iat y exp dependen de la hora - Margen de tolerancia pequeño.
- Sincronización entre servidores
Un JWT puro no permite expulsar de inmediato ni degradar permisos: solo cabe esperar a que caduque. Por eso el acceso debe durar minutos y la revocación real vive en el refresh token opaco.
Una denylist es un registro de tokens revocados —normalmente sus identificadores— que el servidor consulta en cada petición hasta que caducan (exp) y después puede purgar. Restaura la revocación inmediata a cambio de volver a guardar y consultar estado en la ruta crítica. Solo compensa en incidentes puntuales, no como diseño permanente de un flujo stateless.
Usar JWT no significa dejar de consultar la BBDD. El token evita buscar una sesión en cada petición, pero se sigue consultando cuando hace falta conocer el estado actual del usuario o sus permisos.
Al probar este flujo, comprueba que se acepta un token válido y se rechazan firma, iss o exp incorrectos; que el filtro publica y limpia el Principal; y que el refresh se rota y detecta su reutilización. Los cambios posteriores a la emisión son un límite documentado del JWT de acceso.
  • clase/daw/dws/jwt.txt
  • Última modificación: 2026/11/08 11:15
  • por cesguiro