原始来源日期:2026-10-13。wolfSSL 修正 AES Direct 接口与加密设备回调的集成顺序。提交说明,`wc_AesEncryptDirect` 和 `wc_AesDecryptDirect` 过去会跳过 crypto callback;如果 AES 对象的密钥只存在于设备中,软件侧没有完成密钥扩展,Direct 路径却仍尝试以空的软件密钥表执行。
新实现会在 Direct 加密或解密前检查回调配置。带有效 `devId` 的对象先把单个 AES 块作为 ECB 请求交给设备;启用设备发现模式时,即使对象本身没有固定设备标识,也允许发现回调选择设备。只有设备返回“不可用”这一特定结果时,代码才继续走软件实现。
错误传播边界被明确区分:设备完成操作时直接返回其结果;设备报告真实错误时原样返回,不再悄悄回退;只有明确拒绝处理时才允许软件路径接手。文档也同步加入该行为,并再次提醒直接 ECB API 的适用范围有限,绝大多数应用不应把它当成通用数据加密模式。
问题的关键不是 AES 算法本身,而是密钥所有权跨越软件与 HSM、加速器或安全元件的边界。设备拥有密钥时,软件对象可能只有句柄或标签;任何绕过回调的旁路都可能造成错误结果,或让应用误以为操作仍在受保护设备中完成。提交未声称密钥被导出,也没有提供 CVE 或远程利用证据。
此提交随后还有测试与构建守卫的配套提交,覆盖设备成功、拒绝、失败、无设备和发现模式等情况。本条以最先改变运行路径的提交作为来源,避免把同一事件拆成多篇。具体可用性仍取决于构建宏、设备回调实现,以及设备是否支持单块 ECB 请求。
量仔观察
本站认为,这类“句柄密钥被软件旁路”是密码敏捷和 HSM 迁移中的高风险集成点。即使未来把 RSA、ECC 或 AES 替换为新的硬件算法,接口若不能表达“密钥不可导出且必须在设备内使用”,仍会产生相同问题。此次修复把回退条件收窄到明确的 unavailable,有利于阻止静默降级;部署方还应把实际执行位置和回调错误纳入可观测性。