فلوی اجرای گامبهگام
ترتیب مرحلهای استخراجشده از بخشهای متدولوژی/اعتبارسنجی — ۱۱ گام؛ گامهای شرطی با «؟ تصمیم» مشخص شدهاند.
نقشهی ساختار اسکیل
روی هر گره کلیک کنید تا به بخش مربوطه بروید؛ دکمهی «سورس MD» در هدر هر بخش، متن اصلی را با شمارهی خط میآورد.
بخشهای اسکیل
هر بخش با عنوان فارسی، نوع محتوا و توضیح فارسی نمایش داده شده. روی «سورس MD» کلیک کنید تا متن اصلی انگلیسی با شمارهی خطوط فایل در نمایشگر کناری باز شود.
بخش تکمیلی
Why Fintech GraphQL Is a Different Risk Classبخش تکمیلی سند که در دستهبندی استاندارد نگنجیده است
باگهای جنریک GraphQL (IDOR، mass assignment، introspection، سوءاستفادهی batching — hunt-graphql را ببین) هنوز اینجا صدق میکنند، ولی شعاع انفجار کاملاً عوض میشود: باگ resolver در اپ SaaS داده لو میدهد، همان کلاس باگ در mutation مربوط به ledger پول جابهجا میکند. سه ویژگی بکاندهای GraphQL مربوط به fintech را سطح شکار متمایز میکنند:
- mutationهای جابهجایی-پول تقریباً همیشه resolver روی ledger دوطرفهاند. یک mutation تکی GraphQL (
transferFunds،redeemRewards،withdrawToBank) میتواند چند نوشتن ledger را تریگر کند (بدهی + بستانکار + کارمزد) که باید اتمیک باشند. انعطافپذیری GraphQL... - آنطور که resolver مقدار را parse و round میکند خودش سطح قابلبهرهبرداری است — این در APIهای غیرمالی GraphQL بهندرت هست.
- فیلدهای KYC/PII کنار فیلدهای روتین اکانت در همان تایپ مینشینند. تایپهای
UserیاAccountمعمولاًssnLast4،routingNumber،kycStatus،governmentIdUrlیاlinkedBankAccountرا کنارdisplayNameوemailافشا میکنند — یک چک authorization سطح-فیلد گم روی تایپی که همهجای اسکیما استفاده میشود به هر کوئری لمسکنندهاش میپرد.
سطح حمله و سیگنالها
Attack Surface Signalsنشانههای URL، header، JS و tech stack که نشان میدهد این تکنیک اینجا جواب میدهد
الگوهای نامگذاری URL / اسکیما (علاوه بر لیست جنریک /graphql مربوط به hunt-graphql):
/graphql/ledger
/graphql/payments
/api/wallet/graphql
/internal/ledger-graphql
/banking/graphql
اسمهای فیلد/تایپ که ارزش grep در introspection اسکیما یا باندلهای JS را دارند:
balance, availableBalance, pendingBalance, ledgerEntry, ledgerEntries
transferFunds, withdraw, redeem, topUp, reverseTransaction, adjustBalance
kycStatus, ssnLast4, routingNumber, accountNumber, governmentIdUrl
quoteExchangeRate, interestAccrued, rewardsPoints, portfolioValue
idempotencyKey, clientMutationId
نشانههای تکاستک مخصوص این عمودی:
- Plaid/Stripe/Dwolla/Marqeta پیچیدهشده پشت gateway داخلی GraphQL (mutationهای
bankLink،plaidLinkToken) - Apollo Federation با زیرگراف
ledgerیاpaymentsاختصاصی — چک کن introspection خود زیرگراف مستقیم reachable باشد و schema مربوط به stitched-down مربوط به gateway را دور بزند - scalar سفارشی
Money/Decimal/BigDecimalدر اسکیما
مراحل شکار
Step-by-Step Hunting Methodologyروششناسی گامبهگام اجرای تکنیک از شناسایی تا اعتبارسنجی
- هر mutationی را map کن که به بالانس دست میزند، مستقیم یا بهعنوان اثر-جانبی. نه فقط
transfer*/withdraw*— بلکهredeemRewards،applyCoupon،upgradeTier،closeAccount(اغلب بالانس را refund میکند)،disputeTransaction(اغلب موقتاً credit میدهد).
- برای هر mutation جابهجایی-پول، شکل نوشتن ledger را شناسایی کن. آیا یک فراخوانی mutation یک ورودی ledger تولید میکند یا چند تا (بدهی فرستنده، بستانکار گیرنده، ورودی کارمزد)؟ نوشتنهای چندورودی همانهاییاند که ارزش race دارند — مرحلهی ۴ را ببین.
- مدیریت idempotency-key را تست کن. همان mutation را با
idempotencyKeyیکسان بفرست. دوtransactionIdموفق و متمایز یعنی idempotency اعمال نمیشود — replay = اجرای دوباره.
- edge caseهای اعشار/دقت را روی هر آرگومان پذیرندهی مبلغ تست کن — بخش Payload را ببین. تأیید کن گردکردن سمت-سرور با گردکردن نمایشدادهشدهی کلاینت match است؛ ناسازگاری مستقیم قابلپولکردن است.
- IDOR بین-اکانتی روی node IDهای اکانت/پرتفوی را پروب کن، مثل
hunt-idor/hunt-graphql، ولی مخصوصاً تست کن آیا mutationی بهشکلtransferFundsوریفای میکند که اکانت مبدأ مالک caller مربوط به authenticated است — نه فقط اینکه اکانتی با آن ID هست. این IDOR مخصوص-fintech است: authz روی مبدأ بدهی راحت فراموش میشود وقتی authz روی مقصد بستانکار درست پیاده شده (credit کردن اکانت دلخواه برای توسعهدهنده «امن بهنظر میرسد»؛ بدهی کردنش واضح نیست، پس چک میشود — ولی گاهی فقط یک جهت چک میشود).
- authorization سطح-فیلد روی فیلدهای KYC/PII را چک کن با کوئری تایپ مشترک
User/Accountاز هر بافتی که آن را برمیگرداند — نه فقط صفحهی پروفایل. تایپtransactionکهcounterparty { ssnLast4 }را embed میکند جای رایجی برای گمبودن چک است، چون توسعهدهنده کوئری top-level مربوط بهtransactionرا authorize کرد ولی دسترسی فیلد رویcounterpartyتودرتو را دوباره چک نکرد.
- بهدنبال mutationهای سطح-admin reachable از طریق mass assignment باش، نه فقط چک auth گم — مثلاً آبجکت input با فیلد
statusیاoverrideقابل-تنظیم-کلاینت که mutation کاربر عادی نباید افشا کند ولی resolver باز هم قبول میکند (updateTransaction(input: {id, status: "COMPLETED", amount: "..."})).
- سازگاری آرگومان ارز را تست کن. mutation انتقال/قیمت با ترکیبهای
sourceCurrency/targetCurrencyناسازگار بفرست که UI هرگز تولید نمیکند (مثلاً انتقال-به-خود با تبدیل ارز) و چک کن آیا lookup مربوط به نرخ FX مربوط به resolver و نوشتن ledger از همان نرخ استفاده میکنند — پنجرهی TOCTOU اینجا باگ آربیتراژ مستقیم است.
- batching مربوط به alias را با mutationهای جابهجایی-پول ترکیب کن تا double-spend را تست کنی —
hunt-race-conditionرا برای تشدید parallel-HTTP ببین وقتی batching مربوط به alias بهتنهایی تأیید کرد resolver نوشتنها را per-اکانت سریال نمیکند.
مراحل استخراجشده
- ۱هر mutationی را map کن که به بالانس دست میزند، مستقیم یا بهعنوان اثر-جانبی. نه فقط `transfer*`/`withdraw*` — بلکه `redeemRewards`، `applyCoupon`، `upgradeTier`، `closeAccount` (اغلب بالانس را refund میکند)، `disputeTransaction` (اغلب موقتاً credit میدهد).
- ۲برای هر mutation جابهجایی-پول، شکل نوشتن ledger را شناسایی کن. آیا یک فراخوانی mutation یک ورودی ledger تولید میکند یا چند تا (بدهی فرستنده، بستانکار گیرنده، ورودی کارمزد)؟ نوشتنهای چندورودی همانهاییاند که ارزش race دارند — مرحلهی ۴ را ببین.
- ۳مدیریت idempotency-key را تست کن. همان mutation را با `idempotencyKey` یکسان بفرست. دو `transactionId` موفق و متمایز یعنی idempotency اعمال نمیشود — replay = اجرای دوباره.
- ۴edge caseهای اعشار/دقت را روی هر آرگومان پذیرندهی مبلغ تست کن — بخش Payload را ببین. تأیید کن گردکردن سمت-سرور با گردکردن نمایشدادهشدهی کلاینت match است؛ ناسازگاری مستقیم قابلپولکردن است.
- ۵authorization سطح-فیلد روی فیلدهای KYC/PII را چک کن با کوئری تایپ مشترک `User`/`Account` از هر بافتی که آن را برمیگرداند — نه فقط صفحهی پروفایل. تایپ `transaction` که `counterparty { ssnLast4 }` را embed میکند جای رایجی برای گمبودن چک است، چون توسعهدهنده کوئری top-level مربوط به `transaction` را authorize کرد ولی دسترسی فیلد روی `counterparty` تودرتو را دوباره چک نکرد.
- ۶بهدنبال mutationهای سطح-admin reachable از طریق mass assignment باش، نه فقط چک auth گم — مثلاً آبجکت input با فیلد `status` یا `override` قابل-تنظیم-کلاینت که mutation کاربر عادی نباید افشا کند ولی resolver باز هم قبول میکند (`updateTransaction(input: {id, status: "COMPLETED", amount: "..."})`).
- ۷سازگاری آرگومان ارز را تست کن. mutation انتقال/قیمت با ترکیبهای `sourceCurrency`/`targetCurrency` ناسازگار بفرست که UI هرگز تولید نمیکند (مثلاً انتقال-به-خود با تبدیل ارز) و چک کن آیا lookup مربوط به نرخ FX مربوط به resolver و نوشتن ledger از همان نرخ استفاده میکنند — پنجرهی TOCTOU اینجا باگ آربیتراژ مستقیم است.
- ۸batching مربوط به alias را با mutationهای جابهجایی-پول ترکیب کن تا double-spend را تست کنی — `hunt-race-condition` را برای تشدید parallel-HTTP ببین وقتی batching مربوط به alias بهتنهایی تأیید کرد resolver نوشتنها را per-اکانت سریال نمیکند.
Payload و الگوهای تشخیص
Payload & Detection Patternsدستورها، payloadها و الگوهای قابلاجرا برای تست تکنیک
تست replay مربوط به idempotency-key:
mutation {
transferFunds(input: {
idempotencyKey: "test-key-001"
sourceAccountId: "acc_1"
destAccountId: "acc_2"
amount: "10.00"
}) { transactionId status }
}
دو بار با idempotencyKey یکسان بفرست. دو مقدار transactionId موفق و متمایز = idempotency اعمال نمیشود.
پروبهای دقت-اعشار / گردکردن:
mutation { transferFunds(input: {sourceAccountId:"acc_1", destAccountId:"acc_2", amount: "0.001"}) { transactionId } }
mutation { transferFunds(input: {sourceAccountId:"acc_1", destAccountId:"acc_2", amount: "9999999999999999.99"}) { transactionId } }
mutation { transferFunds(input: {sourceAccountId:"acc_1", destAccountId:"acc_2", amount: "1e2"}) { transactionId } }
mutation { transferFunds(input: {sourceAccountId:"acc_1", destAccountId:"acc_2", amount: "-50.00"}) { transactionId } }
مبالغ زیر-سنت مدیریت truncate-در-برابر-round را تست میکنند (N بار تکرار کن تا انحراف بالانس خطای-گردکردن انباشته شود)؛ نوتشن علمی و مقادیر بزرگ تست میکنند آیا پارسر Money/Decimal به float/int بومی با رفتار overflow یا ازدستدادن-دقت برمیگردد؛ مبالغ منفی تست میکنند آیا resolver علامت را سمت-سرور فرض میکند یا به کلاینت اعتماد میکند.
double-spend مبتنی-بر-alias-batch:
mutation {
r1: redeemRewards(input: {rewardId: "rwd_1", accountId: "acc_1"}) { success }
r2: redeemRewards(input: {rewardId: "rwd_1", accountId: "acc_1"}) { success }
r3: redeemRewards(input: {rewardId: "rwd_1", accountId: "acc_1"}) { success }
}
علیه کوپن/جایزهی تکمصرف، resolver نوشتنهای per-اکانت/per-منبع را داخل درخواست batched سریال نمیکند — hunt-race-condition را برای ترکیب با POSTهای موازی HTTP برای تأیید impact واقعی double-spend ببین.
پروب authorization مربوط به اکانت-مبدأ (چک IDOR نامتقارن):
mutation {
transferFunds(input: {
sourceAccountId: "VICTIM_ACCOUNT_ID"
destAccountId: "ATTACKER_CONTROLLED_ACCOUNT_ID"
amount: "1.00"
}) { transactionId status }
}
بهعنوان session/token خود مهاجم اجرا کن. موفقیت = resolver وریفای کرد مقصد کنترل-مهاجم است (واضحاً لازم) ولی هرگز وریفای نکرد مبدأ مالک caller است.
پروب PII مربوط به فیلد تودرتو:
query {
transaction(id: "txn_123") {
amount
counterparty { displayName ssnLast4 routingNumber kycStatus }
}
}
بهعنوان کاربری بدون رابطه با counterparty فراتر از تراکنش مشترک کوئری کن؛ موفقیت روی فیلدهای PII تودرتو یافته است حتی اگر کوئری top-level مربوط به transaction خود تراکنش را درست scope کرده باشد.
پروب mass-assignment روی فیلدهای input شکل-admin:
mutation {
updateTransaction(input: {id: "txn_123", status: "COMPLETED", amount: "0.01"}) { id status }
}
بهعنوان کاربر غیر-admin علیه mutationی بفرست که UI کلاینت این فیلدها را برایش افشا نمیکند؛ اسکیمایی که باز هم قبولشان کند mass assignment روی state مربوط به ledger است.
علل ریشهای
Common Root Causesریشههای کدنویسی و طراحی که این باگ را میسازند — با مقایسهی کد آسیبپذیر/امن
- اعتبارسنجی مبلغ/کارمزد فقط سمت-کلاینت. UI مبلغ درست را محاسبه و نمایش میدهد؛ resolver به هر چیزی که کلاینت GraphQL واقعاً بفرستد اعتماد میکند، چون «اپ همیشه مقدار درست میفرستد».
- نوشتنهای چندورودی ledger غیراتمیک. ورودیهای بدهی، بستانکار و کارمزد بهعنوان استیتمنتهای ترتیبی جدا بهجای داخل یک تراکنش/قفل تکی نوشته میشوند — پنجرهی race که این میسازد دقیقاً همان چیزی است که alias batching + HTTP موازی بهرهبرداری میکند.
- scalar مربوط به
Money/Decimalزیر ورودی edge-case به پارس float بومی fallback میکند (نوتشن علمی، رشتههای بزرگ). - idempotency key فقط روی header چک میشود، نه روی بدنه — یا بدون unique constraint پشتبانکی، پس retryها double-execute میشوند.
- authorization per کوئری top-level پیاده شده، نه per تایپ. فیلدهای حساس تایپ
User/Accountوقتی مستقیم کوئری میشوند محافظتشدهاند (me { ssnLast4 }) ولی وقتی همان تایپ داخل کوئری نامرتبط تودرتو برگردانده میشود نه (transaction { counterparty {...} }). - چک مالکیت اکانت-مبدأ گم است وقتی چک وجود اکانت-مقصد هست — گام ۵ متدولوژی را ببین. بدهی خطرناک بهنظر میرسد پس مرور میشود؛ چک «آیا این اکانت مالک caller است» بیصدا فقط روی طرف بستانکار اعمال میشود.
- mutationهای admin/داخلی از همان تایپ input مربوط به mutation عمومی reuse میکنند، فقط با فیلدهای اختیاری اضافه — چیزی در لایهی resolver آن فیلدها را برای callerهای غیر-admin strip نمیکند.
دروازهی اعتبارسنجی
Gate 0 Validationچکلیستها و قواعد پیش از گزارش برای جلوگیری از false positive و N/A
یافتههای جابهجایی-پول به میلهی سختگیرانهتری از IDOR معمولی GraphQL نیاز دارند — «کوئری بالانس کسی دیگر را برمیگرداند» impact واقعی است؛ «مبلغ malformed فرستادم و ۴۰۰ گرفتم» نیست.
- آیا نوشتن ledger واقعی رخ داد، و میتوانی نشانش بدهی؟ بالانس اکانت را قبل و بعد کوئری کن — تغییر state (نه فقط بدنهی پاسخ
200/success) اثبات است. - برد قطعی است، نه تصادف timing؟ برای یافتههای race/double-spend، دو بار از state تمیز بازتولید کن. اگر فقط زیر شرایط لود خاص کار میکند، پنجره را صادقانه مستند کن بهجای ادعای تضمینی.
- آیا دادهای میبینی که نباید ببینی — نه فقط «mutation نوع input غیرمنتظره قبول کرد و API پیام خطا برگرداند». یک خطای پرحرف GraphQL که stack trace را روی scalar مربوط به
Moneyمالفرم لو میدهد یافتهی کلاس-hunt-source-leakاست، نه fintech-logic — در گزارش یکیشان نکن.
مراحل استخراجشده
- ۱آیا نوشتن ledger واقعی رخ داد، و میتوانی نشانش بدهی؟ بالانس اکانت را قبل و بعد کوئری کن — تغییر state (نه فقط بدنهی پاسخ `200`/success) اثبات است.
- ۲برد قطعی است، نه تصادف timing؟ برای یافتههای race/double-spend، دو بار از state تمیز بازتولید کن. اگر فقط زیر شرایط لود خاص کار میکند، پنجره را صادقانه مستند کن بهجای ادعای تضمینی.
- ۳آیا دادهای میبینی که نباید ببینی — نه فقط «mutation نوع input غیرمنتظره قبول کرد و API پیام خطا برگرداند». یک خطای پرحرف GraphQL که stack trace را روی scalar مربوط به `Money` مالفرم لو میدهد یافتهی کلاس-`hunt-source-leak` است، نه fintech-logic — در گزارش یکیشان نکن.
دروازهی اعتبارسنجی
Related Skills & Chainsچکلیستها و قواعد پیش از گزارش برای جلوگیری از false positive و N/A
- اسکیل
hunt-graphql— اسکیل والد برای کشف جنریک GraphQL، دورزدن introspection، IDOR مربوط به node-ID و مکانیک alias-batching. اول این اسکیل را لود کن؛hunt-fintech-graphqlآن متدولوژی را فرض میکند و فقط دلتای مخصوص-جابهجایی-پول را اضافه میکند. - اسکیل
hunt-business-logic— double-redemption مربوط به کوپن/جایزه و دیگر الگوهای نقص-منطقی مستقیم به mutationهای بهشکلredeemRewards/applyCouponاینجا تعمیم مییابند. - اسکیل
hunt-race-condition— مسیر تشدید وقتی alias batching بهتنهایی تأیید میکند mutation جابهجایی-پول نوشتنها را سریال نمیکند: با parallel-HTTP / تکنیک single-packet ترکیب کن. - اسکیل
hunt-auth-bypass— الگوهای tamper مربوط به نقش و JWT-claim مستقیم به آبجکتهای input مربوط به GraphQL شکل-admin reachable توسط کاربران عادی اعمال میشوند. - اسکیل
hunt-idor— الگوی authz نامتقارن اکانت-مبدأ-در-برابر-مقصد (گام ۵) نمونهی مخصوص-fintech کلاس عمومی IDOR-روی-آرگومان-mutation است. - اسکیل
evidence-hygiene— اسکرینشاتهای بالانس و PoCهای ورودی-ledger به همان انضباط پاکسازی کوکی/PII هر کپچر دیگری نیاز دارند، بهعلاوهی مراقبت که شمارهی اکانت/بالانس واقعی از اکانت مالی زنده هرگز verbatim شامل نشود. - اسکیل
triage-validation— دروازهی ۰ بالا را قبل از draft اعمال کن؛ تیم triage مربوط به برنامهی fintech هر چیزی بدون تغییر state مربوط به ledger نشاندادهشده را فوری میکشد.
مراحل استخراجشده
- ۱اسکیل `hunt-graphql` — اسکیل والد برای کشف جنریک GraphQL، دورزدن introspection، IDOR مربوط به node-ID و مکانیک alias-batching. اول این اسکیل را لود کن؛ `hunt-fintech-graphql` آن متدولوژی را فرض میکند و فقط دلتای مخصوص-جابهجایی-پول را اضافه میکند.
- ۲اسکیل `hunt-business-logic` — double-redemption مربوط به کوپن/جایزه و دیگر الگوهای نقص-منطقی مستقیم به mutationهای بهشکل `redeemRewards`/`applyCoupon` اینجا تعمیم مییابند.
- ۳اسکیل `hunt-race-condition` — مسیر تشدید وقتی alias batching بهتنهایی تأیید میکند mutation جابهجایی-پول نوشتنها را سریال نمیکند: با parallel-HTTP / تکنیک single-packet ترکیب کن.
- ۴اسکیل `hunt-auth-bypass` — الگوهای tamper مربوط به نقش و JWT-claim مستقیم به آبجکتهای input مربوط به GraphQL شکل-admin reachable توسط کاربران عادی اعمال میشوند.
- ۵اسکیل `hunt-idor` — الگوی authz نامتقارن اکانت-مبدأ-در-برابر-مقصد (گام ۵) نمونهی مخصوص-fintech کلاس عمومی IDOR-روی-آرگومان-mutation است.
- ۶اسکیل `evidence-hygiene` — اسکرینشاتهای بالانس و PoCهای ورودی-ledger به همان انضباط پاکسازی کوکی/PII هر کپچر دیگری نیاز دارند، بهعلاوهی مراقبت که شمارهی اکانت/بالانس واقعی از اکانت مالی زنده هرگز verbatim شامل نشود.
- ۷اسکیل `triage-validation` — دروازهی ۰ بالا را قبل از draft اعمال کن؛ تیم triage مربوط به برنامهی fintech هر چیزی بدون تغییر state مربوط به ledger نشاندادهشده را فوری میکشد.