web2-recon

skillupstreamشناسایی و OSINT۲۴ کیلوبایت۱۸ بخش

‏پایپ‌لاین recon مربوط به Web2 — ‏enum ساب‌دامین ‏(subfinder، ‏Chaos API، ‏assetfinder)، کشف هاست زنده ‏(dnsx، ‏httpx)، ‏crawl مربوط به URL ‏(katana، ‏waybackurls، ‏gau)، ‏fuzz مربوط به دایرکتوری ‏(ffuf)، تحلیل JS ‏(LinkFinder/SecretFinder)، امتیاز هدف و مانیتورینگ مستمر.

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

Web2 recon pipeline — subdomain enumeration (subfinder, Chaos API, assetfinder), live host discovery (dnsx, httpx), URL crawling (katana, waybackurls, gau), directory fuzzing (ffuf), JS analysis (LinkFinder, SecretFinder), continuous monitoring (new subdomain alerts, JS change detection, GitHub commit watch). Use when starting recon on any web2 target or when asked about asset discovery, subdomain enum, or attack surface mapping.

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

web2-reconشناسایی و OSINT · ۱۸ بخش۱نمای کلی و کاربرد۲بخش تکمیلی۳بخش تکمیلی۴سطح حمله وسیگنال‌ها۵سطح حمله وسیگنال‌ها۶بخش تکمیلی۷بخش تکمیلی۸بخش تکمیلی۹سطح حمله وسیگنال‌ها۱۰بخش تکمیلی۱۱بخش تکمیلی۱۲بخش تکمیلی۱۳بخش تکمیلی۱۴سطح حمله وسیگنال‌ها۱۵زنجیره‌هاو ترکیب‌ها۱۶بخش تکمیلی۱۷دروازه‌ی اعتبارسنجی۱۸ابزار و نکاتعملیاتی
نمای کلی و کاربرد · ۱۲سطح حمله و سیگنال‌ها · ۴زنجیره‌ها و ترکیب‌ها · ۱دروازه‌ی اعتبارسنجی · ۱

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

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

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

۱

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

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

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

# ‏پایپ‌لاین RECON مربوط به WEB2

‏کشف کامل asset از هیچ تا لیست URL اولویت‌بندی‌شده آماده برای شکار.

۲

بخش تکمیلی

SETUP (one-time)
ترجمه‌ی کامل ✓بخش ۲ از ۱۸

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

# 1. Set your Chaos API key (get free key at chaos.projectdiscovery.io)
export CHAOS_API_KEY="your-key-here"
# Add to ~/.zshrc or ~/.bashrc for persistence:
echo 'export CHAOS_API_KEY="your-key-here"' >> ~/.zshrc

# 2. Update nuclei templates (run weekly)
nuclei -update-templates

# 3. Configure subfinder with API keys for more sources
mkdir -p ~/.config/subfinder
cat > ~/.config/subfinder/config.yaml << 'EOF'
# Get free keys at: virustotal.com, securitytrails.com, censys.io, shodan.io
virustotal: [YOUR_VT_KEY]
securitytrails: [YOUR_ST_KEY]
censys_apiid: YOUR_CENSYS_ID
censys_secret: YOUR_CENSYS_SECRET
shodan: [YOUR_SHODAN_KEY]
EOF

# 4. Verify all tools installed
which subfinder httpx dnsx nuclei katana waybackurls gau dalfox ffuf anew gf interactsh-client
۳

بخش تکمیلی

THE 5-MINUTE RULE
ترجمه‌ی کامل ✓بخش ۳ از ۱۸

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

‏اگر هدف بعد از ۵ دقیقه recon چیز جالبی نشان نداد، رد شو. ساعت‌ها روی سطح مرده نسوزان.

سیگنال‌های کشتن ۵-دقیقه:

  • ‏همه‌ی ساب‌دامین‌ها ۴۰۳ یا صفحات marketing استاتیک برمی‌گردانند
  • ‏هیچ endpoint مربوط به API در URLها قابل‌مشاهده نیست
  • ‏هیچ باندل JavaScript با مسیرهای endpoint جالب نیست
  • ‏‏nuclei صفر یافته‌ی medium/high برمی‌گرداند
  • ‏بدون فرم، بدون احراز هویت، بدون داده‌ی کاربر
۴

سطح حمله و سیگنال‌ها

STANDARD RECON PIPELINE
ترجمه‌ی کامل ✓بخش ۴ از ۱۸

نشانه‌های URL، header، JS و tech stack که نشان می‌دهد این تکنیک اینجا جواب می‌دهد

‏پیش‌از-شکار: همیشه اول اجرا کن
TARGET="target.com"

