如何用Go Gin从Auth0 JWT令牌中获取权限？

不需要额外手动解码，auth0/go-jwt-middleware已经完成了解码流程，你可以通过中间件提供的上下文直接获取令牌中的permissions字段。以下是适配Gin框架的具体实现步骤：

1. 定义自定义声明结构体
   先声明一个与Auth0返回的JWT结构匹配的结构体，包含permissions字段：

type CustomClaims struct {
    Permissions []string `json:"permissions"`
    jwt.RegisteredClaims
}

2. 配置JWT中间件时指定自定义声明
   初始化jwtmiddleware时，将自定义声明类型传入，中间件会自动解析并填充字段：

func NewAuthMiddleware() gin.HandlerFunc {
    issuerURL, _ := url.Parse("https://你的Auth0域名/")
    provider := jwks.NewCachingProvider(issuerURL, 5*time.Minute)

    jwtMiddleware := jwtmiddleware.New(jwtmiddleware.Options{
        Validator: &jwtvalidator.Validator{
            Issuer:   issuerURL.String(),
            Audience: []string{"你的API标识符"},
            Claims:   func() jwt.Claims { return &CustomClaims{} },
        },
        JWKSProvider: provider,
    })

    return func(c *gin.Context) {
        err := jwtMiddleware.CheckJWT(c.Writer, c.Request)
        if err != nil {
            c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{"error": "认证失败"})
            return
        }
        c.Next()
    }
}

3. 在路由处理函数中获取并验证权限
   认证通过后，从请求上下文取出解析后的声明，直接访问Permissions字段并做权限校验：

func ProtectedHandler(c *gin.Context) {
    claims, ok := jwtmiddleware.GetClaimsFromContext(c.Request.Context()).(*CustomClaims)
    if !ok {
        c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "无法获取权限信息"})
        return
    }

    // 检查是否拥有目标权限
    targetPermission := "read:resources"
    hasPermission := false
    for _, p := range claims.Permissions {
        if p == targetPermission {
            hasPermission = true
            break
        }
    }

    if !hasPermission {
        c.AbortWithStatusJSON(http.StatusForbidden, gin.H{"error": "无访问权限"})
        return
    }

    c.JSON(http.StatusOK, gin.H{"message": "权限验证通过"})
}

4. 关键注意事项

• 确保在Auth0控制台为API开启了RBAC功能，并已添加对应的权限条目
• 令牌验证的aud（受众）和iss（发行者）必须与Auth0配置完全一致，否则解析会失败
• 获取令牌时，请求需包含scope=openid profile email和audience=你的API标识符参数，这样返回的令牌才会携带permissions字段

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