feat(credentials): add stage 3 authenticated OAuth and access-token issuance
Add explicit legacy/broker configuration. Broker mode requires a protected keyring, product-approved permission profiles and enabled platform OAuth; production requires PostgreSQL. Default legacy behavior stays unchanged. Wire the broker to v2 signed device status, authorization start/status and access-token issuance routes. Bind proofs to protocol, environment, app, method/path and complete payload; verify nonce, certificate, owner and binding generation. Add an additive generation migration and return the current generation in binding receipts or authenticated bootstrap status. Persist encrypted OAuth state and atomically claim callbacks. Verify the actual consenting user, supersede older pending authorization intents and recheck bindings/transactions before credential writes and issuance. Preserve rotated credentials if unbind occurs mid-refresh, but deny issuance. Return an explicit access-only response and record metadata-only audit. Extract shared legacy device authentication so notifications do not depend on the business proxy module. Broker mode omits legacy refresh/claim/start and /work/api routes; authorization cards reference server-owned v2 transactions. Document signatures, configuration and migration boundaries. Validation: 185 passed, 3 skipped (real PostgreSQL not configured), with 15 existing dependency deprecation warnings. New API coverage: 38 passed, 1 real PostgreSQL case skipped. AST, docs and staged diff checks pass. No production deployment, key generation, client upgrade or real Work API calls were performed. Compose/mount configuration, full unbind/connection compensation and durable message-task lifecycle remain later stages.
This commit is contained in:
@@ -10,7 +10,7 @@
|
||||
| --- | --- | --- | --- |
|
||||
| 1 | 服务端加密凭据存储基础 | 密文持久化、应用/用户/环境隔离、版本冲突、密钥轮换与篡改检测测试;不接入旧路由 | 已完成本地开发测试,提交71b9678 |
|
||||
| 2 | 集中凭据Broker及刷新 | 应用/用户锁、持锁重读、版本CAS、响应校验、刷新unknown;新授权不受旧刷新覆盖 | 本次完成本地开发测试 |
|
||||
| 3 | OAuth与认证领取 | 共享state事务、实际用户核验、绑定代次、只返回access的独立DTO及领取认证 | 待开发 |
|
||||
| 3 | OAuth与认证领取 | 共享state事务、实际用户核验、绑定代次、只返回access的独立DTO及领取认证 | 本次完成本地开发测试,显式broker模式启用 |
|
||||
| 4 | ECS权威解绑与消息任务关联 | 停发Token、失效事务/任务、连接和旧码联动,多实例/异常恢复 | 待开发 |
|
||||
| 5 | 配置部署、迁移与旧接口退出 | 密钥挂载、产品权限配置、客户端对接、停用旧刷新/claim及代理、ARM64和真实平台验收 | 待开发 |
|
||||
|
||||
@@ -75,7 +75,7 @@ python -m pytest deployable/tests deployment-source/tests -q
|
||||
|
||||
### 调用边界与后续集成要求
|
||||
|
||||
Broker仍是内部模块,未由connector实例化,没有新HTTP接口或后台调度。`owner`参数暂按应用范围内已核验的open_id使用,只能来自后续可信设备/授权事务映射;不得把此内部方法直接暴露给模型、客户端自选用户或无认证HTTP路由。阶段3仍需完成state、绑定代次、领取认证、产品权限配置及公开响应白名单。
|
||||
截至阶段2,Broker仍是内部模块,未由connector实例化,没有新HTTP接口或后台调度。`owner`参数暂按应用范围内已核验的open_id使用,只能来自可信设备/授权事务映射;不得把此内部方法直接暴露给模型、客户端自选用户或无认证HTTP路由。阶段3的接线与边界见下节。
|
||||
|
||||
此阶段不改变旧OAuth向PC交付refresh的行为,也不读取旧PC凭据。部署阶段必须关闭旧刷新并避免双主,不能仅发布此模块就宣称refresh只在ECS。
|
||||
|
||||
@@ -94,3 +94,35 @@ Broker仍是内部模块,未由connector实例化,没有新HTTP接口或后
|
||||
首轮完整回归有一条原有PC测试遇到Windows临时文件replace拒绝访问(WinError 5);该用例单独重跑和最后完整回归均通过,未修改该客户端实现,具体系统原因未确定。warnings仍为uvicorn/websockets旧API弃用提示。
|
||||
|
||||
未进行真实Redis多进程/多节点压测、真实PostgreSQL、Docker/ARM64、现机部署或真实授权/刷新。FakeRedis共享实例测试证明本地协议并发行为,不外推为生产集群验收。
|
||||
|
||||
## 阶段3:OAuth落库与认证领取(2026-11-04)
|
||||
|
||||
接口细节见 [集中凭据协议v2](CREDENTIAL_PROTOCOL_V2.md)。
|
||||
|
||||
### 改造内容
|
||||
|
||||
- `Settings`新增legacy/broker显式模式、服务端密钥文件和产品权限版本集合。默认legacy,不自动改变现有部署;broker缺少密钥/权限或平台OAuth未启用时拒绝启动。生产broker要求PostgreSQL。
|
||||
- 新增`CredentialAPI`:认证状态、发起授权、授权状态查询、access-token领取和新OAuth回调。所有设备接口验证证书/签名、环境/应用/协议版本、method/path、完整请求摘要、时间nonce、当前owner及绑定代次。
|
||||
- 加密存储共享授权state及请求关联;一次性原子认领,固定600秒有效,重复回调不再次换码;其他connector可处理同一持久事务。实际授权用户必须匹配绑定本人,授权完成直接加密保存ECS,不将refresh下发PC。
|
||||
- 授权稳定request_id幂等且不延长有效期;新授权意图使同用户旧waiting/exchanging事务superseded,旧授权提交前重查,避免较早权限意图覆盖较新的请求。数据库设备行写锁用于跨worker串行化创建/取代。
|
||||
- 设备表增加binding_generation,保留原数据与身份;bind/unbind/revoke推进版本。新绑定回执返回版本,已有客户端可通过设备认证status安全同步,不要求重新配对。
|
||||
- Broker增加同步绑定/事务guard:等待锁后、换码提交前和领取返回前核验当前状态;刷新已轮换时先保存最新凭据,再拒绝向已解绑设备发放,避免丢失服务端refresh。
|
||||
- 领取响应是显式字段白名单,只含access token和必要元数据;成功授权与发放写脱敏审计,不含code、state、Token或完整授权URL。
|
||||
- 共用旧设备证明函数抽取到`device_auth.py`,OAuth/通知与旧代理复用,不再要求保留`work_api`路由才能认证。
|
||||
- broker模式不注册旧`/oauth/start`、`claim`、`pending`、`refresh`及`/work/api`,防止同模式双主。新授权卡以事务ID引用服务器链接;文本/通知卡沿用本人发送边界。
|
||||
|
||||
### 兼容与未完成
|
||||
|
||||
legacy模式继续旧凭据协议;新字段/表是增量迁移,不删除旧设备和绑定。旧客户端与broker模式不兼容,阶段5需协调客户端版本、一次新授权和旧本地凭据清理;不能未经准备切换生产配置。
|
||||
|
||||
本次没有更新实际Compose参数/密钥挂载、安装包或服务器;公开接口仅在显式broker配置下注册。数据库绑定版本让新接口拒绝旧设备上下文,但完整连接断开补偿、持久任务/回包关联、旧绑定码失效和后台刷新暂停等仍为阶段4;不能宣称整体解绑闭环已完成。
|
||||
|
||||
事务在exchanging中崩溃时不自动重放code,超期需重新授权;授权scope不足时显式返回permission_update_required,不把刷新当扩权。平台刷新未知、已发Bearer残余有效、客户端最终缓存清理和用户Scope审批边界保持不变。
|
||||
|
||||
### 验证结果
|
||||
|
||||
Windows / Python 3.12.10,平台桩、临时证书/密钥、SQLite及带Lua的FakeRedis。本轮新增v2接口测试38项通过,另增1项真实PostgreSQL事务/绑定迁移用例因未配置连接而跳过。覆盖跨用户/跨应用环境签名、路径/正文篡改、nonce重放、错人授权、state过期/取消/重放、双connector单次换码、数据库重开、授权取代、部分Scope、旧入口关闭、代次失效和刷新中解绑不发Token。
|
||||
|
||||
最后完整回归:**185 passed,3 skipped,15 warnings**(49.77秒)。3个跳过项均需要真实PostgreSQL测试连接;warnings仍为原有uvicorn/websockets弃用提示。文档表格/围栏、relay模块AST及`git diff --check`通过。
|
||||
|
||||
真实PostgreSQL、真实Redis多进程、ARM64镜像、私有化平台及现机业务验收尚未执行;本地ASGI/FakeRedis结果不能作为线上多节点或生产部署结论。
|
||||
|
||||
Reference in New Issue
Block a user