VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
hmac() do VillageSQL permite fazer isso em SQL.
O Problema: Sem HMAC Embutido
O MySQL temSHA2() e MD5() para hashing, mas nada que receba uma chave. O HMAC (Hash-based Message Authentication Code) usa um segredo compartilhado para produzir um código de autenticação — ele é fundamentalmente diferente de um hash simples porque alguém sem a chave não consegue reproduzi-lo.
A abordagem típica é calcular os HMACs na aplicação antes de gravar no banco de dados:
Com o VillageSQL: hmac() em SQL
A extensãovsql_crypto do VillageSQL adiciona hmac(data, key, algorithm), que retorna um código de autenticação VARBINARY calculado inteiramente no MySQL.
Assinando linhas em um trigger
Use um trigger para assinar cada linha no momento da gravação, independentemente de qual caminho da aplicação a criou:Verificando payloads de webhook
Se a sua aplicação armazena os payloads de webhook recebidos, você pode verificar as assinaturas diretamente em SQL antes de processá-los:Algoritmos suportados
Use HMAC-SHA256 para código novo. A construção HMAC não herda as vulnerabilidades de colisão do hash subjacente, então o HMAC-SHA1 não está quebrado da forma que o SHA-1 simples está — mas o SHA-1 está obsoleto e os reguladores o tratam como legado. Não o use em código novo.
HMAC vs. Hash Simples
Se os dados que você está protegendo são públicos, um hash simples não prova nada. Use HMAC quando precisar provar que os dados foram produzidos por alguém que conhece o segredo. Para hashing sem chave, consulte Gerando Hash de Dados no MySQL.
Perguntas Frequentes
Armazenar a chave HMAC no trigger é seguro?
Não — ela fica fixa na definição do trigger, visível para qualquer pessoa com acesso aSHOW CREATE TRIGGER. Em produção, obtenha a chave de um caminho de configuração seguro ou passe-a como uma variável de sessão definida pela aplicação na conexão. Trate a chave como uma credencial.
Posso usar HMAC para verificar que os resultados de consultas não foram alterados em trânsito?
O HMAC protege contra modificações não autorizadas, não contra espionagem. Para proteção em trânsito, use TLS na sua conexão MySQL. O HMAC é útil para detectar adulteração depois que os dados chegam ao banco de dados.Como faço para rotacionar a chave HMAC?
Assine novamente todas as linhas existentes com a nova chave antes de trocar:hmac() retorna a mesma saída para as mesmas entradas?
Sim — o HMAC é determinístico. Os mesmos dados + a mesma chave + o mesmo algoritmo sempre produzem o mesmo resultado. É isso que faz a verificação funcionar.Solução de Problemas
Veja também
- Gerando Hash de Dados no MySQL — hashing sem chave para fingerprints e deduplicação
- Enviando Webhooks a partir de Triggers — o HMAC é a forma padrão de assinar payloads de webhook