SuperAPI AI 工具集

gin-auth

通用与其它

查看项目

更新于 10-16 06:18

技能介绍

用途:为 Gin API 添加基于 JWT 的认证与角色授权,覆盖登录、令牌生命周期、路由保护与 RBAC 等安全 API 常见模式。

适用场景:给 Gin API 增加 JWT 认证;实现登录或注册端点;用中间件保护路由;实现基于角色或权限的访问控制;处理令牌刷新与吊销;在任意处理器中获取当前用户。

依赖安装: go get github.com/golang-jwt/jwt/v5 go get golang.org/x/crypto

主要能力:自定义 Claims 结构内嵌 jwt.RegisteredClaims;生成与校验访问令牌、刷新令牌,配置密钥与 TTL(从环境变量加载,不硬编码);Auth 中间件解析 Bearer 令牌并把 claims 注入 gin.Context;登录处理器用 bcrypt 校验密码并返回双令牌;通过路由组与 RequireRole 中间件实现 RBAC;在处理器中经 c.GetString 或 c.Get 读取当前用户。

使用方式:用 gin.New() 配合显式中间件搭建引擎,公开路由放 /auth/login、/auth/refresh 与注册,受保护路由组挂载 Auth 中间件,管理路由再加 RequireRole("admin")。

限制与说明:资料主要给出架构建议与代码片段,未提供价格、平台或效果信息;令牌吊销、RS256 与存储建议等细节需查阅其 references/jwt-patterns.md 与 references/rbac.md。