hunt-shadow-api

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

‏شکار سطح API سایه‌ای/zombie/مستندنشده ‏(OWASP API9 Improper Inventory Management) — enumerate کامل تاریخچه‌ی نسخه‌ی API ‏(مسیرهای v1/v2/beta/legacy، ‏versioning مبتنی-بر-header و ساب‌دامین)، pull و diff هر spec قابل‌دسترس OpenAPI/Swagger و مقایسه‌ی رفتاری نسخه‌ی قدیم با جاری.

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

Hunt shadow / zombie / undocumented API surface (OWASP API9 Improper Inventory Management) — enumerate the full API version history (v1/v2/beta/legacy paths, header- and subdomain-based versioning), pull and diff every reachable OpenAPI/Swagger spec (including ones only findable via the Wayback Machine), and behaviorally diff old vs. current versions for auth/rate-limit/validation regressions rather than just response-shape differences. Distinct from hunt-api-misconfig, which owns exploitation once you have a spec or endpoint (mass assignment, JWT, OData, Swagger-chain attacks); distinct from hunt-subdomain, which owns host-level discovery. This skill owns the version-inventory and behavioral-diff workflow itself. Use when the target has versioned API paths, multiple specs, a changelog referencing deprecated endpoints, or a mobile app whose hardcoded backend calls look older than the current web app's.

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

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

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

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

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

۱

بخش تکمیلی

OWASP API9 — Improper Inventory Management (Shadow / Zombie APIs)
ترجمه‌ی کامل ✓بخش ۱ از ۸

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

‏هم‌طور که API تکامل می‌یابد، نسخه‌های قدیمی و routeهای داخلی/staging معمولاً reachable می‌مانند بدون گرفتن همان فیکس‌های امنیتی نسخه‌ی جاری — چون هیچ‌کس track نمی‌کند که هنوز هستند. باگ به‌ندرت در یک endpoint است؛ در دلتای بین چیزی است که نسخه‌ی قدیم اعمال می‌کند و چیزی که نسخه‌ی جاری روی همان عملیات اعمال می‌کند.

چه‌وقت استفاده کنی

‏تریگر کن وقتی:

  • ‏مسیرهای versionدار قابل‌مشاهده‌اند ‏(/v1/، /v2/، /api/2023-01-01/) یا هدرهای Accept/X-API-Version در بازی‌اند
  • ‏‏فراخوانی‌های API قدیمی در ترافیک موبایل یا باندل‌های JS قدیمی دیده می‌شوند
  • ‏چند spec قابل‌کشف OpenAPI/Swagger هست، یا info.version در یک spec دلالت بر وجود بقیه دارد

‏برای APIهای تک‌نسخه بدون تاریخچه‌ی نسخه استفاده نکن — چیزی برای diff نیست؛ مستقیم برو سراغ hunt-api-misconfig برای بهره‌برداری مستقیم از همان یک سطح موجود.

۲

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

Stage 1 — Enumerate the Full Version Surface
ترجمه‌ی کامل ✓بخش ۲ از ۸

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

# Path-based versioning
for v in v1 v2 v3 v4 beta alpha internal legacy old 2022-01-01 2023-01-01 2024-01-01; do
  curl -s -o /dev/null -w "%{http_code} /api/$v/\n" "https://$TARGET/api/$v/"
done

# Header-based versioning
curl -s -H "X-API-Version: 1" https://$TARGET/api/users
curl -s -H "Accept: application/vnd.company.v1+json" https://$TARGET/api/users

# Subdomain-based versioning
for sub in api api-v1 api-v2 apiv1 apiv2 legacy-api old-api internal-api staging-api; do
  curl -s -o /dev/null -w "%{http_code} $sub\n" "https://$sub.$TARGET/"
done

‏یک 200/401/403 روی مسیر نسخه‌ی قدیمی ‏(هرچیزی غیر از 404/connection-refused) یعنی نسخه هنوز زنده است و ارزش بردن به مرحله‌ی ۳ را دارد، حتی اگر auth بخواهد.

۳

بخش تکمیلی

Stage 2 — Pull Every Reachable Spec, Not Just the Linked One
ترجمه‌ی کامل ✓بخش ۳ از ۸

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

for path in openapi.json swagger.json v1/swagger.json v2/swagger.json v3/api-docs \
            api-docs.json swagger/v1/swagger.json .well-known/openapi.json; do
  curl -s -o /dev/null -w "%{http_code} /$path\n" "https://$TARGET/$path"
done

# Wayback Machine — a DEPRECATED version's spec often stays indexed after the live link is removed
curl -s "http://web.archive.org/cdx/search/cdx?url=$TARGET/*swagger*&output=json&collapse=urlkey"
curl -s "http://web.archive.org/cdx/search/cdx?url=$TARGET/*openapi*&output=json&collapse=urlkey"

