# JWT

> Un pase firmado y autocontenido que le dice al servidor quién sos y qué podés hacer.

- Nivel: Avanzado
- Temas: Seguridad, Software
- URL: https://tidbit.legios.com.ar/es/jwt/
- En inglés: [JWT](https://tidbit.legios.com.ar/jwt/)

Un **JWT** (JSON Web Token, que muchos pronuncian "yot") es un texto compacto que lleva algunos datos sobre un usuario, llamados claims, más una firma criptográfica. Tiene tres partes separadas por puntos: un header que dice con qué algoritmo se firmó, un payload con los claims (por ejemplo `sub` para el id del usuario y `exp` para el vencimiento) y la firma. Cada parte es JSON codificado en base64url, así que viaja cómodo en un header HTTP como `Authorization: Bearer eyJ...`. El formato está definido en el RFC 7519.

La gracia es que el servidor puede validar un JWT sin consultar nada. El servicio de login lo firma con una clave secreta (HMAC, como en `HS256`) o con una clave privada (como en `RS256` o `ES256`), y cualquier API que tenga la clave correspondiente puede comprobar que nadie tocó ni un carácter. Por eso los JWT son muy usados en microservicios y en OpenID Connect: el ID token que recibís después de "Iniciar sesión con Google" es un JWT.

Hay dos trampas clásicas. La primera: un JWT firmado no está cifrado. Cualquiera que lo agarre puede decodificar el payload y leerlo, así que nunca tiene que llevar secretos y solo debería viajar por HTTPS. La segunda: como validarlo no requiere base de datos, un JWT robado sigue andando hasta que vence. La solución habitual es darle una vida corta (minutos) y usar aparte un refresh token que el servidor sí puede revocar. Las bibliotecas además tienen que rechazar tokens cuyo header dice `"alg": "none"` o cambia el algoritmo, una fuente histórica de vulnerabilidades.

## Una analogía

Una pulsera de festival con holograma. El de seguridad de cada escenario no llama a la boletería: mira el holograma y la fecha impresa. Cualquiera puede leer la pulsera, nadie puede falsificarla, y una robada sirve hasta que termina el festival.

## Para quedarse

- Tres partes separadas por puntos: header, payload y firma.
- Firmado, no cifrado: cualquiera puede leer el payload.
- El servidor lo valida con una clave, sin consultar una base de datos.
- Es difícil de revocar: vida corta y refresh tokens.

## Para seguir leyendo

- [JSON Web Token en Wikipedia](https://es.wikipedia.org/wiki/JSON_Web_Token)
- [Introducción a JSON Web Tokens (jwt.io, en inglés)](https://jwt.io/introduction)
- [RFC 7519: JSON Web Token (IETF, en inglés)](https://datatracker.ietf.org/doc/html/rfc7519)

## Términos relacionados

- [Algoritmo](https://tidbit.legios.com.ar/es/algorithm/): Un método preciso, paso a paso, para resolver un problema o hacer una tarea.
- [JSON](https://tidbit.legios.com.ar/es/json/): El formato de texto con el que los programas se pasan datos estructurados.
- [HTTP](https://tidbit.legios.com.ar/es/http/): El idioma de pedido y respuesta que hablan los navegadores y los sitios web.
- [Servidor](https://tidbit.legios.com.ar/es/server/): Una computadora cuyo trabajo es responder pedidos de otras computadoras, todo el día.
- [Criptografía de clave pública](https://tidbit.legios.com.ar/es/public-key-cryptography/): Dos claves ligadas: una que compartís con todos para cerrar, otra que guardás para abrir.
- [API](https://tidbit.legios.com.ar/es/api/): El menú de cosas que un programa le deja pedir a otro programa.
- [Microservicios](https://tidbit.legios.com.ar/es/microservices/): Construir una aplicación como muchos servicios chicos que hacen una sola cosa cada uno.
- [OAuth y SSO](https://tidbit.legios.com.ar/es/oauth-and-sso/): Iniciar sesión una vez con una cuenta confiable y que ella responda por vos en otras apps.
