report-writing

skillupstreamگزارش و اعتبارسنجی۲۱ کیلوبایت۳۹ بخش

‏نگارش گزارش باگ‌بانتی برای H1/Bugcrowd/Intigriti/Immunefi — تمپلیت‌های گزارش، راهنمای لحن انسانی، نگارش impact-اول، امتیازدهی CVSS 3.1، فرمول عنوان، فرمول بیانیه‌ی impact، راهنمای تصمیم شدت، شمارنده‌های downgrade و چک‌لیست پیش‌از-سابمیت.

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

Bug bounty report writing for H1/Bugcrowd/Intigriti/Immunefi — report templates, human tone guidelines, impact-first writing, CVSS 3.1 scoring, title formula, impact statement formula, severity decision guide, downgrade counters, pre-submit checklist. Validation gates and the submittability/always-rejected decision are owned by triage-validation; this skill owns the written report itself (templates, tone, formulas). Use after validating a finding and before submitting. Never use "could potentially" — prove it or don't report.

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

◆
report-writingشروع اجرا
۱
‏به‌عنوان attacker@test.com لاگین کن، توکن Bearer را بگیر
۲
‏درخواست زیر را بفرست:
۳
‏پاسخ را مشاهده کن:
۴
‏[به‌عنوان مهاجم لاگین کن / ‏URL را ببین / درخواست بفرست]
۵
‏درخواست HTTP زیر را بفرست:
۶
‏مشاهده کن پاسخ داده‌ی خصوصی قربانی را دارد:
۷
Log in as Account A
۸
Send this request (replace `111` with victim ID `222`):
۹
Response contains Account B's private data:
✓
پایان — اعتبارسنجی و گزارش

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

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

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

۱

نمای کلی و کاربرد

Introduction
ترجمه‌ی کامل ✓بخش ۱ از ۳۹

توضیح کلی، دامنه‌ی پوشش و زمان به‌کارگیری اسکیل

# REPORT WRITING

‏‎Impact-اول. لحن انسانی. بدون زبان نظری. ‏triagerها آدم‌اند.

۲

بخش تکمیلی

THE MOST IMPORTANT RULE
ترجمه‌ی کامل ✓بخش ۲ از ۳۹

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

هرگز «could potentially» یا «could be used to» یا «may allow» نگو.
یا آن کار را می‌کند یا نمی‌کند. اگر اثباتش نکردی، ادعایش نکن.
BAD:  "This vulnerability could potentially allow an attacker to access user data."
GOOD: "An attacker can access any user's order history by changing the user_id
       parameter to the target user's ID. I confirmed this using two test accounts:
       attacker@test.com (ID 123) successfully retrieved victim@test.com (ID 456)
       orders, including their shipping address and payment method last 4 digits."
۳

سایر

TITLE FORMULA
ترجمه‌ی کامل ✓بخش ۳ از ۳۹

بخش تکمیلی سند

[Bug Class] in [Exact Endpoint/Feature] allows [attacker role] to [impact] [victim scope]

‏عنوان‌های خوب ‏(خاص، ‏impact-اول):

IDOR in /api/v2/invoices/{id} allows authenticated user to read any customer's invoice data
Missing auth on POST /api/admin/users allows unauthenticated attacker to create admin accounts
Stored XSS in profile bio field executes in admin panel — allows privilege escalation
SSRF via image import URL parameter reaches AWS EC2 metadata service
Race condition in coupon redemption allows same code to be used unlimited times

‏عنوان‌های بد ‏(مبهم، بی‌فایده برای triager):

IDOR vulnerability found
Broken access control
XSS in user input
Security issue in API
Unauthorized access to user data
۴

بخش تکمیلی

HACKERONE REPORT TEMPLATE
ترجمه‌ی کامل ✓بخش ۴ از ۳۹

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:


۵

نمای کلی و کاربرد

Summary
ترجمه‌ی کامل ✓بخش ۵ از ۳۹

توضیح کلی، دامنه‌ی پوشش و زمان به‌کارگیری اسکیل

‏[یک پاراگراف: باگ چیست، کجاست، مهاجم چه می‌تواند بکند. خاص باش. شامل: ‏endpoint، ‏method، پارامتر، داده‌ی افشاشده، سطح دسترسی لازم.]

‏مثال: «‏endpoint مربوط به /api/users/{user_id}/orders وریفای نمی‌کند که کاربر authenticated مالک user_id درخواستی است. مهاجم می‌تواند با افزایش پارامتر user_id تاریخچه‌ی سفارش هر کاربری را enumerate کند، شامل PII ‏(ایمیل، آدرس، تلفن) و تاریخچه‌ی خرید، بدون هیچ امتیازی.»

