登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  python教程

Python hmac.compare_digest 的类型约束与摘要校验边界

来源:17golang原创

时间:2026-11-16 22:32:45 235浏览 收藏

Python 里校验 HMAC 时,hmac.compare_digest 只负责比较两个已经得到的摘要,不负责生成摘要,也不替你决定编码。最稳妥的配对是 digest() 对 digest(),或者 hexdigest() 对 hexdigest();一边是 bytes、另一边是 str 时,应先修正表示方式,而不是把异常吞掉。

要点速览
  • compare_digest 接受同类型的 ASCII str,或两个 bytes-like 对象。
  • digest() 返回二进制摘要,hexdigest() 返回十六进制字符串,二者不要交叉比较。
  • 长度不同会返回不相等;类型、长度等元信息仍可能被观察到,不能把它当成完整认证协议。

先把 HMAC 生成和摘要比较分开

HMAC 的计算需要密钥、消息和摘要算法;比较只回答“本地计算出的摘要是否等于外部提供的摘要”。职责分开后,排查会清楚很多:生成阶段关注密钥、消息字节和算法;比较阶段关注两边是不是同一种表示。

Python hmac.compare_digest 中 digest 与 hexdigest 两种摘要表示的类型配对说明图
图1:digest 与 hexdigest 的输入类型配对关系,这是原创静态结构说明图,不是运行截图。
import hashlib
import hmac

def verify_hex_signature(key: bytes, message: bytes, received_hex: str) -> bool:
    # 先按约定算法生成十六进制字符串,再和同类型输入比较。
    expected_hex = hmac.new(key, message, hashlib.sha256).hexdigest()
    # compare_digest 只负责比较,不负责生成 HMAC 或替你编码消息。
    return hmac.compare_digest(expected_hex, received_hex)

如果接口传来的是原始二进制摘要,就把两边都保留为 bytes:

def verify_raw_signature(key: bytes, message: bytes, received: bytes) -> bool:
    # digest() 返回原始字节,适合已经按二进制传输的摘要。
    expected = hmac.new(key, message, hashlib.sha256).digest()
    # 两个参数都是 bytes,避免 bytes 与 str 混比。
    return hmac.compare_digest(expected, received)

类型、编码和长度是三个不同的边界

compare_digest 要求两边同类型:可以都是 ASCII 范围内的 str,也可以都是 bytes-like 对象。不要把十六进制字符串直接和 digest() 的结果比较,也不要为了“兼容”随意对外部值做多次编码。

本地结果外部值处理方式
digest() 的 bytes原始 bytes直接比较
hexdigest() 的 strASCII 十六进制 str直接比较
bytesstr先统一协议表示,不能直接比较
固定长度摘要长度不同返回不相等,同时记录输入格式问题

这里的“统一”必须来自接口协议。例如,外部值约定为十六进制文本,就校验它是 ASCII 文本并使用 hexdigest();约定为 Base64,则应先按协议解码为字节,再和 digest() 的结果比较。不要先把任意字符串用 UTF-8 编码,再假定它就是摘要。

把 compare_digest 放在认证流程的最后一步

安全比较不能修复错误的密钥、消息拼接、算法选择或重放控制。它的价值是避免普通相等运算在摘要校验场景中的内容短路行为;官方文档同时提醒,类型和长度等信息仍可能泄露,因此不能把它描述成“所有时序信息都不可见”。

Python HMAC 校验中消息字节、摘要计算、compare_digest 和边界错误的职责分层说明图
图2:HMAC 校验的职责分层与类型错误边界,这是原创静态结构说明图,不是运行截图。
def verify_request(key: bytes, body: bytes, supplied_hex: str) -> bool:
    # 外部输入先按协议限制为 ASCII,异常输入直接判定失败。
    try:
        supplied_hex.encode("ascii")
    except UnicodeEncodeError:
        return False

    # 消息字节必须来自同一套规范化规则,不能在这里临时改编码。
    expected_hex = hmac.new(key, body, hashlib.sha256).hexdigest()
    # 比较只放在摘要已经算好之后,并保持两边都是 str。
    return hmac.compare_digest(expected_hex, supplied_hex)

排查时先看异常发生在哪一层:TypeError 多半是类型配对错了;返回 False 但长度不同,通常是传输格式或算法约定不一致;长度相同仍不相等,才继续核对消息原文、密钥和摘要算法。日志不要记录密钥或完整签名,可以只记录表示类型和长度。

常见问题

compare_digest 能直接生成签名吗?

不能。它只比较两个已有值;HMAC 应由 hmac.new、hmac.digest 或 HMAC 对象生成。

为什么 hexdigest 和 digest 不能直接比较?

前者是十六进制文本,后者是原始字节,表示和类型都不同。统一使用同一组 API 即可。

长度不同是不是一定代表攻击?

不一定,也可能只是摘要编码、算法或请求格式配置错了。应拒绝校验,并把它作为输入协议问题排查。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>