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
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! # Garrison
//!
//! Garrison 是一个面向 Rust 生态的一站式身份认证鉴权框架。
//!
//! ## 快速开始
//!
//! 最小可用示例:初始化管理器 → 执行登录 → 校验登录状态。
//!
//! ```ignore
//! use std::sync::Arc;
//! use garrison::prelude::*;
//!
//! // 1. 准备依赖(业务方实现 GarrisonDao / GarrisonInterface)
//! let dao: Arc<dyn GarrisonDao> = /* oxcache / dbnexus 实现 */;
//! let config = Arc::new(GarrisonConfig::default_config());
//! let interface: Arc<dyn GarrisonInterface> = Arc::new(MyInterface);
//!
//! // 2. 初始化全局管理器(覆盖式注入 dao / config / interface)
//! GarrisonManager::init(dao, config, interface).unwrap();
//!
//! // 3. 执行登录:生成 token 并写入会话
//! // 注意:login / check_login 依赖 task_local 上下文中的当前 token,
//! // 通常由 web 中间件(如 axum middleware)设置。
//! let token = GarrisonUtil::login(1001).await.unwrap();
//!
//! // 4. 校验登录状态
//! let logged_in = GarrisonUtil::check_login().await.unwrap();
//! assert!(logged_in);
//! ```
//!
//! ## 特性
//!
//! Garrison 通过 Cargo feature flags 控制各能力域的编译:
//!
//! | 类别 | Feature | 说明 |
//! |:---|:---|:---|
//! | 默认 | `default` | 空(按需启用所需 feature;`all-defaults` 可一键启用常用组合) |
//! | 缓存 | `cache-memory` / `cache-redis` | 基于 oxcache 0.3 的 L1(内存) + L2(redis),均启用 oxcache(语义别名) |
//! | 数据库 | `db-sqlite` | 基于 dbnexus 0.2 + auto-migrate |
//! | Web 框架 | `web-axum` / `web-actix` / `web-warp` | 路由拦截器与 extractor 适配 |
//! | 协议层 | `protocol-jwt` / `protocol-oauth2` / `protocol-sso` / `protocol-sign` / `protocol-apikey` / `protocol-temp` | 鉴权协议插件 |
//! | 安全模块 | `secure-totp` / `secure-sign` / `secure-httpbasic` / `secure-httpdigest` | TOTP / 签名 / Basic / Digest |
//! | 可观测性 | `listener` / `tracing-log` / `metrics-prometheus` | 事件监听 / 日志 / 指标 |
//! | 聚合 | `full` / `production` / `development` | 一键启用一组特性 |
//!
//! ## 模块概览
//!
//! 0.2.0 在 0.1.0 基础上扩展了协议层、安全模块与可插拔扩展点:
//!
//! - **核心扩展**(always on)
//! - [`core::token`]:`Token` trait + `TokenStyleFactory`(uuid / random_64 / simple / jwt 四种风格)
//! - [`core::auth`]:`AuthLogic` trait + `DefaultAuthLogic`(login_by_token / verify_token / refresh_token)
//! - [`core::permission`]:`PermissionChecker` trait + `DefaultPermissionChecker`
//! - [`plugin`]:`GarrisonPlugin` trait + `inventory` 编译期注册 + `GarrisonPluginManager`(on_login / on_logout / on_permission_check 钩子)
//! - [`strategy`]:`GarrisonPermissionStrategyDefault` 扩展 `with_permission_checker` / `with_role_hierarchy` / `with_plugin_manager` / `with_dao`(权限缓存)
//! - [`session`]:`GarrisonSession` 扩展 SSO / OAuth2 / 临时凭证关联(`link_sso_ticket` / `link_oauth2_token` / `link_temp_credential`)
//! - **协议层**(特性门控)
//! - `protocol::jwt`:`JwtHandler`(sign / verify / refresh,HS256/HS512)
//! - `protocol::oauth2`:`OAuth2Client`(Authorization Code / Client Credentials / Password 三种流程)
//! - `protocol::sso`:`SsoClient`(ticket 签发 / 校验 / 销毁,一次性 60s TTL)
//! - `protocol::sign`:`SignHandler`(HMAC-SHA256 签名 + 防重放时间窗口)
//! - `protocol::apikey`:`ApiKeyHandler`(生成 / 校验 / 吊销 / 轮换)
//! - `protocol::temp`:`TempCredentialHandler`(issue / get / revoke / consume)
//! - **安全模块**(特性门控)
//! - `secure::totp`:`TotpHandler`(RFC 6238,±1 时间窗口偏差)
//! - `secure::sign`:`SignVerifier` trait
//! - `secure::httpbasic` / `secure::httpdigest`:HTTP Basic / Digest 认证
//! - **可观测性**
//! - `listener`:`GarrisonEvent` + `Listener` trait + `GarrisonListenerManager`(Login / Logout / PermissionCheck / Kickout 事件)
//!
//! ## 特性域
//!
//! Garrison 采用 13 个特性域设计:
//!
//! - **登录认证** - 基于 Token 的会话管理
//! - **权限认证** - RBAC 权限模型
//! - **Session 会话** - 会话生命周期管理
//! - **OAuth2** - 第三方授权
//! - **单点登录 (SSO)** - 跨系统统一登录
//! - **JWT** - JSON Web Token 支持
//! - **微服务网关鉴权** - 网关层签名认证
//! - **API 接口鉴权** - API Key 认证
//! - **TOTP 动态验证码** - 时间一次性密码
//! - **Basic 认证** - HTTP Basic Auth
//! - **Digest 认证** - HTTP Digest Auth
//! - **路由拦截鉴权** - Web 框架适配
//! - **插件化扩展** - 编译期插件注册
//!
//! ## 架构
//!
//! Garrison 采用双抽象层 + 全局单例的架构:
//!
//! - **双抽象层**
//! - `dbnexus`:数据库抽象层(SQLite / PostgreSQL / MySQL),由 [`GarrisonDao`] trait 屏蔽后端差异
//! - `oxcache`:缓存抽象层(L1 内存 + L2 redis),承载 Token-Session 与 Account-Session
//! - **GarrisonManager 单例模式**
//! - [`GarrisonManager`] 持有全局 `Arc<GarrisonLogicDefault>`(基于 `parking_lot::RwLock`,支持覆盖式 `init`)
//! - 业务方启动时调用 [`GarrisonManager::init`] 注入 dao / config / interface 依赖
//! - `GarrisonLogicFactory` 通过 `inventory::submit!` 在编译期注册,运行时由 `inventory::iter` 选取
//! - [`GarrisonUtil::login`] / [`GarrisonUtil::check_login`] 等静态方法委托到全局单例
//!
//! ## 双抽象层
//!
//! - **dbnexus** - 数据库抽象层(SQLite / PostgreSQL / MySQL)
//! - **oxcache** - 缓存抽象层(L1 内存 + L2 redis)
//!
//! ## 使用示例
//!
//! ```toml
//! [dependencies]
//! garrison = { version = "0.7", features = ["web-axum", "protocol-jwt"] }
//! ```
//!
//! ```rust
//! use garrison::prelude::*;
//!
//! // 通过 prelude 引入核心类型
//! // let _config: GarrisonConfig = GarrisonConfig::default();
//! ```
// ====================================================================
// 核心模块(always on,无 feature flag)
// ====================================================================
/// 常量定义模块,提供 DAO key 前缀等类型安全枚举。
/// 核心模块,包含认证、权限、Token 的核心抽象。
/// Stp 模块,提供 GarrisonLogicDefault / GarrisonInterface / GarrisonUtil + 5 个子 trait。
/// 注解模块,定义鉴权注解枚举。
/// 路由模块,提供路由器与拦截器抽象。
/// DAO 模块,定义持久化数据访问抽象层。
/// limiteron 适配器模块,将 GarrisonDao 桥接到 limiteron Storage/QuotaStorage/BanStorage/DistributedLimiter trait。
///
/// 启用 `sms-rate-limit` / `firewall-ratelimit` / `firewall-bruteforce` / `firewall-ddos` /
/// `firewall` / `oauth2-server` feature 时编译。
///
/// v0.7.2:`firewall` 和 `oauth2-server` 传递启用 `dep:limiteron`,
/// 因 `GarrisonFirewallCheckHookDefault` / `PasswordRateLimiter` 统一使用 limiteron(禁止手写限流实现)。
/// 策略模块,提供鉴权策略与防火墙策略。
/// 会话模块,提供 GarrisonSession 会话模型。
/// 缓存模块,提供三层缓存架构(L1 oxcache 内存 + L2 DAO + L3 interface)。
///
/// 启用 `three-tier-cache` feature 时编译。提供 [`UserCacheService`],
/// 用于权限/角色/用户信息的加速查询。
///
/// [`UserCacheService`]: crate::cache::three_tier::UserCacheService
/// 状态机模块,定义 Token / User 显式状态机。
///
/// 提供 [`state::TokenState`](5 状态 + 6 条合法转换)与 [`state::UserStatus`](5 状态 + 9 条合法转换),
/// 严格遵循 FRD §4.2 / §4.3,不集成到现有 Session / User 模块(推迟到 v0.7.0)。
/// 配置模块,提供 GarrisonConfig 全局配置。
/// 健康检查模块,提供 liveness/readiness 探针与依赖项健康检测。
/// 上下文模块,提供请求/响应/存储上下文抽象。
/// JSON 模块,提供 JSON 模板与序列化抽象。
/// 异常模块,定义框架异常类型。
/// 管理器模块,提供全局管理器单例。
/// 插件模块,定义插件 trait 与编译期注册。
/// 可观测性模块,提供 Prometheus 指标 / 结构化 JSON 日志 / OpenTelemetry 分布式追踪。
///
/// 启用 `metrics-prometheus` feature 启用指标采集;启用 `observability-otlp` 启用 OTLP 追踪导出。
/// 未启用任一 feature 时模块仍可导入但 API 为 no-op,保证向后兼容。
/// gRPC 鉴权拦截器模块,提供 `tonic::Interceptor` 实现。
///
/// 启用 `grpc` feature 时编译。从 gRPC 请求 metadata 提取 Authorization Bearer token
/// 并执行鉴权。
/// 国际化模块,提供异常消息中英文切换(fluent-rs)。
///
/// 默认 `Zh`(中文,向后兼容 0.2.x 硬编码行为),通过 `set_locale(GarrisonLocale::En)`
/// 切换至英文。
/// 声明式 JSON 测试套件模块。
///
/// 启用 `garrison-testing` feature 时编译。提供 [`JsonTestSuite`] / [`JsonTestCase`] /
/// [`TestReport`] 类型,支持从 JSON 文件加载测试用例并运行 [`Authorizer`] trait。
///
/// 依赖 `authorize-api` feature(提供 [`Authorizer`] trait 与 [`AuthRequest`] / [`Decision`])。
///
/// [`JsonTestSuite`]: crate::testing::JsonTestSuite
/// [`JsonTestCase`]: crate::testing::JsonTestCase
/// [`TestReport`]: crate::testing::TestReport
/// [`Authorizer`]: crate::core::permission::Authorizer
/// [`AuthRequest`]: crate::core::permission::AuthRequest
/// [`Decision`]: crate::core::permission::Decision
/// actix-web 框架适配模块。
///
/// 启用 `web-actix` feature 时编译。提供 GarrisonRouter + FromRequest extractor +
/// GarrisonMiddleware 完整集成,与 axum 适配对齐。
/// warp 框架适配模块。
///
/// 启用 `web-warp` feature 时编译。提供 GarrisonRouter + Filter extractor +
/// GarrisonRejection 完整集成,与 axum/actix-web 适配对齐。
/// Web 安全中间件模块,提供 WAF / CORS / CSRF 等请求内容校验能力。
///
/// 各子模块独立 feature-gated:
/// - `web-waf`:WAF 请求内容校验
/// - `web-cors`:CORS 跨域资源共享
/// - `web-csrf`:CSRF 跨站请求伪造防护
// ====================================================================
// 可选模块(特性门控)
// ====================================================================
/// 监听器模块,提供事件监听抽象。
/// 安全模块,提供 TOTP / 签名 / Basic / Digest / Unicode 同形异义字检测 / 敏感数据脱敏 验证。
///
/// 密码哈希能力已迁移到 `account::credential::password`(v0.6.0)。
/// 账号安全引擎模块(吸收 keycloak 安全能力)。
///
/// 提供:
/// - 凭证模型 SPI(`account-credential` feature)
/// - 密码策略套件(`account-policy` feature)
/// - 用户级双态锁定(`account-lockout` feature)
/// - AuthenticationFlow DSL(`account-authflow` feature)
///
/// 与 `secure/`(密码学原语)互补:`secure/` 提供底层原语,
/// `account/` 提供账号生命周期安全能力。
/// 协议层模块,包含各协议插件子模块。
/// 认证后端抽象模块,提供 AuthBackend trait + BackendEmbedded + BackendRemote。
///
/// 启用 `backend-embedded` 或 `backend-remote` feature 时编译。
/// - `backend-embedded`:进程内认证,委托 GarrisonManager(zero-break 兼容)
/// - `backend-remote`:HTTP 客户端,连接远程 Auth Server
/// ABAC 策略引擎模块,提供 AbacEngine(基于 Cedar 策略语言)。
///
/// 启用 `abac` feature 时编译核心引擎(AbacEngine / init_abac_engine),
/// 依赖 `cedar-policy` crate。
///
/// `abac` feature 关闭时仅提供 `check_abac_with_policy` stub(no-op),
/// 确保宏 `#[check_permission(permission = "...", abac = "...")]` 生成的代码
/// 在任意 feature 组合下均可编译(R-abac-005)。
///
/// ABAC 作为 RBAC 的增量校验层,不替换 RBAC。RBAC 通过后再检查 ABAC。
/// Auth Server 模块,提供 GarrisonAuthServer(双端口 axum 服务器)。
///
/// 启用 `auth-server` feature 时编译。
/// 将 AuthBackend 方法暴露为 HTTP 端点:
/// - 外网端口:login / logout / refresh(面向用户)
/// - 内网端口:check-* / get-* / kickout 等(服务间调用,需 X-API-Key)
/// OAuth2 Server 模块,提供完整 OAuth2 授权服务器实现(4 端点 + 4 种 grant type + PKCE)。
///
/// 启用 `oauth2-server` feature 时编译。作为授权服务器(AS)角色,处理客户端的
/// authorize / token / revoke / introspect 请求。
///
/// 与 `protocol::oauth2`(OAuth2 客户端 / RP 角色)互补:`protocol::oauth2` 向外部 AS 请求 token,
/// `oauth2_server` 本身就是 AS。
// ====================================================================
// 公共入口
// ====================================================================
/// 预导出模块,包含最常用的类型与 trait。
/// 错误类型定义模块。
// Re-export prelude 以便 `use garrison::prelude::*;` 可用
pub use *;
// ============================================================================
// 多租户隔离类型 re-export
// ============================================================================
//
// 业务方可通过 `use garrison::{TenantContext, TenantResolver, ...}` 直接使用,
// 无需写完整路径 `garrison::context::tenant::TenantContext`。
//
// `ClaimTenantResolver` 需 `protocol-jwt` feature(依赖 jsonwebtoken 解码 JWT claim)。
/// 多租户上下文类型与解析器。
pub use ;
/// JWT claim 租户解析器(需 `protocol-jwt` feature)。
pub use ClaimTenantResolver;
/// 登录主体(携带 login_id,由 web 框架 extractor 填充)。
pub use GarrisonPrincipal;
// ============================================================================
// 状态机类型 re-export
// ============================================================================
//
// 业务方可通过 `use garrison::{TokenState, UserStatus}` 直接使用,
// 无需写完整路径 `garrison::state::TokenState`。
//
// 注:spec R-state-007 提及 `Mode` re-export,但 state-machine.md 未在 state 模块定义 Mode
// (AnnotationMode 位于 annotation 模块),故仅 re-export TokenState / UserStatus(规则7)。
/// Token 生命周期状态(Issued / Active / Expired / Revoked / Refreshed)。
pub use TokenState;
/// 用户账号状态(Pending / Active / Suspended / Inactive / Deleted)。
pub use UserStatus;
// ============================================================================
// 角色层级
// ============================================================================
//
// `RoleHierarchyRecord` 为 always compiled(无 feature gate)。
// `RoleHierarchyService` 需 `db-sqlite` feature(依赖 DbPool 查 SQL)。
//
// 业务方可通过 `use garrison::{RoleHierarchyRecord, RoleHierarchyService}` 直接使用,
// 无需写完整路径 `garrison::dao::repository::role_hierarchy::RoleHierarchyService`。
/// 角色层级表行结构(child_role → parent_role + tenant_id)。
pub use RoleHierarchyRecord;
/// 角色层级服务(TC 预计算 + 缓存 + 增量失效,需 `db-sqlite` feature)。
pub use RoleHierarchyService;
// ============================================================================
// Dbnexus Repository re-export
// ============================================================================
//
// 业务方可通过 `use garrison::{DbnexusUserRepository, ...}` 直接使用,
// 无需写完整路径 `garrison::dao::repository::sqlite::DbnexusUserRepository`。
//
// 需 `db-sqlite` 或 `db-postgres` feature(运行时占位符转换支持两种后端)。
/// 用户表 Repository(app_user)。
pub use DbnexusUserRepository;
/// 角色表 Repository(app_role)。
pub use DbnexusRoleRepository;
/// 权限表 Repository(app_permission,全局表无 tenant_id)。
pub use DbnexusPermissionRepository;
/// 用户-角色关联表 Repository(app_user_role)。
pub use DbnexusUserRoleRepository;
/// 角色-权限关联表 Repository(app_role_permission)。
pub use DbnexusRolePermissionRepository;
/// 认证方式表 Repository(app_auth_method)。
pub use DbnexusAuthMethodRepository;
/// 会话表 Repository(app_session)。
pub use DbnexusSessionRepository;
/// 登录日志表 Repository(app_login_log)。
pub use DbnexusLoginLogRepository;
/// 用户扩展信息表 Repository(app_user_ext)。
pub use DbnexusUserExtRepository;
// ============================================================================
// JWT RefreshToken Rotation
// ============================================================================
//
// `RefreshTokenRecord` 需 `protocol-jwt` feature(hash chain 行结构)。
// `RefreshTokenRotation` 需 `protocol-jwt` + `db-sqlite` feature(依赖 DbPool 查 SQL)。
//
// 业务方可通过 `use garrison::{RefreshTokenRecord, RefreshTokenRotation}` 直接使用,
// 无需写完整路径 `garrison::protocol::jwt::refresh::RefreshTokenRotation`。
/// RefreshToken 表行结构(hash chain:token_hash + parent_token_hash)。
pub use RefreshTokenRecord;
/// RefreshToken Rotation 服务(rotate + detect_reuse + revoke_chain,需 `protocol-jwt` + `db-sqlite`)。
pub use RefreshTokenRotation;
// ============================================================================
// 审计日志
// ============================================================================
//
// 业务方可通过 `use garrison::{AuditLogListener, AuditConfig, AuditEntry, AuditQuery}` 直接使用,
// 无需写完整路径 `garrison::listener::audit::AuditLogListener`。
//
// `AuditConfig` 需 `audit-log` feature(纯配置结构,无 SQL 依赖)。
// `AuditEntry` / `AuditQuery` / `AuditLogListener` 需 `audit-log` + `db-sqlite` feature
// (映射 SQL 表行 / 查询条件 / 持久化监听器)。
/// 审计日志配置(掩码字段 + 保留天数 + 异步写入开关)。
pub use AuditConfig;
/// `audit_logs` 表行结构(tenant_id / event_type / login_id / metadata / success / created_at)。
pub use AuditEntry;
/// 审计日志查询条件(tenant_id / event_type / from / to,全 Option 复合过滤)。
pub use AuditQuery;
/// 审计日志监听器(实现 `GarrisonListener`,持久化 `GarrisonEvent` 到 `audit_logs` 表)。
pub use AuditLogListener;
// ============================================================================
// 社交登录
// ============================================================================
//
// 业务方可通过 `use garrison::{SocialLoginProvider, SocialUserInfo, ...}` 直接使用,
// 无需写完整路径 `garrison::protocol::social::SocialLoginProvider`。
//
// - `SocialLoginProvider` / `SocialUserInfo` / `SocialProvider`:公共 trait/结构,无 feature 依赖
// - `WechatProvider`:需 `social-wechat` feature(微信扫码登录)
// - `AlipayProvider`:需 `social-alipay` feature(支付宝授权登录)
// - `SocialBindingService`:需 `db-sqlite` feature(依赖 DbPool 查 social_bindings 表)
/// 社交登录服务提供方 trait(get_authorization_url / exchange_token / get_user_info)。
pub use SocialLoginProvider;
/// 社交用户信息(provider + provider_user_id + union_id + raw JSON)。
pub use SocialUserInfo;
/// 社交登录平台标识(Wechat / Alipay / WechatMiniApp)。
pub use SocialProvider;
/// 微信扫码登录 provider(需 `social-wechat` feature)。
pub use WechatProvider;
/// 微信小程序登录 provider(需 `social-wechat` feature)。
pub use WechatMiniAppProvider;
/// 支付宝授权登录 provider(需 `social-alipay` feature)。
pub use AlipayProvider;
/// 社交账号绑定服务(find_or_create,需 `db-sqlite` + `social-wechat`/`social-alipay` feature)。
pub use SocialBindingService;
// ============================================================================
// Keycloak OIDC RP
// ============================================================================
//
// 业务方可通过 `use garrison::{KeycloakConfig, KeycloakProvider, ...}` 直接使用,
// 无需写完整路径 `garrison::protocol::oauth2::keycloak::KeycloakConfig`。
//
// 全部类型需 `keycloak-oidc` feature(依赖 `protocol-oidc` → `protocol-jwt` + `protocol-oauth2`)。
/// Keycloak OIDC RP 配置(base_url / client_id / client_secret / redirect_uri)。
pub use KeycloakConfig;
/// Keycloak OIDC 依赖方(discover / verify_id_token / exchange_code)。
pub use KeycloakProvider;
/// Keycloak id_token 的 claims(sub / exp / realm_access / resource_access / tenant_id)。
pub use KeycloakClaims;
/// Keycloak token endpoint 响应(access_token / refresh_token / id_token / expires_in)。
pub use KeycloakTokenSet;
/// Keycloak realm 访问信息(roles 列表)。
pub use RealmAccess;
// ============================================================================
// 安全防护套件
// ============================================================================
//
// 业务方可通过 `use garrison::{GarrisonFirewallStrategy, FirewallContext, ...}` 直接使用,
// 无需写完整路径 `garrison::strategy::firewall::GarrisonFirewallStrategy`。
//
// - `firewall` feature:基础 trait + Context + StrategyRegistration(inventory 注册)
// - `firewall-bruteforce` / `firewall-ratelimit` / `firewall-anomalous` / `firewall-ddos` / `firewall-geoip`:
// 5 个独立 strategy 实现,各自 feature 门控
// - `GeoCoord` / `GeoLookup` / `CountryLookup`:共享地理查询抽象(anomalous / geoip 共用)
/// 防火墙策略 trait(IP 级安全检查契约)。
pub use GarrisonFirewallStrategy;
/// 防火墙上下文(IP / login_id / tenant_id)。
pub use FirewallContext;
/// 防火墙策略注册条目(inventory 收集,仅含 name)。
pub use StrategyRegistration;
/// 暴力破解防护策略 + 配置。
pub use ;
/// 速率限制策略 + 配置 + 作用域枚举。
pub use ;
/// 异地登录检测策略 + 配置。
pub use ;
/// DDoS 防护策略 + 配置。
pub use ;
/// GeoIP 地理位置拦截策略 + 配置。
pub use ;
/// 地理坐标 + GeoLookup / CountryLookup trait(anomalous / geoip 共享)。
pub use ;
// ============================================================================
// 过程宏注解
// ============================================================================
/// 过程宏注解模块(feature = "annotation-macros")。
///
/// 启用 `annotation-macros` feature 时,re-export `garrison-macros` crate 的 7 个
/// `#[proc_macro_attribute]`:
/// - `#[check_login]` / `#[check_permission]` / `#[check_role]`(0.4.2)
/// - `#[check_access_token]` / `#[check_client_token]` / `#[check_temp_token]`(0.5.0 P2)
/// - `#[check_api_key]`
///
/// 宏将 async fn 包装为 wrapper,在 body 前插入 `GarrisonUtil::check_*()` 调用,
/// 失败时返回 `axum::response::Response`(401/403)。
///
/// # 示例
///
/// ```ignore
/// use garrison::check_login;
/// use axum::response::IntoResponse;
///
/// #[check_login]
/// async fn handler() -> impl IntoResponse {
/// "hello"
/// }
/// ```
pub use ;