# Step 0: Passive — crt.sh certificate transparency (no API key needed)
curl -s "https://crt.sh/?q=%.${TARGET}&output=json" \
  | jq -r '.[].name_value' \
  | sed 's/\*\.//g' \
  | sort -u > /tmp/subs.txt
echo "[+] crt.sh: $(wc -l < /tmp/subs.txt) subdomains"

# Step 1: Chaos API (ProjectDiscovery — most comprehensive source)
curl -s "https://dns.projectdiscovery.io/dns/$TARGET/subdomains" \
  -H "Authorization: $CHAOS_API_KEY" \
  | jq -r '.[]' >> /tmp/subs.txt

echo "[+] Chaos returned $(wc -l < /tmp/subs.txt) subdomains"

# Step 2: subfinder (passive multi-source)
subfinder -d $TARGET -silent | anew /tmp/subs.txt
assetfinder --subs-only $TARGET | anew /tmp/subs.txt

echo "[+] Total subdomains after all sources: $(wc -l < /tmp/subs.txt)"

# Step 3: DNS resolution + live host check
cat /tmp/subs.txt | dnsx -silent | httpx -silent -status-code -title -tech-detect | tee /tmp/live.txt

echo "[+] Live hosts: $(wc -l < /tmp/live.txt)"

# Step 4: URL crawl
cat /tmp/live.txt | awk '{print $1}' | katana -d 3 -jc -kf all -silent | anew /tmp/urls.txt

# Step 5: Historical URLs
echo $TARGET | waybackurls | anew /tmp/urls.txt
gau $TARGET --subs | anew /tmp/urls.txt

echo "[+] Total URLs: $(wc -l < /tmp/urls.txt)"

# Step 6: Nuclei scan
nuclei -l /tmp/live.txt -t ~/nuclei-templates/ -severity critical,high,medium -o /tmp/nuclei.txt
خروجی به دایرکتوری سازمان‌یافته
TARGET="target.com"
RECON_DIR="recon/$TARGET"
mkdir -p $RECON_DIR

# All outputs go here:
/tmp/subs.txt         → $RECON_DIR/subdomains.txt
/tmp/live.txt         → $RECON_DIR/live-hosts.txt
/tmp/urls.txt         → $RECON_DIR/urls.txt
/tmp/nuclei.txt       → $RECON_DIR/nuclei.txt
۵

سطح حمله و سیگنال‌ها

ATTACK SURFACE TRIAGE
ترجمه‌ی کامل ✓بخش ۵ از ۱۸

نشانه‌های URL، header، JS و tech stack که نشان می‌دهد این تکنیک اینجا جواب می‌دهد

یافتن هدف‌های جالب در لیست URL
# Parameters worth testing
cat /tmp/urls.txt | grep -E "[?&](id|user|file|path|url|redirect|next|src|token|key|api_key)=" | tee /tmp/interesting-params.txt

# API endpoints
cat /tmp/urls.txt | grep -E "/api/|/v1/|/v2/|/v3/|/graphql|/rest/|/gql" | tee /tmp/api-endpoints.txt

# File upload endpoints
cat /tmp/urls.txt | grep -E "upload|file|attachment|document|image|avatar|photo|media" | tee /tmp/uploads.txt

# Admin/internal paths
cat /tmp/urls.txt | grep -E "/admin|/internal|/debug|/test|/staging|/dev|/management|/console" | tee /tmp/admin-paths.txt

# Authentication endpoints
cat /tmp/urls.txt | grep -E "/oauth|/login|/auth|/sso|/saml|/oidc|/callback|/token" | tee /tmp/auth-paths.txt
الگوهای gf ‏(کلاسه‌بندی سریع)
# Install gf patterns: https://github.com/tomnomnom/gf
cat /tmp/urls.txt | gf xss | tee /tmp/xss-candidates.txt
cat /tmp/urls.txt | gf ssrf | tee /tmp/ssrf-candidates.txt
cat /tmp/urls.txt | gf idor | tee /tmp/idor-candidates.txt
cat /tmp/urls.txt | gf sqli | tee /tmp/sqli-candidates.txt
cat /tmp/urls.txt | gf redirect | tee /tmp/redirect-candidates.txt
cat /tmp/urls.txt | gf lfi | tee /tmp/lfi-candidates.txt
cat /tmp/urls.txt | gf rce | tee /tmp/rce-candidates.txt
۶

بخش تکمیلی

JS ANALYSIS
ترجمه‌ی کامل ✓بخش ۶ از ۱۸

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

‏‏SecretFinder ‏(کلیدهای API، توکن‌ها در باندل‌های JS)
# Activate venv
source ~/tools/SecretFinder/.venv/bin/activate

