Files

170 lines
5.1 KiB
Go

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 <token>;无效/过期/缺失返回 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)
}