aBridge 以当前系统用户权限执行远程请求。Shell、文件和桌面操作不在隔离沙箱中,也不自动提权;部署者通过设备、Agent 与本机能力明确授予访问范围。
管理账户、Device Key 和 Agent Key 分别用于管理、设备连接和 MCP 调用。每次操作重新检查所有者、设备类型、当前授权、会话、能力和连接代次,返回保留结果前也检查其访问范围。
实例管理员与普通管理账户独立。管理员 Token 只允许创建用户、读取全局用户及设备统计,不能代替账户、Device Key 或 Agent Key。本地账户由受保护的管理员 API 创建,不提供本地公开注册或 CLI 创建用户入口;启用 OIDC 后,外部账户首次通过验证时按 issuer 和 sub 建立独立本地身份。
默认生成的 Token 保存在数据库旁的私有文件(权限 600),也可通过 ABRIDGE_ADMIN_TOKEN 覆盖。启动终端只输出普通地址,--web 在本机浏览器打开带 Token 的管理链接;该链接是管理员凭据,不写入终端或请求日志。Token 位于 URL fragment,前端读取后立即清除,再通过同源 API 兑换独立的 HttpOnly、SameSite=Strict Cookie,HTTPS 下带 Secure。Cookie 有效期 30 天,使用管理员 Token 签名;退出管理员清除浏览器 Cookie,重置 Token 使全部旧签名失效。请求日志与错误不输出 Token,统计响应不返回密码、密钥或操作内容。
Host 与 Origin 校验默认只接受回环地址;反向代理使用显式 --public-origin,需要额外访问范围时用 Host/Origin 白名单追加。管理 API 保持同源,额外 Origin 只用于 MCP;扩展的授权申请、兑换、取消接口与 WebSocket 使用独立的扩展 Origin 校验;批准接口仍要求同源管理账户会话,扩展回调 ID 必须与发起 Origin 一致。
浏览器设备只允许 browser,电脑设备允许 screen、input、shell、files。Agent 连接可选择指定设备并逐设备设置能力,或明确覆盖当前及未来的同账户设备并设置默认能力与逐设备覆盖。有效能力取连接策略、设备授权、会话请求、本机开关及实际就绪状态的交集。管理台的连接预览只面向账户所有者;MCP 不暴露未授权设备及其数量。暂停持久保存,重连或重新绑定不自动解除暂停;远程 MCP 不提供恢复本机暂停或授予系统权限的入口。
修改连接策略不更换 Agent Key;轮换密钥使旧 Key 失效,撤销连接使其全部凭据失效。收紧策略时结束不再满足权限要求的会话并请求取消在途操作,后续读取保留结果也重新核对策略。编辑、轮换和撤销不自动扩大其他连接的范围。
Agent 连接默认持续有效直到撤销,可另设到期时间。控制会话闲置期限为 300 秒,获准请求和在途操作续租,设置连接到期时间时不越过该期限。停止、取消和关闭不能回滚已发生的副作用,结果未知时不自动重放。会话按各自持有的资源清理;浏览器清理失败保留记录并阻止新任务,直到清理成功。
数据库保存身份、授权与操作元信息,不保存命令、输入、文件正文或截图。返回内容在 Server 内存中短期保留,可能包含敏感信息;日志与公开测试不应记录这些内容或凭据。SQLite 文件和备份需要限制访问,开发数据库须匹配当前 schema,不提供历史数据迁移。
Swift App 管理系统权限和本机接管监视,设备运行时在其 Node 子进程中执行。官方 Cua SDK 仅在桌面运行时按需加载,并核对同进程模式;Server 启动不需要加载原生驱动。
桌面观察与动作绑定所选窗口;像素输入还核对前台目标,目标变化时拒绝。只有显式整屏观察才返回桌面图像。桌面引用最长有效 120 秒,动作后失效;接收截图不需要额外授予 Shell 或文件能力。
macOS 屏幕录制和辅助功能权限与实际安装的 App 身份关联。原生代码或签名变化后,系统可能要求重新授权。Node CLI 的终端诊断、驱动加载或构建成功不能证明该 App 的 TCC 授权与实际输入可用。
设备凭据保存在当前用户的私有目录,不读取 Keychain。目录权限为 700,凭据文件为 600;读取检查所有者、文件类型、权限和服务地址,保存采用原子替换。这不是加密保险库,同一系统用户下的其他进程仍可能读取。安装器使用稳定的私有运行时目录,不从 npm 临时缓存启动已安装 App。
每个扩展安装实例注册为独立设备,直接连接 Server。首次绑定在管理台浏览器页面登录并确认,扩展仅通过 PKCE 兑换并保存 Device Key,不再收集管理账户密码;WebSocket 首条消息认证,长期凭据不进入 URL。扩展 Origin 不替代设备认证。
任务在所选 Profile 中创建和操作自有标签页,不接管已有个人页面。Profile 由会话的设备身份确定,不接受本机配置目录,不在断连或撤销后自动换账号。任务结束清理自有标签,保留设备绑定与个人页面。
扩展内部使用固定 Chrome debugger 调用。远程仅提供导航、观察、点击和填充,不暴露任意脚本、原始 CDP、受保护输入值或 Cookie 导出。浏览器引用最长有效 10 秒,动作与导航后失效。点击使用合成 DOM 事件,填充替换值并触发 input/change;站点可以拒绝,不静默改为其他输入方式。
浏览器退出、设备睡眠和网络中断时无法保证在线。自动重连保留原身份与暂停状态;撤销后不自动注册。网站会话、密码管理器、验证码和多因素验证仍由浏览器及站点控制,设备绑定不等于永久网站登录。
跨机器连接推荐 HTTPS/WSS 或 SSH 隧道。设备客户端可对具体公网 HTTP Origin 显式确认;OIDC 的公网 HTTP 需部署管理员另行开启 ABRIDGE_ALLOW_INSECURE_HTTP=true,该模式不加密传输,但保持身份和访问控制校验。当前每个数据库只支持一个 Server 实例,内存路由与结果缓存不支持多 worker 或横向部署。Node 内置 SQLite 的稳定性和同步调用限制见 架构。
第三方组件与许可见 第三方说明。发现安全问题时先停止受影响设备或撤销相应授权,通过仓库平台已启用的私密报告渠道提交复现;未配置私密渠道时联系维护者。报告不应包含凭据、个人截图或敏感文件内容。本项目尚未指定公开漏洞邮箱或响应时限。