跳转到主要内容

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

All examples on this page work on VillageSQL. Install Now →
哈希告诉您数据长什么样。HMAC 告诉您数据来自知道密钥的人。当您要验证某一行没有被篡改、某个 webhook 负载是真实的、或者某个令牌是由您的系统生成而不是伪造的时,这个区别就很重要。MySQL 没有内置的 HMAC 函数——标准答案是在应用程序代码中计算它。VillageSQL 的 hmac() 让您可以在 SQL 中完成。

问题:没有内置 HMAC

MySQL 有 SHA2() 和 MD5() 用于哈希,但没有任何接受密钥的函数。HMAC(基于哈希的消息认证码)使用共享密钥生成认证码——它与普通哈希有根本的不同,因为没有密钥的人无法重现它。 典型的做法是在写入数据库之前在应用程序中计算 HMAC:
这可以工作,但意味着每条写入路径——每种语言、每个服务和每个批量加载器——都必须复制签名逻辑。绕过应用程序的迁移脚本会写入未签名的行。

使用 VillageSQL:SQL 中的 hmac()

VillageSQL 的 vsql_crypto 扩展添加了 hmac(data, key, algorithm),它返回一个完全在 MySQL 中计算的 VARBINARY 认证码。

在触发器中为行签名

使用触发器在写入时为每一行签名,无论是哪条应用程序路径创建了它:

验证 webhook 负载

如果您的应用程序存储传入的 webhook 负载,您可以在处理之前直接在 SQL 中验证签名:

支持的算法

新代码请使用 HMAC-SHA256。HMAC 结构不会继承底层哈希的碰撞漏洞,因此 HMAC-SHA1 并不像普通 SHA-1 那样已被攻破——但 SHA-1 已被弃用,监管机构将其视为旧算法。不要在新代码中使用它。

HMAC 与普通哈希

如果您要保护的数据是公开的,普通哈希证明不了任何事。当您需要证明数据由知道密钥的人产生时,使用 HMAC。关于不带密钥的哈希,请参阅 在 MySQL 中对数据进行哈希。

常见问题

把 HMAC 密钥存在触发器中安全吗?

不安全——它被硬编码在触发器定义中,任何有 SHOW CREATE TRIGGER 权限的人都能看到。在生产环境中,请从安全的配置路径获取密钥,或者将其作为应用程序在连接时设置的会话变量传入。将密钥视为凭据。

我可以用 HMAC 验证查询结果在传输中没有被篡改吗?

HMAC 防御的是未经授权的修改,而不是窃听。对于传输中的保护,请为您的 MySQL 连接使用 TLS。HMAC 的用处在于检测数据到达数据库之后的篡改。

如何轮换 HMAC 密钥?

在切换之前,用新密钥重新签名所有现有行:

hmac() 对相同的输入返回相同的输出吗?

是的——HMAC 是确定性的。相同的数据 + 相同的密钥 + 相同的算法总是产生相同的结果。这正是验证能够工作的原因。

故障排除

另请参阅