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

先想清楚:Pod 凭什么拿密钥?
最朴素的做法是给应用发一个 Token,写进环境变量。但这有三个老毛病:
- Token 要长期有效,泄露了就是灾难
- 谁来发、怎么轮换,又是新的管理负担
- 本质上还是"把钥匙藏在另一把钥匙后面"
更好的思路是:让 Pod 用它与生俱来的身份来证明自己。
K8s 里每个 Pod 都跑在某个 ServiceAccount 下,K8s 会给它一个带签名的身份令牌(JWT)。OpenBao 的 Kubernetes 认证方式会拿着这个令牌去问 K8s API:"这个令牌是真的吗?属于哪个 ServiceAccount、哪个命名空间?"确认无误后,再按事先定好的规则,发一个短期有效的 OpenBao Token。
打个比方:
你去公司机房,门卫不会让你出示一把"万能钥匙",而是看你的工牌(ServiceAccount),打电话到 HR(K8s API)核实,再给你发一张当天有效的临时门禁卡(短期 Token),且只能进你有权限的房间(策略)。
整个流程里,应用不需要预先持有任何密钥。
整体流程
- Pod 带着 ServiceAccount 令牌来找 OpenBao
- OpenBao 请 K8s API 验证令牌(TokenReview)
- 验证通过,按 角色(Role) 匹配到对应 策略(Policy)
- 签发短期 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,版本 v2role:用前面创建的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 Injector | External Secrets Operator | |
|---|---|---|
| 密钥落在哪 | Pod 内存卷,不进 etcd | K8s 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 注入 |
| 兼容原生 Secret | External Secrets Operator 同步 |
| 降低泄露面 | 开启 etcd 加密 + 撤销 Root Token |
到这里,从"搭建保险箱"到"让应用安全取钥匙",整条链路就打通了。
文档信息
- 文章作者:运维技术团队 - Devin
- 发布日期:2026-10-15
- 适用平台:linux
- 参考链接:
https://openbao.org/docs/secrets/kubernetes/
下一篇,我们来聊聊 OpenBao 更酷的玩法:动态密钥。比如应用每次需要数据库账号时,OpenBao 当场创建一个有时效的临时账号,用完自动销毁,再也不存在"全公司共用一个数据库密码"的问题。感兴趣的朋友点个关注,我们下期见。