# Scan a single JS file
python3 ~/tools/SecretFinder/SecretFinder.py -i "https://target.com/static/js/main.js" -o cli

# Scan all JS URLs found in recon
cat /tmp/urls.txt | grep "\.js$" | head -50 | while read url; do
  echo "=== $url ==="
  python3 ~/tools/SecretFinder/SecretFinder.py -i "$url" -o cli 2>/dev/null
done

deactivate
‏‏LinkFinder ‏(endpointهای قایم در JS)
source ~/tools/LinkFinder/.venv/bin/activate

# Single JS file
python3 ~/tools/LinkFinder/linkfinder.py -i "https://target.com/app.js" -o cli

# All pages (crawls JS from HTML)
python3 ~/tools/LinkFinder/linkfinder.py -i "https://target.com" -d -o cli

deactivate
۷

بخش تکمیلی

DIRECTORY FUZZING
ترجمه‌ی کامل ✓بخش ۷ از ۱۸

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

‏‏ffuf — ‏fuzzing استاندارد
# Directory discovery on a live host
ffuf -u "https://target.com/FUZZ" \
     -w ~/wordlists/common.txt \
     -mc 200,201,204,301,302,307,401,403 \
     -ac \
     -t 40 \
     -o /tmp/ffuf-dirs.json

# API endpoint discovery
ffuf -u "https://target.com/api/FUZZ" \
     -w ~/wordlists/api-endpoints.txt \
     -mc 200,201,204,301,302 \
     -ac \
     -t 20

# IDOR fuzzing with authenticated request
# Create req.txt with Authorization: Bearer TOKEN
ffuf -request /tmp/req.txt \
     -request-proto https \
     -w <(seq 1 10000) \
     -fc 404 \
     -ac \
     -t 10
۸

بخش تکمیلی

TARGET SCORING — GO / NO-GO
ترجمه‌ی کامل ✓بخش ۸ از ۱۸

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

‏قبل از صرف وقت امتیاز بده. اگر امتیاز < ‏۴ است رد کن.

معیارامتیاز
‏حداکثر bounty >= ‏۵ هزار دلار‏+۲
‏پایگاه کاربر بزرگ ‏(>۱۰۰ هزار) یا با پول سرکار دارد‏+۲
‏برنامه < ‏۶۰ روز پیش لانچ شده‏+۲
‏فیچرهای پیچیده: ‏API، ‏OAuth، آپلود فایل، ‏GraphQL‏+۱

‏NO-GOهای سخت:

  1. ‏برنامه > ‏۵ ساله با صدها ریپورت تکراری ← شکارگرها اشباعش کرده‌اند
  2. ‏‏scope فقط صفحه‌ی marketing استاتیک ← سطح حمله نیست
  3. ‏شرکت < ‏۵ کارمند بدون درآمد ← پرداخت نمی‌کند
  4. ‏صراحتاً کلاس-باگ برنامه‌ریزی‌شده‌ات را در قوانین exclude کرده
۹

سطح حمله و سیگنال‌ها

TECH STACK DETECTION (2 min)
ترجمه‌ی کامل ✓بخش ۹ از ۱۸

نشانه‌های URL، header، JS و tech stack که نشان می‌دهد این تکنیک اینجا جواب می‌دهد

# Response headers reveal backend
curl -sI https://target.com | grep -iE "server|x-powered-by|x-aspnet|x-runtime|x-generator"

# Common signals:
# Server: nginx + X-Powered-By: PHP/7.4 → PHP backend
# Server: gunicorn OR X-Powered-By: Express → Python/Node.js
# X-Powered-By: ASP.NET → .NET
# Server: Apache Tomcat → Java
# X-Runtime: Ruby → Ruby on Rails

# Framework from JS bundle paths:
# /_next/static/ → Next.js
# /static/js/main.chunk.js → CRA (React)
# /packs/ → Ruby on Rails + Webpacker
# /__nuxt/ → Nuxt.js (Vue)
نگاشت استک ← کلاس-باگ اولیه
استکاول شکار کندوم شکار کن
‏‏Ruby on Rails‏mass assignment‏IDOR ‏(routeهای :id)
‏‏Django‏IDOR ‏(ModelViewSet، بدون پرم object)‏SSTI ‏(mark_safe)
‏‏Flask‏SSTI ‏(render_template_string)‏IDOR
‏‏Laravel‏IDOR / ‏mass assignment‏debug-mode RCE
‏‏WordPress‏SQLi مربوط به پلاگین‏دورزدن auth مربوط به REST API
۱۰

بخش تکمیلی

CONTINUOUS MONITORING SETUP
ترجمه‌ی کامل ✓بخش ۱۰ از ۱۸

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

