O que é HMAC
HMAC (Hash-based Message Authentication Code) é um código de autenticação de mensagem construído sobre uma função de hash e uma chave secreta. Quem recebe a mensagem e tem a mesma chave recalcula o HMAC e compara com a assinatura enviada. Se bater, a mensagem não foi adulterada e veio de quem conhece a chave — o que um hash puro (sem chave) não garante.
Diferença entre hash e HMAC
No Gerador de Hash você obtém um resumo irreversível de um texto ou arquivo — bom para checksum de download. No HMAC a chave entra no cálculo: sem ela não há como forjar a assinatura. Em um JWT HS256, a assinatura é HMAC-SHA256 do trecho header.payload codificado em Base64URL — use o JWT Decode & Encode para tokens; use esta página para assinaturas cruas de webhook e API.
Como validar assinatura de webhook
- Copie o body bruto que o provedor assinou (não o JSON já reformatado, se os espaços mudarem).
- Cole o webhook secret no encoding correto (texto, hex ou Base64 — como a doc da API descreve).
- Cole o valor do header de assinatura no campo “esperada” (prefixo
sha256=é aceito). - Se o veredito for “confere”, o problema não é o HMAC em si — olhe timestamp, IP allowlist ou parser do framework. Se não confere, confira newline, encoding e se a doc assina
timestamp.payload.
Por que minha assinatura não bate
- Body com ou sem
\nfinal em relação ao que o servidor assinou. - Comparar hex com Base64 (ou o contrário) — aqui os três encodings saem juntos.
- Chave em hex colada como texto UTF-8 (ou o oposto) — troque o encoding da chave.
- Provedores que assinam
t.payload(Stripe) em vez do body sozinho. - Algoritmo errado (SHA-1 legado vs SHA-256) — o modo verificação tenta todos.
Encoding de bytes em texto costuma ser Base64 — o Codificador Base64 ajuda a inspecionar strings que não são o digest em si.