更新证书恢复整改清单与接口文档
标记证书历史版本恢复前后端开发、前端测试和生产构建进度,补充恢复接口的 history_id、202、幂等、权限和本地恢复边界说明。
This commit is contained in:
1 parent
b75773b85e
commit
79e0e42bf9
2 files changed
+18
No files matched your search
@@ -82,6 +82,15 @@
|
||||
|
||||
前端使用独立 RenewalAction.js 管理提交状态和幂等键,复用任务详情跟踪结果;禁止重复点击时并发提交,不能仅凭受理响应显示续期完成。
|
||||
|
||||
## 证书历史版本恢复
|
||||
|
||||
- `GET /api/v1/domains/:id/certificate/versions` 返回当前证书及可恢复的本地历史版本;前端使用 `history_id` 作为稳定恢复标识,不使用列表序号或展示版本号。
|
||||
- `POST /api/v1/domains/:id/certificate/versions/:history_id/restore` 不接收证书内容,使用 `Idempotency-Key` 提交恢复任务;成功返回 `202 Accepted`、`accepted=true`、`task` 和 `Location: /api/v1/tasks/任务编号`。
|
||||
- 恢复任务必须通过域名可见性、证书管理、部署执行和私钥读取权限复核;当前证书、过期版本、未生效版本、域名不匹配或证书类型不匹配不得恢复。
|
||||
- 同域名存在活动恢复任务时返回冲突及原任务信息;相同幂等键重放时返回原任务,不重复执行。前端必须继续查询任务详情,不能凭 202 或 200 直接显示恢复完成。
|
||||
- 恢复范围仅为 Scert 本地托管证书历史;任务完成不代表远端服务器已经部署新证书,远端部署必须使用独立部署任务并单独确认。
|
||||
- 响应及错误信息不得暴露私钥内容、私钥路径、证书存储本地路径或服务器路径。
|
||||
|
||||
## 数据模型
|
||||
|
||||
| 模型 | 字段 |
|
||||
|
||||
Reference in new issue
Block a user