Mbed TLS 4.0中硬件熵源接口的重大变更与升级指南

在Mbed TLS 4.0版本中，对硬件熵源采集接口进行了重要重构。这一变更不仅涉及函数签名的修改，还引入了更精细的熵含量评估机制，为后续功能扩展奠定了基础。

接口重构背景

早期版本通过mbedtls_hardware_poll()函数实现硬件熵源集成，但存在三个显著问题：

1. 函数声明意外移至内部头文件，导致类型检查缺失
2. 未考虑熵含量评估，限制了熵源质量的可控性
3. 冗余参数增加了接口复杂度

新版本通过全新的mbedtls_platform_get_entropy()接口解决了这些问题，同时保持向后兼容的升级路径。

新接口技术细节

新函数原型设计为：

int mbedtls_platform_get_entropy(
    unsigned char *output, 
    size_t len, 
    size_t *olen,
    size_t *entropy_content);

关键改进点包括：

1. 输出参数精简：移除了从未使用的data参数
2. 熵含量评估：新增entropy_content输出参数，支持未来实现渐进式熵收集
3. 公共头文件声明：明确在mbedtls/platform.h中声明，确保类型安全

兼容性处理策略

在过渡期内，系统将强制要求熵源提供完整熵值（即*entropy_content == 8 * *olen）。这种设计既保证了当前版本的稳定性，又为后续支持部分熵内容（0 < *entropy_content < 8 * *olen）的熵源预留了扩展空间。

开发者迁移指南

从3.x版本升级时需注意：

1. 函数重命名：从mbedtls_hardware_poll改为mbedtls_platform_get_entropy
2. 参数调整：移除第二个参数，新增熵含量输出参数
3. 返回值处理：保持相同的错误码约定
4. 头文件引用：改为包含mbedtls/platform.h

示例迁移代码：

// 旧版本实现
int mbedtls_hardware_poll(void *data, unsigned char *output, size_t len, size_t *olen) {
    // 实现代码
}

// 新版本实现
int mbedtls_platform_get_entropy(unsigned char *output, size_t len, size_t *olen, size_t *entropy) {
    // 实现代码
    *entropy = 8 * (*olen); // 必须声明完整熵值
}

架构演进意义

这一变更标志着Mbed TLS向更模块化的安全架构迈进：

1. 为PSA随机数生成驱动接口（PSA random generation drivers）奠定基础
2. 提升熵源质量的可观测性
3. 保持用户层接口的简洁性，将复杂逻辑封装在库内部

对于系统集成商而言，新接口提供了更规范的硬件熵源集成方式，同时为未来支持各类TRNG硬件保留了充足的扩展空间。