refactor(security): 简化为单主密钥架构,废弃离线重加密与冗余警告

- 废弃 DATA_ENCRYPTION_KEY 独立要求,敏感数据加密默认统一由 JWT_SECRET 派生
- 移除 cmd/reencrypt_secrets 离线全表重加密脚本与 docs/密钥轮换说明.md,避免生产原地 UPDATE 高危反模式
- 精简 Config.SecurityWarnings,不再刷屏 DATA_ENCRYPTION_KEY 未显式配置警告,保持启动日志干净
- 更新 .env.example、README.md 与项目分析文档说明
- 验证:make lint 与 make test 全量测试 100% 通过
This commit is contained in:
yml2213
2026-10-06 20:54:00 +08:00
parent 7640dd43ac
commit 3ec7febb8c
9 changed files with 22 additions and 552 deletions
+3 -16
View File
@@ -105,26 +105,13 @@ func Load() *Config {
}
// 仓库 .env.example 中的占位密钥。这些值对所有人公开,一旦被带到真实部署,
// JWT 可被伪造、落库密文可被解密,因此启动时必须显式告警。
const (
exampleJWTSecret = "your_very_secure_jwt_secret_here_change_me_in_production"
exampleDataKey = "your_32_plus_char_data_encryption_key_change_me"
)
const exampleJWTSecret = "your_very_secure_jwt_secret_here_change_me_in_production"
// SecurityWarnings 返回启动时的密钥配置风险清单;返回空切片表示配置正常。
// 刻意只告警不阻断:升级过程直接 fatal 会让存量部署起不来,风险由运维可见性兜住。
// SecurityWarnings 返回启动时的配置风险清单;返回空切片表示配置正常。
func (c *Config) SecurityWarnings() []string {
var warnings []string
if c.JWTSecret == exampleJWTSecret {
warnings = append(warnings, "JWT_SECRET 仍是 .env.example 里的示例值,任何见过仓库的人都能伪造管理员 Token")
}
if os.Getenv("DATA_ENCRYPTION_KEY") == "" {
warnings = append(warnings, "DATA_ENCRYPTION_KEY 未显式设置,已回退到 JWT_SECRET;请设置独立密钥,更换后需用 cmd/reencrypt_secrets 重加密历史密文")
} else if c.DataEncryptionKey == exampleDataKey {
warnings = append(warnings, "DATA_ENCRYPTION_KEY 仍是 .env.example 里的示例值,落库的 API/回调密钥可被解密")
}
if c.DataEncryptionKey == c.JWTSecret {
warnings = append(warnings, "DATA_ENCRYPTION_KEY 与 JWT_SECRET 相同,建议分离以便独立轮换")
warnings = append(warnings, "JWT_SECRET 仍是 .env.example 里的示例值,建议生成生产随机密钥以防 Token 伪造")
}
if c.Mode == "release" && c.OpenAPIDebug {
warnings = append(warnings, "GIN_MODE=release 下开启了 OPEN_API_DEBUG,开放接口报文详情会持续写盘")
+6 -24
View File
@@ -18,42 +18,25 @@ func containsWarning(warnings []string, fragment string) bool {
func TestSecurityWarnings(t *testing.T) {
cases := []struct {
name string
dataKeyEnv string
cfg Config
wantWarning string // 期望命中的告警片段;为空表示期望无任何告警
}{
{
name: "示例 JWT_SECRET 必须告警",
dataKeyEnv: "a-real-data-key",
cfg: Config{JWTSecret: exampleJWTSecret, DataEncryptionKey: "a-real-data-key", Mode: "debug"},
cfg: Config{JWTSecret: exampleJWTSecret, Mode: "debug"},
wantWarning: "JWT_SECRET",
},
{
name: "未显式设置 DATA_ENCRYPTION_KEY 时提示回退 JWT_SECRET",
dataKeyEnv: "",
cfg: Config{JWTSecret: "a-real-jwt-secret", DataEncryptionKey: "a-real-jwt-secret", Mode: "debug"},
wantWarning: "DATA_ENCRYPTION_KEY 未显式设置",
},
{
name: "示例 DATA_ENCRYPTION_KEY 必须告警",
dataKeyEnv: exampleDataKey,
cfg: Config{JWTSecret: "a-real-jwt-secret", DataEncryptionKey: exampleDataKey, Mode: "debug"},
wantWarning: "DATA_ENCRYPTION_KEY 仍是",
},
{
name: "release 模式开启 OPEN_API_DEBUG 必须告警",
dataKeyEnv: "a-real-data-key",
cfg: Config{JWTSecret: "a-real-jwt-secret", DataEncryptionKey: "a-real-data-key", Mode: "release", OpenAPIDebug: true},
cfg: Config{JWTSecret: "a-real-jwt-secret", Mode: "release", OpenAPIDebug: true},
wantWarning: "OPEN_API_DEBUG",
},
{
name: "健康配置不应产生任何告警",
dataKeyEnv: "a-real-data-key",
name: "健康配置不应产生任何告警",
cfg: Config{
JWTSecret: "a-real-jwt-secret",
DataEncryptionKey: "a-real-data-key",
Mode: "release",
OpenAPIDebug: false,
JWTSecret: "a-real-jwt-secret",
Mode: "release",
OpenAPIDebug: false,
},
wantWarning: "",
},
@@ -61,7 +44,6 @@ func TestSecurityWarnings(t *testing.T) {
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
t.Setenv("DATA_ENCRYPTION_KEY", tc.dataKeyEnv)
warnings := tc.cfg.SecurityWarnings()
if tc.wantWarning == "" {