Gerador de Segredos e Chaves de API

Continuar na ferramenta

Mais páginas desta ferramenta

gerar jwt secret hs256

Gerar JWT secret para HS256, HS384 e HS512 (tamanho correto)

Escolha JWT HS256, HS384 ou HS512 no gerador: o tamanho já vem no mínimo da RFC 7518 e você só decide a codificação. O resultado traz o valor pronto para a variável JWT_SECRET.

Quanto o segredo HMAC precisa ter

A seção 3.2 da RFC 7518 define as assinaturas HS256, HS384 e HS512 e fixa uma regra de tamanho: a chave deve ter o mesmo tamanho da saída do hash, ou maior. Isso dá 256 bits (32 bytes) para HS256, 384 bits (48 bytes) para HS384 e 512 bits (64 bytes) para HS512. Uma chave menor enfraquece a assinatura, porque quem tem um único token pode testar palpites offline contra a assinatura sem tocar no seu servidor. Frases como "minha-chave-secreta" têm pouca entropia e caem rápido nesse ataque.
O tamanho que importa é o dos bytes, não o do texto. Um segredo de 32 bytes vira 64 caracteres em hex, 44 em base64 (com um = no fim) e 43 em base64url. Já o HS384 usa 48 bytes (96 em hex, 64 em base64url) e o HS512 usa 64 bytes (128 em hex, 86 em base64url). Se a biblioteca recebe o segredo como texto e o converte em UTF-8, um hex de 64 caracteres vira 64 bytes de entrada, mas com só 256 bits de entropia real, pois cada caractere hex carrega 4 bits. O tamanho de entrada alto não compensa a entropia: mantenha 32 bytes aleatórios como mínimo de verdade.
Uma boa prática final: um segredo por ambiente e por serviço, guardado em variável de ambiente ou em um gerenciador de segredos, nunca no repositório. Para trocar sem derrubar usuários, aceite os dois segredos por um período (o identificador kid no cabeçalho do token ajuda) e depois descarte o antigo. Quando vários serviços só precisam verificar tokens, considere assinatura assimétrica (RS256, ES256), em que o segredo de assinatura fica em um lugar só.

Tamanhos conferidos

HS256 em base64url

Entrada: 32 bytes
Saída esperada: 43 caracteres, 256 bits

Mínimo da RFC 7518 para HS256.

HS256 em hex

Entrada: 32 bytes
Saída esperada: 64 caracteres, 256 bits

Dois caracteres por byte.

HS384 em base64url

Entrada: 48 bytes
Saída esperada: 64 caracteres, 384 bits

48 é múltiplo de 3, então não há preenchimento.

HS512 em base64url

Entrada: 64 bytes
Saída esperada: 86 caracteres, 512 bits

Em base64 padrão seriam 88, com dois =.

Comando equivalente

Entrada: openssl rand -base64 32
Saída esperada: 44 caracteres

Mesmos 32 bytes em base64 padrão.

FAQ da ferramenta completa

Como gerar um JWT secret seguro para HS256?

Use pelo menos 32 bytes aleatórios (256 bits): a RFC 7518, seção 3.2, diz que a chave HMAC deve ter o tamanho da saída do hash ou mais, ou seja, 256 bits para HS256, 384 para HS384 e 512 para HS512. Uma frase curta ou palavra de dicionário como segredo pode ser quebrada por força bruta offline a partir de um único token.

O que é o APP_KEY do Laravel e como gerar?

Como é a SECRET_KEY do Django gerada aqui?

Qual o tamanho do secret_key_base do Rails?

Como gerar o AUTH_SECRET do Auth.js ou NextAuth?

Quantos bits de entropia um segredo precisa ter?

É seguro gerar segredos de produção em um site?

Por que não usar Math.random para gerar segredos?

Qual a diferença entre hex, base64 e base64url?

Para que serve o sufixo de verificação da chave de API?

Perguntas frequentes

Posso usar uma senha comum como segredo do JWT?

Pode funcionar, mas é arriscado: senhas têm bem menos entropia que 256 bits e podem ser descobertas por força bruta a partir de um token. Gere bytes aleatórios com o gerador.

Devo decodificar o base64 antes de passar para a biblioteca?

