因子加密密钥健康度

GET

/api/v1/admin/auth-factors/key-health

统计 TOTP 密文相对当前 AUTH_ENCRYPTION_KEYS 的分布。
从 AUTH_ENCRYPTION_KEYS 移除旧 key 之前必须先看这个端点：

unavailable > 0：已经有账号读不出种子，处于锁死状态。

rotatable > 0：仍有账号依赖非 active key，此刻退役该 key 会制造新的锁死账号。

legacy > 0：仍有无 kid 的历史信封等待迁移。

单次扫描上限 10000 条；truncated 为真时统计只覆盖前 scanned 条。
响应只包含计数，不返回 kid 列表或密钥环结构。

权限：Owner 专属的 rotate_keys。

请求参数

无

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

🟢200成功

application/json

密文按可读状态的分布计数

Bodyapplication/json

示例

{
    "total": 0,
    "scanned": 0,
    "current": 0,
    "rotatable": 0,
    "legacy": 0,
    "unavailable": 0,
    "truncated": true
}

🟠401没有权限

🟠403禁止访问

🔴503服务器故障

修改于 2026-08-17 07:42:39