容器与云原生 / 系统课时
Secret 安全实践
Secret 安全实践
Secret 的安全不等于把明文改成 Base64。本课将从静态加密、RBAC 最小权限、外部密钥系统和轮换流程四层入手,完成一套可验证、可回滚的 Secret 保护方案。
学习目标
- 识别 Secret 在存储、传输、授权和使用阶段的主要暴露面
- 配置静态加密,并用 RBAC 把读取权限限制到指定工作负载
- 设计外部密钥接入与不中断业务的凭据轮换流程
先明确 Secret 的保护边界
data 字段中的值只是 Base64 编码,任何拿到对象内容的人都能还原。默认情况下,Secret 会以未加密形式写入 etcd;因此必须同时保护 API 访问、etcd、控制面主机、审计日志和应用自身的输出。

配置静态加密与最小权限
生产集群优先考虑 KMS v2,把主密钥保存在集群外部;本地密钥方案只能降低 etcd 数据泄露的风险,不能抵御控制面主机同时失陷。下面的完整配置使用 secretbox 演示提供者顺序,identity 暂时放在末尾,以便迁移期间读取旧的未加密数据。
apiVersion: apiserver.config.k8s.io/v1
kind: EncryptionConfiguration
resources:
- resources:
- secrets
providers:
- secretbox:
keys:
- name: key-2026-08
secret: <BASE64_32_BYTE_KEY>
- identity: {}将文件以仅 kube-apiserver 运行用户可读的权限保存,并通过 --encryption-provider-config=<PATH> 加载。先在全部控制面实例部署同一配置,再重写已有 Secret;确认迁移和备份均成功后,才移除 identity 回退项。提供者列表中的第一项负责加密新写入的数据。
kubectl get secrets --all-namespaces -o json | kubectl replace -f -预期输出
secret/<SECRET_NAME> replaced实际会为每个成功重写的 Secret 输出一行,名称和数量因集群而异。验证时不能只执行 kubectl get secret,因为 API Server 会正常解密后返回数据;自管集群应检查 etcd 中的原始记录包含 k8s:enc: 前缀且不出现业务明文,托管集群则核对控制面静态加密状态。
静态加密并不会缩小 API 权限,因此还要把读取范围压到具体命名空间、具体 Secret 和 get 动词。Kubernetes 官方 RBAC 实践建议优先使用命名空间级授权并避免通配符。
apiVersion: v1
kind: ServiceAccount
metadata:
name: payments-api
namespace: payments
---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
name: payments-db-secret-reader
namespace: payments
rules:
- apiGroups: [""]
resources: ["secrets"]
resourceNames: ["payments-db"]
verbs: ["get"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: payments-api-read-db-secret
namespace: payments
subjects:
- kind: ServiceAccount
name: payments-api
namespace: payments
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: Role
name: payments-db-secret-reader应用该清单后,验证服务账号只能读取指定对象,不能枚举命名空间内的全部 Secret。
kubectl auth can-i get secret/payments-db \
--as=system:serviceaccount:payments:payments-api \
-n payments
kubectl auth can-i list secrets \
--as=system:serviceaccount:payments:payments-api \
-n payments预期输出
yes
no接入外部密钥系统并安排轮换
当凭据由云 KMS、Vault 或硬件安全模块统一管理时,可通过外部 Secret 提供者按需取回,并使用 Secrets Store CSI Driver 挂载给获准的 Pod。除非兼容旧应用确有需要,否则不要无条件把外部值再同步成长期存在的 Kubernetes Secret;同时要限制只有需要凭据的容器能看到挂载。
轮换应采用“发布新版本、双凭据短暂并存、切换工作负载、验证、撤销旧版本”的顺序。环境变量中的值不会在进程运行期间自动刷新,通常需要滚动重启;普通 Secret 卷会由 kubelet 按检测策略更新,但使用 subPath 的挂载不会收到自动更新。对不允许原地修改的凭据,可使用新名称并设置 immutable: true,再通过工作负载版本变更完成切换。
轮换完成后至少验证三件事:新 Pod 能成功认证,旧凭据已无法使用,应用日志、事件和监控中没有出现明文。若任何一步失败,应保留旧版本并立即回滚工作负载引用,而不是先删除唯一可用的凭据。