SuperAPI AI 工具集

jwt-auth

安全与审计

查看项目

更新于 10-15 23:33

技能介绍

用途:该技能用于实现基于 JWT 的认证与授权,包含访问令牌/刷新令牌、RBAC 角色权限、多租户支持,适用于需要登录、令牌校验与权限控制的 API 与前端应用。

主要能力:定义包含 iss、sub、aud、exp、iat、uid、tid、role、scopes 的令牌声明;支持 Go 端生成与校验访问令牌(golang-jwt/jwt v5、bcrypt)、认证中间件(Authenticate、RequireRole、RequireScope)与登录处理器;支持 TypeScript 客户端(jose 5.2+、zustand、jwt-decode)的认证状态、自动刷新与受保护路由;提供角色与用户数据库表结构及示例角色(viewer、operator、admin)。

使用方式:Go 实现中通过 JWTConfig 配置密钥与有效期(访问 15 分钟、刷新 7 天),调用 GenerateAccessToken 与 ValidateAccessToken;中间件从 Authorization: Bearer 头解析令牌并写入上下文。前端通过 useAuthStore 保存令牌、判断过期与检查角色/作用域,ApiClient 在 401 时自动刷新。

适用场景:需要登录认证、API 权限校验、多租户隔离与基于角色或作用域授权的前后端项目。

限制:资料未提供具体安装命令、完整收费信息或部署步骤;示例代码需按实际项目调整,切勿直接套用。安全建议包括短访问令牌、刷新令牌轮换、令牌吊销与速率限制。