Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
Um hash diz como os dados se parecem. Um HMAC diz que os dados vieram de alguém que conhece a chave secreta. A diferença importa quando você está verificando que uma linha não foi adulterada, que um payload de webhook é autêntico, ou que um token foi gerado pelo seu sistema e não forjado. O MySQL não tem uma função HMAC embutida — a resposta padrão é calculá-lo no código da aplicação. A hmac() do VillageSQL permite fazer isso em SQL.

O Problema: Sem HMAC Embutido

O MySQL tem SHA2() 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:
Isso funciona, mas significa que cada caminho de gravação — cada linguagem, serviço e carregador em massa — precisa replicar a lógica de assinatura. Um script de migração que contorna a aplicação vai gravar linhas sem assinatura.

Com o VillageSQL: hmac() em SQL

A extensão vsql_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 a SHOW 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