VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
AES_ENCRYPT() nativo. O problema é que o modo padrão dele — aes-128-ecb — é inseguro. A criptografia ECB é determinística: o mesmo texto em claro criptografado com a mesma chave sempre produz o mesmo texto cifrado. Um atacante que vê a sua coluna criptografada consegue identificar valores repetidos sem nunca conhecer a chave. O encrypt() do VillageSQL usa o modo CBC com um IV aleatório automaticamente, então entradas idênticas produzem saídas diferentes a cada vez.
O Padrão do MySQL: Modo ECB
OAES_ENCRYPT(data, key) do MySQL usa por padrão aes-128-ecb (block_encryption_mode). ECB — Electronic Codebook — criptografa cada bloco de forma independente, sem aleatoriedade. Duas linhas com o mesmo valor produzem o mesmo texto cifrado:
block_encryption_mode para usar CBC, mas então você precisa gerenciar o IV por conta própria: gerá-lo, armazená-lo ao lado do texto cifrado e passá-lo de volta para AES_DECRYPT() todas as vezes.
A Solução Alternativa Padrão: IV Manual com AES-CBC
Usar o modo CBC corretamente no MySQL exige armazenar e passar o IV explicitamente:Com o VillageSQL: Gerenciamento Automático do IV
A extensãovsql_crypto do VillageSQL adiciona encrypt() e decrypt(), que cuidam do IV automaticamente. O IV é gerado do zero a cada chamada e prefixado ao texto cifrado no valor armazenado. decrypt() o extrai sem que você precise pensar nisso.
Tamanhos de chave
Uma chave mais curta do que a cifra exige gera
ERROR 3200: VDF error in function 'encrypt': key too short for <cipher>: need N bytes, got M — ela não é preenchida com zeros. Uma chave mais longa é truncada silenciosamente. Use exatamente 16, 24 ou 32 bytes.
O que armazenar
A colunaVARBINARY guarda o IV (16 bytes) prefixado ao texto cifrado. O preenchimento PKCS7 sempre adiciona um bloco AES extra completo (16 bytes) quando o comprimento do texto em claro já é um múltiplo exato de 16 — nunca são zero bytes de preenchimento. Então a fórmula segura é comprimento do texto em claro + 32 bytes no total (16 para o IV, até 16 para o preenchimento). Dimensione a coluna com folga:
O Que Isto Não Cobre
A criptografia em nível de coluna no SQL protege os dados em repouso contra alguém que tem acesso ao banco de dados, mas não à chave. Ela não protege contra:- Código da aplicação que guarda a chave e consulta dados descriptografados — um atacante que compromete a aplicação obtém os dois
- Consultas que filtram ou ordenam por colunas criptografadas (você não pode fazer
WHERE ssn = ?sem descriptografar)
Perguntas Frequentes
Onde devo armazenar a chave de criptografia?
Não no banco de dados. A chave deve ficar em um gerenciador de segredos (AWS Secrets Manager, HashiCorp Vault, GCP Secret Manager) ou em uma variável de ambiente, carregada pela aplicação em tempo de execução. Uma chave armazenada no mesmo banco de dados que ela criptografa não oferece proteção nenhuma.Posso pesquisar em colunas criptografadas?
Não diretamente. Descriptografar todas as linhas para encontrar uma correspondência é uma varredura completa da tabela. Padrões comuns: armazenar um hash determinístico do valor ao lado da coluna criptografada para buscas por igualdade (sha256(ssn) para busca por SSN), ou descriptografar na camada da aplicação e construir um índice de busca criptografado.
O que acontece se eu perder a chave?
Os dados ficam irrecuperáveis. Faça backup das chaves separadamente do banco de dados. Considere a criptografia por envelope — envolver a chave de dados com uma chave mestra — para que você possa rotacionar a chave mestra sem recriptografar tudo.Posso criptografar uma coluna com uma expressão DEFAULT?
Não atualmente. Funções não determinísticas (o queencrypt() é, por causa do IV aleatório) não podem ser usadas em expressões DEFAULT. Gere o valor criptografado em cada INSERT.
Solução de Problemas
Veja também
- Criptografia Simétrica no MySQL — o algoritmo de criptografia e o gerenciamento de chaves por trás disto
- Hashing de Senhas no MySQL — para credenciais, hashing é melhor do que criptografia
- Hashing de Dados no MySQL — impressão digital unidirecional quando você não precisa descriptografar