选择身份
local Console 和 SDK 通过受保护的本地发现连接工作区。远程 SDK 使用明确 base URL 和 Token。不要把本地发现文件复制成公共配置,或将 owner Token 放进浏览器。 application Token 可以读取允许的任务资源、创建 Session、提交 / 取消 Run、上传初始文件、关闭 Session、管理自身可访问的预览与委托访问。它也可创建 Agent,但不能因此推断允许修订 / 归档。连接 CRUD、Secret、Token 管理、审批决定、工具拒绝 / 对账等管理路由不在其允许范围。准确列表见路由权限实现。 同一租户中的多个业务用户仍由应用执行归属校验。拿到一个 Session ID 不代表有业务权限;Token 也不是自动限定到某个单独 Session 的密钥。代表性的路由权限边界
以下描述 application 角色的路由门禁。通过门禁后仍须满足资源归属、输入与操作状态检查。ID 是占位符,不代表可以访问其他用户的任务。
隔离验收时,签发专用 application Token,用它读取鉴权健康信息并执行允许的任务,再确认创建 Token 和审批决定均返回 403。撤销后重试鉴权请求,应被拒绝。另用第二个测试租户检查跨租户读取/绑定;这与同租户内两个业务用户的隔离是不同检查。不要用 owner Token 替代负向验证。这是操作流程,不声称本轮已执行这些数据库用例。
创建 Token
通过 Console 或有 owner 权限的后端执行:轮换与撤销
rotate_token / rotateToken 在事务中撤销旧 Token 并返回新 ID 和新值,保留旧的到期时间,不重新延长寿命。调用返回后旧 Token 已失效,因此需要安排客户端切换窗口。
如果需要应用层平滑切换,可以先创建独立新 Token、部署并验证,再撤销旧 Token;这与原子 rotate 不同,重叠有效期由你管理。不要把新值发送到不受信任的客户端。
revoke_token / revokeToken 撤销指定 application Token。列表中的 last_used_at 有助于调查使用情况,但不能单独证明所有部署已完成轮换。
轮换响应丢失时
即使客户端没收到新明文,事务也可能已经撤销旧 Token。不要假定旧值仍有效,也不要重复轮换旧 ID。用独立 owner 身份查询 Token 元数据,确认哪些 ID 仍有效。列表无法恢复丢失明文:另行签发替代 Token、部署,并按 ID 撤销未使用的有效替代项。事故记录仅保存标识与状态,不保存明文。撤销应用 Token 控制后续鉴权,不等于取消已经运行的 Run。诊断和验收
401 先核对 Token 格式、撤销 / 过期和正确控制平面;403owner_token_required 表示路由需要管理身份,不应把应用权限错误当作密码错误反复重试。
验证允许的执行调用成功、管理路由被拒绝、旧 Token 在轮换后失败、新 Token 保留原到期时间、撤销后后续鉴权失败。再用两个业务用户检查应用层不能互读任务,及跨租户不能读取或绑定资源。
依据:Token 生命周期、鉴权。下一步:后端集成、安全边界、HTTP API。