99 lines
2.9 KiB
Go
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
|
|
}
|