Files
EasyGoAdmin_GoFrame_NaiveVue/internal/middleware/jwt.go
T
2026-10-20 19:08:49 +08:00

159 lines
6.3 KiB
Go

// +======================================================================
// | 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)
}