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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! 认证逻辑模块,定义以 token 为入参的登录/登出核心抽象。
//!
//! 登录认证核心逻辑,对应 `StpLogic.login / logout` 方法。
//!
//! 0.2.0 将 API 改为 token-as-input,与 0.1.0 的 `GarrisonLogic`(依赖 task_local 上下文)解耦,
//! 便于 `protocol-jwt` 等协议层模块干净复用。
use async_trait;
use DashMap;
use Arc;
use crateToken;
use crate;
use crateGarrisonSession;
/// 身份切换权限校验 trait(L4 修复,依据安全审计 L4)。
///
/// `switch_to` 执行前调用 [`SwitchToGuard::check`] 校验是否允许切换。
/// 默认实现 [`DenyAllSwitchToGuard`] 拒绝所有切换(fail-closed 安全默认),
/// 调用方通过 [`AuthLogicDefault::with_switch_to_guard`] 注入自定义规则。
///
/// # 设计理由
///
/// 审计 L4 指出 `switch_to` 无权限校验,普通用户可切换到管理员身份。
/// 采用 guard trait 模式(而非硬编码权限规则)让调用方灵活定义授权策略,
/// 如基于角色、基于 PermissionChecker、或基于配置白名单。
///
/// # Security Warning
///
/// `switch_to` 是高风险操作:若 [`SwitchToGuard::check`] 直接返回 `Ok(())`,
/// 任何身份都可切换到任意目标身份(含管理员),造成**垂直越权**。
/// 实现方必须校验至少以下三项:
///
/// 1. **original 权限**:调用方是否具备 `switch_to` 权限(如 `admin:switch`)
/// 2. **target 可切换范围**:target 是否在允许切换的集合内(如同一租户、下级账号)
/// 3. **审计日志**:每次 switch_to 记录 `original / target / timestamp / request_context`,
/// 便于事后追溯
///
/// 推荐参考 `AdminOnlyGuard` 示例实现,而非裸用 `AllowAllSwitchToGuard`。
///
/// # 示例
///
/// ```ignore
/// use std::sync::Arc;
/// use garrison::core::auth::{AuthLogicDefault, SwitchToGuard};
/// use garrison::error::GarrisonResult;
///
/// // 仅允许 admin 切换
/// struct AdminOnlyGuard;
/// #[async_trait::async_trait]
/// impl SwitchToGuard for AdminOnlyGuard {
/// async fn check(&self, original: &str, target: &str) -> GarrisonResult<()> {
/// if original.starts_with("admin:") {
/// Ok(())
/// } else {
/// Err(garrison::error::GarrisonError::NotPermission(
/// format!("{} 无权切换到 {}", original, target)
/// ))
/// }
/// }
/// }
///
/// let auth = AuthLogicDefault::new(session, token_handler, 3600)
/// .with_switch_to_guard(Arc::new(AdminOnlyGuard));
/// ```
/// 拒绝所有切换的默认 guard(L4 修复,fail-closed 安全默认)。
///
/// 未通过 [`AuthLogicDefault::with_switch_to_guard`] 注入自定义 guard 时,
/// 所有 `switch_to` 调用都被拒绝。强制调用方显式配置权限规则。
;
/// 允许所有切换的 guard(仅用于测试,生产环境禁止使用)。
///
/// # Deprecated
///
/// 裸用此 guard 等价于关闭 switch_to 权限校验,任何身份可切换到任意
/// 目标身份(含管理员),构成垂直越权风险。测试代码也应实现自定义 guard,参考
/// [`AdminOnlyGuard`] doctest 示例。
///
/// 若必须使用(如遗留测试),需在调用处加 `#[allow(deprecated)]` 抑制警告,例如:
///
/// ```ignore
/// # use garrison::core::auth::AllowAllSwitchToGuard;
/// # use std::sync::Arc;
/// # #[allow(deprecated)]
/// let _guard = Arc::new(AllowAllSwitchToGuard);
/// ```
;
/// 认证逻辑 trait,定义以 token 为入参的认证抽象。
///
/// 所有方法 MUST 使用 `async_trait` 标注,trait 绑定 `Send + Sync`。
/// 与 0.1.0 的 `GarrisonLogic` 解耦:不读取 `tokio::task_local`,所有方法显式接收 `token: &str`。
/// `AuthLogic` 的默认实现,委托 `GarrisonSession`(会话管理)与 `core-token::Token`(token 生成与校验)。
///
/// 协议层模块无需自行实现会话存储逻辑,直接复用此默认实现。
pub use parse_remember_me_param;