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
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! HTTP Digest 认证子模块(RFC 7616),基于 `md5` / `sha2` crate 实现摘要认证。
//!
//! `DigestAlgorithm::default()` 为 `Sha256`;nonce 形如 `base64(timestamp:random_uuid)`,validate 校验时间戳防过期;
//! 支持 `qop=auth` 与 `qop=auth-int`(后者经 `validate_with_body` 传入请求体)。
//!
//! # 安全说明
//!
//! MD5 已被证明存在碰撞攻击,新系统须用 SHA256(现为默认);`MD5` 变体未做 feature 门控,
//! 但构造时输出 `tracing::warn!` 便于审计每次使用,仅限客户端只支持 MD5 时使用。
//!
//! # 重放防护(务必阅读)
//!
//! nonce 本身仅是 `base64(timestamp:uuid)` + TTL(默认 300s),**不防重放**;完整 nc 单调性防护
//! (RFC 7616 §3.4.6)须经 `with_dao` 注入 DAO 才启用:未注入 DAO 时 nc 校验 fail-open(仅进程级 warn 一次),
//! 攻击者可在 TTL 窗口内重放同一 Authorization header;注入 DAO 后 nc 回退/重复被拒绝(fail-closed,DAO 故障即拒绝认证);
//! 未注入 `server_key` 时 nonce 无 HMAC 签名、客户端可自铸(仍受 TTL 约束)。
//!
//! 生产环境必须 `with_dao(...)` 并强烈建议 `with_server_key(...)`;API 无编译期强制,遗漏只在运行期产生 warn 日志。
/// Digest 算法枚举。
/// `DigestAlgorithm` 实现块。
/// HTTP Digest 认证工具,封装 RFC 7616 质询生成与响应校验。
///
/// # 示例
///
/// ```
/// #[cfg(feature = "protocol-httpdigest")]
/// # {
/// use garrison::secure::httpdigest::HttpDigestAuth;
///
/// let auth = HttpDigestAuth::new("test@realm", "MD5").unwrap();
/// let challenge = auth.challenge();
/// assert!(challenge.starts_with("Digest "));
/// # }
/// ```
/// `HttpDigestAuth` 实现块。