Generar un JWT que cumpla con los estándares en la Serialización Compacta JWS (RFC 7515 Sección 3.1) transforma un encabezado JOSE, un conjunto de claims JSON y una clave secreta simétrica en una cadena de tres partes con el formato <header>.<payload>.<signature>.
1. Construir el Encabezado JOSE y el Payload de Claims para la API
Comienza con un encabezado protegido HS256 y un payload JSON que combine claims registrados de RFC 7519 (iss, sub, aud, iat, exp) con claims personalizados de la aplicación (role):
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
Aquí 1767225600 representa 2026-01-01T00:00:00Z y 1767229200 representa 2026-01-01T01:00:00Z (un tiempo de vida del token de 1 hora).
2. Construir la Entrada de Firma Base64URL sin Relleno
Cada objeto JSON se minifica a bytes UTF-8 sin espacios en blanco adicionales, se codifica con Base64URL (alfabeto - y _, eliminando el relleno =) y se une con un punto ASCII (.):
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Vector de Firma Reproducible HMAC-SHA256
Web Crypto importa los bytes de tu secreto mediante crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) y firma exactamente los bytes ASCII <base64url-header>.<base64url-payload>. Puedes verificar la paridad determinista entre OpenSSL, crypto de Node.js, PyJWT de Python y este generador utilizando el vector de prueba canónico HS256 con el secreto UTF-8 your-256-bit-secret:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
Firmar el encabezado {"alg":"HS256","typ":"JWT"} y el payload anterior con your-256-bit-secret produce siempre exactamente este token de 147 caracteres, listo para un encabezado HTTP Authorization: Bearer <token> o para su verificación de ida y vuelta en el Decodificador e Inspector JWT:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c