۶

بخش تکمیلی

Vulnerability Details
ترجمه‌ی کامل ✓بخش ۶ از ۳۹

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

نوع آسیب‌پذیری: ‏IDOR / ‏Broken Object Level Authorization

امتیاز CVSS 3.1: ‏6.5 ‏(Medium) — ‏AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N

‏endpoint آسیب‌پذیر: ‏GET /api/users/{user_id}/orders

۷

مراحل شکار

Steps to Reproduce
ترجمه‌ی کامل ✓بخش ۷ از ۳۹

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

محیط:

  • ‏اکانت مهاجم: ‏attacker@test.com، ‏user_id = 123
  • ‏اکانت قربانی: ‏victim@test.com، ‏user_id = 456
  • ‏تارگت: ‏https://target.com

گام‌ها:

  1. ‏به‌عنوان attacker@test.com لاگین کن، توکن Bearer را بگیر
  1. ‏درخواست زیر را بفرست:
GET /api/users/456/orders HTTP/1.1
Host: target.com
Authorization: Bearer ATTACKER_TOKEN_HERE
  1. ‏پاسخ را مشاهده کن:
{
  "orders": [
    {"id": 789, "items": [...], "email": "victim@test.com", "address": "123 Main St..."}
  ]
}

‏پاسخ تاریخچه‌ی کامل سفارش و PII قربانی را دارد با اینکه کاربر متفاوتی درخواست کرده.

مراحل استخراج‌شده
  1. ۱‏اکانت مهاجم: ‏attacker@test.com، ‏user_id = 123
  2. ۲‏اکانت قربانی: ‏victim@test.com، ‏user_id = 456
  3. ۳‏تارگت: ‏https://target.com
  4. ۴‏به‌عنوان attacker@test.com لاگین کن، توکن Bearer را بگیر
  5. ۵‏درخواست زیر را بفرست:
  6. ۶‏پاسخ را مشاهده کن:
۸

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

Impact
ترجمه‌ی کامل ✓بخش ۸ از ۳۹

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

‏یک مهاجم authenticated می‌تواند با تکرار مقادیر user_id همه‌ی سفارش‌های کاربران را enumerate کند. این افشا می‌کند: اسم کامل، ایمیل، آدرس ارسال، تاریخچه‌ی خرید و روش پرداخت ‏(۴ رقم آخر). با ~۱۰۰هزار کاربر، این یک نشت انبوه PII است که همه‌ی کاربران ثبت‌شده را تحت‌تأثیر می‌گذارد. بهره‌برداری فقط اکانت رایگان می‌خواهد و با یک لوپ ساده دقیقه‌ها طول می‌کشد.

۹

بخش تکمیلی

Recommended Fix
ترجمه‌ی کامل ✓بخش ۹ از ۳۹

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

‏ورifای مالکیت سمت-سرور را اضافه کن:

if order.user_id != current_user.id:
    raise Forbidden()
۱۰

بخش تکمیلی

Supporting Materials
ترجمه‌ی کامل ✓بخش ۱۰ از ۳۹

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

‏[اسکرین‌شاتی که session مهاجم را نشان می‌دهد که داده‌ی سفارش قربانی را برمی‌گرداند]

‏[ویدیوی walkthrough در صورت وجود]


۱۱

بخش تکمیلی

BUGCROWD REPORT TEMPLATE
ترجمه‌ی کامل ✓بخش ۱۱ از ۳۹

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

# [IDOR] User order history accessible without authorization via /api/users/{id}/orders

**دسته‌ی VRT:** ‏Broken Access Control > ‏IDOR > ‏P2

۱۲

نمای کلی و کاربرد

Description
ترجمه‌ی کامل ✓بخش ۱۲ از ۳۹

توضیح کلی، دامنه‌ی پوشش و زمان به‌کارگیری اسکیل

‏[همان پاراگراف impact-اول خلاصه‌ی HackerOne]

۱۳

مراحل شکار

Steps to Reproduce
ترجمه‌ی کامل ✓بخش ۱۳ از ۳۹

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

‏[همان گام‌های ساخت‌یافته — درخواست‌های HTTP دقیق، پاسخ‌های دقیق]

۱۴

بخش تکمیلی

Proof of Concept
ترجمه‌ی کامل ✓بخش ۱۴ از ۳۹

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

‏[اسکرین‌شات/ویدیوی نشان‌دهنده‌ی impact واقعی]

۱۵

بخش تکمیلی

Expected vs Actual Behavior
ترجمه‌ی کامل ✓بخش ۱۵ از ۳۹

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

موردانتظار: ‏403 Forbidden وقتی user_id با کاربر authenticated match نیست

