You need to enable JavaScript to run this app. K8s独立部署OPA无法被Envoy边车触发执行授权策略的问题排查
优惠活动
大模型
产品
解决方案
定价
更多

K8s独立部署OPA无法被Envoy边车触发执行授权策略的问题排查

核心问题排查结论

当前所有现象的根因是Envoy无法连通OPA服务,ext_authz过滤器在集群不可达时直接触发默认拒绝逻辑,请求根本没有送达OPA进程,和授权策略、JWT校验逻辑、后端应用配置都无关。

关键故障点定位

  • 缺失OPA对应的K8s Service资源:Envoy配置中OPA集群采用STRICT_DNS类型,通过主机名opa寻址9191端口的gRPC服务,但你当前仅部署了OPA的Deployment,没有创建对应的K8s Service。
    K8s集群内的Pod要解析opa这个主机名,必须存在和Deployment同命名空间、匹配app: opa标签选择器的Service,否则DNS解析直接失败,Envoy根本拿不到OPA的Pod IP,无法建立gRPC连接。
  • 故障表现完全匹配上述逻辑:
    1. 收到的403响应头server: envoy、空响应体,正是ext_authz过滤器的默认失败策略——当授权后端集群不可达时,过滤器不会尝试转发请求到后端应用,也不会向OPA发请求,直接返回403。
    2. OPA侧完全没有收到授权请求、没有决策日志,也直接印证了连接从未建立,请求根本没跨网络到达OPA容器。
  • 排除其他干扰项:
    1. 如果是OPA策略校验不通过返回的403,OPA一定会打印对应的决策日志,和你当前观测到的“无决策日志”现象矛盾。
    2. 后端应用如果直接返回403,响应头不会是server: envoy,也会带应用自身的响应特征,和当前返回头不匹配。

修复操作步骤

  • 补全OPA的K8s Service配置,明确暴露gRPC端口:
    apiVersion: v1
    kind: Service
    metadata:
      name: opa
    spec:
      selector:
        app: opa
      ports:
        - name: ext-authz-grpc
          port: 9191
          targetPort: 9191
        - name: http
          port: 8181
          targetPort: 8181
    
    部署这个Service后,集群内的Pod就可以将opa主机名正确解析到OPA的Pod IP,建立9191端口的gRPC连接。
  • 连通性验证:
    1. 登录跑example-app的Pod的Envoy容器,访问Envoy的admin端口(配置中监听8001端口),查询/clusters接口,确认opa集群的端点状态为健康、可用端点数为1。
    2. 直接在容器内测试curl -v opa:9191,确认网络连通没有被拦截。
    3. 如果补完Service后连通性仍然失败,检查集群是否配置了NetworkPolicy,拦截了example-app Pod到OPA Pod的9191端口的入站流量。
  • 确认过滤器默认行为:ext_authz过滤器的failure_mode_allow参数默认是false,也就是授权集群不可达时直接拒绝请求,不需要额外修改,只要确认配置中没有误设为true导致逻辑异常即可。

内容的提问来源于stack exchange,提问作者user15202490

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 12:45:03