# Gerador e Verificador HMAC

Calcula uma assinatura HMAC de mensagem + segredo com SHA-1/SHA-2/SHA-3/BLAKE2, ou verifica uma assinatura recebida (comparação em tempo constante), com presets para Stripe / Slack / GitHub

> Página canônica: https://test.elysiatools.com/pt/tools/hmac-generator-verifier

- **Categoria:** Security

- **Palavras-chave:** hmac, assinatura, webhook, sha256, mac

## Visão geral

HMAC (código de autenticação baseado em hash) prova que uma mensagem foi enviada por quem conhece o segredo compartilhado e não foi alterada — é o mecanismo padrão de assinatura de webhooks do Stripe, Slack, GitHub, Shopify, etc.

Dois modos:

- **Gerar**: cole o corpo bruto e seu segredo, escolha o algoritmo (SHA-1/256/384/512, SHA3-256/512, BLAKE2s-256, BLAKE2b-512) e a codificação (hex/base64/base64url).
- **Verificar**: cole também a assinatura recebida no cabeçalho do webhook; a ferramenta recalcula o HMAC e compara em tempo constante via `crypto.timingSafeEqual`.

Os presets de webhook escolhem automaticamente algoritmo, codificação e prefixo para Stripe / Slack / GitHub, e documentam a convenção de cada provedor.

Tudo é calculado localmente com `crypto` do Node; o segredo não sai da requisição.

## Entradas

- **Mensagem (corpo bruto)** (textarea): Paste the raw request body exactly as received (do not re-serialize JSON — byte differences break the signature).
- **Segredo compartilhado** (text): whsec_... (your webhook signing secret)
- **Modo** (select)
- **Algoritmo** (select)
- **Codificação da assinatura** (select)
- **Assinatura para verificar** (text): Paste the signature from the webhook header (verify mode)
- **Preset de webhook** (select)

## Quando usar

- Ao implementar ou testar a validação de webhooks de serviços como Stripe, Slack, Shopify ou GitHub.
- Para assinar requisições de APIs personalizadas que exigem autenticação baseada em chaves simétricas compartilhadas.
- Durante a depuração de falhas de assinatura para verificar se o payload bruto e o segredo geram o hash esperado.

## Como funciona

- Insira o corpo bruto da mensagem (payload) exatamente como recebido e informe a chave secreta compartilhada.
- Escolha o algoritmo de hash (como SHA-256 ou SHA-512) e o formato de codificação da assinatura (hexadecimal, base64 ou base64url).
- Selecione o modo de operação: 'Apenas gerar' para obter a assinatura correspondente, ou 'Verificar assinatura' para compará-la de forma segura com um hash recebido.

## Casos de uso

- Validação de assinaturas de webhooks do Stripe comparando o payload bruto com o cabeçalho Stripe-Signature.
- Geração de assinaturas HMAC-SHA256 para autenticação de chamadas de API em sistemas de parceiros comerciais.
- Depuração de integrações de webhooks do GitHub utilizando o preset de configuração rápida para SHA-256.

## Perguntas frequentes

### O que é um HMAC?

O HMAC é um código de autenticação de mensagem baseado em hash que utiliza uma chave secreta compartilhada para garantir a integridade e a autenticidade dos dados transmitidos.

### Por que a verificação falha se eu formatar o JSON da mensagem?

Qualquer alteração em espaços, quebras de linha ou ordenação de chaves modifica o hash final. Use sempre o corpo bruto (raw body) idêntico ao enviado pelo remetente.

### Como funcionam os presets de webhook?

Eles configuram automaticamente o algoritmo de hash, a codificação de saída e os prefixos específicos exigidos por plataformas como Stripe, Slack e GitHub.

### O meu segredo compartilhado é enviado para a internet?

Não. Todos os cálculos de HMAC são executados localmente no seu navegador utilizando a API crypto do Node.js, garantindo total privacidade.

### O que é a comparação em tempo constante?

É uma técnica de comparação de strings que leva o mesmo tempo para ser concluída independentemente de onde ocorra uma divergência, prevenindo ataques de temporização (timing attacks).

## Ferramentas relacionadas

