package middleware import ( "context" "net/http" "strings" "time" "github.com/gin-gonic/gin" "github.com/golang-jwt/jwt/v5" jwtpkg "go-sms/internal/pkg/jwt" "go-sms/internal/pkg/errors" ) // Claims go-sms JWT 载荷(Day 17 起由 internal/pkg/jwt 定义,别名保持兼容)。 type Claims = jwtpkg.Claims // ContextKeyClaims gin.Context 中存放已解析 Claims 的键。 const ContextKeyClaims = "auth_claims" // AuthJWT JWT 鉴权中间件: // Authorization: Bearer ;无效/过期/缺失返回 401。 // 解析成功后将 Claims 写入 Context 供后续 handler 与权限校验使用。 func AuthJWT(secret string) gin.HandlerFunc { return func(c *gin.Context) { if parseBearer(secret, c) == nil { return // 已 abort } c.Next() } } // parseBearer 解析并校验 Bearer 令牌;失败 abort 并返回 nil,成功则写入 // ContextKeyClaims 并返回 Claims。 // // 注意:不调用 c.Next()。组合型中间件(WithChecker/WithRevocation)必须 // 在放行前完成全部校验,若复用 AuthJWT(末尾 c.Next)会导致 handler 先于 // 包装层校验执行(Day 24 修复的 Day 22 遗留问题)。 func parseBearer(secret string, c *gin.Context) *Claims { raw := bearerToken(c) if raw == "" { abortUnauthorized(c, "缺少 Bearer Token") return nil } claims := &Claims{} token, err := jwt.ParseWithClaims(raw, claims, func(t *jwt.Token) (any, error) { // 强制 HMAC 系列签名算法,防 alg 混淆攻击 if _, ok := t.Method.(*jwt.SigningMethodHMAC); !ok { return nil, jwt.ErrSignatureInvalid } return []byte(secret), nil }) if err != nil || !token.Valid { abortUnauthorized(c, "Token 无效或已过期") return nil } c.Set(ContextKeyClaims, claims) return claims } // BearerToken 提取 Authorization 头中的 Bearer 令牌(导出版,handler 复用)。 func BearerToken(c *gin.Context) string { return bearerToken(c) } // bearerToken 提取 Authorization 头中的 Bearer 令牌。 // 权限校验(PermissionChecker/RequirePermission)见 permission.go(Day 25)。 func bearerToken(c *gin.Context) string { h := c.GetHeader("Authorization") if h == "" { return "" } parts := strings.SplitN(h, " ", 2) if len(parts) != 2 || !strings.EqualFold(parts[0], "Bearer") { return "" } return strings.TrimSpace(parts[1]) } // abortUnauthorized 统一 401 响应。 func abortUnauthorized(c *gin.Context, msg string) { c.AbortWithStatusJSON(http.StatusUnauthorized, gin.H{ "code": errors.Unauthorized.Code, "msg": msg, }) } // AuthJWTWithChecker 带账号状态校验的 JWT 鉴权(Day 22:禁用后 Token 即失效; // Day 24 修复:改用 parseBearer,校验先于 handler,不再经 base(c) 提前放行)。 func AuthJWTWithChecker(secret string, checker func(ctx context.Context, accountID int64) (bool, error)) gin.HandlerFunc { return func(c *gin.Context) { claims := parseBearer(secret, c) if claims == nil { return // 已 abort } if checker == nil { return } enabled, err := checker(c.Request.Context(), claims.AccountID) if err != nil { abortUnauthorized(c, "账号状态校验失败") return } if !enabled { abortUnauthorized(c, "账号已被禁用,令牌失效") } } } // AuthJWTWithRevocation JWT 鉴权 + 登出黑名单 + 账号状态校验(Day 24): // revoked 查询令牌是否已注销(nil 跳过);checker 校验账号启用态(nil 跳过)。 // 任一不通过返回 401(令牌层面的失效统一按未认证处理)。 func AuthJWTWithRevocation(secret string, revoked func(ctx context.Context, rawToken string) bool, checker func(ctx context.Context, accountID int64) (bool, error)) gin.HandlerFunc { return func(c *gin.Context) { claims := parseBearer(secret, c) if claims == nil { return // 已 abort } if revoked != nil && revoked(c.Request.Context(), bearerToken(c)) { abortUnauthorized(c, "令牌已注销,请重新登录") return } if checker == nil { return } enabled, err := checker(c.Request.Context(), claims.AccountID) if err != nil { abortUnauthorized(c, "账号状态校验失败") return } if !enabled { abortUnauthorized(c, "账号已被禁用,令牌失效") } } } // IPCheck IP 白名单校验中间件(Day 23): // 从 JWT claims 取 accountID,查询 account_user.ip_bind(JSON 数组), // 非空白名单且请求 IP 不在其中 → 403 ISC:403。 func IPCheck(checker func(ctx context.Context, accountID int64, clientIP string) (bool, error)) gin.HandlerFunc { return func(c *gin.Context) { if checker == nil { c.Next() return } v, ok := c.Get(ContextKeyClaims) if !ok { c.Next() return } claims := v.(*Claims) allowed, err := checker(c.Request.Context(), claims.AccountID, c.ClientIP()) if err != nil || !allowed { c.AbortWithStatusJSON(http.StatusForbidden, gin.H{ "code": errors.Forbidden.Code, "msg": "IP 不在白名单内: " + c.ClientIP(), }) return } c.Next() } } // ttl 直接透传(非正值同样生效,便于测试过期场景)。 func SignAccessToken(secret string, accountID int64, username, role string, ttl time.Duration) (string, error) { return (&jwtpkg.Manager{Secret: secret, TTL: ttl, Issuer: "go-sms"}).Sign(accountID, username, []string{role}, nil) }