‏وقتی بیش از یک spec resolve می‌شود ‏(یک جاری و یک آرشیو/قدیمی)، inventoryهای endpoint را مستقیم diff کن:

jq -r '.paths | keys[]' v1-swagger.json | sort > /tmp/v1_paths.txt
jq -r '.paths | keys[]' v2-swagger.json | sort > /tmp/v2_paths.txt
comm -23 /tmp/v1_paths.txt /tmp/v2_paths.txt   # in v1 only — candidates for "still live but forgotten"

‏برای هر مسیر در آن diff، تأیید کن هنوز علیه base URL مربوط به v1 reachable است. یک route که فقط در spec قدیمی مستند شده و هنوز چیزی غیر از 404 برمی‌گرداند کاندید zombie-endpoint است — ببرش به مرحله‌ی ۳.

۴

بخش تکمیلی

Stage 3 — Behavioral Diff Between Old and Current Version
ترجمه‌ی کامل ✓بخش ۴ از ۸

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

‏برای هر عملیاتی که در هر دو نسخه هست، رفتار security-relevant را مقایسه کن، نه شکل پاسخ. تفاوت‌های شکل پاسخ Informational‌اند؛ رگرسیون‌های امنیتی رفتاری خود یافته‌اند.

  • ‏قدرت auth. آیا نسخه‌ی قدیمی توکن-بدون، توکن منقضی یا توکن کم‌امتیازی را قبول می‌کند که نسخه‌ی جاری رد می‌کند؟
curl -s -H "Authorization: Bearer $EXPIRED_TOKEN" https://$TARGET/api/v1/users/me -w '\n%{http_code}\n'
curl -s -H "Authorization: Bearer $EXPIRED_TOKEN" https://$TARGET/api/v2/users/me -w '\n%{http_code}\n'
  • ‏محدودیت نرخ. همان تعداد درخواست را علیه endpoint معادل هر دو نسخه burst کن؛ ‏429 گم در نسخه‌ی قدیمی یعنی rate limiting فقط forward اعمال شده.
  • ‏اعتبارسنجی input. payloadی بفرست که نسخه‌ی جاری validate/sanitize می‌کند؛ اگر نسخه‌ی قدیمی همان payload را می‌پذیرد و اجرا می‌کند، هاردنینگ فقط-forward اتفاق افتاده — به هر کلاس injectionی که payload هدفش است زنجیر کن ‏(hunt-sqli، hunt-idor و غیره).
  • ‏افشای فیلد. آیا بدنه‌ی پاسخ نسخه‌ی قدیمی فیلدهایی دارد — IDهای داخلی، داده‌ی کاربران دیگر، نوت‌های داخلی، ‏PII — که نسخه‌ی جاری از آن زمان پاک کرده است؟
اسکیل‌های مرتبط:
۵

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

Stage 4 — Deprecated / Internal Routes Never Referenced by the Current UI
ترجمه‌ی کامل ✓بخش ۵ از ۸

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

  • ‏‏باندل‌های JS را برای فراخوانی‌های APIای grep کن که هیچ فلوی قابل‌مشاهده‌ی UI تریگرشان نمی‌کند ‏(/internal/، /admin/، /debug/، /_internal/، /test/، /staging/) — الگوهای grep مربوط به باندل-JS hunt-source-leak را مخصوصاً برای همین reuse کن.
  • ‏فایل‌های robots.txt / sitemap.xml را برای مسیرهای API ممنوع چک کن — افشای خودتحمیل‌شده.
  • ‏‏inventoryهای endpoint مربوط به اپ-موبایل ‏(از طریق apk-redteam-pipeline / ios-redteam-pipeline) خیلی اغلب به نسخه‌ی بک‌اند قدیمی‌تری از چیزی که اپ وب جاری فرامی‌خواند اشاره می‌کنند. هر endpoint سورس-APK/IPA را به‌عنوان کاندید بالقوه برای diff نسخه علیه API وب زنده تلقی کن.
۶

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

False-Positive Gate
ترجمه‌ی کامل ✓بخش ۶ از ۸

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

  • ‏تفاوت نسخه به‌تنهایی ‏(شکل پاسخ متفاوت، تغییر‌نام فیلد آرایشی) ‏Informational است. یافته یک رگرسیون security-relevant است — auth، ‏rate-limit یا اعتبارسنجی که با برگشتن عقب در تاریخچه‌ی نسخه ضعیف‌تر شده.
  • ‏قبل از ادعای تفاوت رفتاری تأیید کن endpoint قدیمی صرفاً alias/proxy به پیاده‌سازی جاری نیست — payloadی بفرست که واقعاً زیر منطق قدیم در برابر جدید متفاوت رفتار کند، نه فقط رشته‌ی نسخه را در بدنه‌ی پاسخ مقایسه کنی وقتی همان اجرا همچنان اعمال می‌شود.