واقعی: ‏200 OK با داده‌ی کامل سفارش قربانی

۱۶

بخش تکمیلی

Severity Justification
ترجمه‌ی کامل ✓بخش ۱۶ از ۳۹

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

‏P2 ‏(High) — دسترسی خواندن مستقیم به PII کاربران دیگر. همه‌ی اکانت‌های کاربری را تحت‌تأثیر می‌گذارد. ‏interaction کاربر لازم نیست. توسط هر کاربر authenticated قابل‌بهره‌برداری است. ‏enumeration خودکار می‌تواند همه‌ی [N] رکورد کاربر را ظرف دقیقه exfil کند.

۱۷

بخش تکمیلی

Remediation
ترجمه‌ی کامل ✓بخش ۱۷ از ۳۹

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

‏ورifای مالکیت را اضافه کن: if order.user_id != current_user.id: raise 403


۱۸

بخش تکمیلی

INTIGRITI REPORT TEMPLATE
ترجمه‌ی کامل ✓بخش ۱۸ از ۳۹

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

# [Bug Class]: [Exact Impact] in [Endpoint/Feature]

۱۹

نمای کلی و کاربرد

Description
ترجمه‌ی کامل ✓بخش ۱۹ از ۳۹

توضیح کلی، دامنه‌ی پوشش و زمان به‌کارگیری اسکیل

‏[پاراگراف impact-اول. با کاری که مهاجم می‌تواند بکند شروع کن، نه چطور پیدایش کردی. شامل: ‏endpoint، ‏method، پارامتر، داده‌ی افشاشده، امتیازهای لازم.]

۲۰

مراحل شکار

Steps to Reproduce
ترجمه‌ی کامل ✓بخش ۲۰ از ۳۹

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

محیط:

  • ‏مهاجم: ‏email=attacker@test.com ‏(اکانت استاندارد، بدون نقش خاص)
  • ‏قربانی: ‏email=victim@test.com
  • ‏تست‌شده: ‏[date]

گام‌های بازتولید:

  1. ‏[به‌عنوان مهاجم لاگین کن / ‏URL را ببین / درخواست بفرست]
  1. ‏درخواست HTTP زیر را بفرست:

