1
0
0

OpenBao系列文章2-让 Pod 自己"刷脸"拿密钥:OpenBao + ServiceAccount + External Secrets Operator 实战

2026-10-14
2026-10-14
文章摘要
|

OpenBao系列文章2-让 Pod 自己"刷脸"拿密钥:OpenBao + ServiceAccount + External Secrets Operator 实战

上一篇我们在 RKE2 上搭好了会自动解封的 OpenBao 高可用集群。保险箱有了,新问题来了:业务应用怎么安全地把密钥取出来? 总不能再把 Root Token 塞进 Deployment 里吧?这篇就解决这件事:让 Pod 靠自己的身份"刷脸"拿密钥,并且用 External Secrets Operator 把密钥无感同步成 K8s Secret。

image.png

先想清楚:Pod 凭什么拿密钥?

最朴素的做法是给应用发一个 Token,写进环境变量。但这有三个老毛病:

  • Token 要长期有效,泄露了就是灾难
  • 谁来发、怎么轮换,又是新的管理负担
  • 本质上还是"把钥匙藏在另一把钥匙后面"

更好的思路是:让 Pod 用它与生俱来的身份来证明自己。

K8s 里每个 Pod 都跑在某个 ServiceAccount 下,K8s 会给它一个带签名的身份令牌(JWT)。OpenBao 的 Kubernetes 认证方式会拿着这个令牌去问 K8s API:"这个令牌是真的吗?属于哪个 ServiceAccount、哪个命名空间?"确认无误后,再按事先定好的规则,发一个短期有效的 OpenBao Token。

打个比方:

你去公司机房,门卫不会让你出示一把"万能钥匙",而是看你的工牌(ServiceAccount),打电话到 HR(K8s API)核实,再给你发一张当天有效的临时门禁卡(短期 Token),且只能进你有权限的房间(策略)。

整个流程里,应用不需要预先持有任何密钥。

整体流程

  1. Pod 带着 ServiceAccount 令牌来找 OpenBao
  2. OpenBao 请 K8s API 验证令牌(TokenReview)
  3. 验证通过,按 角色(Role) 匹配到对应 策略(Policy)
  4. 签发短期 Token,Pod 凭它读取允许范围内的密钥

涉及三个概念,记住就行:

概念一句话解释
认证方式(Auth Method)验证"你是谁",这里用 kubernetes
角色(Role)把"哪个 ServiceAccount"绑定到"哪些策略"
策略(Policy)规定"能读写哪些路径"

动手配置 OpenBao

进入 Pod 并登录

kubectl exec -ti -n openbao openbao-0 -- sh
bao login        # 输入 Root Token

上一篇说过,配置完成后要撤销 Root Token。本篇的配置做完,就是撤销它的好时机。

启用 KV 密钥引擎并写入测试数据

bao secrets enable -path=secret kv-v2
bao kv put secret/myapp/config username=app password=s3cr3t

KV v2 是带版本管理的键值存储,改错了还能回滚。

启用并配置 Kubernetes 认证

bao auth enable kubernetes

bao write auth/kubernetes/config \
  kubernetes_host="https://$KUBERNETES_PORT_443_TCP_ADDR:443"

在 OpenBao 的 Pod 里执行时,它会自动使用自己的 ServiceAccount 令牌和集群 CA 去调用 K8s API。

这里有个容易忽略的前提:OpenBao 自己的 ServiceAccount 必须有权限做 TokenReview。官方 Helm chart 默认会创建对应的 system:auth-delegator 绑定,如果你在 values 里关掉了它,这一步会报权限错误。

编写策略

给业务应用一份"只读自己目录"的策略:

bao policy write myapp - <<EOF
path "secret/data/myapp/*" {
  capabilities = ["read"]
}
EOF

注意路径里的 data/:KV v2 的实际读取路径是 secret/data/...,而命令行 bao kv get secret/myapp/config 会自动帮你补上。写策略时必须写完整路径,这是新手最常踩的坑。

创建角色,绑定身份

bao write auth/kubernetes/role/myapp \
  bound_service_account_names=myapp \
  bound_service_account_namespaces=default \
  policies=myapp \
  ttl=1h

意思是:只有 default 命名空间里叫 myapp 的 ServiceAccount,才能拿到 myapp 策略,Token 有效期 1 小时。

