Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Formação DevOps

    O que é HMAC-SHA256?

    O HMAC-SHA256 combina uma chave secreta e a função SHA-256 para verificar mensagens. O destinatário recalcula o código sobre os bytes recebidos.

    Também chamado de: HMAC SHA-256, HMAC-SHA-256

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação DevOps

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano