Home
Cybersecurity & AI Security / Part 43 — Writing Reports That Get Paid

Writing Reports That Get Paid

CAP, ACID vs BASE, latency numbers, back-of-envelope estimation, single points of failure — the vocabulary every system designer thinks in.


Core Philosophy: In bug bounty, you are not paid for finding a vulnerability. You are paid for communicating a vulnerability so clearly and convincingly that the company can understand it, reproduce it, grasp its impact, and fix it. The report is not paperwork that follows the work — the report is the product you sell. A brilliant finding in a poor report earns little or nothing. An equally good finding in an excellent report earns full value. This page is the craft of the report.

Part 1: The Problem

Across 5A.1–5A.3 you learned to choose programs, hunt deeply, and find what others miss. But here is the truth that newcomers underestimate most: all of that effort converts to income only through the report.

The company never watched you find the bug. They receive only your report. From that document alone, they must: understand what the vulnerability is, reproduce it themselves, assess how severe it is, and decide what to pay. If the report is unclear, they cannot reproduce it (rejected — 5A.1). If it fails to convey impact, it is rated — and paid — lower than it deserves. If it is unprofessional, it damages your reputation.

This was previewed in 2.11: “the report is the deliverable.” In bug bounty that is literally and economically true — the report is the product. This page is how to write one that gets paid.

Part 2: The Concept — What the Report Must Achieve

A bug bounty report has a specific job: get a busy triager and a busy security team, who never saw your work, to fully understand and act on your finding. To do that, every report must achieve four things:

text
   1. UNDERSTAND  — they grasp exactly what the vulnerability is
   2. REPRODUCE   — they can make it happen themselves, exactly
   3. APPRECIATE  — they grasp the real-world IMPACT (→ severity → reward)
   4. FIX         — they know how to remediate it

Each maps to a known failure (5A.1’s rejection reasons): fail (1) and it is “insufficient information”; fail (2) and it is “not reproducible” — rejected; fail (3) and it is under-rated and under-paid; fail (4) and you have given them less than a complete, professional report.

A report that achieves all four is a report that gets paid its full value. Notice this is the same structure as a pentest finding (2.11) — title, severity, description, reproduction, evidence, impact, remediation — because a bug bounty report is a single, polished pentest finding. You already learned the shape; this page is about doing it excellently, because here it is the product.

Part 3: The Concept — The Anatomy of a Strong Report

A strong bug bounty report contains these components. (Platforms provide templates; the components are consistent.)

A clear, specific title. States the vulnerability type and where it is — e.g. the bug class and the affected component. A triager should know roughly what they are looking at from the title alone. Vague titles signal a vague report.

A concise summary. A short, plain-language statement of what the vulnerability is and why it matters — readable quickly by someone who has not yet dug in.

Severity / risk assessment. Your assessment of how serious it is — using the risk thinking (likelihood × impact, 1.1) and severity rating you learned in 2.11. Justified, not just asserted. (The company makes the final call, but a well-reasoned severity assessment frames it.)

Affected asset and scope confirmation. Exactly which in-scope asset is affected — confirming, implicitly, that you tested within scope (5A.1).

Reproduction steps. The single most important section. Precise, numbered, complete steps that let the team reproduce the vulnerability exactly. Every detail needed, nothing assumed. If they cannot follow your steps and see the bug themselves, the report fails — regardless of how real the bug is. Detailed in Part 4.

Proof of concept (PoC) and evidence. Supporting proof that the vulnerability is genuine — request/response captures, screenshots, a demonstration. Minimal and safe (the confirm-don’t-pillage discipline from Phase 2 — never include real user data you accessed; redact anything sensitive).

Impact. A clear explanation of what a real attacker could actually achieve — the realistic, concrete consequence. This is what drives severity and therefore reward. Detailed in Part 5.

Remediation guidance. Clear, actionable advice on how to fix it — drawing directly on your Phase 4 defensive knowledge. This is where being a purple practitioner pays off: you do not just report the attack, you help them defend. It marks you as professional and is genuinely valued.

Part 4: The Concept — Reproduction Steps, the Make-or-Break Section

Reproduction steps deserve their own focus, because more reports fail here than anywhere else.

The standard a triager applies: “Can I, following only this report, make the vulnerability happen myself?” If yes, your report can proceed. If no, it is rejected as not reproducible — even if the bug is completely real.

What makes reproduction steps excellent:

