Gitcode 上的项目 EduSwarm 静态安全审计报告

举报
yd_248967048 发表于 2026/11/19 18:52:49 2026/11/19
【摘要】 API Key 可被伪造请求头绕过、无 JWT 请求被默认为最高权限 owner、授权异常时 fail-open 放行,三者叠加后,edu_policy.yaml 中设计为「任何外部角色不可达」的 admin 级方法也可被远程未认证调用;再叠加学生角色被授予沙箱镜像构建(自定义 Dockerfile = 宿主机代码执行)等过宽权限,构成从「局域网未认证访问」到「全量教学数据泄露」链条

EduSwarm 静态安全审计报告

审计对象:https://gitcode.com/agent-best-practices/eduSwarm
审计版本:main 分支 HEAD 80ad2adfc1d1b7d2a2d102548e906fe43d1b5077(“!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),非常量时间比较,属次要问题。

修复建议:

  1. 「可信客户端」只能由服务端不可伪造的属性判定:来源 IP 为回环地址是唯一可保留的口径;删除基于 Origin/Host 的信任判定。浏览器前端跨端口调用应改为显式配置的 Origin 白名单(项目已有 cors_origins 配置机制)+ 仍然要求 key 或会话令牌。
  2. key 比较改用 hmac.compare_digest。
  3. 为该判定补回归测试:伪造 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-175
  • jiuwenswarm/extensions/edu_platform/edu_gateway.py:_invokeBackend() L1401-1441
  • jiuwenswarm/extensions/edu_platform/edu_policy.yaml:admin 级别 L254 起、roles L283-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 且端口对局域网开放(学生接入的常态),同一链条同样成立。

修复建议:

  1. owner 身份只能授予回环来源的请求(与 SEC-01 的可信判定收敛为同一口径);非回环无 JWT 请求应为 anonymous,仅能访问 public 级别方法。
  2. 授权异常改为 fail-closed(返回 503/403),可用性诉求通过健康检查与告警解决,而不是放行。
  3. 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.py data_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 端口的人(同局域网学生、误暴露公网时的互联网扫描者)可未授权下载全量学生数据备份与他人作业附件,属未成年学生个人信息泄露级别的事件。

修复建议:

  1. 两个下载端点移入统一鉴权之后:备份下载至少要求教师身份/API Key;作业下载至少要求学生 JWT 且校验该附件属于其有权访问的作业。
  2. 备份文件名加入不可预测随机后缀(如 edu-backup-<ts>-<secrets.token_hex(8)>.zip),或下载改为一次性令牌链接。
  3. 删除 _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_build L41;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.py build_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 链条的未认证远程攻击者)可获得宿主机级代码执行。

修复建议:

  1. sandbox_image_build 及上述运维方法从 self_or_class 移至 write 或 admin 级别。
  2. 若确需学生侧构建,只允许「基础镜像 + 包名白名单」的参数化生成路径(项目已有 _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-27319
  • sandbox_file_read() L27322-27328
  • sandbox_file_write() L27331-27340
  • 实例枚举:edu_sandbox/manager.py list_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。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。