Go后端验证Auth0 ID Token时需使用哪个密钥？

安全阿岳

2026-8-29

问题描述

我使用Auth0为用户生成JWT ID Token，现需在Go后端验证该ID Token，目标是从令牌中提取用户身份，同时校验令牌确实是由我在Auth0中创建的自有应用所签发。

我当前使用chi路由搭配jwtauth中间件，该中间件是jwx的轻量封装组件。

根据文档说明，初始化校验实例的写法如下：

tokenAuth = jwtauth.New("RS256", []byte("secret"), nil)

我已尝试将多种取值作为上述代码中的"secret"参数传入，包括Auth0应用的Client Secret、签名证书，但均未校验通过，我已反复确认使用的签名算法配置正确。

校验始终返回token is unauthorized错误，我的路由配置代码如下：

r.Route("/users", func(r chi.Router) {
    r.Use(jwtauth.Verifier(tokenAuth))
    //r.Use(jwtauth.Authenticator)
    r.Post("/info", usersService.InfoHandler)
})

我在处理器中获取令牌的代码如下：

token, _, err := jwtauth.FromContext(r.Context())
fmt.Println("token", token)
fmt.Println("error", err)

解决方案

你踩了RS256算法的基础认知坑：RS256是非对称签名算法，你之前写的初始化逻辑是HS256这类对称签名算法的用法，传单个字节数组密钥的方式完全不适配RS256场景。

Auth0签发的RS256格式JWT，是用Auth0持有的私钥做签名的，本地校验需要用Auth0公开的JWKS公钥集合，Client Secret、你自己持有的私钥/证书都不能当校验参数用
你用的jwtauth底层依赖jwx，原生支持自动拉取、缓存JWKS公钥，还能自动适配Auth0的公钥轮转，不需要手动硬编码证书内容
你把jwtauth.Authenticator中间件注释掉了，只加Verifier只会尝试解析令牌，不会实际做签名、有效期、签发方这类有效性校验，这也是校验不生效的原因之一

正确实现步骤：

准备两个核心配置参数：你的Auth0租户域名（格式为https://<你的租户名>.auth0.com/）、对应应用的Client ID（作为令牌受众校验值）
初始化时从Auth0的JWKS端点拉取公钥集合，不要传自定义字节数组密钥
额外配置签发方、受众校验规则，确保令牌是Auth0发给你自有应用的，不是同租户下其他应用签发的
路由中恢复jwtauth.Authenticator中间件的调用，完成实际校验逻辑

参考实现代码：

import (
  "context"
  "github.com/go-chi/chi/v5"
  "github.com/go-chi/jwtauth/v5"
  "github.com/lestrrat-go/jwx/v2/jwk"
  "github.com/lestrrat-go/jwx/v2/jwt"
)

// 替换成你自己的Auth0配置
const (
  auth0Domain   = "https://替换成你的租户名.auth0.com/"
  auth0ClientID = "替换成你的Auth0应用Client ID"
)

func setupTokenAuth() (*jwtauth.JWTAuth, error) {
  // 拉取Auth0公开的JWKS公钥集合
  jwksUrl := auth0Domain + ".well-known/jwks.json"
  keySet, err := jwk.Fetch(context.Background(), jwksUrl)
  if err != nil {
    return nil, err
  }

  // 初始化校验实例，传入公钥集合和强制校验规则
  tokenAuth := jwtauth.New(
    "RS256",
    keySet,
    nil,
    jwt.WithIssuer(auth0Domain),
    jwt.WithAudience(auth0ClientID),
  )
  return tokenAuth, nil
}

// 路由配置
func setupRouter(tokenAuth *jwtauth.JWTAuth) *chi.Mux {
  r := chi.NewRouter()
  r.Route("/users", func(r chi.Router) {
    r.Use(jwtauth.Verifier(tokenAuth))
    r.Use(jwtauth.Authenticator(tokenAuth)) // 这行不要注释，否则不会执行校验
    r.Post("/info", usersService.InfoHandler)
  })
  return r
}

校验通过后，在处理器里直接从jwtauth.FromContext拿到的token中解析sub字段就是用户唯一身份标识，也可以根据需要拿邮箱、昵称等其他存在ID Token里的自定义字段。

几个避坑点：

RS256流程里Client Secret只用于调用Auth0管理接口，完全不参与JWT签名校验，不要白费功夫传这个值
不要把Auth0的公钥硬编码到代码里，Auth0会定期轮转签名公钥，用上面的JWKS自动拉取方式会自动缓存、更新公钥，不需要手动维护
必须加audience校验，否则同租户下其他应用签发的令牌也能通过你的校验，不符合你校验自有应用签发令牌的需求
如果ID Token配置了自定义受众，把对应值追加到jwt.WithAudience参数里即可

内容的提问来源于stack exchange，提问作者Mark