Struct KeyVault 

pub struct KeyVault { /* private fields */ }

密钥保险库，集成生成、轮换、存储、检索与版本管理

所有操作线程安全，通过 parking_lot::RwLock 保护内部状态。

Implementations

impl KeyVault

pub fn new(rotation_policy: RotationPolicy) -> Self

创建密钥保险库，指定轮换策略

pub fn generate_key( &self, name: &str, algorithm: KeyAlgorithm, purpose: KeyPurpose, ) -> Result<String, KeyError>

生成新密钥并存入存储，返回密钥 ID

pub fn rotate_key(&self, name: &str) -> Result<String, KeyError>

轮换密钥：弃用当前版本并生成新版本

pub fn get_key(&self, key_id: &str) -> Option<KeyEntry>

获取密钥（按 ID），同时递增使用计数

pub fn get_latest_key(&self, name: &str) -> Option<KeyEntry>

获取最新版本密钥（按名称）

pub fn get_key_by_version(&self, name: &str, version: u32) -> Option<KeyEntry>

按名称与版本获取密钥

pub fn get_all_versions(&self, name: &str) -> Vec<KeyEntry>

获取指定名称的所有版本

pub fn revoke_key(&self, key_id: &str) -> Result<(), KeyError>

吊销密钥

pub fn deprecate_key(&self, key_id: &str) -> Result<(), KeyError>

弃用密钥

pub fn needs_rotation(&self, name: &str) -> bool

检查密钥是否需要轮换

pub fn auto_rotate(&self, name: &str) -> Option<String>

自动轮换检查：若需要轮换则执行

pub fn key_count(&self) -> usize

返回密钥总数

pub fn version_count(&self, name: &str) -> usize

返回指定名称的版本数

pub fn key_names(&self) -> Vec<String>

返回所有密钥名称

pub fn audit_log(&self) -> KeyAuditLog

返回审计日志的只读快照

pub fn usage_count(&self, key_id: &str) -> u64

返回指定密钥的使用次数

pub fn get_by_tag(&self, tag: &str) -> Vec<KeyEntry>

按标签检索密钥

pub fn get_by_status(&self, status: KeyStatus) -> Vec<KeyEntry>

按状态检索密钥

pub fn delete_key(&self, key_id: &str) -> Result<KeyEntry, KeyError>

删除密钥（永久移除）

Trait Implementations

impl Debug for KeyVault

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.