‏یک بار per هدف راه‌اندازی کن. قبل از شکارگران دیگر بهت هشدار می‌دهد.

هشدارهای ساب‌دامین جدید ‏(cron روزانه)
#!/bin/bash
TARGET="target.com"
KNOWN="/tmp/$TARGET-subs-known.txt"

subfinder -d $TARGET -silent > /tmp/$TARGET-subs-fresh.txt
curl -s "https://dns.projectdiscovery.io/dns/$TARGET/subdomains" \
  -H "Authorization: $CHAOS_API_KEY" \
  | jq -r '.[]' >> /tmp/$TARGET-subs-fresh.txt

# Diff against known
NEW=$(comm -23 <(sort /tmp/$TARGET-subs-fresh.txt) <(sort $KNOWN 2>/dev/null))

if [ -n "$NEW" ]; then
  echo "NEW SUBDOMAINS: $NEW"
  echo "$NEW" >> $KNOWN
fi

# Schedule: crontab -e → 0 8 * * * /bin/bash ~/monitors/subs-watch.sh
ساعت کامیت GitHub
#!/bin/bash
REPO="TargetOrg/target-app"
LAST_SHA="/tmp/$REPO-last-sha.txt"

CURRENT=$(curl -s "https://api.github.com/repos/$REPO/commits?per_page=1" | jq -r '.[0].sha')
KNOWN=$(cat $LAST_SHA 2>/dev/null)

if [ "$CURRENT" != "$KNOWN" ]; then
  echo "New commit on $REPO: $CURRENT"
  echo $CURRENT > $LAST_SHA
  # Get changed files
  curl -s "https://api.github.com/repos/$REPO/commits/$CURRENT" \
    | jq -r '.files[].filename' | grep -E "auth|middleware|route|permission|role|admin"
fi

# Schedule: */30 * * * * /bin/bash ~/monitors/github-watch.sh
۱۱

بخش تکمیلی

