Files

99 lines
2.9 KiB
Go

// Package jwt JWT 签发与解析(Day 17):
// Claims 携带 account_id / roles / permissions,供网关鉴权与 RBAC 快速判定。
package jwt
import (
"crypto/rand"
"encoding/hex"
"errors"
"fmt"
"time"
"github.com/golang-jwt/jwt/v5"
)
// Claims go-sms JWT 载荷。
type Claims struct {
AccountID int64 `json:"account_id"`
Username string `json:"username"`
Roles []string `json:"roles"` // 角色码(admin/ops/service/group/customer)
Permissions []string `json:"permissions"` // 权限码快照(resource:action)
jwt.RegisteredClaims
}
// Manager JWT 管理器(签发 + 解析,统一 HMAC-SHA256)。
// 字段导出:允许跨包直接构造(绕过 NewManager 默认值,如负 TTL 测试场景)。
type Manager struct {
Secret string
TTL time.Duration
Issuer string
}
// NewManager 构造;ttl<=0 使用默认 2h。
func NewManager(secret string, ttl time.Duration) *Manager {
if ttl <= 0 {
ttl = 2 * time.Hour
}
return &Manager{Secret: secret, TTL: ttl, Issuer: "go-sms"}
}
// Validity 返回令牌有效期。
func (m *Manager) Validity() time.Duration { return m.TTL }
// Sign 签发访问令牌。
func (m *Manager) Sign(accountID int64, username string, roles, permissions []string) (string, error) {
if username == "" {
return "", errors.New("jwt: username 不能为空")
}
if len(roles) == 0 {
return "", errors.New("jwt: roles 不能为空")
}
now := time.Now()
claims := &Claims{
AccountID: accountID,
Username: username,
Roles: roles,
Permissions: permissions,
RegisteredClaims: jwt.RegisteredClaims{
ID: newJTI(),
Issuer: m.Issuer,
Subject: fmt.Sprintf("%d", accountID),
ExpiresAt: jwt.NewNumericDate(now.Add(m.TTL)),
IssuedAt: jwt.NewNumericDate(now),
},
}
return jwt.NewWithClaims(jwt.SigningMethodHS256, claims).SignedString([]byte(m.Secret))
}
// newJTI 令牌唯一标识(crypto/rand 16 字节 hex)。
// 确保同一秒内多次签发的令牌互不相同——否则刷新轮换(旧令牌拉黑 +
// 重签)在同一秒会产生与旧令牌完全相同的串,导致新令牌被自己的黑名单误杀。
func newJTI() string {
b := make([]byte, 16)
if _, err := rand.Read(b); err != nil {
return fmt.Sprintf("t%d", nowNano())
}
return hex.EncodeToString(b)
}
// nowNano rand 失败时的时间戳退化源。
func nowNano() int64 { return time.Now().UnixNano() }
// Parse 解析并校验令牌(强制 HMAC 系列签名,防 alg 混淆)。
func (m *Manager) Parse(token string) (*Claims, error) {
claims := &Claims{}
parsed, err := jwt.ParseWithClaims(token, claims, func(t *jwt.Token) (any, error) {
if _, ok := t.Method.(*jwt.SigningMethodHMAC); !ok {
return nil, jwt.ErrSignatureInvalid
}
return []byte(m.Secret), nil
})
if err != nil {
return nil, fmt.Errorf("jwt: 令牌无效: %w", err)
}
if !parsed.Valid {
return nil, errors.New("jwt: 令牌无效")
}
return claims, nil
}