Skip to content

[Epic] Browser Runtime 与 CDP / Browser runtime and CDP #33

Closed
3 of 3 issues completed
Closed

Description

@Qiyuanqiii

目标 / Goal

在不降低现有安全边界的前提下,完成受限 Safe Web 与高风险 Full CDP 两条明确分离的浏览器能力路线。

Deliver two explicitly separated browser lanes without weakening current safeguards: restricted Safe Web and high-risk Full CDP.

当前基线 / Current baseline

  • 浏览器配置、可执行文件识别、独立 Profile、Scope 和启动计划已存在。
  • 受限 CDP 与完整 CDP 已有权限合同和高风险标识。
  • 浏览器产品入口仍关闭;Windows WFP 生产探针由 bug(browser): Windows WFP 受限浏览器生产探针尚未通过验收 #1 跟踪。
  • Full CDP 目前只有权限上限和 Disabled/Fake 合同,没有产品级真实执行入口。

子任务范围 / Child scope

完成定义 / Definition of done

  • Safe Web 只能访问精确允许的 loopback/目标 Scope,错误端口、错误地址、非 loopback 与 IPv6 绕过均被拒绝。
  • Full CDP 与 Safe Web 使用不同权限、不同启动确认和不同 UI 风险提示。
  • 每个 Run 使用独立、一次性 Profile,结束后可验证清理。
  • 进程、Job、网络规则、CDP 会话和 Profile 生命周期均可追溯。
  • readiness 不满足时入口禁用并给出可操作原因。

安全边界 / Security boundaries

  • 禁止用 --disable-web-security 等参数替代网络隔离。
  • 禁止连接用户日常 Chrome/Edge Profile。
  • Full CDP 必须标记“高度敏感权限”,默认关闭且不可跨重启继承授权。

涉及目录 / Affected directories

  • internal/browserruntime/
  • internal/application/
  • internal/domain/
  • internal/store/
  • internal/events/
  • internal/policy/
  • internal/approval/
  • internal/httpapi/
  • cmd/cyberagent/
  • cmd/cyberagent-desktop/
  • web/src/
  • docs/adr/

Activity

  1. added
    roadmapProduct roadmap and cross-cutting delivery tracking
    epicParent issue grouping related deliverables
    browserBrowser runtime and CDP capabilities
    securitySecurity boundary or high-risk capability
    on Aug 13, 2026
  2. Qiyuanqiii commented on Aug 16, 2026

    @Qiyuanqiii
    MemberAuthor

    关闭说明

    本 Epic 的三个子任务全部完成并合并,5 条完成定义全部满足。

    子任务与 PR

    子任务 PR 状态
    #1 Windows WFP 受限浏览器生产探针 #69 ✅ merged(11 项生产验收全绿,MSA 令牌 TOKEN_ALL_ACCESS 修复)
    #41 受限 Safe Web 操作者入口与 readiness 收据 #71 ✅ merged(readiness 收据 + store 持久化 + CLI/HTTP/Desktop + Activity + 启动→观察→关闭编排,Closes #41)
    #42 Full CDP 调试通道与高度敏感权限隔离 #77 ✅ merged(独立授权链 + 启动协议 + 调试会话 + 元数据 only 脱敏 + 两条权限链不串联回归,Closes #42)

    完成定义对照

    安全边界

    • 两条权限链互不串联(Safe Web 证据不能授权 Full CDP,maximum-access debug 权限不能进入受限运行时)。
    • Full CDP 的 InstructionAuthorized 恒为 false(网页指令永不提升权限),capability 有 TTL + Run/Workspace/进程绑定、重启即失效。
    • 会话结果元数据 only(无 header/cookie 值/body/页面内容)。
    • 不默认关闭浏览器安全机制(RelaxOriginPolicy/AllowInsecureContent/IgnoreCertificateErrors 恒拒绝)。
  3. Qiyuanqiii commented on Aug 16, 2026

    @Qiyuanqiii
    MemberAuthor

    完成定义全部满足,三个子任务(#1/#41/#42)均已合并,关闭本 Epic。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    browserBrowser runtime and CDP capabilitiesepicParent issue grouping related deliverablesroadmapProduct roadmap and cross-cutting delivery trackingsecuritySecurity boundary or high-risk capability高难度

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions