OpenAlice 红队工具包(safe/)深度解析:面向 AI 攻击者的 Agent-First 安全测试体系
OpenAlice 红队工具包(safe/)深度解析:面向 AI 攻击者的 Agent-First 安全测试体系
本文讲解 OpenAlice 仓库中
safe/目录的定位、结构与实战方法:它是一套以 AI 红队 Agent 为主要操作者的内网渗透测试套件(Red Team Toolkit),包含攻击剧本(playbooks)、目标情报(knowledge)、可复用攻击工具(tools)、验证框架(harness)与历史发现(findings)。读者将掌握如何启动一次 AI 驱动的安全演练、如何阅读与扩展攻击剧本、如何基于威胁模型与测试范围界定攻击边界、如何提交结构化安全发现,并理解该套件与src/webui实际认证/CSRF/WebSocket 防护实现之间的对应关系。
一、定位:这不是部署指南,而是一套"先枚举攻击、再补防御"的测试体系
OpenAlice 是一个自托管的 AI 交易代理(涵盖股票、加密、大宗商品、外汇与宏观研究,从研究到建仓、持仓管理直至退出的全流程)。safe/ 目录是该项目内部渗透测试套件,其 README 开宗明义地强调:"NOT a deployment guide"(不是部署指南)。想了解如何托管 OpenAlice,应阅读仓库根目录的 README.md;而 safe/ 只服务于一个目的——在真实攻击者之前,用与真实攻击者同级别的对手去测试这个实例。
1.1 为什么存在(Why this exists)
现代安全测试颠倒了正常的工程流程:不是"先构建防御、再写测试",而是先枚举攻击,再把防御构建当作一次 TDD 练习来关闭这些攻击面。
这背后有一个 2026 年特有的判断:OpenAlice 实例将会被 AI Agent 攻击,而不仅仅是脚本小子扫描器。因此防御必须针对同级别的对手构建——一个拥有代码访问权限、有创造本能、愿意把弱点链式组合的 AI Agent。项目的验证逻辑是:
如果我们自己的红队 Agent 都无法攻破这个实例,那么我们至少为真实攻击者设置了一个合理的安全底线(floor)。
1.2 Agent-First 设计:操作者是一个 AI,不是人类脚本
safe/ 天生为 Agent 优先(agent-first by design)。主要"操作者"是一个阅读 safe/AGENT_BRIEF.md 的 AI 红队 Agent,而不是运行 shell 脚本的人类。人类当然也可以使用它(一切内容都是 Markdown + curl),但剧本结构预设了一个具有探索能力的 AI 会将每类攻击扩展到种子用例(seed cases)之外。
1.3 它不是什么(What this is NOT)
为准确理解边界,原文档明确列出了四类"不是":
- ❌ 不是部署指南——不要用它学习如何托管 OpenAlice;
- ❌ 不是合规审计——没有 SOC2 / PCI / GDPR 检查清单,它只针对 OpenAlice 自己的威胁模型;
- ❌ 不是模糊测试器——不做随机字节尝试,而是做定向场景;
- ❌ 不是穷尽的——真实对手会发现我们没想象到的东西。这是"地板"(floor),不是"天花板"(ceiling)。
二、目录布局:五类构件 + 攻击剧本扩展计划
safe/ 根目录 README 给出了完整的目录树,其设计是"每个目录一种职责":
safe/
README.md ← 你正在读的入口
AGENT_BRIEF.md ← 红队 Agent 的入口点
THREAT_MODEL.md ← 我们防御谁、他们想要什么
scope.md ← 测试的边界(什么在范围内/范围外)
knowledge/ ← 目标情报
architecture.md
endpoints.md
config-files.md
data-flows.md ← (TBD post-auth-impl)
playbooks/ ← 攻击类别(Agent 从这里开始)
01-auth-bypass.md
02-csrf-cross-origin.md
03-localhost-spoofing.md
04-public-misconfig.md (TBD)
05-credential-leakage.md (TBD)
06-session-lifecycle.md (TBD)
07-websocket-auth.md (TBD)
08-uta-direct-bypass.md (TBD)
09-credential-storage.md (TBD)
10-network-exposure.md (TBD)
11-xss-and-headers.md (TBD)
12-brute-force-rate-limit.md (TBD)
tools/ ← 攻击构建块
README.md
harness/ ← 验证 + 报告
runner.ts ← 最小脚手架 runner
findings/ ← 已发现的弱点(时间快照)
README.md
2026-05-23-pre-implementation.md
从当前仓库实际内容看,已落地的构件包括:AGENT_BRIEF.md、THREAT_MODEL.md、scope.md 三个顶层文件;knowledge/ 下的三个情报文件(architecture.md、endpoints.md、config-files.md);playbooks/ 下的四个已完成剧本(01-auth-bypass、02-csrf-cross-origin、03-localhost-spoofing、07-websocket-auth);harness/runner.ts 脚手架;以及 findings/ 下的预实现基线发现。剧本 04–12 属于规划中的攻击类别,暂未填充种子用例。
这套布局的核心思想是分层作战:知识层回答"目标是什么样",剧本层回答"怎么打",工具层提供"攻击构件",验证框架回答"打没打穿",发现层沉淀"弱点 + 修复历史"。
三、红队 Agent 任务简报(AGENT_BRIEF.md):从任务到心态的完整规范
safe/AGENT_BRIEF.md 是红队 Agent 的"入职文件",它定义了这个 AI 攻击者的目标、工具、方法、范围、输出与心态。
3.1 目标清单
简报定义的目标是:绕过认证、访问受保护端点、泄露凭据、或攻破交易工作区。它把目标实例的运行拓扑列成了一张表,这对任何安全测试者都是第一手的资产地图:
| 进程 | URL | 应当被谁访问 |
|---|---|---|
| Alice(Web + Agent 运行时) | http://localhost:47331 |
用户(认证后) |
| UTA 服务(券商载体) | http://127.0.0.1:47333 |
仅 Alice 进程 |
| MCP 服务器(工具注册表) | http://localhost:47332/mcp |
仅工作区 CLI |
| Vite 开发 UI | http://localhost:5173 |
浏览器;代理 API 到 Alice |
| 文件系统状态 | 仓库下的 data/ 目录 |
用户的主机进程 |
同时提示:如果这些默认端口被占用,端口可能偏移——启动时读取 Guardian 的日志行确认实际端口。
3.2 工具集与方法论
Agent 拥有 Bash(curl、脚本、文件检查)、Read/Glob/Grep(静态分析)、Write/Edit(在 safe/tools/ 编写攻击脚本)、WebFetch(以"全新浏览器"视角验证端点),以及可选的 Playwright MCP 工具(用于需要真实浏览器的 CSRF 与点击劫持 POC)。没有独立机器、网络位置或带外攻击向量——它的视角是"与操作者同机、有代码访问权限、想看能提取或做什么"。
方法论是一个六步循环:
- 先读
knowledge/——理解架构、端点与配置触点,"你无法攻击你不理解的东西"; - 打开
playbooks/——每个NN-*.md是一类攻击,种子用例是起点而非穷尽,运行每个用例、观察响应、多想一步变体; - 创造性迭代——种子用例该返回 401 却返回 200 就是发现;返回 401 就尝试变异请求(改头、换方法、试同一家族的其它 URL),现代攻击者会链式组合弱点;
- 读源码——认证在哪强制?存在哪些中间件?进程边界发生了什么?"阅读往往比盲探更有效";
- 提交发现——按
findings/README.md模板,一个弱点一条发现,强证据 > 数量; - 跟踪进度——剧本用 ✅(用例耗尽)、⬜(发现新变体待补充)、❌(发现弱点)标记。
3.3 输出与心态规范
会话结束后操作者期望看到:findings/ 中按 YYYY-MM-DD-<title>.md 提交的发现(一个弱点一条)、更新的剧本状态(含超出种子用例的尝试记录)、以及一段简短总结("我跑了 N 个剧本,发现 M 个已确认弱点,已提交 findings/,建议优先处理 X")。
心态五条:怀疑(假定开发者犯了显而易见的错误,直到被证明相反)、分层(每个剧本是一层,组合层,如 CSRF + localhost-trust 绕过 = 真实攻击链)、诚实(不要把需要不现实前提的东西报成 finding,如"如果攻击者拥有 root,他们就能读 auth.json"——那不是 finding,那是在定义 root)、可复现(每个 finding 都应有一条从干净状态演示它的 curl 命令或脚本)、建设性(每个 finding 都应附带修复提示)。
四、威胁模型(THREAT_MODEL.md):防御谁、不防御谁、攻击者想要什么
safe/THREAT_MODEL.md 回答了安全工作的根本问题,并给出了 OpenAlice 专属的分层防御计划。
4.1 五类防御对象
- 互联网扫描机器人:扫描公网 IP 的已知服务端口、尝试默认凭据、利用已知 CVE。覆盖度高——绑定默认仅限 localhost;公网模式拒绝无认证启动;管理员令牌是随机生成而非默认值。
- 有代码知识的定向攻击者(主要对手):知道 OpenAlice 开源、读过本仓库、知道端点路径/认证机制/文件布局。防御必须对代码感知型对手稳健,而不是靠隐晦保安全(security through obscurity)。
- 网络位置攻击者(HTTPS 配置错误时):TLS 配置错误时的中间人、会话 Cookie 嗅探、重放攻击。覆盖度中等——公网部署强制位于 TLS 终结反向代理(Caddy、nginx、Cloudflare Tunnel)之后,仅当配置了显式可信代理 IP 时才信任
X-Forwarded-Proto,Cookie 为Secure+HttpOnly+SameSite=Lax。 - 客户端设备沦陷(XSS / 浏览器供应链):能读 DOM 但不能读 HttpOnly Cookie,能以用户 Cookie 发起请求。依赖 CSP、agent 渲染内容的谨慎净化与 CSRF 防御限制爆炸半径。
- AI 红队 Agent(我们自己的主要对手):程序化探索、代码阅读、场景链式组合、创造性变体生成,比人类红队更快更彻底。这就是我们测试所依据的标准——如果专用 AI Agent(拥有完整源码访问权)都无法攻破运行中的实例,安全底线就是合理的。
4.2 明确不防御的对象
文档以"游戏结束"定义了排除项:主机 root(能读 data/config/auth.json、杀进程、改代码);被攻陷的操作者(内鬼);对密码学原语的量子攻击(假设 argon2id、ed25519、AES-GCM 成立);硬件侧信道(argon2 验证时序、跨 VM 缓存攻击、电磁泄漏);供应链沦陷(恶意 npm 包落入依赖属于另一类问题,单独工作流:锁文件审计、签名、SBOM 追踪);社会工程(诱骗操作者点链接/粘命令);拒绝服务(应用层对认证端点的限流在范围内,但完整 DDoS 抗性不在);多租户隔离(OpenAlice 设计上单用户,只有一个"admin",不存在"用户 A 防用户 B",多租户到来时本节将重写)。
4.3 攻击者目标排序(防御优先级随之而定)
- 直接访问券商 → 执行交易、提取资金(危害最大)
- 读取交易历史/持仓 → 竞争情报、隐私损害
- 修改交易配置 → 静默改变 agent 行为,通过自定义券商/护栏植入后门
- 窃取 AI 提供方凭据 → 白嫖操作者的 OpenAI/Claude key
- 持久立足点 → 写入工作区目录、运行 agent CLI 命令、最终升级到主机 root
- 读取工作区用户代码 → 外泄操作者项目
- 把 Alice 当代理 → 隐藏其它攻击来源
防御优先级遵循:券商隔离 > 配置完整性 > 凭据存储 > 防持久化。
4.4 规划中的五层防御
- L1 Origin / Transport:绑定 / 代理 / 网络限制
- L2 Authentication:admin 令牌 + 会话 Cookie
- L3 Authorization:Alice 能向 UTA 请求什么的限制(部分,v2 完整)
- L4 Carrier Isolation:UTA 部署到独立设备(v2+)
- L5 Pre-execution ceremony:载波侧逐笔交易审批(v2+)
该工具包今天测试 L1+L2(因为正在构建的就是它们);L3/L4/L5 上线后由新剧本覆盖。威胁模型文档以带日期的版本化表格演进(2026-05-23 为初始威胁模型,认证实现之前)。
五、测试范围(scope.md):允许做什么、绝对禁止做什么
safe/scope.md 为红队 Agent(或人类渗透测试者)划定了法律边界。
5.1 测试目标与允许动作
目标被限定为操作者本机运行的 dev 实例(pnpm dev 启动 Guardian + UTA + Alice + Vite,默认绑定 localhost;操作者测试公网模式场景时可改绑 0.0.0.0)。除非操作者显式指定,绝不测试非 dev 实例。允许动作的判定表核心规则包括:
- ✅ 对
localhost:47331/localhost:47333使用 curl(主要攻击向量)、读本仓库源码(静态分析公平竞赛)、在safe/tools/写脚本、在safe/findings/提交发现、修改safe/自身; - ❌ 修改
safe/之外的源码(用 findings 建议修复,不要自己修);大规模爆破认证端点(只允许单次"限流是否存在"测试);向真实券商账户下单(仅模拟器);诱导主机 OS/内核崩溃;ARP/DNS 等网络层攻击; - ⚠️ 运行
pnpm dev/重启服务(若操作者留下可恢复状态;不要在有在途券商连接时杀进程);写/改data/config/*.json模拟弱化状态(先备份后恢复)。
5.2 账户类型:什么是安全的玩物
data/config/accounts.json 控制加载哪些券商。判定规则:
| Broker 类型 | 可上手? | 原因 |
|---|---|---|
mock(MockBroker) |
✅ 是 | 内存模拟器,无真实副作用 |
alpaca-paper |
⚠️ 谨慎 | 纸面账户无真实资金,但限流/API key 是真实的 |
bybit-demo / okx-test |
⚠️ 谨慎 | 同 alpaca-paper |
alpaca-live / bybit-main / 任何 live |
❌ 绝对不行 | 真实资金,绝不从 safe/ 触碰 |
ibkr-paper |
⚠️ 谨慎 | TWS 会话有状态,可能干扰操作者 |
不确定时查看 data/config/accounts.json 中 presetConfig 的 mode: "live" vs mode: "paper"/mode: "demo"。
5.3 破坏性测试纪律与收尾清单
默认是非破坏性测试(观察响应、提交发现、不改变状态);破坏性测试(轮换 admin 令牌、删除 data/config/sessions.json、修改 accounts.json)需要操作者确认,且必须:先备份文件、在 finding 中记录改动、会话结束时恢复。每轮红队会话后执行清理清单:恢复所有 data/config/*.json、无遗留测试会话、无遗留 data/control/restart-uta.flag、无僵留进程、findings 已归档、每个剧本状态已更新。
升级机制:若发现严重问题(券商资金有风险、秘密可被明文外泄、主机完全 RCE),立即停止进一步探测——发现本身已足够,按 Critical 归档,并在最终总结中注明操作者应在任何公开展示前审阅。Critical 发现必须在推送到 master 或打标签发布之前落地。
六、目标情报库(knowledge/):进攻前的地图
safe/knowledge/architecture.md、safe/knowledge/endpoints.md、safe/knowledge/config-files.md 三个文件为 Agent 提供了"你不理解就无法攻击"的目标知识。
6.1 进程拓扑与信任边界(architecture.md)
运行时是三个长驻进程:Guardian 主管(scripts/guardian/dev.ts 或 prod.mjs,负责孵化与监管)→ UTA 进程(services/uta/src/main.ts,绑定 127.0.0.1:47333,持有券商连接、Trading-as-Git 状态、FX、快照)→ Alice 进程(src/main.ts,按配置绑定,默认 localhost:47331,持有 agent 运行时、UI 服务器、UTA 的 BFF、所有用户面);dev 模式还有 Vite dev 服务器(0.0.0.0:5173,代理 /api/* 到 Alice)。生产(Docker)无 Vite,Alice 直接服务 ui/dist/ 预构建 UI。
信任边界表揭示了攻击焦点:Browser → Alice(:47331)是我们在意的认证边界,因为它是绑定非 localhost 时唯一暴露的边。Alice → UTA 与 Alice → MCP 今天是同主机同用户的完全信任;任何东西 → data/ 目录也是完全信任(仅主机文件系统权限)。
6.2 端点清单与攻击优先级(endpoints.md)
端点清单按挂载前缀组织,源真相是 src/webui/plugin.ts 及其导入的路由文件。认证列反映的是意图——实现之后,除标记为公开的之外,每个路由都应要求有效会话。公开面(实现后无需认证)只有 /api/auth/login、/api/auth/logout、/api/version、/login、/favicon.ico、/assets/*;其余全部属于认证面,包括:
- Chat & 会话:
/api/chat/*、/api/channels/*、/api/media/:id - 配置:
/api/config(读合并配置)、/api/config/*(变更 AI provider/connector)、/api/trading/config(UTA 账户列表)、/api/trading/config/uta(CRUD)、/api/trading/config/test-connection、/api/trading/config/broker-presets - 交易域(BFF 代理 → UTA):
/api/trading/uta、equity、contracts/search、fx-rates、各uta/:id/*(account、positions、orders、market-clock、quote、wallet/log、wallet/show/:hash、wallet/status、wallet/commit、wallet/push、wallet/reject、stage-place-order 等)、snapshots 系列。⚠️POST /api/trading/uta/:id/wallet/push是最高价值攻击目标——它向券商发送真实订单。 - 模拟器(BFF → UTA):
/api/simulator/utas、uta/:id/state、mark-price、tick-price、orders/:orderId/fill|cancel、external-deposit|withdraw|trade - 其它工作区与基础设施:
/api/workspaces/*(PTY、MCP)、/api/events/*、/api/topology、/api/cron/*、/api/heartbeat/*、/api/dev/*、/api/tools、/api/agent-status/*、/api/news/*、/api/market/*、/api/notifications、/api/inbox/*、/api/market-data/* - MCP:
/mcp(全局,完整工具目录)、/mcp/:wsId(按工作区)
UTA 侧挂载 /api/trading/*、/api/simulator/* 与 /__uta/health。健康/探测端点(/api/version、/__uta/health)故意免认证(更新检查与 Guardian 轮询用),仅泄露版本串与账户数,无秘密。
文档明确点出"这里没有的":没有 /admin、/console、/debug 魔法端点;没有原始文件系统浏览器;没有 SQL(无数据库);没有会写入工作区目录之外的文件上传端点。攻击优先级排序:①wallet/push(真实券商副作用)→ ②test-connection(投喂券商凭据)→ ③/api/config/*(修改全局配置含 AI provider key)→ ④/api/workspaces/*(文件系统写 + PTY 孵化)→ ⑤/api/auth/login(认证面本身)→ ⑥wallet/reject(破坏挂起状态)→ ⑦其余。
6.3 配置与文件系统状态(config-files.md)
一切持久化都是 data/ 下的 JSON 文件。认证落地后出现的关键路径:data/config/auth.json(admin 令牌的哈希 + 元数据,Critical——令牌恢复/重放)、data/config/sessions.json(活跃会话列表,High——会话劫持面)、data/control/restart-uta.flag(触发 UTA 重启的时间戳,Medium——重复 touch 可 DoS UTA)。
当前已存在的敏感文件(认证前):data/config/accounts.json(券商 UTA 配置含 API key,加密密封:AES-256-GCM 信封,密钥在 <userDataHome>/sealing.key,位于 data/ 之外——Critical,需要文件 + 密钥,密钥被盗 = 券商直接被偷)、data/config/ai-provider-manager.json(AI provider key,High)、data/config/connectors.json(Telegram bot token + 允许的 chat ID,High)、data/config/cron/jobs.json(Medium——静默代码执行路径)、data/trading/<utaId>/commit.json(High——暴露交易策略)、snapshots(Medium——竞争情报)、data/workspaces/<wsId>/(Variable——取决于用户内容)。
文件权限:auth.json、accounts.json、sealing.key 以 600(仅属主)写入,对忽略 writeFile mode 的平台尽力重试 chmod;其余配置按进程 umask(通常 644)写入。文档还给出了 sanitized 后的 accounts.json 逻辑形态(presetId、enabled、guards、presetConfig.mode/apiKey/apiSecret),并强调静止状态是密封信封:{"$sealed":1,"alg":"aes-256-gcm","iv":…,"tag":…,"data":…}——单独读取文件不再能得到券商凭据,文件 + 密钥才可以。
路径解析(攻击者相关):数据根目录由 src/core/paths.ts 解析——默认(dev、pnpm start、Electron)为 ~/.openalice/data/(跨 checkout 与桌面应用共享的全局存储);可被 OPENALICE_HOME 环境变量覆盖(Docker 设为 /data;OPENALICE_HOME="$PWD" 固定为 checkout 本地存储)。攻击者若能诱导 OpenAlice 读写数据根之外路径就是严重原语,需要审计的函数:paths.ts 的 dataPath()/defaultPath()/uiBundlePath()、src/webui/routes/media.ts(附件 ID——路径注入风险?)、src/webui/routes/inbox.ts(工作区文档渲染)、src/workspaces/service.ts(工作区目录创建,wsId 从哪来、是否净化)。文档还提供了非破坏性侦察命令(如 curl -s http://localhost:47331/api/trading/config/ | jq '.utas[] | {id, presetId, enabled}')与破坏性测试的备份/恢复纪律(cp -r data/config /tmp/alice-config-snapshot 后测试、再 rm -rf data/config && mv ... 恢复,或使用 git stash/git checkout data/,不过 data/ 通常在 .gitignore 中)。
七、攻击剧本(playbooks/):四类已完成攻击类的实战拆解
每个剧本文件是一个"攻击类",统一结构:威胁说明 → 严重性 → 适用层级(T2 LAN / T3 公网)→ 状态 → 攻击原理 → 前置条件 → 种子用例(Attack / Secure behavior / Current behavior)→ 验证状态表 → 扩展提示 → 待读代码路径 → 修复建议 → 参考。当前仓库中四个已完成剧本均已标记 ✅ Mitigated(提交 754cef7 中缓解),下面拆解其核心用例。
7.1 01-auth-bypass:认证绕过(Severity: Critical)
攻击者无 admin 令牌、无有效会话,想要调用应受认证保护的端点。绕过来源包括:认证中间件完全未接线、接线但顺序错误(挂在受保护路由之后)、特定路由被意外加入"公开"白名单、可从非 localhost 利用的 localhost-trust 透传、接受可被轻易伪造的 Cookie、会话查找返回拥有者已轮换令牌的陈旧会话。11 个种子用例中关键几个:
- 1.1 无 Cookie 的普通 GET:
curl -i http://localhost:47331/api/trading/uta。安全行为 401;当前(post-754cef7)非 localhost 套接字返回 401,真回环(127.0.0.1/::1)返回 200(T1 单用户透传,设计如此),由auth.spec.ts的 "01.1: GET /api/trading/uta without cookie from non-localhost → 401" 验证。✅ - 1.2 无 Cookie 的普通 POST 到变更端点:
curl -i -X POST .../wallet/stage-place-order -H "content-type: application/json" -d '{...}'。非 localhost 返回 401(Cookie 缺失)。✅ - 1.3 伪造 Cookie:
Cookie: alice_session=this-is-not-a-real-session-id→ 401。伪造 SID 从session-store.validateAndTouch()返回 null,中间件默认拒绝。✅ - 1.10 BFF 代理绕过:
curl http://127.0.0.1:47333/api/trading/uta直连 UTA——UTA 接受任何能到达 127.0.0.1:47333 的人。❌ 仍然开放,但在当前威胁模型下可接受(主机 root = 游戏结束),值得作为纵深防御缺口标记,UTA 移出主机时需重访。 - 1.11 OPTIONS 预检绕过:跨源 OPTIONS 到
wallet/push期望 403/405。
剧本还提供了 11 条验证状态表(Unit-verified / Curl re-run / Status)与扩展提示:1.1 + 03 组合(用 X-Forwarded-For: 127.0.0.1 冒充 localhost 特权)、1.3 + 02 组合(受害者浏览器持有有效 Cookie 触发跨源请求)、空 Cookie 值处理、login 的畸形 JSON 是否泄露内部栈、登录/登出并行竞态、子路径匹配边界(如 /api/trading2/...)。
7.2 02-csrf-cross-origin:跨站请求伪造(Severity: High)
受害者在登录状态(持有有效会话 Cookie)访问攻击者站点,攻击者 JS 或 HTML 表单向 Alice 发请求,浏览器自动携带会话 Cookie。文档列出了三层防御并按威胁模型选择了 SameSite=Lax + Origin 头校验(CSRF token 方案过度)。种子用例 2.1(经典 HTML 表单 POST,本地可复现:在 safe/tools/browser/ 写 csrf-poc.html,用 python3 -m http.server 9999 从不同源服务,务必用 Mock UTA 测试)、2.2(跨源 JSON fetch DELETE,携带 credentials:'include')、2.3(img 标签 GET 触发副作用——OpenAlice 设计变更端点仅 POST/PUT/DELETE,审计 grep -rn "app\.get" src/webui/routes/ services/uta/src/http/)、2.4(HTML 表单只能发 application/x-www-form-urlencoded 等,无法原生发 JSON,只接受 JSON 的端点隐含击败简单表单 CSRF,测试 curl -X POST ... -H "content-type: application/x-www-form-urlencoded")、2.5(子域 Domain 设置,不设 Domain 让浏览器默认 host-only)、2.6(CORS"简单请求"免预检绕过——Origin 校验必须在处理函数内部而非仅 CORS 中间件)。
修复建议:Cookie 设 SameSite=Lax;Hono 中间件校验 POST/PUT/DELETE 的 Origin(同源或 OPENALICE_CSRF_TRUSTED_ORIGINS 白名单,其余拒绝);CORS 返回精确匹配源而非 *;不信任可被剥离的 Referer;为 WS 升级补 Origin 校验测试。
7.3 03-localhost-spoofing:localhost 信任伪造(Severity: Critical)
这是攻击面最微妙的一类:计划中"真 localhost 跳过认证"是为了保住 pnpm dev 的零摩擦 UX,但"真 localhost"极易实现错。文档列出的常见错误与防御:①仅查 req.socket.remoteAddress === '127.0.0.1'——生产环境 Alice 通常在反向代理后,代理本身就是 127.0.0.1,每个请求都像 localhost;②无条件信任 X-Forwarded-For——攻击者可发 X-Forwarded-For: 127.0.0.1 冒领 localhost;③信任 X-Real-IP 同样问题;④按主机名 Host: localhost 匹配——请求中可轻易伪造。
正确防御:仅从已配置的可信代理 IP 信任转发头;未配置可信代理时只信 req.socket.remoteAddress(真回环);配置了可信代理则绝不把代理自身 IP 当"localhost"。
种子用例 3.1(无代理配置时直发 X-Forwarded-For: 127.0.0.1 期望 401)、3.2(X-Real-IP 同样)、3.3(Host: localhost 期望 401——Host 用于路由/虚拟主机而非认证)、3.4(配置了 OPENALICE_TRUSTED_PROXIES=10.0.0.5 但请求来自非可信 IP,必须忽略 XFF)、3.5(多跳 XFF 链——最微妙的坑:攻击者在 XFF 中先写 127.0.0.1,可信代理追加 1.2.3.4,若 Alice 读最左条目会误授 localhost;正确做法是从右往左跳过可信代理 IP,取第一个非可信 IP 为客户)、3.6(IPv6 回环变体:::1 应绕过,0.0.0.0 不是回环应要求认证,中间件应依据真实 socket IP 而非主机名)、3.7(IPv4-mapped IPv6 ::ffff:127.0.0.1 归一化)。
剧本还给出了一段必须存在的单元测试示例(TDD:实现前写、使其红、再实现转绿),涵盖真回环 IPv4/IPv6 放行、无可信代理时 XFF 冒称 localhost 不放行、可信代理后从 XFF 正确提取客户端 IP、非可信代理外的 XFF 伪造拒绝。
7.4 07-websocket-auth:WebSocket 升级认证(Severity: Critical)
这一类的特殊之处在于架构盲区:Hono 中间件只对完成正常 HTTP 交换的请求运行,而 WebSocket 升级请求(Connection: Upgrade)由底层 node:http.Server 的 upgrade 事件处理——永远不会经过 Hono 中间件链。因此只通过 app.use('*', ...) 注册的认证中间件不会守卫 /api/workspaces/pty。而 PTY 端点把客户端直接接到操作者用户下孵化进程(Claude Code、Codex CLI 等)的原始终端:未认证攻击者可附着到现有 PTY 会话、向运行中 agent 的 stdin 发送任意按键、读取全部 agent stdout(环境凭据、文件路径、券商 ID 等)。
种子用例:7.1(非 localhost 的未认证升级,期望握手期 401)、7.2(升级时伪造 Cookie → 401)、7.3(真回环无 Cookie → 101 Switching Protocols,设计如此)、7.4(升级时的 XFF 伪造被忽略,升级处理器读 req.socket.remoteAddress)、7.5(可信代理模式下回环透传整体禁用)。修复要点:升级处理器在 wss.handleUpgrade() 前重放认证门(isUpgradeAuthorized);Origin 校验拒绝跨源浏览器(同源——Origin 主机等于 Host 头——始终允许,WEB_TERMINAL_ALLOWED_ORIGINS 白名单覆盖跨源拓扑);会话 ID 目前为 6 字符工作区 SID,若未来多用户应 ≥128 位熵。
八、验证框架(harness/):从"人工跑 curl"到"程序化回归"
safe/harness/runner.ts 是最小脚手架验证运行器,规划中的能力是:读取每个 safe/playbooks/NN-*.md → 提取种子用例(每个含 curl 式调用 + 期望状态)→ 对本地运行中的 OpenAlice 实例执行 → 报告 pass/fail/skipped 与总覆盖率。当前(2026-05-23)是草图——具体实现要等至少一种可由 AI Agent 或 vitest 程序化运行的完全形式化用例格式。
运行方式(从仓库根):
pnpm tsx safe/harness/runner.ts
pnpm tsx safe/harness/runner.ts --playbook 01-auth-bypass
pnpm tsx safe/harness/runner.ts --report-only
关键设计点值得注意:目标 URL 由 OPENALICE_RED_TEAM_TARGET 环境变量控制(默认 http://localhost:47331);剧本解析器会按 ### N.X — <title> 头与 **Attack**:/**Secure behavior**: 块定位用例;报告的语义是 pass = 攻击被阻断 = 安全在守住,fail = 攻击成功 = 需要提交 finding。脚手架注释中还预告了结构化用例的替代来源(safe/harness/cases.yaml),并明确"剧本数 > 5 时再形式化"。
这套 runner 与安全工作的关系是闭环的:基线 finding 中定义"实现完成"的判据之一就是"harness runner 对 L1+L2 范围内的所有用例报告 pass"。
九、Findings 管理:弱点的结构化沉淀
findings/ 是"已发现弱点的时间快照"。添加一条 finding 的四步流程(来自 safe/README.md):
- 创建
findings/YYYY-MM-DD-<short-title>.md - 使用 safe/findings/README.md 中的模板
- 交叉链接相关剧本与代码路径
- 诚实地设定严重性——critical 意味着"券商资金有风险"
仓库中已落地的示例 safe/findings/2026-05-23-pre-implementation.md 本身就是一篇完整的"前置基线"研究:2026-05-23 时 OpenAlice 在 Alice 进程边界零认证——任何到达绑定接口的 HTTP 请求都被当作合法用户处理。复现只需两条 curl(curl -s http://localhost:47331/api/trading/uta | jq 返回完整 UTA 列表;POST .../wallet/stage-place-order 返回 200 且订单被暂存)。该 finding 详述了危害(T2/T3 部署下任何人可列出券商、读交易历史、经 wallet/push 下真单、改券商配置含 API key、改 AI provider 配置、孵化新工作区)与七条修复建议(L1 传输门、L2 认证、Cookie 加固、CSRF、localhost 信任透传、会话存储权限、令牌轮换)。Mitigation 段落记录了提交 754cef7 当天的实际落地:
- src/services/auth/token-store.ts:admin 令牌引导,scrypt 哈希(N=16384, r=8, p=1),明文仅在首次运行打印一次,
auth.json以0o600写入; - src/services/auth/session-store.ts:
data/config/sessions.json,32 字节 base64url SID,7 天滑动 TTL,原子 tmp+rename 写入,30 秒 touch 节流; - src/webui/middleware/auth.ts:Hono 中间件,公开路径白名单、变更请求 Origin 白名单、以
OPENALICE_TRUSTED_PROXIES配置门控的 localhost 透传; - src/webui/routes/auth.ts:
POST /api/auth/login、POST /api/auth/logout、GET /api/auth/status,Cookie 为HttpOnly; SameSite=Lax; Secure(HTTPS 时); Max-Age=604800; - src/webui/plugin.ts:引导调用提前,公网模式安全网(非回环绑定 + 无令牌 + 无
OPENALICE_DISABLE_AUTH=1→ 拒绝启动); - src/webui/workspaces-ws.ts:WebSocket 升级处理器重放同一认证门。
测试覆盖:43 个新测试用例,分布在 token-store / session-store / middleware 的 spec 中,全部通过(总 1783/1783)。
十、源码佐证:认证中间件的真实实现如何落实剧本要求
把剧本的"Secure behavior"与 src/webui/middleware/auth.ts 的实际实现对照,可以确认每一条防线都有对应代码:
- 公开白名单:
PUBLIC_PATH_EXACT(/api/auth/login、/api/auth/logout、/api/auth/status、/api/version)与PUBLIC_PATH_PREFIX(/login、/favicon、/assets/、/mcp)——对应剧本 01 的"显式公开白名单"; - SPA shell 放行:
GET且非/api/前缀的请求公开(React 包体通过轮询/api/auth/status决定渲染登录页还是应用,若对 HTML 本身 401,用户连登录 UI 都到不了); - localhost 透传:仅在
trustedProxies.size === 0时生效,且要求isLoopbackIp(getSocketRemoteAddress(c))并且 Origin 为空或属于可信本地源(isTrustedLocalOrigin:app://openalice、localhost、127.0.0.1、[::1])——对应剧本 03 的"只信真实 socket 回环,配置可信代理后整体禁用"; - 会话校验:
readSessionCookie显式把空值视为"无会话"(对应剧本 01 扩展提示),validateAndTouch校验存在性与有效期(对应 1.3/1.4); - CSRF Origin 校验:仅对
POST/PUT/DELETE/PATCH,isAllowedOrigin比较 Origin 与 Host 是否同源、或在csrfTrustedOrigins内;Origin 缺失(curl、Telegram bot、服务端调用)放行——对应剧本 02 的"校验在处理函数内部"与"不信任 Referer"。
而 src/webui/workspaces-ws.ts 的 isUpgradeAuthorized 用与 HTTP 中间件相同的规则(OPENALICE_DISABLE_AUTH=1 跳过、无可信代理时真回环透传、validateAndTouch Cookie 校验)在 upgrade 事件中重放认证门,正好补上剧本 07 指出的"Hono 中间件不覆盖升级请求"盲区;其 Origin 校验 isWsOriginAllowed 另有 src/webui/workspaces-ws.spec.ts 单测覆盖。
顺带一提,safe/THREAT_MODEL.md 中提到的端口架构(47331/47332/47333 三层)与 Guardian 的探测/重启机制,对应仓库中 scripts/guardian/dev.ts 与 data/control/restart-uta.flag 的轮询逻辑(100ms 去抖 → SIGTERM + 重生 UTA)。
十一、License 与保密哲学:公开的攻击面文档化
safe/ 目录随仓库提交、公开可见,这是设计使然。原文档的立场是:攻击面本就是攻击者已知的领土,不是秘密;我们只是把它清晰地文档化——纵深防御(defense in depth),而不是隐晦保安全(security through obscurity)。
同时有一条硬边界:会伤害运行实例的真实利用工具不应放在这里(应走私有渠道)。这里存放的是剧本框架 + 记录问题的 curl 片段。
十二、结语:把安全测试当作面向 AI 对手的 TDD
safe/ 工具包把 OpenAlice 的安全工作组织成一条可迭代的流水线:威胁模型定义对手与边界 → 知识库绘制攻击地图 → 剧本枚举攻击类与种子用例 → AI 红队 Agent 执行并创造性扩展 → harness 未来将程序化回归 → findings 沉淀弱点与修复历史。其最鲜明的设计判断是:用 AI 攻击者测试 AI 时代的防御,且"我们自己打不穿"就是合理的安全地板。对任何自托管 AI 应用的开发者,这套"先枚举攻击、再把防御当 TDD 补上"的方法论,以及剧本/知识/验证/发现四层结构,都是可以直接借鉴的安全工程组织方式。
若想继续深入:阅读 safe/AGENT_BRIEF.md 体验红队 Agent 的完整任务简报;对照 safe/playbooks/01-auth-bypass.md 与 src/webui/middleware/auth.ts 验证剧本到实现的映射;查看 safe/findings/2026-05-23-pre-implementation.md 了解基线 finding 如何驱动认证落地;用 pnpm tsx safe/harness/runner.ts 体验验证框架的当前形态。