مراحل استخراج‌شده
  1. ۱‏تفاوت نسخه به‌تنهایی ‏(شکل پاسخ متفاوت، تغییر‌نام فیلد آرایشی) ‏Informational است. یافته یک رگرسیون security-relevant است — auth، ‏rate-limit یا اعتبارسنجی که با برگشتن عقب در تاریخچه‌ی نسخه ضعیف‌تر شده.
  2. ۲‏قبل از ادعای تفاوت رفتاری تأیید کن endpoint قدیمی صرفاً alias/proxy به پیاده‌سازی جاری نیست — payloadی بفرست که واقعاً زیر منطق قدیم در برابر جدید متفاوت رفتار کند، نه فقط رشته‌ی نسخه را در بدنه‌ی پاسخ مقایسه کنی وقتی همان اجرا همچنان اعمال می‌شود.
۷

بخش تکمیلی

Severity Table
ترجمه‌ی کامل ✓بخش ۷ از ۸

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

یافتهشدت
‏نسخه‌ی قدیمی auth را کلاً دور می‌زند جایی که نسخه‌ی جاری لازم دارد‏Critical
‏نسخه‌ی قدیمی فاقد rate-limit حاضر روی نسخه‌ی جاری‏Medium–High ‏(زنجیر از طریق hunt-brute-force)
‏نسخه‌ی قدیمی فیلدهای اضافه لو می‌دهد ‏(PII، ‏IDهای داخلی) نسبت به جاری‏Medium–High
‏نسخه‌ی قدیمی payloadهایی می‌پذیرد که نسخه‌ی جاری حالا validate/sanitize می‌کند‏High ‏(زنجیر به کلاس injection زیرین)
‏نسخه reachable است ولی از نظر رفتاری با جاری یکسان‏Informational
اسکیل‌های مرتبط:
۸

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

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

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

  • ‏اسکیل hunt-api-misconfig — مالک بهره‌برداری وقتی spec یا endpoint در دست است ‏(mass assignment، ‏حملات JWT، ‏OData، ‏حملات زنجیره‌ی-Swagger). این اسکیل هدف تیزتری به آن می‌دهد: «این یک endpoint مربوط به zombie با اعتبارسنجی ضعیف‌تر از نسخه‌ی جاری است».
  • ‏اسکیل hunt-subdomain — مالک کشف سطح-هاست/ساب‌دامین ‏(api-v1.target.com به‌عنوان هاست خودش، تصرف بالقوه). این اسکیل مالک چیزی است که وقتی داخل سطح-نسخه‌ی یک هاست شدی رخ می‌دهد.
  • ‏اسکیل hunt-source-leak — الگوهای grep مربوط به باندل-JS برای یافتن routeهای داخلی/deprecated که UI جاری هرگز صداشان نمی‌زند؛ هر endpoint جداافتاده کاندید version-diff است.
  • ‏اسکیل hunt-brute-force — یک رگرسیون rate-limit پیداشده این‌جا فقط وقتی یافته‌ی کامل است که به impact واقعی brute-forceable زنجیر شود ‏(login، ‏OTP، ‏enumeration).
مراحل استخراج‌شده
  1. ۱‏اسکیل `hunt-api-misconfig` — مالک بهره‌برداری وقتی spec یا endpoint در دست است ‏(mass assignment، ‏حملات JWT، ‏OData، ‏حملات زنجیره‌ی-Swagger). این اسکیل هدف تیزتری به آن می‌دهد: «این یک endpoint مربوط به zombie با اعتبارسنجی ضعیف‌تر از نسخه‌ی جاری است».
  2. ۲‏اسکیل `hunt-subdomain` — مالک کشف سطح-هاست/ساب‌دامین ‏(`api-v1.target.com` به‌عنوان هاست خودش، تصرف بالقوه). این اسکیل مالک چیزی است که وقتی داخل سطح-نسخه‌ی یک هاست شدی رخ می‌دهد.
  3. ۳‏اسکیل `hunt-source-leak` — الگوهای grep مربوط به باندل-JS برای یافتن routeهای داخلی/deprecated که UI جاری هرگز صداشان نمی‌زند؛ هر endpoint جداافتاده کاندید version-diff است.
  4. ۴‏اسکیل `hunt-brute-force` — یک رگرسیون rate-limit پیداشده این‌جا فقط وقتی یافته‌ی کامل است که به impact واقعی brute-forceable زنجیر شود ‏(login، ‏OTP، ‏enumeration).