AKS环境下基于K8s CSR的Vault TLS配置与AppRole登录证书报错问题
报错根因
- 报错码
UNABLE_TO_VERIFY_LEAF_SIGNATURE的本质是后端服务配置了strictSSL: true开启严格TLS校验,但服务运行时的信任库中,没有存储签发Vault服务端证书的根CA公钥,TLS握手阶段直接被客户端拦截,和AppRole认证流程本身无关。 - 端口转发场景可正常操作的原因:kubectl端口转发建立的是本地到API Server的加密隧道,你在操作Vault时要么手动指定了本地的CA证书路径,要么临时关闭了SSL校验,没有触发严格证书校验逻辑,因此暴露不了这个问题。
关于你计划沿用的kubelet-serving签名方案在AKS中的适用性
kubernetes.io/kubelet-serving是Kubernetes内置的专用签名者,设计用途仅为给kubelet节点服务签发节点级Serving证书,从设计层面就不支持给用户自定义工作负载(比如Vault业务服务)签发证书,不属于生产环境给业务签发证书的推荐路径。- 技术层面该签名者无法满足Vault的证书需求:内置的签名审批逻辑会严格校验证书的SAN字段,仅允许包含节点自身的主机名,不会给包含集群Service域名(比如你的
vault.vault.svc.cluster.local)的CSR签发合法证书。 - 在AKS环境中,该签名者对应的根CA是托管的控制面核心信任组件,无公开的导出途径,也不允许用户直接读取用于自定义业务的信任配置,你之前在本地K3s集群能拿到这个CA做信任,本质是K3s的全栈用户可控特性,和AKS的托管安全模型不兼容,这条路在AKS生产环境本身就无法落地。
AKS环境下的生产级解决方案
- 优先采用Kubernetes生态通用的证书管理组件为Vault签发TLS证书:由组件自动完成证书签发、续期的全生命周期管理,不需要手动维护证书有效期。
- 证书链路打通逻辑:将对应签发体系的根CA公钥通过Kubernetes Secret挂载到所有需要访问Vault的后端服务容器中,通过环境变量
NODE_EXTRA_CA_CERTS指定CA文件的路径,Node.js运行时会自动将该CA加入系统信任库,不需要修改业务代码的SSL校验逻辑。 - 临时验证方案(禁止生产长期使用):在后端服务测试阶段可临时将请求配置中的
strictSSL设为false,先打通AppRole登录的全链路逻辑,排除非证书类的配置问题后再替换为正式的CA信任配置。
快速落地操作步骤
- 提取当前Vault使用的根CA证书:进入Vault Pod,导出当前服务端证书链的根CA公钥。
- 将提取的CA公钥创建为对应命名空间下的Kubernetes Secret,供同命名空间的后端服务挂载使用。
- 修改后端服务的Deployment配置,挂载该Secret并配置
NODE_EXTRA_CA_CERTS环境变量指向挂载的CA文件路径,重启服务后即可正常完成TLS校验。 - 若需要实现证书自动续签能力,可在集群内部署独立的签名控制器,不要依赖控制面内置的kubelet-serving签名体系,避免受托管控制面的权限限制。
内容的提问来源于stack exchange,提问作者Jamie
相关产品推荐
相关产品推荐

