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
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! OAuth2 协议模块,提供 Authorization Code / Client Credentials / Password / Refresh Token 四种授权流程。
//!
//! 对应 OAuth2 协议支持,
//! 基于 `reqwest` crate 实现 HTTP 请求。
//!
//! 仅在启用 `protocol-oauth2` 特性时编译。
//!
//! ## 设计决策
//!
//! - `OAuth2Client` 不持久化 token,由业务方决定存储方式。
//! - HTTP 客户端使用 `reqwest` 0.13(rustls-tls,禁用 native-tls)。
//! - 实现四种授权流程:Authorization Code / Client Credentials / Password / Refresh Token()。
//! - 支持 Token Introspection (RFC 7662):通过 `OAuth2Client::introspect_token` 查询 token 状态()。
use ;
/// OIDC 扩展模块。
///
/// 提供 `OidcHandler` 用于签发/验证 OIDC id_token + discovery endpoint 元数据生成。
/// 仅在启用 `protocol-oidc` feature 时编译。
/// Scope Handler 注册表模块。
///
/// 提供 `ScopeHandler` trait + `ScopeRegistry` 动态注册表,用于在 OAuth2 token
/// 请求前对 scope 进行客户端策略校验。仅在启用 `oauth2-scope-handler` feature 时编译。
/// Keycloak OIDC RP 模块。
///
/// 提供 `KeycloakProvider` 作为 OIDC 依赖方(RP),对接 Keycloak IdP:
/// - `KeycloakConfig`:配置 base_url / client_id / client_secret / redirect_uri
/// - `KeycloakProvider`:discover(fetch discovery metadata)/ verify_id_token(JWKS 验签)
/// / exchange_code(authorization_code → token set)
/// - `KeycloakClaims`:Keycloak 特有 claim(realm_access.roles / resource_access / tenant_id)
///
/// 仅在启用 `keycloak-oidc` feature 时编译。
/// OAuth2 客户端实现模块。
///
/// 提供 [`OAuth2Client`](OAuth2 协议客户端),实现 Authorization Code / Client
/// Credentials / Password / Refresh Token 四种授权流程,以及 Token Introspection
/// (RFC 7662)。仅在启用 `protocol-oauth2` feature 时编译。
/// OAuth2 客户端 re-export。
///
/// 通过 `pub use` 将 `client::OAuth2Client` 暴露在 `protocol::oauth2` 命名空间根,
/// 供外部以 `garrison::protocol::oauth2::OAuth2Client` 直接使用。
pub use OAuth2Client;
/// OAuth2 令牌响应。
///
/// 授权服务器返回的 JSON 通过 `Deserialize` 解析。
/// 可选字段使用 `#[serde(default)]` 以容忍授权服务器省略部分字段。
/// Token Introspection 响应。
///
/// 表示授权服务器对 token 的 introspection 结果。`active` 字段为必填,
/// 其他字段在 `active=true` 时由授权服务器按需返回;`active=false` 时通常省略。
///
/// # 字段语义(RFC 7662 §2.2)
/// - `active`: token 是否当前有效(必填)。
/// - `scope`: token 的 scope 列表(空格分隔字符串)。
/// - `client_id`: token 关联的客户端 ID。
/// - `username`: token 关联的人类可读用户名。
/// - `token_type`: token 类型(如 "Bearer")。
/// - `exp`: token 过期时间(Unix 时间戳)。
/// - `iat`: token 签发时间(Unix 时间戳)。
/// - `nbf`: token 生效时间(Unix 时间戳,之前不可用)。
/// - `sub`: token 主体标识(通常为用户 ID)。
/// - `aud`: token 受众(预期消费者)。
/// - `iss`: token 签发者。
/// - `jti`: token 唯一标识。
// ============================================================================
// OAuth2Client struct + impl + Drop 已迁移至 `client.rs`(规则 25:mod.rs 接口隔离)。
// URL 编码工具由 `percent-encoding` crate 提供,详见 `client.rs` 中的 `url_encode`。
// ============================================================================