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
145
146
147
148
149
150
151
152
//! JWT Token 管理模块
//!
//! 提供 Token 生成、验证、解析和刷新机制。
//!
//! # 主要组件
//!
//! - `TokenManager`:Token 管理器
//! - `TokenClaims`:Token 声明
//! - `TokenConfig`:Token 配置
//!
//! # 示例
//!
//! ```rust,ignore
//! use yang_base::token::{TokenManager, TokenClaims};
//! use jsonwebtoken::Algorithm;
//!
//! // 创建 Token 管理器(对称加密)
//! let manager = TokenManager::new_symmetric(
//! "your_secret_key",
//! Algorithm::HS256,
//! "issuer".to_string(),
//! "audience".to_string(),
//! 3600,
//! 86400,
//! );
//!
//! // 生成 Access Token
//! let token = manager.generate_access_token(
//! "user_id_123",
//! serde_json::json!({"role": "admin"}),
//! )?;
//!
//! // 验证 Token
//! let claims = manager.verify_token(&token)?;
//! println!("用户 ID: {}", claims.sub);
//! ```
pub use TokenManager;
use ;
/// Token 声明
///
/// JWT Token 的标准声明和自定义声明。
///
/// # 标准声明字段
///
/// - `iss`:签发者(Issuer)
/// - `sub`:主题(Subject),通常是用户 ID
/// - `aud`:受众(Audience)
/// - `exp`:过期时间(Expiration Time),Unix 时间戳
/// - `nbf`:生效时间(Not Before),Unix 时间戳
/// - `iat`:签发时间(Issued At),Unix 时间戳
/// - `jti`:JWT ID,唯一标识符
///
/// # 自定义字段
///
/// - `token_type`:Token 类型(access 或 refresh)
/// - `custom`:自定义声明,使用 JSON 格式存储任意数据
///
/// # 示例
///
/// ```rust
/// use yang_base::token::TokenClaims;
/// use serde_json::json;
///
/// let claims = TokenClaims {
/// iss: "yang-base".to_string(),
/// sub: "user_123".to_string(),
/// aud: "yang-app".to_string(),
/// exp: 1234567890,
/// nbf: 1234567800,
/// iat: 1234567800,
/// jti: "unique-token-id".to_string(),
/// token_type: "access".to_string(),
/// custom: json!({
/// "role": "admin",
/// "permissions": ["read", "write"]
/// }),
/// };
/// ```