容器与云原生 / 系统课时

Secret 安全实践

Secret 安全实践

Secret 的安全不等于把明文改成 Base64。本课将从静态加密、RBAC 最小权限、外部密钥系统和轮换流程四层入手,完成一套可验证、可回滚的 Secret 保护方案。

学习目标

  • 识别 Secret 在存储、传输、授权和使用阶段的主要暴露面
  • 配置静态加密,并用 RBAC 把读取权限限制到指定工作负载
  • 设计外部密钥接入与不中断业务的凭据轮换流程

先明确 Secret 的保护边界

data 字段中的值只是 Base64 编码,任何拿到对象内容的人都能还原。默认情况下,Secret 会以未加密形式写入 etcd;因此必须同时保护 API 访问、etcd、控制面主机、审计日志和应用自身的输出。

Secret 从密钥源到工作负载的分层保护链路

配置静态加密与最小权限

生产集群优先考虑 KMS v2,把主密钥保存在集群外部;本地密钥方案只能降低 etcd 数据泄露的风险,不能抵御控制面主机同时失陷。下面的完整配置使用 secretbox 演示提供者顺序,identity 暂时放在末尾,以便迁移期间读取旧的未加密数据。

yaml
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 回退项。提供者列表中的第一项负责加密新写入的数据。

bash
kubectl get secrets --all-namespaces -o json | kubectl replace -f -

预期输出

text
secret/<SECRET_NAME> replaced

实际会为每个成功重写的 Secret 输出一行,名称和数量因集群而异。验证时不能只执行 kubectl get secret,因为 API Server 会正常解密后返回数据;自管集群应检查 etcd 中的原始记录包含 k8s:enc: 前缀且不出现业务明文,托管集群则核对控制面静态加密状态。

静态加密并不会缩小 API 权限,因此还要把读取范围压到具体命名空间、具体 Secret 和 get 动词。Kubernetes 官方 RBAC 实践建议优先使用命名空间级授权并避免通配符。

yaml
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。

bash
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

预期输出

text
yes
no

接入外部密钥系统并安排轮换

当凭据由云 KMS、Vault 或硬件安全模块统一管理时,可通过外部 Secret 提供者按需取回,并使用 Secrets Store CSI Driver 挂载给获准的 Pod。除非兼容旧应用确有需要,否则不要无条件把外部值再同步成长期存在的 Kubernetes Secret;同时要限制只有需要凭据的容器能看到挂载。

轮换应采用“发布新版本、双凭据短暂并存、切换工作负载、验证、撤销旧版本”的顺序。环境变量中的值不会在进程运行期间自动刷新,通常需要滚动重启;普通 Secret 卷会由 kubelet 按检测策略更新,但使用 subPath 的挂载不会收到自动更新。对不允许原地修改的凭据,可使用新名称并设置 immutable: true,再通过工作负载版本变更完成切换。

轮换完成后至少验证三件事:新 Pod 能成功认证,旧凭据已无法使用,应用日志、事件和监控中没有出现明文。若任何一步失败,应保留旧版本并立即回滚工作负载引用,而不是先删除唯一可用的凭据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Secret 安全实践

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通