退出 Pod,然后在 K8s 里创建对应的 ServiceAccount:

kubectl create serviceaccount myapp -n default

到这里,OpenBao 这一侧就配好了。接下来是应用怎么用,常见有两种方式。

方式一:Agent Injector,把密钥"注入"Pod

原理

OpenBao 有个 Injector 组件,是一个 K8s 准入 Webhook。你只要在 Pod 上加几行注解,它就会自动给 Pod 塞一个 Sidecar 容器,负责登录、取密钥、写成文件放在共享目录,并且密钥更新时自动刷新。

应用只需要读文件,完全不用改代码去对接 OpenBao。

启用 Injector

在 Helm values 里确认开启:

injector:
  enabled: true
helm upgrade openbao openbao/openbao -n openbao -f values.yaml

示例 Deployment

apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
  namespace: default
spec:
  replicas: 1
  selector:
    matchLabels:
      app: myapp
  template:
    metadata:
      labels:
        app: myapp
      annotations:
        vault.hashicorp.com/agent-inject: "true"
        vault.hashicorp.com/role: "myapp"
        vault.hashicorp.com/agent-inject-secret-config: "secret/data/myapp/config"
    spec:
      serviceAccountName: myapp
      containers:
        - name: app
          image: busybox
          command: ["sh", "-c", "cat /vault/secrets/config && sleep 3600"]

部署后,进容器看看:

kubectl exec -n default deploy/myapp -c app -- cat /vault/secrets/config

默认输出是一段 Map 格式的内容。想要自定义格式(比如生成 .env 或配置文件),可以加模板注解 agent-inject-template-config,用 Go 模板自由拼装。

注解前缀、挂载路径等细节取决于 injector 的版本,请以 openbao-k8s 的官方文档为准。

优缺点

  • 优点:应用零改造;密钥不落入 K8s Secret(不进 etcd);支持动态刷新
  • 缺点:每个 Pod 多一个 Sidecar,占资源;排查问题多一层

方式二:External Secrets Operator,同步成原生 Secret

原理

很多应用(尤其是 Helm 部署的第三方软件)只认 K8s 原生 Secret,不可能让你去改。这时候用 External Secrets Operator(简称 ESO):

它像个"搬运工",定时去 OpenBao 把密钥取出来,自动创建并维护一个 K8s Secret。OpenBao 里改了,K8s Secret 自动跟着改。

OpenBao 与 Vault API 兼容,所以 ESO 直接用它的 Vault 提供者就能对接。

安装 ESO

helm repo add external-secrets https://charts.external-secrets.io
helm repo update

helm install external-secrets external-secrets/external-secrets \
  -n external-secrets --create-namespace \
  --set installCRDs=true

给 ESO 准备策略和角色

ESO 自己也要有身份。进入 OpenBao 的 Pod 执行:

bao policy write eso - <<EOF
path "secret/data/*" {
  capabilities = ["read"]
}
path "secret/metadata/*" {
  capabilities = ["read", "list"]
}
EOF

bao write auth/kubernetes/role/eso \
  bound_service_account_names=external-secrets \
  bound_service_account_namespaces=external-secrets \
  policies=eso \
  ttl=1h

这里为了演示给了整个 secret/ 的读权限。生产环境请按业务拆分路径,只授权必要范围,最小权限原则不能丢。

创建 ClusterSecretStore(告诉 ESO 去哪取)

apiVersion: external-secrets.io/v1
kind: ClusterSecretStore
metadata:
  name: openbao
spec:
  provider:
    vault:
      server: "http://openbao.openbao.svc:8200"
      path: "secret"
      version: "v2"
      auth:
        kubernetes:
          mountPath: "kubernetes"
          role: "eso"
          serviceAccountRef:
            name: external-secrets
            namespace: external-secrets

apiVersion 取决于你装的 ESO 版本,较老版本用 external-secrets.io/v1beta1。可以用 kubectl api-resources | grep external-secrets 确认。

几个字段用人话解释:

  • server:OpenBao 的集群内地址(生产请换成 https)
  • path + version:KV 引擎挂载在 secret,版本 v2
  • role:用前面创建的 eso 角色登录

确认连通

kubectl get clustersecretstore openbao

STATUS 显示 Valid、READY 为 True 就说明 ESO 已经能登录 OpenBao 了。

创建 ExternalSecret(告诉 ESO 取什么)

