// +====================================================================== // | EasyGoAdmin 企业数字化开发平台 [ 赋能开发者,助力企业发展 ] // +---------------------------------------------------------------------- // | Copyright (c) 2019-2026 半城风雨团队 版权所有 // +---------------------------------------------------------------------- // | 开源协议: Apache-2.0 // | 重要声明: 未经书面许可,不得移除或修改本框架相关版权标识。 // +---------------------------------------------------------------------- // | 官方网站: https://www.easygoadmin.vip // +---------------------------------------------------------------------- // | 研发团队: 小蚂蚁云团队 荣誉出品 // +====================================================================== // | 版权和免责声明: // | 一、知识产权声明 // | 本团队对该软件框架产品(以下简称“本产品”)拥有完整知识产权,包括但不限于商标权、专利权、 // | 著作权、商业秘密等。前述权利均受中华人民共和国及相关国际法律法规保护。未经本团队书面授权, // | 任何个人或单位不得基于本产品本身申请任何形式的知识产权。 // | 二、使用限制与禁止条款 // | 您理解并同意,禁止将本产品用于以下任何行为: // | 1. 任何违反中华人民共和国法律法规的用途; // | 2. 任何侵害他人合法权益(包括但不限于人身权、财产权、知识产权等)的行为; // | 3. 任何危害国家安全、公共利益及社会道德风尚的行为。 // | 三、责任豁免 // | 因使用本产品而产生的任何损失或法律纠纷(包括但不限于直接损失、间接损失、附带损失、衍生损失 // | 以及因违约、侵权等引发的责任),本团队均不承担任何法律责任。若因违规使用本产品导致任何第三 // | 方提起索赔或行政机关进行调查,您应独立承担全部责任。 // | 四、违约与法律责任 // | 如发现任何违反本声明的行为,本团队有权: // | 1. 无条件配合公安机关及其他有权机关的调查取证工作; // | 2. 依法追究相关方的民事责任,并要求赔偿全部损失; // | 3. 保留进一步采取刑事控告等法律措施的权利。 // | 五、许可范围说明 // | 1、被授权方应视本产品源代码为核心机密信息,负有最高标准的保密与保管义务。禁止以任何形式(包 // | 括但不限于直接或间接的分享、复制、传播、分发、转售、出租、开源、反向工程、反编译、反汇编或通 // | 过网络服务提供给任何第三方)泄露、披露或处置源代码的全部或部分内容。任何未经授权的复制、使用、 // | 传播行为均构成对本团队知识产权的严重侵权,本团队有权依法追究其全部法律责任,并要求赔偿因此造 // | 成的一切经济损失及商誉损害。 // | 2、本产品仅限于公司或个人在法律允许范围内,用于内部且合规的软件产品研发。具体权利义务以《软件 // | 许可协议》附件为准。 // +====================================================================== package middleware import ( "encoding/json" "strings" "github.com/gogf/gf/v2/errors/gerror" "github.com/gogf/gf/v2/net/ghttp" "easygoadmin/internal/consts" "easygoadmin/utility/cache" jwtutil "easygoadmin/utility/jwt" "easygoadmin/utility/response" ) // ============================== 身份认证中间件 ============================== // JWT 身份认证中间件 // // 处理流程: // 1. 免登录路由直接放行 // 2. 解析 Bearer Token,校验签名、过期与签发者 // 3. 校验 Redis 黑名单,登出或刷新后的旧令牌失效 // 4. 加载角色与权限(缓存 300 秒)并注入请求上下文 func JWT(r *ghttp.Request) { if IsPublicPath(r.URL.Path) { r.Middleware.Next() return } token := parseBearer(r.Header.Get("Authorization")) if token == "" { token = r.Get("token").String() // 兼容个别 URL 直传场景 } if token == "" { writeUnauthorized(r) return } claims, err := jwtutil.Parse(r.Context(), token) if err != nil { writeUnauthorized(r) return } // 黑名单(登出/轮换后的旧令牌) if cache.Exists(r.Context(), consts.CacheKeyTokenBlacklist(claims.ID)) { writeUnauthorized(r) return } ctx := r.Context() ctx = consts.WithUserID(ctx, claims.UserID) ctx = consts.WithTenantID(ctx, claims.TenantID) ctx = consts.WithUsername(ctx, claims.Username) ctx = consts.WithRealname(ctx, claims.Realname) ctx = consts.WithTokenJTI(ctx, claims.ID) if claims.ExpiresAt != nil { ctx = consts.WithTokenExpire(ctx, claims.ExpiresAt.Time) } // 身份扩展(角色/权限/数据范围):缓存优先 if idn := loadIdentity(r, claims.UserID); idn != nil { ctx = consts.WithRoles(ctx, idn.Roles) ctx = consts.WithPerms(ctx, idn.Perms) ctx = consts.WithDataScope(ctx, idn.DataScope) ctx = consts.WithDeptID(ctx, idn.DeptId) } r.SetCtx(ctx) r.Middleware.Next() } // loadIdentity 读取用户身份 // // 优先读取身份缓存,未命中时回源 IdentityLoader 并写入缓存 func loadIdentity(r *ghttp.Request, userID int) *Identity { if userID <= 0 { return nil } ck := consts.CacheKeyUserIdentity(userID) if v, ok := cache.Get(r.Context(), ck); ok { idn := &Identity{} if err := json.Unmarshal([]byte(v), idn); err == nil { return idn } } if IdentityLoader == nil { return &Identity{} } idn, err := IdentityLoader(r.Context(), userID) if err != nil || idn == nil { glogWarn(r.Context(), "加载用户身份失败 userID=%d err=%v", userID, err) return &Identity{} } if b, err := json.Marshal(idn); err == nil { _ = cache.Set(r.Context(), ck, string(b), 300) } return idn } // parseBearer 解析 Bearer 令牌 // // 兼容带前缀与直接传值两种形式 func parseBearer(h string) string { if h == "" { return "" } if strings.HasPrefix(h, "Bearer ") || strings.HasPrefix(h, "bearer ") { return strings.TrimSpace(h[7:]) } return strings.TrimSpace(h) } // writeUnauthorized 输出未认证响应 // // 状态码为 401,供前端识别并跳转登录页 func writeUnauthorized(r *ghttp.Request) { res := response.Fail(gerror.NewCode(consts.CodeUnauthorized)) response.WriteWithCode(r, res, 401) }