نقشهی ساختار اسکیل
روی هر گره کلیک کنید تا به بخش مربوطه بروید؛ دکمهی «سورس 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 مربوط به باندل-JShunt-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ی بفرست که واقعاً زیر منطق قدیم در برابر جدید متفاوت رفتار کند، نه فقط رشتهی نسخه را در بدنهی پاسخ مقایسه کنی وقتی همان اجرا همچنان اعمال میشود.
مراحل استخراجشده
- ۱تفاوت نسخه بهتنهایی (شکل پاسخ متفاوت، تغییرنام فیلد آرایشی) Informational است. یافته یک رگرسیون security-relevant است — auth، rate-limit یا اعتبارسنجی که با برگشتن عقب در تاریخچهی نسخه ضعیفتر شده.
- ۲قبل از ادعای تفاوت رفتاری تأیید کن 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).
مراحل استخراجشده
- ۱اسکیل `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).