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
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! 单点登录 (SSO) 协议模块,提供 ticket 签发/校验/销毁能力。
//!
//! 对应 SSO 单点登录支持,
//! 通过 `GarrisonDao` 存储 ticket(TTL 60 秒,一次性使用)。
//!
//! 仅在启用 `protocol-sso` 特性时编译。
//!
//! ## Key 命名空间
//!
//! 所有 SSO 票据存储在 `garrison:sso:ticket:<ticket>` 命名空间下,
//! 与 session/sign/apikey/temp 模块隔离。
// SSO Server 独立抽象模块。
// 仅在启用 `protocol-sso-server` 特性时编译,依赖 `protocol-sso`。
// 模块重导出:通过 mod 路径访问子模块类型(避免外部代码引用具体文件路径)
pub use SsoServer;
// SAML 2.0 协议支持。
// OIDC RP 协议支持。
/// Re-export OIDC 核心类型(Rule 25:mod.rs 暴露接口)。
///
/// 通过 `garrison::protocol::sso::OidcProvider` / `DefaultOidcProvider`
/// / `OidcDiscoveryConfig` / `OidcUserInfo` 直接访问,无需 `oidc::` 前缀。
pub use ;
// Redis pub/sub SsoChannel 实现。
// 仅在 cache-redis + protocol-sso-server feature 同时启用时编译。
use crateGarrisonDao;
use ;
use Arc;
/// `SsoClient` 实现模块。
///
/// 从 `mod.rs` 迁移以符合规则 25(mod.rs 接口隔离):
/// impl 块与顶层 `fn sign_ticket` / `fn verify_ticket_signature` 不允许留在 `mod.rs`。
/// `server.rs` 通过 `use super::client::{sign_ticket, verify_ticket_signature}` 直接引用。
pub
/// SSO ticket 存储的 JSON 数据。
///
/// `pub(crate)` 暴露以供 `server` 模块复用,避免跨模块重复定义导致格式漂移(M6 修复)。
pub
/// SSO 客户端,提供 ticket 签发/校验/销毁。
///
/// 持有 `Arc<dyn GarrisonDao>` 用于票据存储,TTL 默认 60 秒。
/// 实现 `Send + Sync`,可在多线程环境共享。
///
/// # Ticket 签名(依据安全审计 M5)
///
/// 所有 ticket 使用 HMAC-SHA256 签名,格式为 `{64_hex_random}.{hmac_b64}`。
/// 即使 DAO 层被攻破或存在 key 碰撞,攻击者也无法伪造有效签名。
/// secret 由 `new(dao, secret)` 必传,禁止空 secret。