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
// Copyright (c) 2026 Kirky.X🌠
// SPDX-License-Identifier: Apache-2.0
//! WebAuthn/Passkey 凭据 SPI 与注册/认证仪式(feature = "protocol-webauthn"),
//! 基于 `webauthn-rs` 0.5:
//!
//! - [`challenge`](crate::protocol::webauthn::challenge):仪式态经 DAO `set_if_absent`+TTL 暂存、
//! `get_and_delete` 原子读删,键不存在即判重放——challenge 一次性是协议的反重放根基。
//! - [`credential`](crate::protocol::webauthn::credential):凭据领域模型
//! (公钥/sign_count/backup flags/attestation)与 SQL 行双向映射。
//! - [`service`](crate::protocol::webauthn::service):仪式编排;注册侧 `ExcludeCredentials`
//! 防同 authenticator 重复绑定(叠加 `credential_id` 唯一约束兜底),认证侧
//! sign_count 单调(回退判克隆)与 backup flags 更新落库。
//!
//! ## RP 配置派生
//!
//! RP 配置从 issuer URL 派生(`rp_id` = URL host,`origins` = issuer URL),
//! issuer 变更后自动跟随,无需独立 RP 配置项。
//!
//! ## key 命名空间
//!
//! `garrison:webauthn:challenge:<challenge_b64>`(仪式态 JSON,
//! TTL = `WebauthnConfig::challenge_ttl_secs`),与 session/qrlogin/sign 等隔离。
//!
//! ## 安全语义
//!
//! - 仪式态只落服务端存储(`danger-allow-state-serialisation` 上游认可场景),
//! 绝不可下发客户端可读位置,否则重放防御失效。
//! - 认证成功后 sign_count 单调推进,回退显性拒克隆(不静默放行);
//! backup_eligible 只升不降,backup_state 跟随最新断言。
// 仪式测试经 sqlite 真实库承载凭据/challenge 持久化,production 组合
// (无 db-sqlite)下不编译;pub(crate) 供 stp/mfa 的 provider 全流程
// 穿透测试复用同一套录制向量装置(避免向量复制漂移)
pub
use ;
// FactorPurpose / FactorPolicy:passwordless 与 2FA 双 policy
/// 凭据准入用途:passwordless(凭据即身份)或 second factor(叠加因子)。
///
/// 双 policy 分立配置([`WebauthnConfig::passwordless`] /
/// [`WebauthnConfig::second_factor`]):注册期按用途门控准入,
/// 关闭的用途显性拒绝(不做静默降级)。
/// 单一用途的准入 policy(构造后不可变)。
// WebauthnConfig:配置(构造后不可变)
/// WebAuthn/Passkey 配置(经 [`service::WebauthnService`] 注入,构造后不可变)。
// WebauthnCeremonyError:仪式错误词汇表(显性化,不静默)
/// WebAuthn 仪式错误:模块自有的错误词汇表,边界处映射为
/// [`crate::error::GarrisonError`](`InvalidParam` 携带显性 detail)。
///
/// 每个变体对应一个可测试的安全属性(重放/克隆/重复绑定/attestation 非法),
/// 不与 DAO/配置错误混淆。