PORT SCANNING (often skipped — don't skip)
ترجمه‌ی کامل ✓بخش ۱۱ از ۱۸

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

# naabu — fast port scanner from ProjectDiscovery
# Finds non-standard ports: 8080, 8443, 3000, 8888, 9000, etc.
cat /tmp/live.txt | awk '{print $1}' | naabu -port 80,443,8080,8443,3000,4000,5000,8000,8888,9000,9090,9200,6379 -silent | tee /tmp/open-ports.txt

# Why this matters: admin panels, debug services, internal APIs often run on alt ports
# Example wins: :8080/actuator/env (Spring Boot), :9200/_cat/indices (Elasticsearch), :6379 (Redis)
۱۲

بخش تکمیلی

SECRET SCANNING IN JS BUNDLES
ترجمه‌ی کامل ✓بخش ۱۲ از ۱۸

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

# trufflehog — high-signal secret detection with entropy analysis
# Scans JS files and git repos
pip install trufflehog3 2>/dev/null || true
trufflehog filesystem --only-verified recon/$TARGET/ 2>/dev/null

# SecretFinder — manual JS bundle scan (already in tools/)
source ~/tools/SecretFinder/.venv/bin/activate
cat /tmp/urls.txt | grep "\.js$" | head -100 | while read url; do
  python3 ~/tools/SecretFinder/SecretFinder.py -i "$url" -o cli 2>/dev/null
done
deactivate

# Quick grep for common patterns in downloaded JS
wget -q -r -l 1 -A "*.js" -P /tmp/js-files/ "https://$TARGET" 2>/dev/null
grep -rn "api_key\|apiKey\|client_secret\|access_token\|private_key\|AWS_SECRET\|AKIA" /tmp/js-files/ 2>/dev/null
۱۳

بخش تکمیلی

GITHUB DORKING FOR TARGET
ترجمه‌ی کامل ✓بخش ۱۳ از ۱۸

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

# Search GitHub for hardcoded secrets before hunting the app
TARGET_ORG="TargetOrgName"  # Check their GitHub org

# Useful dorks (search on github.com):
# org:TARGET_ORG password
# org:TARGET_ORG api_key
# org:TARGET_ORG "Authorization: Bearer"
# org:TARGET_ORG .env
# org:TARGET_ORG "BEGIN RSA PRIVATE KEY"

# CLI with gh (GitHub CLI):
gh search code "api_key" --owner "$TARGET_ORG" --json path,repository 2>/dev/null | jq '.'
gh search code "password" --owner "$TARGET_ORG" --json path,repository 2>/dev/null | head -20

# GitDorker (if installed):
python3 ~/tools/GitDorker/GitDorker.py -t GITHUB_TOKEN -d ~/tools/GitDorker/Dorks/alldorksv3 -q "$TARGET" -org
۱۴

سطح حمله و سیگنال‌ها

30-MINUTE RECON PROTOCOL
ترجمه‌ی کامل ✓بخش ۱۴ از ۱۸

نشانه‌های URL، header، JS و tech stack که نشان می‌دهد این تکنیک اینجا جواب می‌دهد

دقیقه‌های ۰-۵: صفحه‌ی برنامه را بخوان
Note:
- ALL in-scope assets (every domain listed)
- Out-of-scope list (read carefully — common trap)
- Safe harbor statement
- Impact types accepted (some exclude "low")
- Average bounty amount (signals program generosity)
دقیقه‌های ۵-۱۵: کشف asset

‏پایپ‌لاین استاندارد بالا را اجرا کن. روی خروجی live.txt تمرکز کن.

دقیقه‌های ۱۵-۲۵: نقشه‌ی سطح

‏الگوهای gf و grep مربوط به interesting-params بالا را اجرا کن.

دقیقه‌های ۲۵-۳۰: کاوش دستی — اولویت‌بندی کن
Priority 1: API endpoints with ID parameters → IDOR candidates
Priority 2: File upload features → XSS/RCE candidates
Priority 3: OAuth/SSO flows → auth bypass candidates
Priority 4: Search/filter with user input → SQLi/SSRF/SSTI candidates
Priority 5: Admin/debug endpoints → auth bypass candidates
۱۵

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

Toolchain fallback (when `dnsx` / `httpx` crash)
ترجمه‌ی کامل ✓بخش ۱۵ از ۱۸

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

‏باینری‌های Go مربوط به projectdiscovery ‏(dnsx، httpx، naabu) گاهی روی macOS arm64 به‌خاطر تعامل cgo / ‏system-resolver ‏SIGSEGV می‌خورند. امضای کراش صرف‌نظر از روش نصب یکسان است — هم brew install و هم go install github.com/project....

dnsx -version   # if SIGSEGV: use the dig fallback below
httpx -version  # if SIGSEGV: use the curl fallback below
# Replaces: dnsx -l subs.txt -a -resp -silent
while read s; do
  ips=$(dig +short +tries=1 +time=3 "$s" \
    | grep -E '^[0-9.]+$' \
    | paste -sd, -)
  [ -n "$ips" ] && echo "$s|$ips"
done < subs.txt
# Replaces: httpx -l subs.txt -silent -status-code -title -tech-detect
while read s; do
  resp=$(curl -s -L -m 5 -o /tmp/body \
    -w "%{http_code}|%{url_effective}|%{header_server}" \
    "https://$s")
  code=$(echo "$resp" | cut -d'|' -f1)
  if [ "$code" != "000" ]; then
    title=$(grep -oE '<title[^>]*>[^<]*</title>' /tmp/body | head -1 | sed 's/<[^>]*>//g')
    echo "$s|$resp|$title"
  fi
done < subs.txt

‏برای اجراهای < ‏۱۰۰ هاست، fallback مربوط به dig+curl در ~۱۴ ثانیه خوب کار می‌کند. برای recon توده‌ای ‏(۱۰۰۰+) اول تول‌چین را فیکس کن.

‏وریفای‌شده علیه VDP خود HackerOne در docs/verification/recon-hackerone-vdp.md.

۱۶

بخش تکمیلی

API Spec / Swagger / OpenAPI Discovery (2024-2026 surface)
ترجمه‌ی کامل ✓بخش ۱۶ از ۱۸

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

‏endpointهای spec مربوط به API پراهرم‌ترین هدف recon منفرد روی هر بک‌اند مدرن .NET / ‏Node / ‏Python / ‏Java هستند. ‏spec هر endpoint، متدهای HTTP، اسم+تایپ+فرمت پارامترها، مدل‌ها و قواعد اعتبارسنجی را افشا می‌کند — نقشه‌ی حمله‌ی کامل در JSON. مقادیر پیش‌فرض:

# NSwag / Swashbuckle (ASP.NET Core)
/swagger
/swagger/
/swagger/index.html
/swagger/ui/index.html
/swagger/v1/swagger.json
/swagger/v2/swagger.json
/swagger/v3/swagger.json
/swagger/docs/v1
/swagger/docs/v2
/swagger-ui
/swagger-ui/
/swagger-ui.html
/swagger-resources
/swagger-resources/configuration/ui
/nswag
/nswag/index.html
/api/swagger
/api/swagger.json
/api/swagger/v1/swagger.json
/api/openapi
/api/openapi.json
/api/v1/swagger.json
/api/v2/swagger.json
/api-docs
/api-docs/swagger.json

# OpenAPI generic
/openapi
/openapi.json
/openapi.yaml
/openapi.yml
/openapi/v1.json
/openapi/v2.json
/openapi/v3.json
/.well-known/openapi.json

# Java / Spring (Springfox / springdoc)
/v2/api-docs
/v3/api-docs
/v3/api-docs.yaml
/v3/api-docs/swagger-config
/swagger-ui/index.html

# Python (FastAPI / Flask-RESTPlus / Connexion / DRF)
/docs
/docs/
/redoc
/redoc/
/openapi.json
/swagger.json
/swagger/?format=openapi
/swagger.yaml

# Express / Node / Hapi
/api-docs
/api-docs.json
/swagger.json
/swagger-stats
/graphql-docs

# GraphQL adjacent (often co-located)
/graphql
/graphiql
/playground
/altair
/voyager
/graphql/console
/graphql-explorer

# ReDoc / RapiDoc / Stoplight / alt UIs
/redoc
/redoc.html
/redoc-ui.html
/rapidoc
/rapidoc.html
/stoplight
/elements

# Misc / dev-leftover
/actuator
/actuator/openapi
/actuator/mappings
/q/openapi
/q/swagger-ui
/docs/swagger.json
/api/v1/docs
/api/v2/docs
/internal/swagger
/admin/swagger
/management/swagger
# After live-hosts.txt is built (Phase 1 / 2), run:
ffuf -w swagger-paths.txt -u "https://FUZZ.target.com" -mc 200,302 -fs 0 -t 50 -o swagger-hits.json
# Or with httpx for content-aware filtering:
httpx -l live-hosts.txt -path swagger-paths.txt -mc 200 -mr "swagger|openapi" -json | tee swagger-hits.jsonl
# For every hit:
jq '.paths | keys' swagger.json > endpoints.txt
jq '.components.schemas' swagger.json > schemas.json   # mass-assignment field candidates
‏primitiveهای زنجیره‌ی حمله که spec بهت می‌دهد
  • ‏‏spec ← کشف scope — endpointهای مستندشده اما UI-نقشه‌نشده که هیچ تستر دیگری نمی‌بیند.
  • ‏‏spec ← ساخت payload مربوط به mass-assignment — components.schemas.UserUpdateDto فیلدهای isAdmin، emailVerified، tenantId، role را enumerate می‌کند.
  • ‏‏spec ← کشف endpoint پنهان — routeهای /internal/*، /debug/*، /v0/*، /legacy/* مستندشده ولی هرگز auth-gate نشده.
  • ‏‏spec ← سیدکردن کلاس-injection — تایپ+فرمت+enum+حداکثر-طول هر پارامتر یعنی payloadها قبل از رسیدن به sink از اعتبارسنجی می‌گذرند. مخصوصاً علیه ASP.NET Core ارزشمند که model binder ورودی مال‌فرم را قبل از هر منطق کنترلر رد می‌کند.
ابزارها
  • ‏‏kiterunner — بومی spec مربوط به OpenAPI را ingest می‌کند، درخواست‌ها علیه API تولید می‌کند.
  • ‏‏sj ‏(Swagger Jacker) — مخصوص بهره‌برداری spec مربوط به Swagger ساخته شده.
  • ‏‏apidetector ‏(brinhosa) — اسکنر توده‌ای Swagger-UI.
  • ‏‏XSSwagger ‏(vavkamil) — نسخه‌های آسیب‌پذیر Swagger UI را تشخیص می‌دهد ‏(خانواده‌ی CVE-2018-25031).
  • ‏‏nuclei -t http/exposures/apis/ — تمپلیت‌های داخلی برای مسیرهای spec پیش‌فرض.
یادآور anti-pattern

‏یک ۴۰۴/۴۰۳ روی /swagger به‌معنای نبود spec افشاشده نیست. خیلی پروژه‌های .NET مسیر spec را زیر /api/swagger/v1/swagger.json به‌جای /swagger route می‌کنند. همیشه لیست کامل مسیرها را تست کن، نه فقط root.

‏تحلیل کامل زنجیره‌ی حمله در hunt-api-misconfig ← NSwag / Swagger / OpenAPI Spec Exposure است.

اسکیل‌های مرتبط:
۱۷

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

Related Skills & Chains
ترجمه‌ی کامل ✓بخش ۱۷ از ۱۸

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

  • ‏اسکیل offensive-osint — وقتی recon به پروب‌ها / ‏wordlistها / ‏regexهای عینی فراتر از پایپ‌لاین پایه نیاز دارد. ‏primitive مربوط به جریان‌کار: این اسکیل مجموعه‌ی URL را تولید می‌کند؛ offensive-osint رجکس‌های secret، مسیرهای GraphQL/Swagger و پروب‌های identity-fabric را فراهم می‌کند که آن‌ها را مصرف می‌کنی.
  • ‏اسکیل hunt-subdomain — وقتی subdomains.txt شامل CNAME اشاره‌کننده به S3 / ‏GitHub Pages / ‏Heroku / ‏Shopify / ‏Azure است باید خودکار به hunt-subdomain برای اعتبارسنجی takeover route شود.
  • ‏اسکیل security-arsenal — وقتی مجموعه‌ی URL توسط gf کلاسه شد و برای تست اکتیو آماده است. ‏primitive مربوط به جریان‌کار: اسم‌های خروجی gf xss/ssrf/sqli/idor به کوئری‌های کلاس-payload علیه کتابخانه‌ی payload مربوط به security-arsenal تبدیل می‌شوند.
  • ‏اسکیل bb-methodology — وقتی recon کامل شد و فاز ۱ به فاز ۲ ‏(نگاشت) منتقل می‌شود. ‏primitive مربوط به جریان‌کار: مجموعه‌ی هاست زنده + ‏URL را به bb-methodology فاز ۲ برای نگاشت endpoint و روتینگ کشف آسیب‌پذیری فاز ۳ تحویل بده.
مراحل استخراج‌شده
  1. ۱‏اسکیل `offensive-osint` — وقتی recon به پروب‌ها / ‏wordlistها / ‏regexهای عینی فراتر از پایپ‌لاین پایه نیاز دارد. ‏primitive مربوط به جریان‌کار: این اسکیل مجموعه‌ی URL را تولید می‌کند؛ `offensive-osint` رجکس‌های secret، مسیرهای GraphQL/Swagger و پروب‌های identity-fabric را فراهم می‌کند که آن‌ها را مصرف می‌کنی.
  2. ۲‏اسکیل `hunt-subdomain` — وقتی `subdomains.txt` شامل CNAME اشاره‌کننده به S3 / ‏GitHub Pages / ‏Heroku / ‏Shopify / ‏Azure است باید خودکار به `hunt-subdomain` برای اعتبارسنجی takeover route شود.
  3. ۳‏اسکیل `security-arsenal` — وقتی مجموعه‌ی URL توسط `gf` کلاسه شد و برای تست اکتیو آماده است. ‏primitive مربوط به جریان‌کار: اسم‌های خروجی `gf xss/ssrf/sqli/idor` به کوئری‌های کلاس-payload علیه کتابخانه‌ی payload مربوط به `security-arsenal` تبدیل می‌شوند.
  4. ۴‏اسکیل `bb-methodology` — وقتی recon کامل شد و فاز ۱ به فاز ۲ ‏(نگاشت) منتقل می‌شود. ‏primitive مربوط به جریان‌کار: مجموعه‌ی هاست زنده + ‏URL را به `bb-methodology` فاز ۲ برای نگاشت endpoint و روتینگ کشف آسیب‌پذیری فاز ۳ تحویل بده.
۱۸

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

Operator Notes (Claude-BugHunter)
ترجمه‌ی کامل ✓بخش ۱۸ از ۱۸

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

‏افزوده‌های engagement-محور و مخصوص-۲۰۲۶ به فونداسیون vendored.
‏ حکمت از engagementهای واقعی authorised + وریفیکیشن فاز ۲ بین
‏۳۱+ تست زنده‌ی ناحیه-اسکیل این repo. پایپ‌لاین upstream ‏WHAT را پوشش می‌دهد؛
‏این لایه WHEN-IT-WORKS-vs-WHEN-IT-DOESN'T را پوشش می‌دهد.
‏‏TLDهای خواهر — scope را وریفای کن

‏target.com مالکیت target.io / target.app را تضمین نمی‌کند، ولی تیم‌های enterprise مکرراً TLDهای متعدد ثبت می‌کنند: target.com ← target.io / target.app / target.one / target.dev / target.test / target-corp.com / target-cdn.net. همیشه از طریق WHOIS یا با چک اینکه زنجیره‌ی cert به همان CA داخلی اعتماد می‌کند وریفای کن قبل از اینکه TLD خواهر را داخل-scope تلقی کنی.

اولویت‌های wordlist مربوط به ساب‌دامین تا ۲۰۲۶

‏پیشوندهای برتر کشف بر اساس نرخ-hit علیه VDPهای enterprise در کورپوس ۲۰۲۴-۲۰۲۶ ما:

# pull all JS, grep for sibling-TLD candidates
for url in $(cat live-hosts.txt); do
  curl -s "$url" | grep -oE 'src="[^"]+\.js"' | sed 's/src="//;s/"//'
done | sort -u > js-urls.txt

# then on each JS file
for j in $(cat js-urls.txt); do
  curl -s "$j" | grep -oE '[a-z0-9.-]+\.(io|app|one|dev|test|cloud|ai|co)' | sort -u
done | sort -u > sibling-tld-candidates.txt

‏ساب‌دامین‌های داخلی-به‌نظر اغلب سطح بیشتری از سایت marketing افشا می‌کنند — partner.target.com و vendor-portal.target.com مکرراً auth ضعیف‌تری از اپ اصلی دارند چون برای کاربران خارجی «مورداعتماد» scope شده‌اند. همیشه بعد از تکمیل اجرای استاندارد subfinder یک پروب به wordlist مربوط به long-tail بفرست.

پروب هاست-زنده: چطور استک را سریع fingerprint کنی

‏هدرهای curl -sI <host> ‏۸۰٪ fingerprint هستند:

  • ‏‏Server: — ‏apache / ‏nginx / ‏cloudflare / ‏kestrel ‏(= ‏.NET Core) / ‏openresty / ‏envoy
  • ‏‏X-Powered-By: — نسخه‌ی PHP، نسخه‌ی ASP.NET، ‏Express.js
  • ‏‏X-Drupal-Cache، X-Generator: Drupal 9 — ‏Drupal
  • ‏‏X-Generator: WordPress — ‏WordPress
  • ‏‏Via: — زنجیره‌ی CDN ‏(1.1 varnish، ‏1.1 cloudfront)
  • ‏اسم‌های Set-Cookie: — JSESSIONID ‏(جاوا)، PHPSESSID ‏(PHP)، ASP.NET_SessionId ‏(.NET)، connect.sid ‏(Express)، laravel_session ‏(Laravel)

‏الگوهای اسم فایل باندل JS:

  • ‏‏/_next/static/ = ‏Next.js
  • ‏‏/_nuxt/ = ‏Nuxt
  • ‏‏/assets/static/ با اسم‌های فایل هش‌شده = ‏Vite
  • ‏‏/static/js/main.*.chunk.js = ‏Create React App
  • ‏‏runtime.*.js + polyfills.*.js + main.*.js = ‏Angular CLI

‏۱۰ ثانیه‌ی اول recon باید حدس استک بدهد؛ بقیه هدف‌گیری است. اگر fingerprint تو خودتناقض است ‏(Server می‌گوید nginx، ‏Set-Cookie می‌گوید ASP.NET) یک فرانت‌اند reverse-proxy پیدا کردی — اپ origin را برای حملات بعدی smuggling/cache نوت کن.

‏‏GitHub Pages 404 در برابر سیگنال takeover

‏تفکیک بحرانی که اپراتورها اشتباه می‌گیرند:

  • ‏«Page not found · GitHub Pages» با HTTP 404 یعنی ریپو هست — takeover نیست.
  • ‏«There isn't a GitHub Pages site here» یعنی ریپو حذف شده — کاندید ‏TAKEOVER.

‏همین تفکیک برای CloudFront:

  • ‏«Error - 404» با Server: CloudFront = ‏distribution هست، origin مقدار ۴۰۴ برگرداند — takeover نیست.
  • ‏«The request could not be satisfied» با X-Cache: Error from cloudfront = ‏origin کلاً غایب — takeover بالقوه.

‏فاز ۲C هر دو الگو را زنده وریفای کرد. همیشه رشته‌ی دقیق بدنه‌ی پاسخ را قبل از فایل کردن یافته‌ی takeover چک کن — ابزارهای takeover-scanner ‏(subzy، ‏subjack) روی چند fingerprint match می‌کنند و مکرراً روی کیس «هنوز owned، فقط خالی» مثبت-کاذب می‌دهند.

‏‏fallback تول‌چین

‏در افزوده‌ی فاز ۲C این فایل قبلاً پوشش داده شده. یادآور سریع: ‏dnsx/httpx ممکن است روی macOS arm64 ‏segfault کنند؛ ‏fallback مربوط به dig+curl برای اجراهای < ‏۱۰۰ هاست در ~۱۴ ثانیه کار می‌کند. یک ساعت دیباگ panic مربوط به باینری Go نسوزان وقتی fallback تو را به همان مجموعه‌ی URL می‌رساند.

mta-sts.*          api.*              docs.*
dev-*              staging-*          *-qa
*-stage            *-uat              events.*
portal.*           customer.*         partner.*
vendor.*           internal-*         admin-*
employee-*         hr.*               jobs.*
sso.*              auth.*             id.*