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 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

O AES_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:
O MySQL 8.0 permite alterar 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:
Isso é correto, mas verboso — toda tabela precisa de uma coluna extra para o IV, e toda consulta que toca em dados criptografados precisa passar o IV.

Com o VillageSQL: Gerenciamento Automático do IV

A extensão vsql_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.
Sem coluna de IV, sem parâmetro de IV nas consultas. Duas linhas com o mesmo SSN produzem textos cifrados diferentes — sem vazamento de padrões.

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 coluna VARBINARY 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)
Para criptografia pesquisável ou gerenciamento de chaves por envelope (rotacionar chaves sem recriptografar todos os dados), você precisa de infraestrutura adicional na camada da aplicação.

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 que encrypt() é, 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