身份认证与应用安全 / 系统课时
生成并管理 JWT 签名密钥
生成并管理 JWT 签名密钥
JWT 是否可信,最终取决于签名密钥是否足够强、是否只被授权组件持有,以及是否能够安全轮换。本节以常见的 HS256 为例生成密钥,并把“源码常量”改造成可部署、可轮换的外部配置。
学习目标
- 按签名算法准备满足强度要求的密钥材料
- 用安全随机数生成 HS256 密钥并验证实际字节数
- 区分源码常量、配置文件、环境变量与秘密管理服务的风险边界
先按签名算法确定密钥材料
HS256 使用 HMAC-SHA-256,签发和校验共用同一份秘密,因此密钥至少应有 256 位,也就是 32 字节的高熵随机数据。不要把普通密码、项目名或短字符串直接当签名密钥。
如果系统由多个独立服务负责校验令牌,且不希望每个校验方都具备签发能力,可以考虑 RSA 或 EC 这类非对称算法:认证服务持有私钥签名,其他服务只拿公钥验证。无论选择哪类算法,密钥长度都应满足对应算法和库的要求。
生成一把 HS256 随机密钥
下面命令依赖 OpenSSL。它生成 32 字节随机数据,再以 Base64 文本输出,并立即解码检查实际字节数。
SECRET=$(openssl rand -base64 32)
printf '%s\n' "$SECRET"
printf '%s' "$SECRET" | openssl base64 -d -A | wc -c预期输出
<BASE64_SECRET>
32<BASE64_SECRET> 每次都会不同,这是正确现象。应保存随机生成的结果,而不是把示例占位符当成真实密钥。应用读取后要按 Base64 解码成原始字节,再用于 HMAC 签名。
把密钥从源码移到外部配置
把密钥写成 Java 常量看似方便,但它会随着源码、构建产物和镜像一起传播。把明文直接写进已提交的 application.yml 也没有本质改善,只是换了一个泄露位置。
更合理的配置方式是只在配置文件中保留变量引用,让部署环境负责注入真实值。下面是 application.yml 的片段示例,依赖部署环境提供 JWT_SECRET。
security:
jwt:
secret-base64: ${JWT_SECRET}该配置生效后,Spring Boot 启动时会从环境或其他 PropertySource 解析 JWT_SECRET。应用应在启动阶段完成 Base64 解码并检查长度;缺失、无法解码或不足 32 字节时直接启动失败,不要退回默认密钥。
开发环境可以通过本机环境变量或仅本机可见的秘密文件注入值;生产环境更适合使用云秘密管理服务、Kubernetes Secret 配合外部密钥系统,或组织已有的安全配置中心。关键原则是:真实密钥不进入源码仓库,也不由业务日志打印。
为轮换保留操作空间
生产系统不能假设一把密钥永久有效。常见轮换过程是先发布新密钥用于签发,同时暂时保留旧密钥用于校验;等所有旧访问令牌自然过期后,再停止接受旧密钥。
如果同时存在多把可验证密钥,可在 JWT Header 中使用 kid 标识当前签名使用的密钥版本。校验端按 kid 选择对应密钥,而不是逐把尝试,这样更容易审计和撤销。
密钥管理最终要做到三点:生成时使用密码学安全随机源,存储时限制读取范围,轮换时允许新旧密钥短暂重叠。只要这三点成立,JWT 签名才不会因为“密钥写在哪儿”这一环把整个认证链路变成单点风险。