Gitcode 上的项目 EduSwarm 静态安全审计报告
EduSwarm 静态安全审计报告
审计对象:https://gitcode.com/agent-best-practices/eduSwarm
审计版本:main分支 HEAD80ad2adfc1d1b7d2a2d102548e906fe43d1b5077(“!255 merge main into main”)
审计日期:2026-11-19
审计方式:纯静态审计(源码检索 + 逐条人工复核),未做动态渗透测试;下文每条发现均给出文件与行号,可按图索骥复现。
审计范围:以一方代码为主 ——jiuwenswarm/(含extensions/edu_platform、extensions/agent_studio、server、agents/harness、common)、jiuwenbox/、town-bridge.cjs、town-frontend/、deploy-files/、scripts/、Dockerfile、docker-compose.yml。openjiuwen_src/为 vendored 框架源码,仅做抽查,不作为主要结论来源。
项目概况
EduSwarm 是基于 JiuwenSwarm / openjiuwen 的多 Agent「AI 智慧课堂工作台」:教师端在本机或服务器运行,学生凭课堂码加入。主要网络面:
| 端口 | 服务 | 说明 |
|---|---|---|
| 5173 | 前端(Vite 构建产物) | 教师/学生 Web UI |
| 18092 | AgentServer WebSocket | 主 Agent 通道,Agent 具备宿主机命令/文件工具 |
| 19000 | WebChannel WebSocket | Web 通道 |
| 19001 | Gateway WebSocket | 网关通道 |
| 19200 | edu REST 网关(edu_gateway) | 教学数据 API,学生 JWT / API Key 鉴权 |
| 8321 | jiuwenbox 沙箱服务(独立部署时) | 沙箱创建/执行 API |
| 15100 | Agent Studio 后端 | 仅绑 127.0.0.1 |
| 55210/55211 | town-bridge | 仅绑 127.0.0.1 |
典型部署形态有两种,威胁模型不同,报告中会分别指出:(a) 教师本机单机部署(学生同局域网接入);(b) 云服务器/Docker 部署(README 提供云部署指引,端口可能暴露公网)。多条高危发现的成立条件正是「服务端口可被非本机访问」,而该项目的学生接入模型天然要求 19200 等端口对局域网开放,因此不能以「只在本机跑」来消解。
本报告由 AI 检查生成并搭配人工核验确认
结论摘要
共整理 19 条可独立提交的 Issue:严重(P0)4 条、高(P1)7 条、中(P2)6 条、低(P3)2 条。
核心问题集中在 edu 网关的信任模型:API Key 可被伪造请求头绕过、无 JWT 请求被默认为最高权限 owner、授权异常时 fail-open 放行,三者叠加后,edu_policy.yaml 中设计为「任何外部角色不可达」的 admin 级方法也可被远程未认证调用;再叠加学生角色被授予沙箱镜像构建(自定义 Dockerfile = 宿主机代码执行)等过宽权限,构成从「局域网未认证访问」到「宿主机 RCE + 全量教学数据泄露」的完整链条。
| 编号 | 标题 | 等级 | 主要位置 |
|---|---|---|---|
| SEC-01 | edu 网关 API Key 可被伪造 Origin 头绕过 |
P0 严重 | edu_gateway.py:1145-1202 |
| SEC-02 | 无 JWT 即 owner:授权被跳过且异常 fail-open | P0 严重 | edu_policy.py:304-332、edu_gateway.py:1401-1441 |
| SEC-03 | 未鉴权文件下载:作业附件与全量数据备份可直接下载 | P0 严重 | edu_gateway.py:1240-1270 |
| SEC-04 | 学生角色可调用沙箱镜像构建,自定义 Dockerfile 导致宿主机 RCE | P0 严重 | edu_policy.yaml:41、edu_sandbox/image.py:423-507 |
| SEC-05 | 沙箱实例 IDOR:exec/文件读写无归属校验 | P1 高 | edu_backend.py:27313-27340 |
Issue 清单(只记录最严重的 P0 和一个 P1)
SEC-01edu 网关 API Key 可被伪造 Origin 头绕过
- CWE:CWE-807(依赖不可信输入做安全决策)、CWE-302(Authentication Bypass by Assumed-Immutable Data)
- 位置:
jiuwenswarm/extensions/edu_platform/edu_gateway.py _checkApiKey():L1145-1168_isTrustedClient():L1170-1186_isTrustedOrigin():L1188-1202
证据:配置了 EDU_GATEWAY_API_KEY 后,带错 key 或不带 key 的请求最终都会落到 _isTrustedClient() 兜底;而「可信」的判定之一是请求头 Origin 的主机名为 localhost/127.0.0.1,或者与请求头 Host 相同:
# _checkApiKey(节选)
if provided == expected:
return True
# 本应用前端浏览器(Origin 同机)或回环来源放行
return self._isTrustedClient()
# _isTrustedOrigin(节选)
if o_host in ("localhost", "127.0.0.1", "::1"):
return True
req_host = (self.headers.get("Host", "") or "").split(":")[0].strip().lower()
if o_host and o_host == req_host:
return True
影响:Origin 与 Host 都是请求方完全可控的普通请求头。对 curl/脚本类客户端(恰恰是 API Key 要防的对象),一条命令即可绕过:
curl -H "Origin: http://<教师机IP>:19200" http://<教师机IP>:19200/api/edu/...
# Host 头由 curl 按 URL 自动填写,与 Origin 主机名天然相等 → 被判定为“本应用前端” → 放行
需要澄清的是:这不是浏览器 CSRF 向量(浏览器无法伪造 Origin),而是非浏览器客户端的鉴权绕过——API Key 在该场景下形同虚设。凡是服务端口可达的局域网/公网攻击者均可利用。此外 key 比较使用 provided == expected(L1165),非常量时间比较,属次要问题。
修复建议:
- 「可信客户端」只能由服务端不可伪造的属性判定:来源 IP 为回环地址是唯一可保留的口径;删除基于
Origin/Host的信任判定。浏览器前端跨端口调用应改为显式配置的 Origin 白名单(项目已有cors_origins配置机制)+ 仍然要求 key 或会话令牌。 - key 比较改用
hmac.compare_digest。 - 为该判定补回归测试:伪造
Origin: http://localhost、Origin与Host同主机两种请求在远程来源下必须 401。
验证方法:从非回环地址对配置了 key 的网关发上述 curl,应返回 401;本机浏览器前端功能不受影响。
SEC-02无 JWT 即 owner:授权被整段跳过,授权异常时 fail-open 放行
- CWE:CWE-862(Missing Authorization)、CWE-636(Weakness in Fail-open Security Control / 未做到 fail securely)
- 位置:
jiuwenswarm/extensions/edu_platform/edu_policy.py:identity_from_http()L304-332;Identity.can()L45-47;owner 放行 L172-175jiuwenswarm/extensions/edu_platform/edu_gateway.py:_invokeBackend()L1401-1441jiuwenswarm/extensions/edu_platform/edu_policy.yaml:admin级别 L254 起、rolesL283-287
证据:HTTP 请求只要不带合法学生 JWT,身份就被认定为 owner(注释自述为「单教师内网信任侧」,设计文档列为「待收敛项 3」):
# edu_policy.identity_from_http(节选)
...
return Identity(kind="owner", channel="web")
而网关调用后端前,owner 直接跳过授权检查;授权层抛任何异常也只是记日志后放行本请求:
# edu_gateway._invokeBackend(节选)
identity = edu_policy.identity_from_http(params, dict(self.headers))
if not identity.is_owner:
policy = edu_policy.get_policy()
dec = policy.authorize(identity, func_key, params)
...
except Exception as exc:
# 授权层自身故障:记录并放行(绝不因授权模块故障阻断教学)
logger.exception("[EduGateway] 授权检查异常(本请求放行): %s", exc)
edu_policy.yaml 中 admin 级别有 21 个方法,注释明确写道「任何角色都不经 agent/HTTP 外部入口调用(仅教师端本地操作)」——但这层保护的前提是请求方不能自称 owner,而当前实现恰恰默认人人都是 owner。另注意:EduPolicy 在策略文件未写 mode 时代码默认 dry_run(edu_policy.py:132-133,只记日志不拦截);当前仓库 yaml 已显式写 mode: enforce(L6),但默认值本身仍是 fail-open 取向,建议一并改为 enforce。
影响:与 SEC-01 叠加后,远程未认证攻击者可调用包括 admin 级在内的全部网关方法(数据备份/恢复、配置读写等)。即使不叠加 SEC-01,只要网关未配置 API Key 且端口对局域网开放(学生接入的常态),同一链条同样成立。
修复建议:
- owner 身份只能授予回环来源的请求(与 SEC-01 的可信判定收敛为同一口径);非回环无 JWT 请求应为
anonymous,仅能访问public级别方法。 - 授权异常改为 fail-closed(返回 503/403),可用性诉求通过健康检查与告警解决,而不是放行。
mode缺省值改为enforce;dry_run仅允许显式配置并在启动日志中高亮警告。
验证方法:从局域网另一台机器不带任何令牌调用一个 write/admin 级方法,应返回 401/403;教师本机 UI 功能正常。
SEC-03未鉴权文件下载:作业附件与全量数据备份可被直接下载
- CWE:CWE-862(Missing Authorization)、CWE-359(Exposure of Personal Information)
- 位置:
jiuwenswarm/extensions/edu_platform/edu_gateway.py do_GET()L1240-1270(下载分支在鉴权之前return)_serve_backup_file()L1213-1237(且硬编码Access-Control-Allow-Origin: *,L1230)- 备份内容生成:
jiuwenswarm/extensions/edu_platform/edu_backend.pydata_backup()L28493-28545;文件名时间戳_now_utc_ts()L28286-28288
证据:do_GET 中两个下载路径在进入路由表鉴权循环(L1274 起才有 _checkApiKey())之前就被处理并返回,全程没有任何鉴权:
if path == "/api/edu/assignment/download":
...
self._serve_assignment_file(filename)
return
if path == "/api/edu/data/backup_download":
...
self._serve_backup_file(filename)
return
文件名校验只拦截 /、\、..,能防目录穿越到其他目录,但防不住「猜中本目录内的文件名」。而备份文件名是完全可预测的格式:edu-backup-<UTC时间戳>.zip,时间戳为秒级 strftime("%Y%m%dT%H%M%SZ")——知道大致备份日期即可按秒枚举。备份 zip 的内容是全量教学数据:edu.db 的 SQLite 完整快照(全部学生、班级、成绩)、班级 JSON 与全部作业附件(data_backup 实现,L28493 起)。
影响:任何能连到 19200 端口的人(同局域网学生、误暴露公网时的互联网扫描者)可未授权下载全量学生数据备份与他人作业附件,属未成年学生个人信息泄露级别的事件。
修复建议:
- 两个下载端点移入统一鉴权之后:备份下载至少要求教师身份/API Key;作业下载至少要求学生 JWT 且校验该附件属于其有权访问的作业。
- 备份文件名加入不可预测随机后缀(如
edu-backup-<ts>-<secrets.token_hex(8)>.zip),或下载改为一次性令牌链接。 - 删除
_serve_backup_file中硬编码的Access-Control-Allow-Origin: *,走统一 CORS 白名单逻辑。
验证方法:未带令牌请求两个下载路径应返回 401/403;枚举时间戳文件名不应能命中备份。
SEC-04学生角色可调用沙箱镜像构建:自定义 Dockerfile = 宿主机代码执行
- CWE:CWE-862 / CWE-284(权限配置错误导致特权操作暴露给低权限角色)
- 位置:
jiuwenswarm/extensions/edu_platform/edu_policy.yaml:self_or_class级别 L33-60,其中sandbox_image_buildL41;roles中student: [public, ui_state, self, self_or_class]L285- 路由:
jiuwenswarm/extensions/edu_platform/edu_gateway.py:943(POST /api/edu/sandbox/image/build) - 实现:
jiuwenswarm/extensions/edu_platform/edu_sandbox/image.pybuild_image()L423-507
证据:策略表把 sandbox_image_build 放在 self_or_class 级别,而学生角色包含该级别。实现接受调用方传入的完整自定义 Dockerfile 并直接对宿主机 Docker 守护进程执行构建:
# image.py build_image(节选)
custom_df = str(_opt(params.get("dockerfile"), "")).strip()
dockerfile = custom_df or _gen_dockerfile(packages)
...
client.images.build(path=tmp, dockerfile="Dockerfile", tag=image_tag, rm=True) # L507
Dockerfile 的 RUN 指令就是构建期任意命令执行,且构建上下文/守护进程权限在宿主机侧;配合 Docker 的经典逃逸手法(--security-opt、挂载类写法虽受 build 语法限制,但 RUN 中可联网下载并执行任意载荷、污染镜像供后续沙箱实例使用等)足以构成宿主机沦陷。策略层 L2 数据域检查只比对参数中的 student_id,而该方法根本不使用 student_id,因此对学生身份没有任何实际约束。
同一级别中还有多项明显不应授予学生的运维类方法,建议同批收敛:sandbox_task_publish(L60)、sandbox_instance_reap(L44)、sandbox_reap_dead(L54)、sandbox_instances_list(L48)、sandbox_instances_overview(L49)。
影响:任一加入课堂的学生(或按 SEC-01/02 链条的未认证远程攻击者)可获得宿主机级代码执行。
修复建议:
sandbox_image_build及上述运维方法从self_or_class移至write或admin级别。- 若确需学生侧构建,只允许「基础镜像 + 包名白名单」的参数化生成路径(项目已有
_gen_dockerfile),禁止外部传入dockerfile原文;构建应在隔离的构建服务中进行。
验证方法:以学生 JWT 调用 /api/edu/sandbox/image/build 应返回 403;教师端构建预置镜像功能正常。
SEC-05沙箱实例 IDOR:命令执行与文件读写无归属校验
- CWE:CWE-639(Authorization Bypass Through User-Controlled Key / IDOR)
- 位置:
jiuwenswarm/extensions/edu_platform/edu_backend.py sandbox_exec_run()L27313-27319sandbox_file_read()L27322-27328sandbox_file_write()L27331-27340- 实例枚举:
edu_sandbox/manager.pylist_task_instances()L1029 起
证据:三个方法只校验参数非空,拿到 sandbox_id 后直接执行,不校验该实例是否属于当前 JWT 对应的学生:
def sandbox_exec_run(params):
sandbox_id = str(p.get("sandbox_id") or "")
command = str(p.get("command") or "")
if not sandbox_id or not command:
return _fail("缺少 sandbox_id 或 command")
return _sandbox_result(_sandbox_module().executor.run_command(sandbox_id, command))
而实例 ID 可枚举:sandbox_instances_list 同在学生可达的 self_or_class 级别(见 SEC-04),其实现按 task_id 返回全部实例(含 osb_sandbox_id)。
影响:学生可对同班(乃至跨班)同学的沙箱实例任意执行命令、读写文件——窃取/篡改他人实训作业与凭据,破坏他人环境。沙箱内的命令执行本身是功能设计,但跨实例越权不是。
修复建议:在 exec/file 系列方法入口统一校验实例归属(实例记录中的 student_id/class_id 与身份比对),抽成一个 _assert_sandbox_owner(identity, sandbox_id) 供所有 sandbox_* 方法复用;sandbox_instances_list 按身份过滤返回范围。
验证方法:学生 A 的 JWT 对学生 B 的 sandbox_id 调用 sandbox_exec_run 应返回 403。
- 点赞
- 收藏
- 关注作者
评论(0)