apiVersion: external-secrets.io/v1
kind: ExternalSecret
metadata:
  name: myapp-secret
  namespace: default
spec:
  refreshInterval: 1h
  secretStoreRef:
    name: openbao
    kind: ClusterSecretStore
  target:
    name: myapp-secret
    creationPolicy: Owner
  data:
    - secretKey: DB_PASSWORD
      remoteRef:
        key: myapp/config
        property: password
    - secretKey: DB_USER
      remoteRef:
        key: myapp/config
        property: username

注意:这里的 key 写 myapp/config,不要带 data/,ESO 会根据 version: v2 自动处理。

稍等几秒,检查结果:

kubectl get externalsecret -n default
kubectl get secret myapp-secret -n default -o jsonpath='{.data.DB_PASSWORD}' | base64 -d

看到 SecretSynced,并解出了 s3cr3t,就成功了。之后应用就像用普通 Secret 一样,通过 envFrom 或 volumeMounts 引用 myapp-secret 即可。

优缺点

  • 优点:应用零改造,兼容一切只认 K8s Secret 的软件;没有 Sidecar 开销
  • 缺点:密钥最终还是落在 K8s Secret(即 etcd)里,务必开启 etcd 的 Secret 加密(RKE2 的 secrets-encryption: true),并用 RBAC 严格限制谁能读 Secret

两种方式怎么选?

Agent InjectorExternal Secrets Operator
密钥落在哪Pod 内存卷,不进 etcdK8s Secret,进 etcd
额外资源开销每 Pod 一个 Sidecar全集群一个 Operator
适合场景对安全要求高、自研应用第三方软件、已有大量 Secret 用法
应用改造读文件无需改造
密钥更新Sidecar 自动刷新文件按 refreshInterval 同步

一个实用的建议:两者不冲突。核心业务、敏感度高的用 Injector;Helm 装的中间件、需要原生 Secret 的用 ESO。

踩坑清单

1. 登录报 permission denied
依次检查:ServiceAccount 名称、命名空间是否与 Role 里的 bound_service_account_* 完全一致;Pod 是否真的用了该 ServiceAccount(serviceAccountName)。

2. 读取报 403
99% 是策略路径问题。KV v2 的策略路径要带 data/,列目录要用 metadata/。

3. Injector 的注解不生效
确认 Injector 组件正常运行(kubectl get pods -n openbao);确认 Pod 是在 Injector 部署之后才创建的,已存在的 Pod 需要重启。

4. ClusterSecretStore 一直不是 Valid
先看事件:kubectl describe clustersecretstore openbao。常见原因是 server 地址不通、角色名写错,或者 ESO 的 ServiceAccount 与角色绑定的名字不一致。

5. Token 到期怎么办?
不用管。Injector 的 Sidecar 和 ESO 都会自动续期、重新登录。

收尾:撤销 Root Token

现在已经有了正常的接入方式,Root Token 就可以退休了。更稳妥的做法是先创建一个管理员策略和管理员身份,再撤销 Root Token:

bao token revoke <root-token>

以后真需要 Root 权限,用上一篇初始化时保存的 Recovery Key 重新生成即可。

全文总结

目标做法
应用不持有长期密钥Kubernetes 认证,ServiceAccount 换短期 Token
最小权限Policy 限定路径 + Role 限定身份
应用零改造(文件方式)Agent Injector 注入
兼容原生 SecretExternal Secrets Operator 同步
降低泄露面开启 etcd 加密 + 撤销 Root Token

到这里,从"搭建保险箱"到"让应用安全取钥匙",整条链路就打通了。

文档信息

下一篇,我们来聊聊 OpenBao 更酷的玩法:动态密钥。比如应用每次需要数据库账号时,OpenBao 当场创建一个有时效的临时账号,用完自动销毁,再也不存在"全公司共用一个数据库密码"的问题。感兴趣的朋友点个关注,我们下期见。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

OpenBao系列文章2-让 Pod 自己"刷脸"拿密钥:OpenBao + ServiceAccount + External Secrets Operator 实战
/archives/openbaoxi-lie-wen-zhang-2-rang-pod-zi-ji-shua-lian-na-mi-yao-openbao-serviceaccount-external-secrets-operator-shi-zhan
Author
Administrator
Published at
2026-10-14

欢迎来到我的博客!