使用Open Policy Agent实现Gloo Gateway的精细化授权策略

2025-06-12 00:50:30作者：邵娇湘

概述

在现代微服务架构中，API网关作为系统的入口点，承担着重要的安全防护职责。Gloo Gateway作为一款功能强大的API网关，提供了与Open Policy Agent(OPA)的深度集成，使开发者能够实现比传统RBAC更细粒度的访问控制策略。

Open Policy Agent简介

Open Policy Agent(OPA)是一个开源的通用策略引擎，它允许组织以统一的方式定义和执行各种策略。与传统的基于角色的访问控制(RBAC)相比，OPA提供了更灵活、更细粒度的策略控制能力。

OPA使用Rego语言编写策略，这是一种受Datalog启发的声明式语言，专门设计用于处理现代JSON文档。Rego语言的优势在于其表达能力强，能够处理复杂的业务逻辑判断。

OPA与Gloo Gateway集成架构

当Gloo Gateway与OPA集成时，会为每个请求构建一个input文档，该文档的结构取决于请求的上下文：

input.check_request - 包含Envoy Auth Service的CheckRequest对象，包含请求的所有信息
input.http_request - 专门为HTTP请求设计的便捷字段
input.state.jwt - 当使用OIDC认证插件时，存储获取的JWT令牌

实战：基于请求属性的授权控制

1. 部署示例应用

首先部署一个宠物商店示例应用作为后端服务：

kubectl apply -f petstore.yaml

2. 创建虚拟服务

定义路由规则将所有请求转发到petstore服务：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: petstore
spec:
  virtualHost:
    domains: ['*']
    routes:
    - matchers: [{prefix: /}]
      routeAction:
        single:
          kube:
            ref: {name: petstore, namespace: default}
            port: 8080

3. 定义OPA策略

创建策略文件policy.rego，实现以下控制逻辑：

默认拒绝所有请求
允许GET方法访问/api/pets路径
允许GET和DELETE方法访问/api/pets/2路径

package test

default allow = false
allow {
    startswith(input.http_request.path, "/api/pets")
    input.http_request.method == "GET"
}
allow {
    input.http_request.path == "/api/pets/2"
    any({input.http_request.method == "GET",
        input.http_request.method == "DELETE"
    })
}

4. 创建认证配置

将策略存储在ConfigMap中，并创建AuthConfig资源：

apiVersion: enterprise.gloo.solo.io/v1
kind: AuthConfig
metadata:
  name: opa
spec:
  configs:
  - opaAuth:
      modules:
      - name: allow-get-users
      query: "data.test.allow == true"

5. 更新虚拟服务

将认证配置应用到虚拟服务：

spec:
  virtualHost:
    options:
      extauth:
        configRef:
          name: opa

实战：基于JWT的授权控制

1. 部署OIDC提供者

使用Dex作为OIDC提供者，配置两个测试用户：

admin@example.com
user@example.com

2. 创建JWT验证策略

定义策略检查JWT中的声明：

package test

default allow = false
[header, payload, signature] := io.jwt.decode(input.state.jwt)

allow {
    payload["email"] == "admin@example.com"
}
allow {
    payload["email"] == "user@example.com"
    not startswith(input.http_request.path, "/owners")
}

3. 创建多步骤认证配置

组合OIDC认证和OPA授权：

apiVersion: enterprise.gloo.solo.io/v1
kind: AuthConfig
metadata:
  name: jwt-opa
spec:
  configs:
  - oauth2:
      oidcAuthorizationCode:
        appUrl: http://localhost:8080
        clientId: gloo
        issuerUrl: http://dex.gloo-system.svc.cluster.local:32000/
        scopes: [email]
  - opaAuth:
      modules:
      - name: allow-jwt
      query: "data.test.allow == true"