text
   ❌ WEAK:  "There's an IDOR in the invoice feature, just
              change the ID and you get other users' invoices."
              → triager cannot reproduce precisely → rejected

   ✅ STRONG: numbered steps — log in as [test account], navigate
              to [exact location], capture [exact request],
              change [exact parameter] from X to Y, observe
              [exact result] — with evidence at the key step.
              → triager reproduces it exactly → proceeds

A report whose reproduction steps are excellent has cleared the highest bar between you and a reward.

Part 5: The Concept — Articulating Impact

If reproduction steps decide whether you get paid, impact largely decides how much.

Reward scales with severity, and severity is driven by demonstrated real-world impact (5A.1, and the risk thinking of 1.1). A vulnerability described only as a technical quirk gets a low rating. The same vulnerability, with its real-world consequence clearly articulated, gets rated — and paid — for what it actually is.

How to articulate impact well:

The skill: make the company see the real consequence of your finding — clearly, demonstrably, and honestly.

Part 6: The Concept — Professionalism and the Triage Relationship

A report is not only a technical document — it is a professional communication, and bug bounty is an ongoing professional relationship. Two final framings.

Professionalism in the report and after.

Reputation is the long game. Every report contributes to your reputation on a platform (5A.1). A track record of clear, honest, professional, valid reports builds the reputation that unlocks private programs, better targets, and a sustainable practice (5A.5). Poor or dishonest reports do lasting damage. Each report is both an income event and a deposit into your professional standing.

🔑 The deep lesson: in bug bounty the report is the product. Finding the bug is half the work; communicating it — so the company can understand, reproduce, appreciate the impact, and fix it — is the half that actually gets paid. Excellent reproduction steps clear the rejection bar; well-articulated, honest impact drives the reward; professionalism builds the reputation that compounds into a real career. Treat every report as the deliverable it is.

📓 Key Terms

Term Plain meaning
Bug bounty reportThe document communicating a vulnerability — the actual product sold.
Reproduction stepsPrecise, numbered, complete steps to reproduce the vulnerability — the make-or-break section.
Proof of concept (PoC)Minimal, safe evidence that the vulnerability is genuine.
ImpactThe real-world consequence of the vulnerability — drives severity and reward.
Severity assessmentYour reasoned rating of how serious the finding is (likelihood × impact).
Remediation guidanceActionable advice on how to fix the vulnerability.
TriageThe company/platform process of validating and assessing a report.
ReputationA researcher’s accumulated track record — built report by report.

🧪 Hands-On Lab

Practice report-writing on findings from deliberately vulnerable apps, practice platforms, and CTFs — and on real findings from authorized programs. The skill is the writing; practice it on legal findings of any kind.

Task 1 — Study real reports. Read several responsibly-disclosed bug bounty reports (the disclosed reports from 5A.2). This time, study them as writing: how is the title phrased? how clear are the reproduction steps? how is impact articulated? Note what makes the strong ones strong.

Task 2 — Write a full report for a lab finding. Take a vulnerability you found in a deliberately vulnerable app (Phase 2 or 5A.2 labs). Write a complete bug bounty report with every component from Part 3 — title, summary, severity, affected asset, reproduction steps, PoC/evidence, impact, remediation.

Task 3 — Stress-test your reproduction steps. Take the report from Task 2. Walk through your own reproduction steps as if you knew nothing else about the finding. Find every gap, ambiguity, and assumed step. Rewrite until the steps are complete and self-contained.

Task 4 — Write up a chain. Take the chain you built in the 5A.2 lab. Write it as a report that demonstrates the escalated impact — showing how the combined findings produce a serious, concrete consequence. Practice articulating impact powerfully and honestly.

Task 5 — Practice impact articulation. Take three lab findings. For each, write two impact statements: a weak “technical quirk” version, and a strong “real-world consequence” version. See the difference clearly — this is what moves severity and reward.

Task 6 — Write the remediation sections. For each lab finding, write clear remediation guidance using your Phase 4 knowledge. Practice being the purple practitioner who reports the attack and the fix.

Task 7 — Build a report template. In Notion, create your own bug bounty report template with all the Part 3 components and notes-to-self on doing each well. You will reuse this for every real submission — and a good template makes every report faster and more consistent.

⚠️ Common Mistakes

✅ Recap & What’s Next

Next (5A.5): You can now choose programs, recon at scale, hunt deeply, and report professionally. The final page turns these skills into a sustainable practice — managing the irregular income, the workflow, the burnout risk, and the long game of a real bug bounty career.

⁂ Back to all modules