♧ Godown 安全知识树

source map 泄露还原前端源码:从打包产物提取隐藏上传下载接口

pentest/recon · verified

一句话结论

生产环境若未关闭 source map,攻击者可直接下载 app.js.map,用 source-map 工具还原出原始 Vue/JS 源码;源码中的 API 配置对象会暴露页面里看不到的上传、下载等隐藏接口,直接把攻击面从“压缩后的字符串”扩展到“可读的业务代码”。

原理

  • 前端构建工具(webpack/Vite 等)在生成压缩 bundle 时,可同时输出 .map 文件;bundle 末尾通常有 //# sourceMappingURL=app.xxxx.js.map 注释,浏览器开发者工具据此把压缩代码映射回原始文件。
  • source map 是 JSON,核心字段包括 sources(原始文件路径)、sourcesContent(原始文件内容,常直接内嵌)、mappings(行列映射)。只要 sourcesContent 存在,就不需要目标服务器上的原始工程文件,本地即可完整还原。
  • 生产部署常把整个 dist/ 目录原样发布,.map 与 JS 一起可公开访问;网关/静态服务器默认也不会拦截 .map。开发者工具不打开时浏览器不会主动请求 map,但攻击者可以手工下载。
  • 还原后的源码比压缩产物可读得多:Vue 组件的 methods、this.$API.common.upload1、common: { upload: '/common/upload.do', upload1: '/common/upload1.do', download: '/common/download.do' } 等配置会原样出现,隐藏端点无需字典爆破即可获得。
  • 这类泄露本身不是 RCE,但它把“不可见攻击面”变成可测试清单,后续的未授权上传/下载、越权、文件读取都依赖这份清单。

触发条件

  • 目标为 SPA 或使用打包工具的前端,生产环境仍发布 .map 文件。
  • JS bundle 可公开访问,末尾保留 sourceMappingURL 注释或 map 路径可猜解。
  • map 中包含 sourcesContent,或至少包含可读的 sources 路径。
  • 还原出的源码里存在硬编码 API 配置、内部域名、注释或调试入口。

利用步骤

  1. 打开页面,在 Network 中记录主 bundle 与异步 chunk;查看 JS 末尾是否有 //# sourceMappingURL=。
  2. 直接请求对应 .map(如 /js/app.0388e199.js.map),确认返回 JSON 且包含 sources/sourcesContent。
  3. 用 reverse-sourcemap、shuji 或 source-map 库把 map 还原为目录结构;若 sourcesContent 存在,可直接从 JSON 写出原始文件。
  4. 在还原源码中搜索 api、common、upload、download、baseURL、axios、request,整理端点表与参数名。
  5. 对每个隐藏端点做未授权/低权限访问测试,重点关注 upload/download/export/admin 类接口。
  6. 若 map 无 sourcesContent,用 sources 中的相对路径尝试直接访问源文件或对应目录,或改用 JS 字符串提取补充。

PoC

# 1. 找 sourceMappingURL
curl -s https://target/js/app.0388e199.js | tail -c 200

# 2. 下载 map
curl -s https://target/js/app.0388e199.js.map -o app.js.map
python -c "import json;d=json.load(open('app.js.map'));print(d.keys());print(d.get('sources',[])[:10])"

# 3. 还原源码(任选其一)
npx reverse-sourcemap --output-dir ./src app.js.map
# 或
shuji app.js.map -o ./src
import json, re, pathlib

m = json.load(open("app.js.map", encoding="utf-8"))
out = pathlib.Path("restored")
for name, content in zip(m.get("sources", []), m.get("sourcesContent", [])):
    if content is None:
        continue
    p = out / name.replace("webpack://", "").lstrip("/")
    p.parent.mkdir(parents=True, exist_ok=True)
    p.write_text(content, encoding="utf-8")

# 从还原源码中提取可疑接口
for f in out.rglob("*"):
    if f.is_file():
        text = f.read_text(errors="ignore")
        for path in re.findall(r'["\'](/(?:common|api|admin|file|upload|download)[^"\']*)["\']', text):
            print(f, path)

变体与关联

  • 变体:内联 source map(sourceMappingURL=data:application/json;base64,...)无需额外请求,直接从 bundle 中解码即可。
  • 变体:Vite 产物使用 //# sourceMappingURL=... 或 /*# sourceMappingURL=... */;Next.js/Nuxt 的 map 路径不同,可在构建目录中枚举。
  • 变体:CSS map、worker 脚本 map、按路由懒加载的 chunk map 同样可能泄露源码与接口。
  • 关联:[[pentest-recon-vue-spa-router-service-api-extraction]](无 map 时从打包产物正则提取 API)、[[pentest-recon-webpack-apiurlkey-endpoint-extraction]](Angular apiUrlKey 提取);本卡是两者的“源码级”前置步骤。
  • 边界:生产构建关闭 source map、网关拦截 .map、CDN 缓存已清理、sourcesContent 被移除时,还原失败或只能拿到文件路径;即使拿到源码,端点仍需服务端鉴权缺陷才能进一步利用。

检测与防御

  • 检测:定期扫描本单位域名下的 *.js.map、*.css.map 是否可公开访问;检查 JS 末尾是否残留 sourceMappingURL;监控网关对 .map 的大量下载。
  • 修复:生产构建关闭 source map(webpack devtool: false、Vite build.sourcemap: false),或在发布流程中删除 .map 文件。
  • 加固:在网关/静态服务器对 .map 返回 404/403;即使需要错误监控上传 map,也应放在独立鉴权域名下;清理 CDN 历史缓存。
  • 防御:不要在前端源码中硬编码内部端点、密钥、调试开关;服务端对每个端点做认证与对象级授权,不依赖“接口不可见”。