170 lines
5.1 KiB
Go
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)
|
|
}
|