hunt-spa-api

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

کشف API بک‌اند پنهان یک SPA از روی باندل عمومی JS آن، بعد تست آن API برای کنترل دسترسی شکسته / احراز هویت غایب. یکی از پررونق‌ترین پلی‌های وب در recon مدرن — لاگین SSO/SSO-gated بودن فرانت‌اند هیچی درباره‌ی enforce بودن auth روی API نمی‌گوید.

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

Discover a single-page-app's hidden backend API from its public JS bundle, then test that API for broken access control / missing authentication. One of the highest-yield web plays in modern recon — SPAs ship their entire backend route map to the browser, and the API behind them is frequently missing the auth middleware the login page implies. Built from an authorized engagement where this play found an unauthenticated financial API that an ASM scan reporting hundreds of "Criticals" completely missed. Use whenever a target serves a JS-heavy SPA (React/Vue/Angular/Next), an "app"/"console"/"dashboard"/"portal" subdomain, or any `*api*` host shows up in recon. Leaked build artifacts (source maps / .env / .git / asset-manifest) are owned by hunt-source-leak; API version-inventory and behavioral diffing by hunt-shadow-api; this skill owns mapping a live SPA's backend routes from its JS bundle and testing them for broken access control / missing auth.

فلوی اجرای گام‌به‌گام

◆
hunt-spa-apiشروع اجرا
۱
‏IDهایی که یک endpoint برمی‌گرداند (`account_id`، `order_id`، `deal_id`) همان کلیدهایی هستند که endpointهای *دیگر* مصرف می‌کنند — اثبات می‌کنند کل router در دسترس است نه فقط یک مسیر.
۲
‏واریانت‌های `dev-`/`beta-`/`staging-` مربوط به API را تست کن — غالباً auth ضعیف‌تر/غیرفعال دارند.
۳
‏هدرهای پاسخ را چک کن: `Access-Control-Allow-Origin: *` مسئله را تشدید می‌کند (هر origin وبی از مرورگر قربانی می‌خواند).
۴
‏روی حداقل-اثبات-لازم متوقف شو. مشتی رکورد (یا یک `totalCount`) چک غایب را تأیید می‌کند. جدول را enumerate نکن — مرز کمینه‌سازی داده‌ی `redteam-mindset` را ببین. یافته auth غایب است، نه حجم داده.
✓
پایان — اعتبارسنجی و گزارش

ترتیب مرحله‌ای استخراج‌شده از بخش‌های متدولوژی/اعتبارسنجی — ۴ گام؛ گام‌های شرطی با «؟ تصمیم» مشخص شده‌اند.

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

hunt-spa-apiکلاس آسیب‌پذیری · ۵ بخش۱سطح حمله و سیگنال‌ها۲مراحل شکار۳بخش تکمیلی۴Payload و الگوهای تشخیص۵دروازه‌ی اعتبارسنجی
سطح حمله و سیگنال‌ها · ۱مراحل شکار · ۲بخش تکمیلی · ۱Payload و الگوهای تشخیص · ۱

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

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

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

۱

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

When to use this skill
ترجمه‌ی کامل ✓بخش ۱ از ۵

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

