Files

52 lines
4.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 租赁账户的应用工作台
入口:PROXY_ACCOUNT → 租赁应用(system/rentApp/user/index)。
1. 无应用时显示创建引导;有应用时显示卡片列表及分页。
2. 创建时填写名称及可选 HTTPS 默认回调地址,创建成功自动进入详情。
3. 详情展示应用 ID、状态、默认回调、创建时间和凭证版本。
4. 点击创建/轮换凭证,确认影响后,服务端为当前 APP 签发凭证;无需手工填写主体编号。
5. API Secret 仅在成功响应的弹窗中展示一次,默认隐藏;确认安全保存后关闭,立即清除内存引用,不写缓存或日志。
签发会使旧 ACTIVE 凭证变为 VERIFY_ONLY,新请求须切换到新凭证。签发失败不自动重试,避免多次轮换。
## 接口与权限
| 接口 | 权限 | 说明 |
| --- | --- | --- |
| GET /rental/mine/app | rent:portal:view | 本人应用分页 |
| POST /rental/register/app | rent:app:create 或旧 rent:portal:register | 归属取当前登录用户 |
| GET /rental/app/{id} | rent:portal:view | 按当前用户校验应用归属,凭证显式选列,不返回 Secret |
| POST /rental/credential/issue | rent:credential:issue | owner_type 固定 APP,owner_id 为当前应用;后端再次校验归属 |
现有 sql/rent_role_permissions.sql 授予 PROXY_ACCOUNT 创建、查看、签发及删除权限,无新增表结构。已部署环境执行 sql/rent_app_remove_permission.sql 增量授权删除权限,执行后重新登录。
## 删除与时间显示(2026-10-25)
- 应用详情时间统一返回 UTC 毫秒时间戳,页面按浏览器本地时区显示。前端兼容 ISO 与旧 UTC 日期文本;无效值显示 `—`,不会再显示全零时间。
- 详情底部提供删除按钮和二次确认。DELETE /rental/app/{id} 需要 rent:app:remove(兼容旧 rent:portal:register)。
- 删除只允许本人应用;任何状态订单及任何状态 APP 凭证(包括已过期、已吊销及 VERIFY_ONLY)均阻止删除,不自动清理关联。
- 订单下的任务、退款、流水、回调等通过禁止删除有订单应用而受到保护。审计日志独立保留,并记录删除操作,不作为业务依赖阻止空应用删除。
- 删除、下单、凭证签发共享应用行锁,先检查后删除在同一事务完成。旧生成器单个及批量删除入口同步复用此规则,整批失败回滚。
本轮验证:JDK8 Rental*Test 56项通过;ESLint、Vue模板编译、`node tests/rental-app-time.mjs` 时间回归通过。未执行数据库授权SQL及真实浏览器联调。
## Secret 展示与凭证删除
- 一次性 Secret 保持只读密码框,使用独立“显示/隐藏”按钮;修复 Element UI readonly 导致内置显隐按钮被隐藏的问题。每次签发重置为隐藏,关闭清空。
- 凭证列表提供删除与二次确认,DELETE /rental/credential/{id} 复用 rent:credential:issue,无新增权限 SQL。
- 仅允许本人 APP 凭证删除;有关联任务、回调或未过期 nonce 时拒绝。由于订单不记录请求凭证版本,有任何应用订单(包括已取消历史订单)也拒绝删除,应保留历史凭证、按需吊销。
- 节点凭证禁止删除,继续使用吊销,避免丢失历史任务验签依据。旧生成器凭证删除入口同样复用业务校验。
- 删除不清理审计,也不恢复原先已转 VERIFY_ONLY 的其他版本;删除后若无 ACTIVE 凭证,需主动重新签发。
本轮验证:后端 Rental*Test 57项通过,前端 ESLint 与模板编译通过;未进行实际登录浏览器验收。
验收:空列表引导、创建失败保留输入、创建后打开详情、取消轮换不签发、重复点击防重、一次性密钥确认、跨用户详情拒绝、窄屏布局。构建及隔离测试不替代真实登录浏览器联调。
## 本次验证
- 页面及 API 文件 ESLint 通过,Vue 模板独立编译通过。
- staging 全量构建成功;其他页面存在 3 项导出缺失及资源体积警告。
- JDK8 后端 Rental*Test 共 55 项通过(0 失败),包含新增应用详情隔离测试。
- 尚未连接实际 MySQL 或登录 PROXY_ACCOUNT 浏览器验收。