PHP 密钥管理与轮换实践生产环境落地检查清单
然后第一部分:背景 / 常见问题,这里列实际生产遇到的坑,比如: 1. 密钥硬编码在代码/配置仓库,一旦泄露全站数据暴露 2. 密钥终身不轮换,泄露后无止损手段 3. 轮换时直接停服替换,导致业务中断 4. 轮换后旧密文无法解密,历史数据丢失 5. 测试/预发密钥与生产密钥混用,环境泄露导致生产数据被盗 然后第二部分:方案与落地检查清单,分模块,每个模块有检查项: 首先是【密钥存储检查清单】,检查项比如: □ 禁止将密钥硬编码在代码、Git 仓库、配置文件(如 .env 提交到仓库)中 □ 生产环境密钥通过环境变量、K8s Secret、云厂商KMS服务注入,禁止明文落盘 □ 密钥访问权限最小化,仅业务服务账号有读取权限,禁止开发/测试人员直接接触生产密钥 □ 密钥存储服务开启审计日志,所有读取操作可追溯 然后是【密钥生成与规范检查清单】: □ 使用PHP原生加密扩展(如sodium、openssl)生成密钥,禁止自定义弱加密算法 □ 密钥长度符合规范:对称密钥至少32字节,非对称RSA至少2048位,ECC至少256位 □ 不同业务线、不同环境(测试/预发/生产)使用独立密钥,禁止复用 □ 密钥生成过程在安全环境执行,禁止在客户端/前端生成密钥 然后是【密钥轮换检查清单】,这个是重点: □ 制定轮换周期,核心业务密钥不超过90天,普通业务密钥不超过180天 □ 轮换采用「双密钥兼容」策略:新密钥生成后先加入密钥池,旧密钥保留至少1个轮换周期,待所有历史数据迁移完成后再下线旧密钥 □ 轮换过程无停服:加密逻辑优先使用最新版本密钥,解密逻辑兼容所有有效历史密钥 □ 轮换前先在预发环境验证加密解密逻辑正常,再推生产 □ 轮换完成后立即下线旧密钥,回收权限,避免残留风险 然后是【灾备与监控检查清单】: □ 密钥定期备份,备份文件加密存储,与主存储物理隔离 □ 监控密钥异常访问行为(如非业务时间读取、异地访问),触发告警 □ 制定密钥泄露应急预案,明确轮换、通知、止损流程 然后第三部分:代码示例,这里写个支持多密钥版本轮换的加密解密工具类,用sodium扩展,可运行的,比如:
'hex密钥', ...] */
private $keyPool = [];
/** @var int 最新密钥版本号 */
private $latestVersion = 1;
public function __construct(array $keyPool)
{
// 校验密钥格式合法性
foreach ($keyPool as $version => $keyHex) {
if (!ctype_xdigit($keyHex) || strlen($keyHex) !== 64) {
throw new InvalidArgumentException("密钥版本{$version}格式非法,需为64位十六进制字符串");
}
$this->keyPool[$version] = $keyHex;
$this->latestVersion = max($this->latestVersion, $version);
}
}
/**
* 加密数据,自动使用最新版本密钥
*/
public function encrypt(string $plaintext): string
{
$key = hex2bin($this->keyPool[$this->latestVersion]);
$nonce = random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES);
$cipher = sodium_crypto_secretbox($plaintext, $nonce, $key);
// 返回格式:版本号(1字节) + nonce + 密文,方便解密时识别密钥版本
return pack('C', $this->latestVersion) . $nonce . $cipher;
}
/**
* 解密数据,自动兼容所有有效密钥版本
*/
public function decrypt(string $ciphertext): string
{
$version = unpack('C', substr($ciphertext,如需更完整的 PHP 代码保护与在线加密服务,可访问 https://article.vvxyz.com 了解更多。