Depende da biblioteca. Algumas aceitam texto e usam os bytes UTF-8 do texto; outras pedem um buffer. O importante é que quem assina e quem verifica usem exatamente o mesmo tratamento.

HS512 é mais seguro que HS256?

Só se o segredo também for maior. Com 32 bytes de entropia, o HS512 não passa de 256 bits de segurança. O que protege é o segredo, não o nome do algoritmo.

Próximos passos

Quanto o segredo HMAC precisa ter

A seção 3.2 da RFC 7518 define as assinaturas HS256, HS384 e HS512 e fixa uma regra de tamanho: a chave deve ter o mesmo tamanho da saída do hash, ou maior. Isso dá 256 bits (32 bytes) para HS256, 384 bits (48 bytes) para HS384 e 512 bits (64 bytes) para HS512. Uma chave menor enfraquece a assinatura, porque quem tem um único token pode testar palpites offline contra a assinatura sem tocar no seu servidor. Frases como "minha-chave-secreta" têm pouca entropia e caem rápido nesse ataque.

O tamanho que importa é o dos bytes, não o do texto. Um segredo de 32 bytes vira 64 caracteres em hex, 44 em base64 (com um = no fim) e 43 em base64url. Já o HS384 usa 48 bytes (96 em hex, 64 em base64url) e o HS512 usa 64 bytes (128 em hex, 86 em base64url). Se a biblioteca recebe o segredo como texto e o converte em UTF-8, um hex de 64 caracteres vira 64 bytes de entrada, mas com só 256 bits de entropia real, pois cada caractere hex carrega 4 bits. O tamanho de entrada alto não compensa a entropia: mantenha 32 bytes aleatórios como mínimo de verdade.

Uma boa prática final: um segredo por ambiente e por serviço, guardado em variável de ambiente ou em um gerenciador de segredos, nunca no repositório. Para trocar sem derrubar usuários, aceite os dois segredos por um período (o identificador kid no cabeçalho do token ajuda) e depois descarte o antigo. Quando vários serviços só precisam verificar tokens, considere assinatura assimétrica (RS256, ES256), em que o segredo de assinatura fica em um lugar só.

Tamanhos conferidos

HS256 em base64url

Entrada: 32 bytes
Saída esperada: 43 caracteres, 256 bits

Mínimo da RFC 7518 para HS256.

HS256 em hex

Entrada: 32 bytes
Saída esperada: 64 caracteres, 256 bits

Dois caracteres por byte.

HS384 em base64url

Entrada: 48 bytes
Saída esperada: 64 caracteres, 384 bits

48 é múltiplo de 3, então não há preenchimento.

HS512 em base64url

Entrada: 64 bytes
Saída esperada: 86 caracteres, 512 bits

Em base64 padrão seriam 88, com dois =.

Comando equivalente

Entrada: openssl rand -base64 32
Saída esperada: 44 caracteres

Mesmos 32 bytes em base64 padrão.

FAQ da ferramenta completa

Como gerar um JWT secret seguro para HS256?

O que é o APP_KEY do Laravel e como gerar?

Como é a SECRET_KEY do Django gerada aqui?

Qual o tamanho do secret_key_base do Rails?

Como gerar o AUTH_SECRET do Auth.js ou NextAuth?

Quantos bits de entropia um segredo precisa ter?

É seguro gerar segredos de produção em um site?

Por que não usar Math.random para gerar segredos?

Qual a diferença entre hex, base64 e base64url?

Para que serve o sufixo de verificação da chave de API?

Perguntas frequentes

Posso usar uma senha comum como segredo do JWT?

Pode funcionar, mas é arriscado: senhas têm bem menos entropia que 256 bits e podem ser descobertas por força bruta a partir de um token. Gere bytes aleatórios com o gerador.

Devo decodificar o base64 antes de passar para a biblioteca?

Depende da biblioteca. Algumas aceitam texto e usam os bytes UTF-8 do texto; outras pedem um buffer. O importante é que quem assina e quem verifica usem exatamente o mesmo tratamento.

HS512 é mais seguro que HS256?

Só se o segredo também for maior. Com 32 bytes de entropia, o HS512 não passa de 256 bits de segurança. O que protege é o segredo, não o nome do algoritmo.