O HMAC-SHA256 calcula um código de autenticação a partir de uma mensagem e de uma chave secreta compartilhada, usando a função de hash SHA-256. O destinatário recalcula o código para conferir o conteúdo recebido, usando a mesma chave que o remetente. A chave precisa permanecer secreta, pois sua exposição permite a criação de mensagens com códigos válidos.
Como a chave participa do cálculo
A construção HMAC usa duas etapas de hash encadeadas. Na primeira, o algoritmo combina a chave com uma constante interna e acrescenta a mensagem ao cálculo. Na segunda, combina a chave com uma constante externa e calcula o hash dessa combinação com o resultado anterior. O código final permite conferir a mensagem sem transmitir a chave junto dela.
Como as duas partes conhecem o segredo, ambas conseguem gerar códigos válidos. O resultado autentica a mensagem entre participantes que compartilham a chave, sem comprovar qual deles a criou. O conteúdo continua legível, pois o HMAC não realiza cifragem.
Os bytes recebidos pelo webhook
Em um exemplo didático, um serviço calcula o HMAC sobre o corpo {"ativo":true} de um webhook. O destinatário usa a mesma chave e os mesmos bytes para repetir o cálculo. A comparação com o código recebido permite recusar uma mensagem cuja verificação falhou.
Você pode obter outro código ao interpretar esse JSON e gerar o texto {"ativo": true}, porque o espaço acrescentado muda a entrada. Preserve o corpo bruto quando o protocolo o definir como entrada do HMAC. Na implementação, use uma comparação apropriada para códigos de autenticação, como crypto.timingSafeEqual do Node.js, respeitando a exigência de comprimentos iguais.
Uma mensagem válida ainda pode ser reenviada. A documentação de webhooks da Stripe exemplifica uma proteção adicional: incluir um horário no conteúdo autenticado e conferir sua idade ao receber a chamada. A aplicação também precisa evitar o processamento duplicado do mesmo evento.
Dúvidas frequentes
Perguntas frequentes sobre HMAC-SHA256
- O HMAC-SHA256 cifra o conteúdo?
- O cálculo produz um código de autenticação, sem ocultar a mensagem. Para manter o conteúdo confidencial durante o transporte, use uma conexão protegida, como HTTPS.
- Dois documentos JSON equivalentes produzem o mesmo código?
- O cálculo considera os bytes, não o significado do documento. Espaços ou uma ordem diferente dos campos alteram a entrada. Preserve a representação definida pelo protocolo.
- Um código válido impede a repetição da mensagem?
- O HMAC sozinho não distingue o envio original de uma repetição dos mesmos bytes. O protocolo precisa conferir também a validade temporal ou os identificadores já processados.
Para continuar
Recursos relacionados
Documentação
RFC 2104: HMAC
Construção do HMAC com uma função de hash e uma chave compartilhada, incluindo o tratamento da chave.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação ao vivo para revisar a validação de webhooks e investigar divergências no cálculo do código.
Abrir recursoAplicação na formação
Formação DevOps
Integrações entre serviços precisam conferir a autenticidade das mensagens recebidas e preservar os segredos usados nessa verificação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.