摘要
本版本增强个人凭据和 Bearer Key 的存储安全性,客户端已有令牌继续有效。
[!WARNING] 升级前请备份数据库/配置文件,并保留原个人凭据加密密钥。 密钥丢失后,仅有数据库备份无法恢复绑定。操作步骤见升级与恢复指南。
[!CAUTION] Bearer Key 哈希迁移不可逆。 迁移后不可直接使用旧版本读取已迁移的数据库/配置,回滚必须恢复升级前的备份。
修复
- 个人凭据(#1393): 数据库模式不再自动生成本地加密密钥,需配置
MCPHUB_CREDENTIAL_ENCRYPTION_KEY或保留已有的有效密钥文件;升级和多实例部署必须使用同一密钥。密钥丢失后,仅有数据库备份无法恢复绑定。正常部署的升级步骤及密钥丢失后的处理方案见升级与恢复指南。 - Bearer Key(#1387): 改为保存 SHA-256 哈希,启动时自动迁移已有明文密钥。客户端已有令牌继续有效,新建令牌仅在创建时返回一次。迁移后不可直接用旧版本读取已迁移的数据库/配置,回滚需恢复升级前备份。 从文件模式切换到数据库模式时,应先以文件模式运行新版本一次,或清除源配置文件遗留的明文密钥。