\```http

METHOD /endpoint HTTP/1.1

Host: target.com

Authorization: Bearer ATTACKER_TOKEN

Content-Type: application/json

{"param": "victim_id_here"}

\```

  1. ‏مشاهده کن پاسخ داده‌ی خصوصی قربانی را دارد:

\```json

{"email": "victim@test.com", "address": "123 Main St", ...}

\```

مراحل استخراج‌شده
  1. ۱‏مهاجم: ‏email=attacker@test.com ‏(اکانت استاندارد، بدون نقش خاص)
  2. ۲‏قربانی: ‏email=victim@test.com
  3. ۳‏تست‌شده: ‏[date]
  4. ۴‏[به‌عنوان مهاجم لاگین کن / ‏URL را ببین / درخواست بفرست]
  5. ۵‏درخواست HTTP زیر را بفرست:
  6. ۶‏مشاهده کن پاسخ داده‌ی خصوصی قربانی را دارد:
۲۱

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

Impact
ترجمه‌ی کامل ✓بخش ۲۱ از ۳۹

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

‏[‏impact خاص و کمی‌شده. چه داده‌ای، چند کاربر، مهاجم چه می‌تواند بکند.]

‏امتیاز CVSS 3.1: ‏X.X ‏([Severity]) — ‏AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:N/A:N

۲۲

بخش تکمیلی

Remediation
ترجمه‌ی کامل ✓بخش ۲۲ از ۳۹

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

‏[فیکس عینی ۱-۳ جمله‌ای. در صورت مفیدبودن کد بگذار.]

۲۳

بخش تکمیلی

Attachments
ترجمه‌ی کامل ✓بخش ۲۳ از ۳۹

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

‏[اسکرین‌شات یا ویدیوی Loom نشان‌دهنده‌ی impact — triagerهای Intigriti برای باگ‌های پیچیده ویدیو ترجیح می‌دهند]


**نوت‌های مخصوص-Intigriti:**
- ‏قالب عنوان: `[Bug Class]: [One-line impact]` ‏(فرمول اجباری نیست، ولی خاص نگهش دار)
- ‏شدت را تو تعیین می‌کنی: ‏Critical/High/Medium/Low/Exceptional
- ‏‏CVSS 3.1 استاندارد است ‏(‏CVSS 4.0 هم روی برنامه‌های جدیدتر پذیرفته)
- ‏ویدیوی PoC خیلی بیشتر از اسکرین‌شات تنها ارزش دارد — با Loom رکورد کن
- ‏‏safe harbor: ‏Intigriti معمولاً در محدودیت‌های تست سخت‌گیرتر است

۲۴

بخش تکمیلی

IMMUNEFI REPORT TEMPLATE
ترجمه‌ی کامل ✓بخش ۲۴ از ۳۹

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

# [Bug Class] — [Protocol Name] — [Severity]

۲۵

نمای کلی و کاربرد

Summary
ترجمه‌ی کامل ✓بخش ۲۵ از ۳۹

توضیح کلی، دامنه‌ی پوشش و زمان به‌کارگیری اسکیل

‏[یک پاراگراف با: ریشه‌ی علت، تابع آسیب‌پذیر، impact اقتصادی، هزینه‌ی حمله. هر جا ممکن عدد بگذار: «مهاجم می‌تواند $X را در Y تراکنش خالی کند».]

۲۶

بخش تکمیلی

Vulnerability Details
ترجمه‌ی کامل ✓بخش ۲۶ از ۳۹

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

کانترکت: VulnerableContract.sol

تابع: claimRedemption()

کلاس باگ: ‏Accounting State Desynchronization

شدت: ‏Critical

ریشه‌ی علت

‏[اسنیپت دقیق کد آسیب‌پذیر با کامنت]

۲۷

بخش تکمیلی

Proof of Concept
ترجمه‌ی کامل ✓بخش ۲۷ از ۳۹

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
// Foundry PoC — run: forge test --match-test test_exploit -vvvv

contract ExploitTest is Test {
    // ... full working exploit
}
۲۸

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

Impact
ترجمه‌ی کامل ✓بخش ۲۸ از ۳۹

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

‏[کمی‌شده: «مهاجم می‌تواند ‏X٪ از TVL = ‏$Y با نرخ‌های فعلی خالی کند. ‏$Z گس می‌خواهد. حمله تکرارپذیر است.»]

۲۹

بخش تکمیلی

Recommended Fix
ترجمه‌ی کامل ✓بخش ۲۹ از ۳۹

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

‏[تغییر کد خاص با قبل/بعد]


۳۰

بخش تکمیلی

CVSS 3.1 QUICK SCORING
ترجمه‌ی کامل ✓بخش ۳۰ از ۳۹

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

فرمول
CVSS = f(AV, AC, PR, UI, S, C, I, A)
انتخاب‌های سریع متریک
متریکمقداروزنکِی
‏Attack Vector (AV)‏Network‏+0.85از طریق اینترنت
‏Local‏+0.55دسترسی local لازم
‏Attack Complexity (AC)‏Low‏+0.77تکرارپذیر
‏High‏+0.44‏race/timing لازم
‏Privileges Required (PR)‏None‏+0.85بدون login
‏Low‏+0.62اکانت کاربر عادی
‏High‏+0.27اکانت admin
‏User Interaction (UI)‏None‏+0.85بدون اکشن قربانی
‏Required‏+0.62قربانی باید کلیک کند
‏Confidentiality (C)‏High‏+0.56همه‌ی داده لو می‌رود
‏Low‏+0.22داده‌ی محدود
‏Integrity (I)‏High‏+0.56هر داده‌ای را تغییر می‌دهد
‏Availability (A)‏High‏+0.56سرویس را کرش می‌کند
امتیازهای معمول per کلاس باگ
باگ‏CVSS معمولشدت
‏IDOR ‏(خواندن PII)‏6.5‏Medium
‏IDOR ‏(نوشتن/حذف)‏7.5‏High
‏دورزدن auth ← ‏admin‏9.8‏Critical
‏‏XSS ذخیره‌شده ‏(هر کاربر)‏5.4–8.8‏Med–High
‏‏SQLi ‏(‏exfil داده)‏8.6‏High
‏‏SSRF ‏(متادیتای ابری)‏9.1‏Critical
‏‏race condition ‏(‏double spend)‏7.5‏High
‏دورزدن auth مربوط به GraphQL‏8.7‏High
‏‏JWT با الگوریتم none‏9.1‏Critical
۳۱

بخش تکمیلی

SEVERITY DECISION GUIDE
ترجمه‌ی کامل ✓بخش ۳۱ از ۳۹

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

‏Critical ‏(P1)
  • ‏تصرف کامل اکانت هر کاربر بدون interaction
  • ‏اجرای کد از راه دور
  • ‏‏SQLi با توانایی dump/تغییر کل DB
  • ‏دورزدن auth به پنل admin
  • ‏‏SSRF به متادیتای ابری ← ‏exfil مربوط به credentialهای IAM
‏High ‏(P2)
  • ‏افشای انبوه PII ‏(ایمیل، تلفن، ‏SSN، داده‌ی پرداخت)
  • ‏‏privilege escalation از کاربر به admin
  • ‏‏SSRF رسیدن به سرویس‌های داخلی ‏(داده برگردانده شد)
  • ‏‏XSS ذخیره‌شده اجراشونده برای همه‌ی کاربران فیچر حساس
  • ‏دستکاری قیمت/مبلغ پرداخت
  • ‏دورزدن rate limit روی OTP ‏(با تلاش نشان‌داده‌شده)
‏Medium ‏(P3)
  • ‏‏IDOR روی داده‌ی غیرحیاتی کاربر خاص
  • ‏‏XSS روی صفحه‌ی حساس که کلیک می‌خواهد
  • ‏‏CSRF روی اکشن state-changing
‏Low ‏(P4)
  • ‏افشای اطلاعات ‏(غیرحساس، بدون PII)
  • ‏‏Clickjacking روی اکشن حساس با PoC کارکن
  • ‏‏CORS روی داده‌ی محدود
۳۲

بخش تکمیلی

SEVERITY SELF-ASSESSMENT
ترجمه‌ی کامل ✓بخش ۳۲ از ۳۹

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

‏هر بله شدت را بالا می‌برد:

1. Exposes PII / health / financial data of other users?        → +1 severity
2. Allows account takeover or privilege escalation?             → +2 severity
3. Requires ZERO user interaction from victim?                  → +1 severity
4. Affects ALL users (not specific condition)?                  → +1 severity
5. Remotely exploitable with no internal network access?        → baseline for High+
۳۳

بخش تکمیلی

DOWNGRADE COUNTERS
ترجمه‌ی کامل ✓بخش ۳۳ از ۳۹

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

برنامه می‌گویدبا این جواب بده
«نیاز به احراز هویت دارد»«مهاجم فقط اکانت رایگان می‌خواهد — نقش یا اجازه‌ی خاصی نه»
«‏impact محدود»«‏[N] کاربر را تحت‌تأثیر می‌گذارد / ‏[نوع PII] را افشا می‌کند / ‏$[مبلغ] در ریسک»
«از قبل شناخته‌شده»«شماره‌ی گزارش را نشان بده — hacktivity را جستجو کردم و پیدا نکردم»
«طبق طراحی»«مستنداتی را نشان بده که می‌گوید این رفتار مقصود است»
«‏CVSS پایین»«‏CVSS impact بیزنسی را پوشش نمی‌دهد — داده‌ی برگشتی به session مهاجم واقعی است»
۳۴

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

THE 60-SECOND PRE-SUBMIT CHECKLIST
ترجمه‌ی کامل ✓بخش ۳۴ از ۳۹

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

[ ] Title follows formula: [Class] in [endpoint] allows [actor] to [impact]
[ ] First sentence states exact impact in plain English
[ ] Steps to Reproduce has exact HTTP request (copy-paste ready)
[ ] Response showing the bug is included (screenshot or JSON body)
[ ] Two test accounts used — not just one account testing itself
[ ] CVSS score calculated and included
[ ] Recommended fix is 1-2 sentences (not a lecture)
[ ] No typos in endpoint paths or parameter names
[ ] Report is < 600 words — triagers skim long reports
[ ] Severity claimed matches impact described — don't overclaim
[ ] Never used "could potentially" or "may allow"
[ ] PoC is reproducible by triager from a fresh state
۳۵

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

CVSS 4.0 QUICK REFERENCE (newer programs)
ترجمه‌ی کامل ✓بخش ۳۵ از ۳۹

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

‏CVSS 4.0 در نوامبر ۲۰۲۳ جایگزین CVSS 3.1 شد. بعضی برنامه‌های جدیدتر آن را می‌خواهند.

تفاوت‌های کلیدی با CVSS 3.1
متریک‏CVSS 3.1‏CVSS 4.0
‏Attack Vector‏Network/Adjacent/Local/Physicalهمان
‏Attack Complexity‏Low/High‏Low/High
جدید: ‏Attack Requirements‏(وجود نداشت)‏None/Present ‏(جایگزین بخشی از PR/UI)
‏Privileges Required‏None/Low/Highهمان
‏User Interaction‏None/Required‏None/Passive/Active
مثال‌های امتیاز CVSS 4.0
یافتهامتیازوکتور
‏IDOR خواندن PII‏7.1‏CVSS:4.0/AV:N/AC:L/AT:N/PR:L/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N
‏SSRF ← متادیتای ابری‏8.7‏CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:H/SI:H/SA:N
ماشین‌حساب سریع CVSS 4.0
Use: https://www.first.org/cvss/calculator/4.0
Key fields:
  VC/VI/VA = Vulnerable System Confidentiality/Integrity/Availability
  SC/SI/SA = Subsequent System (downstream impact)
  AT = None (no special condition) | Present (race/specific config needed)
  UI = None | Passive (victim visits URL) | Active (victim takes explicit action)

‏قاعده‌ی عملی: اگر برنامه از CVSS 4.0 استفاده می‌کند و وکتور را نمی‌دانی، از ماشین‌حساب استفاده کن و رشته‌ی کامل شروع‌شونده با CVSS:4.0/AV:... را بگذار. برنامه‌ها نمی‌توانند رشته‌ی وکتور معتبر را رد کنند.

۳۶

بخش تکمیلی

HUMAN TONE GUIDELINES
ترجمه‌ی کامل ✓بخش ۳۶ از ۳۹

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

به یک آدم بنویس، نه به یک سیستم:

  • ‏‏triagerها خسته‌اند. در جمله‌ی ۱ به impact برس.
  • ‏از «من» استفاده کن نه «پژوهشگر» — تو پیدایش کردی، مالکش شو
  • ‏پاراگراف‌های کوتاه، بولت برای گام‌ها
  • ‏در صورت نیاز به مستندات مرتبط لینک بده

‏زبان escalation ‏(وقتی payout دارد downgrade می‌شود):

"This vulnerability does not require any special privileges — only a free account."
"The exposed data includes [PII type], which is subject to GDPR requirements."
"An attacker can automate this with a simple loop — all [N] records in minutes."
"This is exploitable externally without network access to any internal system."
"The impact is equivalent to a full data breach of [feature/data type]."

‏اجتناب کن:

  • ‏اصطلاحاتی که triager شاید نداند
  • ‏توضیح ۵-پاراگرافی اینکه IDOR چیست ‏(می‌دانند)
  • ‏زنجیره‌های نظری ‏(«could be combined with X to...»)
۳۷

مراحل شکار

STEPS TO REPRODUCE FORMAT (triager-optimized)
ترجمه‌ی کامل ✓بخش ۳۷ از ۳۹

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

‏این بخش صرفاً کد / دستور است — بدون تغییر حفظ شده:

**Setup:**
- Account A (attacker): email=attacker@test.com, ID=111
- Account B (victim): email=victim@test.com, ID=222
- Both created via normal registration — no special access

**Steps:**

1. Log in as Account A
2. Send this request (replace `111` with victim ID `222`):

\```
GET /api/v2/resource/222 HTTP/1.1
Host: target.com
Authorization: Bearer ACCOUNT_A_TOKEN
\```

3. Response contains Account B's private data:

\```json
{"id": 222, "email": "victim@test.com", "name": "Victim User", "address": "..."}
\```

**Expected:** 403 Forbidden
**Actual:** 200 OK with victim's private data
مراحل استخراج‌شده
  1. ۱Account A (attacker): email=attacker@test.com, ID=111
  2. ۲Account B (victim): email=victim@test.com, ID=222
  3. ۳Both created via normal registration — no special access
  4. ۴Log in as Account A
  5. ۵Send this request (replace `111` with victim ID `222`):
  6. ۶Response contains Account B's private data:
۳۸

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

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

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

  • ‏اسکیل triage-validation — وقتی تصمیم می‌گیری اصلاً گزارش بنویسی یا نه. ‏primitive فلوی کار: هرگز این اسکیل را قبل از پاس‌شدن دروازه‌ی ۷-سؤال triage-validation باز نکن؛ یافته‌ای که گیت را رد می‌کند باید کشته شود، نه نوشته.
  • ‏اسکیل bugcrowd-reporting — وقتی تارگت برنامه‌ی Bugcrowd است. ‏primitive فلوی کار: تمپلیت بدنه‌ی این اسکیل بنیاد است؛ bugcrowd-reporting انتخاب VRT، پاراگراف درخواست-شدت و شمارنده‌های بند-OOS را رویش می‌گذارد.
  • ‏اسکیل evidence-hygiene — وقتی شاهد برای پیوست آماده می‌شود. ‏primitive فلوی کار: بدنه‌ی گزارش از این اسکیل است؛ اسکرین‌شات‌ها و HARها از evidence-hygiene برای پاک‌سازی کوکی + PII قبل از پیوست می‌آیند.
  • ‏اسکیل redteam-report-template — وقتی engagement ردتیم خارجی است ‏(نه باگ‌بانتی). ‏primitive فلوی کار: مد engagement را از طریق PART 0 مربوط به bb-methodology تأیید کن؛ اگر ردتیم، این اسکیل را با redteam-report-template عوض کن ‏(مخاطب متفاوت، ساختار متفاوت: ‏Subject / ‏Observations / ‏Description / ‏Impact / ‏Recommendation / ‏PoC).
مراحل استخراج‌شده
  1. ۱‏اسکیل `triage-validation` — وقتی تصمیم می‌گیری اصلاً گزارش بنویسی یا نه. ‏primitive فلوی کار: هرگز این اسکیل را قبل از پاس‌شدن دروازه‌ی ۷-سؤال `triage-validation` باز نکن؛ یافته‌ای که گیت را رد می‌کند باید کشته شود، نه نوشته.
  2. ۲‏اسکیل `bugcrowd-reporting` — وقتی تارگت برنامه‌ی Bugcrowd است. ‏primitive فلوی کار: تمپلیت بدنه‌ی این اسکیل بنیاد است؛ `bugcrowd-reporting` انتخاب VRT، پاراگراف درخواست-شدت و شمارنده‌های بند-OOS را رویش می‌گذارد.
  3. ۳‏اسکیل `evidence-hygiene` — وقتی شاهد برای پیوست آماده می‌شود. ‏primitive فلوی کار: بدنه‌ی گزارش از این اسکیل است؛ اسکرین‌شات‌ها و HARها از `evidence-hygiene` برای پاک‌سازی کوکی + PII قبل از پیوست می‌آیند.
  4. ۴‏اسکیل `redteam-report-template` — وقتی engagement ردتیم خارجی است ‏(نه باگ‌بانتی). ‏primitive فلوی کار: مد engagement را از طریق PART 0 مربوط به `bb-methodology` تأیید کن؛ اگر ردتیم، این اسکیل را با `redteam-report-template` عوض کن ‏(مخاطب متفاوت، ساختار متفاوت: ‏Subject / ‏Observations / ‏Description / ‏Impact / ‏Recommendation / ‏PoC).
۳۹

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

Operator Notes (Claude-BugHunter)
ترجمه‌ی کامل ✓بخش ۳۹ از ۳۹

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

‏افزونه‌های مشتق-از-engagement روی بنیاد vendored. حکمت از engagementهای مجاز واقعی + وریفیکیشن فاز ۲ بین تست‌های زنده‌ی ۳۱+ حوزه‌ی اسکیل این repo. متدولوژی upstream مقدار WHAT را پوشش می‌دهد؛ این لایه مقدار WHEN-IT-ACTUALLY-WORKS و FAILURE-MODES را.
فرمول عنوان در عمل

‏<asset> | <bug class> | <impact> — سه مؤلفه، بدون حشو. ‏triagerها عنوان‌ها را حدوداً در سه ثانیه می‌خوانند و با آن‌ها صف را مرتب می‌کنند:

  • ‏بد: «باگ در صفحه‌ی پروفایل»
  • ‏بد: «‏IDOR یافت شد»
  • ‏خوب: «‏IDOR روی /api/users/{uid} مقدار ایمیل + نقش هر کاربری را افشا می‌کند»
  • ‏خوب: «‏SSRF مربوط به unauthenticated روی /preview?url= ← ‏متادیتای AWS مربوط به 169.254.169.254 reachable»

‏عنوان‌های بد آخر باز می‌شوند. عنوان‌های خوب اول باز می‌شوند. یافته‌ی یکسان، موقعیت متفاوت در صف، روز triage متفاوت، سرعت payout متفاوت.

‏triagerها واقعاً چه می‌خوانند

‏ترتیب خواندنشان روی گزارش تازه:

  1. ‏عنوان ‏(۳ ثانیه)
  2. ‏پاراگراف اول impact / خلاصه ‏(۱۵ ثانیه)
  3. ‏دستور curl یا بلاک درخواست HTTP ‏(۳۰ ثانیه)
  4. ‏گام‌های بازتولید ‏(فقط اگر سه‌تای اول قانع بود)
  5. ‏بقیه‌ی همه‌چیز ‏(فقط در مرور پیگیری)

‏بالای گزارش را بی‌رحمانه بهینه کن. روایت را برای وسط نگه دار. ‏triagerهایی که تا گام ۳ قانع شده‌اند بقیه را مهر می‌زنند؛ آن‌هایی که تا گام ۳ قانع نشده‌اند گام ۵ را نمی‌خوانند.

‏CVSS 3.1 در برابر Bugcrowd VRT در برابر شدت-پیش‌فرض H1

‏این سه سیستم حدود ۳۰٪ مواقع ناسازگارند. رایج‌ترین گپ: یافته‌ای که CVSS 7.x ‏(High) می‌گیرد به Bugcrowd P4 ‏(Low) یا Medium-default مربوط به H1 map می‌شود. وقتی پیش‌فرض پلتفرم از CVSS کمتر است:

  1. ‏پاراگراف درخواست-شدت را به‌عنوان اولین بخش بدنه بنویس. ‏Bugcrowd به این احترام می‌گذارد. ‏(تمپلیت canonical را در bugcrowd-reporting ببین.)
  2. ‏درخواست را به رشته‌ی وکتور CVSS + impact بیزنسی لنگر کن، نه احساسات. «‏CVSS 3.1 AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N = ‏7.5 High چون Confidentiality:High روی افشای داده‌ی بین-tenant صدق می‌کند.»
  3. ‏به ورودی VRT خود پلتفرم که با یافته‌ات match است ارجاع بده. علیه پلتفرم بحث نکن؛ داخلش route کن.

‏یک engagement مجاز باگ‌بانتی یافته‌های P4-default را دید که از طریق پاراگراف درخواست-شدت به P3 رسیدند. ‏escalation خودکار نیست — باید با استدلال grounded در اولین بخش بدنه بخواهی.

چرخش شاهد

‏هر چیز در بدنه‌ی سابمیشن برای همیشه توسط پلتفرم لاگ می‌شود. بر این اساس عمل کن:

  • ‏از اکانت‌های تست throwaway ساخته‌شده مخصوص engagement استفاده کن.
  • ‏کوکی‌ها / توکن‌ها را بعد از هر سابمیشن rotate کن ‏(کوکی پیست‌شده در گزارش را دوباره استفاده نکن).
  • ‏هرگز کوکی‌های production، ایمیل‌های کاربر واقعی یا PII واقعی را در بدنه‌ی گزارش پیست نکن — در گام PoC پاک‌سازی کن.
  • ‏اسکرین‌شات‌های پنل‌های admin: لیست کاربران را بلر کن، نوار URL را اگر توکن دارد بلر کن.

‏به evidence-hygiene برای پروتکل کامل capture-and-redact ارجاع بده.

تمپلیت‌ها per پلتفرم — کِی فرق می‌کنند
پلتفرملحنساختار لازممکانیزم شدت
‏HackerOneروایی‏Summary ← ‏Steps ← ‏Impact ← ‏Suggested fixتنظیم-triager، قابل-اعتراض
‏Bugcrowdساخت‌یافته‏Severity request ← ‏VRT category ← ‏Title ← ‏Body ← ‏Remediation‏VRT-default + پاراگراف override دستی
‏Intigritiبینابین‏Summary ← ‏PoC ← ‏Impact ← ‏Recommendationپیشنهاد-پژوهشگر، تأیید-triager
‏Immunefi‏PoC-اولکد PoC کارکن ← ‏Walkthrough ← ‏Impact ← ‏Severityکد Foundry/Hardhat deliverable اصلی است

‏انتخاب قالب قالب غلط به اعتبار هزینه می‌زند. گزارش Bugcrowd پرروایت نگاشت VRTای که triager نیاز دارد را از دست می‌دهد؛ گزارش H1 ساخت‌یافته خشک خوانده می‌شود و سؤال‌های پیگیری می‌گیرد که payout را به‌تأخیر می‌اندازد.

بزرگ‌ترین اشتباه نگارش گزارش

‏ادعای اینکه حمله «در تئوری» کار می‌کند یا «could be chained to [bigger impact]» بدون نشان‌دادنش. ‏triage-validation Q6 ‏(‏impact فراتر از از-نظر-فنی-ممکن) این‌ها را سمت validation می‌کشد؛ ‏report-writing باید آن را سمت نگارش آینه کند.

‏دو مسیر معتبر:

  1. ‏‏impact عینی سرتاسر نشان بده. زنجیره را روی اکانت تست بگیر. کل دنباله‌ی request/response را پیست کن. تمام.
  2. ‏ادعای شدت را به آنچه واقعاً نشان دادی کم کن. «‏IDOR روی /api/users/{uid} که ایمیل + نقش را می‌خواند» واقعی و گزارش‌پذیر است؛ «‏IDOR زنجیره‌شده به تصرف-بالقوه‌ی admin» نیست تا تصرف را نشان بدهی.

‏یکی را انتخاب کن. هرگز با «could potentially» یا «may allow» نصفه-راه سازش نکن — آن عبارت‌ها سیگنال triager هستند که گزارش نظری است، و گزارش‌های نظری N/A می‌گیرند.

  • ‏اسکیل bb-methodology — وقتی گام نگارش-گزارش فاز ۵ شروع می‌شود. ‏primitive فلوی کار: فاز ۵ مقدار /report را invoke می‌کند که این اسکیل را برای تمپلیت مخصوص-پلتفرم لود می‌کند ‏(H1 / ‏Bugcrowd / ‏Intigriti / ‏Immunefi).