A geração de um JWT compatível com os padrões na JWS Compact Serialization (RFC 7515 Seção 3.1) transforma um cabeçalho JOSE, um conjunto de claims JSON e uma chave secreta simétrica em uma string de três partes formatada como <header>.<payload>.<signature>.
1. Construa o Cabeçalho JOSE e o Payload de Claims da API
Comece com um cabeçalho protegido HS256 e um payload JSON combinando claims registradas da RFC 7519 (iss, sub, aud, iat, exp) com claims personalizadas da aplicação (role):
{
"alg": "HS256",
"typ": "JWT"
}
{
"iss": "https://auth.example.com",
"sub": "usr_9481",
"aud": "api.example.com",
"iat": 1767225600,
"exp": 1767229200,
"role": "admin"
}
Aqui 1767225600 representa 2026-01-01T00:00:00Z e 1767229200 representa 2026-01-01T01:00:00Z (um tempo de vida de token de 1 hora).
2. Construa a Entrada de Assinatura em Base64URL sem Padding
Cada objeto JSON é minificado em bytes UTF-8 sem espaços em branco extras, codificado com Base64URL (alfabeto - e _, com padding = removido) e unido por um ponto ASCII (.):
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJodHRwczovL2F1dGguZXhhbXBsZS5jb20iLCJzdWIiOiJ1c3JfOTQ4MSIsImF1ZCI6ImFwaS5leGFtcGxlLmNvbSIsImlhdCI6MTc2NzIyNTYwMCwiZXhwIjoxNzY3MjI5MjAwLCJyb2xlIjoiYWRtaW4ifQ
3. Vetor de Assinatura HMAC-SHA256 Reprodutível
A Web Crypto importa os bytes do seu segredo via crypto.subtle.importKey("raw", secretBytes, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]) e assina exatamente os bytes ASCII <base64url-header>.<base64url-payload>. Você pode verificar a paridade determinística entre OpenSSL, crypto do Node.js, PyJWT do Python e este gerador usando o vetor de teste canônico HS256 com o segredo UTF-8 your-256-bit-secret:
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022
}
Assinar o cabeçalho {"alg":"HS256","typ":"JWT"} e o payload acima com your-256-bit-secret sempre produz exatamente este token de 147 caracteres, pronto para um cabeçalho HTTP Authorization: Bearer <token> ou verificação completa no Decodificador e Inspetor JWT:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c