‏وقتی trigger کن:

  • ‏هاست هدف یک شل HTML کوچک + باندل‌های بزرگ /static/js/*.js یا /_next/static/* برمی‌گرداند (SPA مربوط به React/Vue/Angular/Next/Svelte)
  • ‏ساب‌دامینی به‌نام console، app، dashboard، portal، admin، panel، manage، internal می‌بینی
  • ‏Recon هر هاست *api*، *-api*، api.* را بیرون می‌دهد
  • ‏صفحه‌ی لاگین OAuth/SSO-gated است (auth مربوط به فرانت‌اند هیچی درباره‌ی enforce بودن auth روی API به تو نمی‌گوید)

‏بینش مرکزی: ‏SPA کلاینت یک API بک‌اند است و نقشه‌ی کامل آن API — هاست‌ها، مسیرها، گاهی کلیدها — را برای هرکسی که view-source کند می‌فرستد. محافظت‌شده بودن صفحه‌ی لاگین هیچی درباره‌ی چک‌کردن توکن در API پشتش نمی‌گوید. auth غالباً روی گیت‌وی/لاگین enforce می‌شود و روی گروه مسیری از API غایب است.

‏به‌خاطر «اپ لاگین می‌خواهد» این را رد نکن — دقیقاً همان‌وقت است که پرداخت می‌کند.

۲

مراحل شکار

The play (5 steps)
ترجمه‌ی کامل ✓بخش ۲ از ۵

روش‌شناسی گام‌به‌گام اجرای تکنیک از شناسایی تا اعتبارسنجی

۱. شل را بکش و باندل‌ها را enumerate کن
curl -s https://console.target.com/ -o index.html
# React/CRA:
grep -oE '/static/js/[^"]+\.js' index.html
# Next.js:
grep -oE '/_next/static/[^"]+\.js' index.html
# generic:
grep -oiE 'src="[^"]+\.js[^"]*"' index.html

‏همه‌ی باندل‌ها را دانلود کن (می‌توانند چند‌مگابایتی باشند — اشکالی ندارد، همه‌ش داده‌ی مسیر است):

mkdir bundles
for j in $(grep -oE '/static/js/[^"]+\.js' index.html | sort -u); do
  curl -s "https://console.target.com$j" -o "bundles/$(echo "$j"|tr '/' '_')"
done
۲. هاست‌ها، مسیرها و secretهای API را از باندل‌ها برداشت کن
B=bundles/*.js
# Backend API hosts (incl. dev/beta/staging variants — often weaker auth)
grep -ohiE 'https://[a-z0-9.-]*(api|console|backend|service)[a-z0-9.-]*\.target\.com[a-z0-9/_-]*' $B | sort -u
# Versioned API base paths
grep -ohiE '/api/v[0-9]+/?' $B | sort -u
# Route literals — minified bundles store routes as STRING segments, not full URLs.
# Grep for quoted "resource/action" strings:
grep -ohiE '"[a-z0-9_-]+/[a-z0-9_/-]+"' $B | tr -d '"' \
  | grep -iE '(login|user|account|order|billing|invoice|payment|deal|report|token|otp|password|reset|admin|profile|auth|upload|export|role|permission|dashboard|wallet|finance|sales)' | sort -u
# Secrets (validate before trusting — most AIza keys are Maps/analytics, not Auth)
grep -ohiE '(AIza[0-9A-Za-z_-]{35}|AKIA[0-9A-Z]{16}|sk_live_[0-9A-Za-z]+|eyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}|apiKey["'"'"']?\s*[:=]\s*["'"'"'][^"'"'"']+)' $B | sort -u

‏نکته: minifierها مسیرها را به‌عنوان قطعات رشته‌ی الحاق‌شده ذخیره می‌کنند (مثل "account/payment/list")، نه URLهای کامل /api/v2/... — پس grep ساده‌ی /api/v* هیچی برنمی‌گرداند. برای رشته‌های مسیر resource-word grep کن و base را خودت اضافه کن.

‏چانک‌های lazy-loaded ‏(async) — روی باندل‌های ارجاع‌شده‌ی HTML متوقف نشو. SPAهای CRA/webpack در index.html فقط runtime+main+vendor را ارجاع می‌دهند؛ چانک‌های async مسیر شماره‌دار داخل chunk-map مربوط به main.js نام‌گذاری و در runtime لود می‌شوند، پس grep کردن فقط /static/js/*.js از شل پوشش مسیر را به چانک‌های eager کوتاه می‌کند.

grep -oE '[0-9]+:"[a-f0-9]+"' bundles/*main*.js        # {chunkId:"hash"} pairs
# reconstruct /static/js/<id>.<hash>.chunk.js, download each, re-run route/host/secret harvest
# asset-manifest.json (if present) lists them all -> hunt-source-leak
۳. یک CONTROL بساز — endpointی پیدا کن که واقعاً gated است

‏قبل از اعلام آسیب‌پذیر بودن هرچیزی، به endpointی که انتظار داری محافظت‌شده باشد درخواست unauthenticated بفرست و آنچه باید اتفاق بیفتد را بگیر (۴۰۱/۴۰۳/redirect به لاگین). این baseline توست — اگر همه‌چیز ۴۰۳ باشد API سالم است؛ اگر بعضی مسیرها ۲۰۰ با داده برگردانند، شکاف auth را پیدا کردی.

۴. پیمایش unauthenticated روی مسیرهای کشف‌شده

‏هر رشته‌ی مسیر برداشت‌شده را به base الصاق کن و بدون توکن بفرست. دنبال ناهماهنگی enforce بگرد — گروه‌های مسیری که ۲۰۰ برمی‌گردانند وقتی بقیه ۴۰۳ می‌دهند. فیلدهای گویای privilege در پاسخ‌ها را هم فلگ کن: is_admin / is_internal / requested_by / role_id / account_type ← authorization مشتق از پارامترهای client-supplied — پرچم امتیاز را ست کن و خودت elevate شو. کلاس Critical.

۵. Pivot کن و اثبات کن (به‌حداقل)
  • ‏IDهایی که یک endpoint برمی‌گرداند (account_id، order_id، deal_id) همان کلیدهایی هستند که endpointهای دیگر مصرف می‌کنند — اثبات می‌کنند کل router در دسترس است نه فقط یک مسیر.
  • ‏واریانت‌های dev-/beta-/staging- مربوط به API را تست کن — غالباً auth ضعیف‌تر/غیرفعال دارند.
  • ‏هدرهای پاسخ را چک کن: Access-Control-Allow-Origin: * مسئله را تشدید می‌کند (هر origin وبی از مرورگر قربانی می‌خواند).
  • ‏روی حداقل-اثبات-لازم متوقف شو. مشتی رکورد (یا یک totalCount) چک غایب را تأیید می‌کند. جدول را enumerate نکن — مرز کمینه‌سازی داده‌ی redteam-mindset را ببین. یافته auth غایب است، نه حجم داده.
مراحل استخراج‌شده
  1. ۱‏IDهایی که یک endpoint برمی‌گرداند (`account_id`، `order_id`، `deal_id`) همان کلیدهایی هستند که endpointهای *دیگر* مصرف می‌کنند — اثبات می‌کنند کل router در دسترس است نه فقط یک مسیر.
  2. ۲‏واریانت‌های `dev-`/`beta-`/`staging-` مربوط به API را تست کن — غالباً auth ضعیف‌تر/غیرفعال دارند.
  3. ۳‏هدرهای پاسخ را چک کن: `Access-Control-Allow-Origin: *` مسئله را تشدید می‌کند (هر origin وبی از مرورگر قربانی می‌خواند).
  4. ۴‏روی حداقل-اثبات-لازم متوقف شو. مشتی رکورد (یا یک `totalCount`) چک غایب را تأیید می‌کند. جدول را enumerate نکن — مرز کمینه‌سازی داده‌ی `redteam-mindset` را ببین. یافته auth غایب است، نه حجم داده.
اسکیل‌های مرتبط:
۳

بخش تکمیلی

What "the API behind the SSO login" really means
ترجمه‌ی کامل ✓بخش ۳ از ۵

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

‏یک معماری رایج و خطرناک:

  • ‏console.target.com ‏(SPA) ← لاگین Entra/Okta/Google OAuth است (به‌نظر غیرقابل‌نفوذ می‌رسد).
  • ‏api.target.com ‏(بک‌اند) ← بعضی گروه‌های مسیر توکن bearer را enforce می‌کنند، بعضی گروه‌ها middleware را یادشان رفته.

‏لاگین فرانت‌اند تئاتر است اگر API روی هر مسیر مستقلاً توکن را اعتبارسنجی نکند. همیشه API را مستقیم، بدون credential، تست کن صرف‌نظر از اینکه UI لاگین چقدر قفل به‌نظر می‌رسد.

۴

Payload و الگوهای تشخیص

Anti-patterns
ترجمه‌ی کامل ✓بخش ۴ از ۵

دستورها، payloadها و الگوهای قابل‌اجرا برای تست تکنیک

  • ‏«اپ لاگین می‌خواهد، پس API باید محافظت‌شده باشد.» نه — API را مستقیم، بدون احراز هویت تست کن. کل نکته همین است.
  • ‏«باندل minify است، نمی‌شود خواندش.» لازم نیست بخوانیش — برای هاست‌ها/مسیرها/secretها grepش کن. ۵ دقیقه.
  • ‏«‏/api/v1/foo مقدار ۴۰۴ داد، پس API اینجا نیست.» base یا متد اشتباه. /api/، /api/v2/، POST به‌جای GET و رشته‌های مسیر دقیق از باندل را امتحان کن (۴۰۴ مربوط به Express مسیر را echo می‌کند — برای کالیبره‌کردن استفاده‌اش کن).
  • ‏«کلید AIza پیدا شد ← secret بحرانی.» اول اعتبارسنجی کن — بیشترشان کلید Maps/analytics هستند (CONFIGURATION_NOT_FOUND روی identitytoolkit = Auth-enabled نیست). بیش‌ازحد ادعا نکن.
  • ‏وقتی ۲۰۰ گرفتی کل دیتاست را dump کردن. روی PoC متوقف شو. (redteam-mindset.)
  • ‏endpointهای ساخت-اکانت / نوشتن به‌عنوان «اثبات». endpointهای خواندن خلأ auth را بدون ساختن state اثبات می‌کنند. هرگز create/signup/upload را POST نکن برای «نشان‌دادن» — آن نوشتن مخرب است و به مجوز صریح به‌ازای هر اکشن نیاز دارد.
اسکیل‌های مرتبط:
۵

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

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

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

  • ‏‏hunt-api-misconfig — وقتی API نقشه شد، ماتریس گسترده‌تر misconfig را به‌ازای هر مسیر اجرا کن (دستکاری متد، mass assignment، alg confusion مربوط به JWT).
  • ‏‏hunt-idor — pivotهای account_id/order_id مستقیم به تست IDOR میان مسیرهای کشف‌شده می‌خورند.
  • ‏‏hunt-source-leak — sourcemapها (*.js.map) سورس اصلی را برای استخراج عمیق‌تر مسیر/secret بازسازی می‌کنند؛ همان ماهیچه‌ی برداشت.
  • ‏‏hunt-nextjs — برای تارگت‌های Next.js، تست‌های دورزدن middleware ‏(x-middleware-subrequest) و مسیر /_next/data را روی این لایه کن.
  • ‏‏redteam-mindset — مرز کمینه‌سازی داده استپ ۵ را حاکم می‌کند: چک غایب را اثبات کن، جدول را بیرون نکش.
  • ‏‏recon-scope-triage — verify کن هاست API واقعاً مال تارگت است قبل از تست (API third-party هم‌نام را منتر.)
مراحل استخراج‌شده
  1. ۱‏‏`hunt-api-misconfig` — وقتی API نقشه شد، ماتریس گسترده‌تر misconfig را به‌ازای هر مسیر اجرا کن (دستکاری متد، mass assignment، alg confusion مربوط به JWT).
  2. ۲‏‏`hunt-idor` — pivotهای `account_id`/`order_id` مستقیم به تست IDOR میان مسیرهای کشف‌شده می‌خورند.
  3. ۳‏‏`hunt-source-leak` — sourcemapها (`*.js.map`) سورس اصلی را برای استخراج عمیق‌تر مسیر/secret بازسازی می‌کنند؛ همان ماهیچه‌ی برداشت.
  4. ۴‏‏`hunt-nextjs` — برای تارگت‌های Next.js، تست‌های دورزدن middleware ‏(`x-middleware-subrequest`) و مسیر `/_next/data` را روی این لایه کن.
  5. ۵‏‏`redteam-mindset` — مرز کمینه‌سازی داده استپ ۵ را حاکم می‌کند: چک غایب را اثبات کن، جدول را بیرون نکش.
  6. ۶‏‏`recon-scope-triage` — verify کن هاست API واقعاً مال تارگت است قبل از تست (API third-party هم‌نام را منتر.)