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 →
O MySQL tem MD5() e SHA2(). Desenvolvedores recorrem a elas ao fazer hash de senhas. Isso é um erro — essas funções foram projetadas para serem rápidas, que é exatamente a propriedade errada para o armazenamento de senhas.

Por Que Hashes Rápidos São Errados para Senhas

Funções de hash criptográficas como MD5 e SHA-256 são otimizadas para velocidade. Uma GPU moderna consegue calcular bilhões de hashes SHA-256 por segundo. Isso é útil para checksums e integridade de dados. Para senhas, significa que um atacante que obtém a sua tabela de senhas com hash pode quebrá-la por força bruta em horas. Algoritmos de hash de senha — bcrypt, Argon2, PBKDF2 — são intencionalmente lentos. Eles são projetados para que a verificação de uma senha leve dezenas de milissegundos, o que é aceitável para um login, mas torna ataques de força bruta impraticáveis.

A Resposta Padrão: Hash no Código da Aplicação

A maioria das aplicações MySQL lida com isso corretamente fazendo o hash na camada da aplicação — usando bcrypt em PHP, Python, Node.js ou qualquer linguagem em que a aplicação roda. O banco de dados só vê o valor já com hash. Isso funciona, mas cria uma divisão: a lógica de hashing vive no código da aplicação, enquanto os dados vivem no banco de dados. Migrações, operações em massa e importações de dados precisam passar pela aplicação para fazer o hash corretamente, ou precisam replicar a lógica de hashing em várias bases de código.

Com o VillageSQL: PBKDF2 Diretamente em SQL

A extensão vsql_crypto do VillageSQL adiciona crypt() e gen_salt() — uma API de hashing de senhas baseada em PBKDF2, modelada no pgcrypto do PostgreSQL. Você pode fazer hash e verificar senhas em SQL sem passar pelo código da aplicação.

Armazenando uma senha

gen_salt cobre somente a família PBKDF2 — pbkdf2-sha256 e pbkdf2-sha512, mais os aliases curtos pbkdf2, sha256 e sha512. Os tipos bf (bcrypt), md5 e des do pgcrypto não são suportados: gen_salt retorna NULL para esses nomes.

Verificando uma senha

crypt() extrai o salt e os parâmetros do hash armazenado automaticamente — você passa o hash armazenado como segundo argumento:

Escolhendo a contagem de iterações

A contagem de iterações controla quanto tempo o hash leva para ser calculado. Mais iterações = mais lento = mais difícil de quebrar por força bruta, mas também logins mais lentos. Comece em 10.000 e aumente conforme o seu hardware permitir. O seu endpoint de login tolera 100ms; um atacante tentando bilhões de palpites, não.

Quando Fazer Hash em SQL vs. no Código da Aplicação

Fazer hash em SQL nem sempre é a escolha certa. Use quando:
  • Você está fazendo inserções em massa ou migrações em que passar pela aplicação não é prático
  • Você quer a lógica de hashing centralizada na camada do banco de dados
  • Você está construindo ferramentas administrativas ou scripts de seed orientados a SQL
Faça hash no código da aplicação quando:
  • O seu framework de aplicação já tem uma biblioteca bcrypt/Argon2 bem testada
  • Você usa uma linguagem em que o ecossistema de criptografia é maduro (a maioria é)
  • Você quer trocar de algoritmo de hashing sem uma migração de esquema
As duas abordagens produzem hashes seguros. O essencial é usar um algoritmo lento — PBKDF2, bcrypt ou Argon2 — e não SHA2 puro.

Perguntas Frequentes

O PBKDF2 é tão forte quanto o bcrypt?

Com contagens de iterações equivalentes, o bcrypt tem uma leve vantagem porque é memory-hard (mais difícil de paralelizar em GPUs). O PBKDF2 com contagens de iterações altas (100.000+) continua forte e é amplamente usado. A diferença importa em cenários adversariais; os dois são muito melhores que SHA2.

Posso migrar hashes SHA2 existentes?

Sim. Adicione uma flag needs_rehash. Em um login bem-sucedido, verifique se o hash está no formato SHA2 antigo e refaça o hash com crypt(). Remova os hashes antigos quando todos os usuários ativos tiverem feito login.

Posso migrar hashes bcrypt existentes do PostgreSQL?

Não diretamente. crypt() retorna NULL para qualquer salt ou hash que não esteja no formato PBKDF2, então hashes bcrypt do pgcrypto não podem ser verificados aqui. Mantenha-os na coluna existente e refaça o hash de cada usuário no próximo login bem-sucedido, da mesma forma que os hashes SHA2 acima. O guia de migração do PostgreSQL para o MySQL tem o mapeamento completo de extensões.

O hash armazenado inclui o salt?

Sim. A saída de crypt() codifica o algoritmo, a contagem de iterações, o salt e o hash em uma única string. Você não gerencia o salt separadamente.

Solução de Problemas

Veja também