[umbrella][security] 授权全生命周期缺口地图 — 包开发 → 生产上线(P0–P3)

[os-zhuang]

概述

平台授权在整个生命周期上的全部已知缺口的总追踪 issue —— 覆盖包开发、分发安装、环境组合、运行时强制、生产/企业加固五个阶段。源自 #2557 / ADR-0086(PR #2559)工作中同步完成的全生命周期评估。

核心结论: 运行时强制层已相当扎实(约 18 个原语已强制,由 ADR-0056 D10 一致性矩阵在 CI 中守护)。缺口集中在两头——包开发端与生产/企业端。

✅ 状态更新(2026-07-04 收尾):所有 P0 关闭,P1 全部落地,P2 里三项已完成。上线所需的授权 + 认证能力已就绪。

• P0 全部合并:requireAuth 翻转 + [P0][security] Permission lifecycle ops ungated (allowTransfer/allowRestore/allowPurge) #1883 门(feat(security)!: secure-by-default requireAuth flip + RBAC gates for transfer/restore/purge (#2561 P0) #2562)、ADR-0086 objectui(objectui#2222)。
• P1 全部落地:ADR-0086 P1 framework(feat(security): permission-set package provenance + bootstrapDeclaredPermissions (ADR-0086 P1) #2566)、授权架构综述文档(docs(concepts): Authorization Architecture overview (#2561 P1) #2569)、企业认证 P1(评估发现主体早已实现,补 last-login 缺口 feat(auth): last-login audit fields + ADR-0069 status (P1 completion) #2570,ADR-0069→Accepted)。
• P2 部分完成:权限解析可观测性(fix(security): surface swallowed permission-set resolution failures (#2565) #2568 ✅)、多节点共享限流 store(feat(auth): shared cross-node rate-limit + session store via cache service (ADR-0069 D2) #2572 ✅)。
• 剩余为 P2/P3 纵深项,不阻断上线。

📌 优先级重排(2026-07-04,面向本次生产上线)
本次上线不评估 AI 相关能力:ADR-0086 objectui 升 P0;强制 agent visibility(#1901)降 P3(唯一 AI 专属项);其余不变。

---

P0 — 上线阻断(全部关闭 ✅)

• 给 transfer / restore / purge 补 RBAC 门 —— 已合并(feat(security)!: secure-by-default requireAuth flip + RBAC gates for transfer/restore/purge (#2561 P0) #2562):三操作预映射到权限位 + modifyAllRecords 旁路;审查中补齐行级防护(RLS 预镜像 / controlled-by-parent 覆盖破坏性操作类)。→ [P0][security] Permission lifecycle ops ungated (allowTransfer/allowRestore/allowPurge) #1883(开启追踪 M2 操作)
• ADR-0086 P0(objectui) —— 已合并(fix(studio): scope Access matrix by { packageId } + slice-merge on save (ADR-0086 P0) objectui#2222):Access 矩阵按 { packageId } 限定作用域 + 保存切片合并;关闭「84 对象泄漏」+ 跨包数据丢失;带中途迁移守卫,对齐 framework feat(security): permission-set package provenance + bootstrapDeclaredPermissions (ADR-0086 P1) #2566 的记录级 package_id。
• requireAuth 安全默认翻转 —— 已合并(feat(security)!: secure-by-default requireAuth flip + RBAC gates for transfer/restore/purge (#2561 P0) #2562):spec default(true) + rest ?? true,显式退出 boot warn;一致性矩阵 requireAuth-default-flip → enforced;浏览器实测 401/200/201 闭环;ObjectStackDefinitionSchema.api 让 defineStack 层退出开关生效。→ ADR-0056 D2

P1 — 高优先级(生产必需,全部落地 ✅)

• ADR-0086 P1(framework) —— 已合并(feat(security): permission-set package provenance + bootstrapDeclaredPermissions (ADR-0086 P1) #2566):PermissionSetSchema.packageId + 每记录 managedBy + sys_permission_set.package_id/managed_by 列;bootstrapDeclaredPermissions 播种 stack.permissions(幂等/升级感知/不沾染环境行);一致性矩阵行 declarative-permission-seeding + dogfood 证明;关闭 ADR-0078 惰性违规。
• 授权架构综述文档 —— 已合并(docs(concepts): Authorization Architecture overview (#2561 P1) #2569):content/docs/concepts/authorization.mdx,九份 ADR 缝成单篇(六道强制门链 + 组合语义 + 包来源 + 生命周期五阶段 + CI 治理)。
• 企业认证 P1 —— 密码策略(复杂度/过期/历史/HIBP)、账号锁定、强制 MFA + 宽限期。→ ADR-0069 D1–D3。评估结论:P1 主体早已实现并合并;本轮补上唯一 D7 缺口 last-login 审计字段(feat(auth): last-login audit fields + ADR-0069 status (P1 completion) #2570 ✅) + ADR-0069 状态→Accepted;真实 app 实测复杂度拒弱密码、锁定后 403、last_login 落库。

P2 — 模型完备性

• 两道门分离 —— 包 Access 面板只编辑本包切片、走草稿/发布;环境管理员门保留跨包矩阵 + 分配 UI。→ ADR-0086 P2 / D6–D7
• 权限集组(groups)+ 减法 muting —— 捆绑 + 显式 deny 层。muting 落地时必须覆盖字段授权(FLS 并集同根,ADR-0066 ⑧)。 → ADR-0066 ⑦、ADR-0086 P2
• 按操作粒度的 requiredPermissions —— 对象级 { read, create, update, delete } 映射。→ ADR-0066 ⑤
• 能力注册表(字符串 → 记录) —— sys_permission 能力定义 + authoring/publish-gate lint(ADR-0066 ⑨)。→ ADR-0066 D1
• secure-by-default 姿态推广 —— 系统/控制面/敏感对象默认 access.default:'private'。→ ADR-0066 D2/④
• 企业认证 P2 —— 会话生命周期/空闲/并发控制、IP 白名单、限流调优。→ ADR-0069 D4–D6。评估:会话控制 + 全局 IP 白名单 + 多节点共享限流 store(feat(auth): shared cross-node rate-limit + session store via cache service (ADR-0069 D2) #2572 ✅)已实现;剩余缺口 = per-org/per-user allowed_ip_ranges 记录级字段([security][P2] Per-org / per-user IP allow-list (record-level allowed_ip_ranges) — ADR-0069 D5 #2571,带「收紧 vs 替换」设计决策)。
• 权限解析可观测性 —— 已合并(fix(security): surface swallowed permission-set resolution failures (#2565) #2568):resolvePermissionSets 吞异常改为 fail-closed + warn 日志。→ [security][observability] resolvePermissionSets swallows dbLoader failures silently — custom permission sets vanish with no log #2565 ✅

P3 — 企业 / 合规纵深

• 强制 agent visibility —— AI 专属项,本次不评估、不阻断上线(2026-07-04 由 P1 下移)。→ [P1][security] Enforce agent visibility (organization/private) — needs tenant/owner in request context #1901
• 委派管理(delegated admin) —— → ADR-0066 [WIP] Create a new release version #9
• 合规子系统 —— 字段加密/脱敏/合规配置,当前 [EXPERIMENTAL];需设计+强制或移除。→ ADR-0056 D8
• SSO 扩展 —— OIDC 信任列表 UI;SAML 评估;SCIM 单独立 ADR。→ ADR-0069 P3
• 能力进表达式面 —— CEL current_user 能力检查。→ ADR-0066 ⑥、ADR-0068 EvalUser

---

依据来源 / 关联

• CI 守护的已落地状态:packages/dogfood/test/authz-conformance.matrix.ts(ADR-0056 D10)
• ADR:0049、0054、0056、0057、0066(含 2026-07-04 补记 ⑧⑨)、0068、0069(状态→Accepted)、0078、0086
• Issue:[P0][security] Permission lifecycle ops ungated (allowTransfer/allowRestore/allowPurge) #1883、[P1][security] Enforce agent visibility (organization/private) — needs tenant/owner in request context #1901(P3)、Design: authorization model — metadata vs environment-config boundary + cross-package composition #2557、[security][observability] resolvePermissionSets swallows dbLoader failures silently — custom permission sets vanish with no log #2565(fix(security): surface swallowed permission-set resolution failures (#2565) #2568 ✅)、[security] Anonymous posture inconsistent across surfaces: /meta, dispatcher /graphql, and raw hono /data bypass enforceAuth #2567(anonymous 门跨面一致性,pre-existing)、[security][P2] Per-org / per-user IP allow-list (record-level allowed_ip_ranges) — ADR-0069 D5 #2571(per-org IP,P2 deferred)、objectui#2221 / fix(objectql): findData 返回真实 total/hasMore (#2212) #2222(P0 ✅)
• 已合并 PR(本轮 6 个):feat(security)!: secure-by-default requireAuth flip + RBAC gates for transfer/restore/purge (#2561 P0) #2562(P0×2)· feat(security): permission-set package provenance + bootstrapDeclaredPermissions (ADR-0086 P1) #2566(ADR-0086 P1)· fix(security): surface swallowed permission-set resolution failures (#2565) #2568(可观测性 [security][observability] resolvePermissionSets swallows dbLoader failures silently — custom permission sets vanish with no log #2565)· docs(concepts): Authorization Architecture overview (#2561 P1) #2569(综述文档)· feat(auth): last-login audit fields + ADR-0069 status (P1 completion) #2570(企业认证 last-login + ADR-0069 Accepted)· feat(auth): shared cross-node rate-limit + session store via cache service (ADR-0069 D2) #2572(多节点共享限流 store)· objectui#2222(ADR-0086 P0)