Struct KeyRotation 

pub struct KeyRotation { /* private fields */ }

JWT 密钥轮换管理器

支持多密钥并存验证：当前密钥签发/验证，旧密钥在 grace period 内仍可验证。 轮换任务定期生成新密钥，旧密钥移入 previous 列表，超期后删除。

Implementations

impl KeyRotation

pub fn from_env() -> Result<KeyRotation, KeyRotationError>

从环境变量创建密钥轮换管理器

• SZ300_JWT_SECRET（必填）：当前密钥
• SZ300_JWT_ROTATION_INTERVAL：轮换间隔秒数（默认 86400 = 24h）
• SZ300_JWT_GRACE_PERIOD：宽限期秒数（默认 3600 = 1h）

pub fn new( current: String, rotation_interval: Duration, grace_period: Duration, max_previous: usize, ) -> KeyRotation

直接构造（用于测试或显式配置）

pub fn sign_token(&self, claims: &JwtClaims) -> Result<String, KeyRotationError>

用当前密钥签发 token

pub fn verify_token(&self, token: &str) -> Result<JwtClaims, KeyRotationError>

验证 token：先尝试当前密钥，失败则遍历旧密钥（grace period 内）

pub fn spawn_rotation_task(self: Arc<KeyRotation>) -> JoinHandle<()>

启动密钥轮换定时任务

pub async fn do_rotation( &self, grace_period: Duration, max_previous: usize, ) -> Result<(), String>

执行一次密钥轮换

pub fn fingerprint(key: &str) -> String

计算密钥指纹（SHA256 前 8 位十六进制）

pub fn current_fingerprint(&self) -> String

获取当前密钥指纹（用于审计日志）

Trait Implementations

impl Debug for KeyRotation

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

Formats the value using the given formatter.