跳转到主要内容

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

All examples on this page work on VillageSQL. Install Now →
MySQL 内置了 AES_ENCRYPT()。问题在于它的默认模式——aes-128-ecb——是不安全的。ECB 加密是确定性的:用同一个密钥加密同一段明文,总是产生同样的密文。看到您加密列的攻击者无需知道密钥就能发现重复的值。VillageSQL 的 encrypt() 自动使用带随机 IV 的 CBC 模式,所以相同的输入每次都产生不同的输出。

MySQL 的默认值:ECB 模式

MySQL 的 AES_ENCRYPT(data, key) 默认使用 aes-128-ecb(block_encryption_mode)。ECB——电子密码本——独立加密每个块,没有任何随机性。两行相同的值会产生相同的密文:
MySQL 8.0 允许您把 block_encryption_mode 改为使用 CBC,但那样您就必须自己管理 IV:生成它、把它与密文一起存储,并在每次调用 AES_DECRYPT() 时传回去。

标准的变通方法:AES-CBC 配合手动 IV

在 MySQL 中正确使用 CBC 模式需要显式地存储和传递 IV:
这是正确的,但很繁琐——每张表都需要一个额外的 IV 列,每个访问加密数据的查询都必须传递 IV。

使用 VillageSQL:自动 IV 管理

VillageSQL 的 vsql_crypto 扩展添加了 encrypt() 和 decrypt(),它们自动处理 IV。每次调用都会重新生成 IV,并把它放在存储值中密文的前面。decrypt() 会提取它,您无需操心。
没有 IV 列,查询中也没有 IV 参数。两行相同的 SSN 产生不同的密文——没有模式泄露。

密钥长度

比加密算法要求更短的密钥会引发 ERROR 3200: VDF error in function 'encrypt': key too short for <cipher>: need N bytes, got M——它不会被零填充。更长的密钥会被静默截断。请使用恰好 16、24 或 32 字节。

存储什么

VARBINARY 列保存的是密文,前面加上了 IV(16 字节)。当明文长度恰好是 16 的倍数时,PKCS7 填充总是会添加一个完整的额外 AES 块(16 字节)——填充永远不会是零字节。所以安全的公式是明文长度 + 总共 32 字节(16 字节用于 IV,最多 16 字节用于填充)。为列留出余量:

这不能覆盖的内容

SQL 中的列级加密保护静态数据,防范有数据库访问权限但没有密钥的人。它不能防范:
  • 持有密钥并查询解密数据的应用代码——攻破应用的攻击者两者都能得到
  • 对加密列进行过滤或排序的查询(不解密就无法 WHERE ssn = ?)
对于可搜索加密或信封密钥管理(轮换密钥而无需重新加密所有数据),您需要在应用层增加额外的基础设施。

常见问题

我应该把加密密钥存储在哪里?

不要存在数据库里。密钥应放在密钥管理服务(AWS Secrets Manager、HashiCorp Vault、GCP Secret Manager)或环境变量中,由应用程序在运行时加载。存储在它所加密的同一个数据库中的密钥不提供任何保护。

我能在加密列上搜索吗?

不能直接搜索。解密每一行来查找匹配项是全表扫描。常见模式:在加密列旁边存储该值的确定性哈希用于等值查找(用 sha256(ssn) 查找 SSN),或者在应用层解密并构建加密的搜索索引。

如果我丢失了密钥会怎样?

数据将无法恢复。请把密钥与数据库分开备份。考虑信封加密——用主密钥包裹数据密钥——这样您可以轮换主密钥而无需重新加密所有数据。

我能用 DEFAULT 表达式加密列吗?

目前不能。非确定性函数(由于随机 IV,encrypt() 属于此类)不能用在 DEFAULT 表达式中。请在每条 INSERT 中生成加密值。

故障排除

另请参阅