docs: 增加管理端 API 密钥操作与验证说明 (#46)

2026-08-25 10:29:27 +08:00
parent 3b5eacc47d
commit 31061a29cf
1 changed files with 19 additions and 0 deletions
@@ -522,3 +522,22 @@ go -C admin test -count=1 -run '^(TestAdminAPIKeyGovernanceMySQL|TestChorusAPIMy
 ```

 验证覆盖：生命周期事务审计、未知 Key 不写行、成功/拒绝/429 提交审计、summary 脱敏、`last_used_at` 节流、管理检索/详情、并发安全的幂等撤销、双审计和 JWT/Casbin 负向路径。管理 API 的真实 go-admin 鉴权失败沿用框架约定，可能返回 HTTP 200 且 JSON `code=401`；判断时必须同时检查响应 JSON，不能只看 HTTP 状态。
+
+
+## #46 管理端 API 密钥治理页面
+
+管理员登录后，从“Chorus 运营 → API 密钥”进入治理页面。列表仅展示终端用户、密钥名称、固定前缀、状态和时间元数据，支持按用户编号/账号/密钥名称/前缀与状态筛选，并使用服务端分页。页面和浏览器缓存中都不会取得完整密钥、`public_id` 或 `secret_hash`，也不提供管理员创建用户密钥的入口。
+
+“详情”读取单条元数据和最近 20 条脱敏安全事件；摘要只显示已审核的来源、类型、幂等结果和管理员编号。“撤销”必须经过二次确认，成功后立即刷新列表；重复请求保持幂等，但已撤销密钥不能恢复。没有权限、加载失败、空结果和加载中均有独立页面状态。
+
+前端回归命令：
+
+```powershell
+corepack pnpm --dir admin-ui lint
+corepack pnpm --dir admin-ui exec vue-cli-service test:unit --runInBand
+$env:NODE_OPTIONS = "--max-old-space-size=4096"
+corepack pnpm --dir admin-ui build:prod
+$env:NODE_OPTIONS = $null
+```
+
+浏览器验收需登录实际管理端，覆盖列表、筛选、详情、撤销确认的取消路径以及 375/768/1024/1440 四种视口；主页面不得横向溢出，表格在窄屏内自行滚动。真实撤销只对专门创建的合成测试密钥执行，不使用生产用户或真实凭据。