- [Gerador de PKCE Code Verifier e Challenge](https://test.elysiatools.com/pt/tools/pkce-code-verifier-generator): Gera, valida e verifica pares code_verifier / code_challenge PKCE (RFC 7636) de OAuth2 / OIDC. Três modos: (1) gerar um par novo a partir de bytes aleatórios criptográficos (256/384/512/768 bits), (2) auditar um verifier existente frente ao RFC — comprimento (43–128), charset \[A-Za-z0-9-._~\] e ≥256 bits de entropia, e (3) verificar um par recalculando BASE64URL(SHA256(verifier)). Opcionalmente constrói a URL completa de autorização e o corpo de troca de token. Complementa o nonce-generator genérico (que só emite o par) com auditoria de conformidade RFC e verificação de pares.
- [Gerador de par de chaves SSH](https://test.elysiatools.com/pt/tools/ssh-key-generator): Gera um par de chaves SSH (Ed25519 recomendado, ou RSA 4096, ECDSA P-256) com a chave pública no formato OpenSSH pronta para ~/.ssh/authorized_keys, uma impressão digital SHA256 e uma chave privada PEM. Criptografia opcional com senha. Executa localmente.
- [Gerador de códigos TOTP / HOTP offline](https://test.elysiatools.com/pt/tools/totp-hotp-offline-generator): Gera senhas de uso único TOTP RFC 6238 (6/8 dígitos, 30/60 s) e HOTP RFC 4226 (por contador) a partir de um segredo base32, offline, com HMAC-SHA1/256/512, e exporta uma URI otpauth://
- [Gerador de frases mnemônicas BIP39](https://test.elysiatools.com/pt/tools/mnemonic-bip39-generator): Gera ou valida frases BIP39 de 12 a 24 palavras com saída de entropia e seed PBKDF2-HMAC-SHA512
- [Gerador de quebra-cabeças Kakuro / Fillomino / Masyu / Yajilin / Hashiwokakero / Nurikabe / Slitherlink / Star Battle com prova de unicidade](https://test.elysiatools.com/pt/tools/kakuro-fillomino-masyu-yajilin-hashiwokakero-nurikabe-slitherlink-and-star-battle-puzzle-generator-with-uniqueness-prover): Gera de forma determinística por semente quebra-cabeças de 8 famílias Nikoli (mesma semente, mesmo tabuleiro): Kakuro denso, Fillomino, Masyu, Yajilin, Hashiwokakero, Nurikabe, Slitherlink e Star Battle; cada tabuleiro nasce «solução primeiro» e é verificado por um solver exaustivo que conta soluções até duas — a unicidade é provada, e se o orçamento se esgota é declarada honestamente «unproven»; SVGs de puzzle e solução e dificuldade por nós de busca inclusos.
- [Visualizador do fluxo OAuth 2.0 / OIDC com código de autorização e PKCE](https://test.elysiatools.com/pt/tools/oauth-oidc-authorization-code-pkce-flow-visualizer): Simula de ponta a ponta o fluxo de código de autorização com PKCE: geração de verifier/challenge, URL de autorização, troca de token, checklist de validação do ID Token e demonstração de ataque de interceptação.
- [Gerador de hash de senha Argon2](https://test.elysiatools.com/pt/tools/argon2-password-hash-generator): Gera hashes Argon2id com memoria, iteracoes, paralelismo e comprimento de salt ajustaveis, com saida PHC
- [Gerador em lote de codigos](https://test.elysiatools.com/pt/tools/barcode-batch-generator): Gera em lote Code 128, EAN-13, UPC-A, ITF-14, QR Code e Data Matrix a partir de CSV ou texto multilinha com saida PNG ZIP ou PDF

## Exemplos

- [Exemplos de Processamento de Imagem Android Java](https://test.elysiatools.com/pt/samples/android-image-processing-java): Exemplos de processamento de imagem Android Java incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Android Kotlin](https://test.elysiatools.com/pt/samples/android-image-processing-kotlin): Exemplos de processamento de imagem Android Kotlin incluindo leitura/escrita, dimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Web Python](https://test.elysiatools.com/pt/samples/web-image-processing-python): Exemplos de processamento de imagem Web Python usando PIL/Pillow incluindo leitura, salvamento, redimensionamento e conversão de formato
- [Exemplos de Processamento de Imagem Web Rust](https://test.elysiatools.com/pt/samples/web-image-processing-rust): Exemplos de processamento de imagem Web Rust incluindo leitura/gravação, redimensionamento e conversão de formato

## Conteúdo relacionado

- [Fluxo autorizado de testes de JWT, OTP, TOTP e sessões](https://test.elysiatools.com/pt/hubs/token-session-and-2fa-workflows): Prepare fixtures de autenticação sanitizados, separe geração de tokens de decodificação e verificação, teste o tempo de OTP/TOTP e audite evidências de JWT e sessão sem expor segredos reais.
- [Ferramentas para Verificar o Formato, Preparar o Replay e Depurar APIs](https://test.elysiatools.com/pt/hubs/api-request-replay-and-debugging): Verifique a estrutura, prepare um replay local, compare respostas e reúna pistas de depuração. A análise e a geração são locais e não substituem a autenticação real nem os testes no servidor.
