1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! Token 抽象模块,定义 Token 生成/验证/解析的 trait 与多种风格实现。
//!
//! 对应 Token 风格切换能力,
//! 0.2.0 将 token 逻辑独立为 `core-token` 模块,
//! 框架内部通过 `Token` trait 实现多种 token 风格切换。
//!
//! 支持 4 种风格:uuid / random_64 / simple / jwt。
use crate;
use ;
/// Token 声明信息,承载 token 解析后的声明。
/// Token 抽象 trait,定义 token 生成、验证与解析的契约。
///
/// 实现方需提供 `generate`、`verify`、`parse` 三个方法。
/// `verify` 在 token 有效时返回 `Ok(Some(login_id))`,无效时返回 `Ok(None)`。
// ====================================================================
// UuidTokenStyle
// ====================================================================
/// UUID v4 风格 Token。
///
/// 生成标准 UUID v4 格式 token(如 `6e56d6f8-2b31-4d8e-92c3-7a9c8f0d1234`)。
/// UUID 不包含 login_id 或过期信息,`verify` 始终返回 `Ok(None)`。
;
// ====================================================================
// Random64TokenStyle
// ====================================================================
/// 64 字符随机 hex 风格 Token。
///
/// 生成 64 字符随机十六进制串,多次调用返回不同 token。
/// 不包含 login_id 或过期信息,`verify` 始终返回 `Ok(None)`。
;
// ====================================================================
// SimpleTokenStyle
// ====================================================================
/// Simple 风格 Token(A11 安全修复版)。
///
/// 格式为 `<login_id>-<uuid>.<hmac_sha256_base64(secret, login_id|uuid)>`,
/// 通过 HMAC-SHA256 签名防止 token 伪造(CRITICAL 漏洞修复)。
///
/// # 安全模型(A11)
///
/// - **生成**:服务端用 `secret` 对 `login_id|uuid` 计算 HMAC-SHA256,附加到 token 末尾
/// - **验证**:用 `subtle::ConstantTimeEq` 常数时间比较 HMAC,防止 timing side-channel
/// - **fail-closed**:`secure-simple-token` feature 未启用时,`generate` 返回 `Err`,
/// 杜绝无签名的不安全 token 流入生产环境
///
/// # Feature 依赖
///
/// 需启用 `secure-simple-token` feature(已包含在 `auth-server` 中)。
/// 未启用时 `generate` / `verify` / `parse` 均返回 `Err`。
///
/// # 迁移说明
///
/// 旧格式 `<login_id>-<uuid>`(无 HMAC)的 token 在 `verify` 时返回 `Ok(None)`,
/// 视为无效 token,用户需重新登录获取新格式 token。
// ====================================================================
// JwtTokenStyle
// ====================================================================
/// JWT 风格 Token。
///
/// 委托 `protocol-jwt::JwtHandler` 实现签发与校验。
/// 仅在启用 `protocol-jwt` feature 时编译。
// ====================================================================
// TokenStyleFactory
// ====================================================================
/// Token 风格工厂,依据 `GarrisonConfig.token_style` 创建对应的 `Token` 实现。
;