使用Solo.io Gloo Gateway集成Auth0实现OIDC身份认证

2025-06-12 14:45:51作者：虞亚竹Luna

概述

在现代微服务架构中，API网关作为系统入口，身份认证和授权是必不可少的安全功能。本文将详细介绍如何使用Solo.io的Gloo Gateway与Auth0身份提供商集成，实现基于OIDC(OpenID Connect)的身份认证流程。

准备工作

部署测试服务

首先我们需要在Kubernetes集群上部署一个简单的测试服务。这里我们选择httpbin作为演示应用：

kubectl apply -f https://raw.githubusercontent.com/istio/istio/master/samples/httpbin/httpbin.yaml

Gloo Gateway会自动发现Kubernetes服务，创建对应的Upstream。可以通过以下命令验证：

glooctl get upstreams default-httpbin-8000

创建虚拟服务

接下来创建VirtualService将流量路由到httpbin服务：

apiVersion: gateway.solo.io/v1
kind: VirtualService
metadata:
  name: httpbin-auth0-vs
  namespace: gloo-system
spec:
  virtualHost:
    domains:
    - 'glootest.com'
    routes:
    - matchers:
      - prefix: /
      routeAction:
        single:
          upstream:
            name: default-httpbin-8000
            namespace: gloo-system

配置HTTPS访问

为了安全考虑，我们为服务配置HTTPS访问：

生成自签名证书：

openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout tls.key -out tls.crt -subj "/CN=glootest.com"

创建Kubernetes Secret：

kubectl create secret tls upstream-tls --key tls.key --cert tls.crt --namespace gloo-system

更新VirtualService启用HTTPS：

spec:
  sslConfig:
    secretRef:
      name: upstream-tls
      namespace: gloo-system

集成Auth0身份认证

配置Auth0应用

在Auth0管理控制台创建新应用，选择"Regular Web Application"类型
配置允许的回调URL为https://glootest.com/callback
记录应用的Client ID和Client Secret

配置Gloo Gateway认证

创建OAuth Secret：

glooctl create secret oauth --namespace gloo-system --name auth0-client-secret --client-secret $CLIENT_SECRET

创建AuthConfig资源：

apiVersion: enterprise.gloo.solo.io/v1
kind: AuthConfig
metadata:
  name: auth0-ac
  namespace: gloo-system
spec:
  configs:
  - oauth2:
      oidcAuthorizationCode:
        appUrl: https://glootest.com
        callbackPath: /callback
        clientId: <your-client-id>
        clientSecretRef:
          name: auth0-client-secret
          namespace: gloo-system
        issuerUrl: <your-auth0-domain>
        scopes:
        - email

更新VirtualService引用AuthConfig：

options:
  extauth:
    configRef:
      name: auth0-ac
      namespace: gloo-system

调整认证超时

由于需要与外部Auth0服务交互，建议适当增加认证超时时间：

spec:
  extauth:
    requestTimeout: 1s

JWT令牌处理

提取JWT令牌

我们可以从Auth0返回的Cookie中提取JWT令牌，并转换为请求头：

options:
  stagedTransformations:
    early:
      requestTransforms:
      - requestTransformation:
          transformationTemplate:
            extractors:
              token:
                header: 'cookie'
                regex: '.*id_token=([^;]*).*'
                subgroup: 1
            headers:
              jwt:
                text: '{{ token }}'
  headerManipulation:
    requestHeadersToRemove:
    - "cookie"

使用JWKS验证JWT

Auth0提供了JWKS端点用于验证JWT令牌。我们可以配置Gloo Gateway使用这个端点：

创建指向Auth0 JWKS端点的Upstream：

apiVersion: gloo.solo.io/v1
kind: Upstream
metadata:
  name: auth0-jwks
  namespace: gloo-system
spec:
  static:
    hosts:
    - addr: <your-auth0-domain>
      port: 443

配置JWT验证和声明提取：

options:
  jwt:
    providers:
      auth0:
        issuer: <your-auth0-domain>
        jwks:
          remote:
            upstreamRef:
              name: auth0-jwks
              namespace: gloo-system
            url: "/.well-known/jwks.json"
    claimsToHeaders:
    - claim: email
      header: X-User-Email

基于角色的访问控制(RBAC)

利用从JWT中提取的声明，我们可以实现细粒度的访问控制：

options:
  rbac:
    policies:
      viewer:
        permissions:
          methods: ["GET"]
        principals:
        - jwtPrincipal:
            claims:
              email: "user@example.com"