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
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! API 签名协议模块(对应 微服务网关签名认证):HMAC-SHA256 + Base64 请求签名
//! 生成与校验 + nonce 防重放。仅在启用 `protocol-sign` 特性时编译。
//!
//! ## 签名算法
//!
//! `sign = base64(hmac_sha256(hkdf_key, "{method}\n{path}\n{timestamp}\n{nonce}\n{body_sha256}"))`
//!
//! 其中 `hkdf_key = HKDF-SHA256(app_secret, salt=app_key, info="garrison-sign-v2")`。
//!
//! ## Key 命名空间
//!
//! sign nonce 存于 `garrison:sign:nonce:<app_key>:<nonce>`(app_key 前缀隔离多应用)。
/// SignHandler 实现(构造/签名/校验/Drop 零化)。
use crateGarrisonDao;
use Hmac;
use Sha256;
use Arc;
/// 默认时间戳窗口(秒)。
const DEFAULT_TIMESTAMP_WINDOW: i64 = 300;
/// app_secret 最小长度(32 字节 = 256 位,满足 HMAC-SHA256 安全要求)。
const MIN_APP_SECRET_LEN: usize = 32;
/// HKDF info 上下文字符串(域分隔,防止同一密钥在不同用途间复用)。
const HKDF_INFO: & = b"garrison-sign-v2";
/// HMAC-SHA256 类型别名。
type HmacSha256 = ;
/// API 签名处理器:持有 `app_key`、`app_secret` 与 `Arc<dyn GarrisonDao>`(nonce
/// 存储)。`app_secret` 最小 32 字节;HKDF 派生密钥在构造时一次性计算并缓存到
/// `derived_key`,`sign`/`validate` 直接复用。