Burp Suite tutorial from scratch: what it is, installing and configuring the proxy (127.0.0.1:8080 + CA certificate), Proxy/Intercept, Repeater, Intruder, Decoder, useful extensions, Community vs Pro and a real hunting workflow.
Gorka El Bochi
Founder of BBLABS
Quick answer: Burp Suite is the essential tool for web bug bounty: a proxy that sits between your browser and the server so you can see, intercept and modify every HTTP request. You install it for free (Community edition), configure the browser to route through
127.0.0.1:8080, import its CA certificate to see the HTTPS, and you're ready to hunt with Repeater and Intruder.
Burp Suite is an intercepting proxy for web security testing, developed by PortSwigger. It sits in the middle of the conversation between your browser and the server: all the HTTP/HTTPS traffic passes through Burp, where you can see it, pause it, edit it and resend it before it reaches its destination.
That's exactly what you need to hack a website: to stop being limited to what the interface lets you do and start talking directly to the server, changing parameters, headers, cookies and request bodies at will.
It is, without question, the central tool of almost every web bug bounty hunter. If you're only going to learn one tool, make it this one.
Download Burp Suite Community Edition (free) from the official PortSwigger website and install it. It needs Java, but the official installer already includes it. Launch Burp and create a temporary project ("Temporary project") with the default settings ("Use Burp defaults").
By default, Burp's proxy listens on 127.0.0.1:8080. Confirm it in Proxy → Proxy settings (or Options in older versions): an active listener should appear at that address.
Now you have to tell your browser to send traffic there. Two options:
127.0.0.1:8080. That way you switch between "Burp proxy" and "direct connection" with one click.If you try to browse an HTTPS site with the proxy active, the browser will give you a certificate error. That's normal: Burp needs its own certificate to be able to "open" the encrypted traffic.
1. With the proxy active, visit http://burp in the browser
2. Click "CA Certificate" and download the cacert.der file
3. Import it into your browser as a trusted authority:
- Firefox: Settings -> Certificates -> Import -> check "trust for websites"
- Chrome/OS: add it to the "Trusted Root Certification Authorities" store
With Burp's embedded browser, this step is already done. From here on you'll see all the HTTPS traffic in the clear.
Burp is a suite: several tools that work together. These are the ones you'll actually use as a hunter.
The heart of Burp. In Proxy → Intercept, when you enable "Intercept is on", each request is paused before leaving and you can edit it by hand:
POST /api/login HTTP/1.1
Host: target.com
Content-Type: application/json
{"user":"admin","password":"123456"}
Change whatever you want and hit Forward to send it, or Drop to discard it. In Proxy → HTTP history you have the log of everything that's passed through Burp, even if it wasn't intercepted: it's where you review endpoints, parameters and responses calmly.
Your best friend. Repeater lets you resend the same request over and over, modifying it each time, to test hypotheses. Right-click on any request → "Send to Repeater" (or Ctrl+R).
It's where you manually test an IDOR (change an ID and see the response), an authentication bypass or an injection payload. You edit, hit Send, read the response, adjust. The basic cycle of manual hunting lives here.
For automating the sending of many requests while varying one part. You mark the payload position with §:
GET /api/users/§1§/profile HTTP/1.1
Host: target.com
Authorization: Bearer YOUR_TOKEN
With a payload of numbers from 1 to 1000, Intruder iterates on its own and tells you which IDs return 200 with data: perfect for discovering an IDOR at scale, fuzzing parameters or testing lists of values. The Community version limits Intruder's speed (throttling); Pro unlocks it.
eyJhbGciOi..., decode it and read the payload.In Extensions → BApp Store you have dozens of extensions. The ones that show up most in a web hunter's arsenal:
The obligatory question. The practical difference:
| Capability | Community (free) | Professional (paid) |
|---|---|---|
| Proxy, Repeater, Decoder, Comparer | Yes | Yes |
| Intruder | Yes, but speed-limited | Full, no throttling |
| Vulnerability scanner | No | Yes (automated) |
| Save projects | No | Yes |
To get started, Community is more than enough. You can learn absolutely everything with the free version. Pro pays off when you already do this seriously and the slow Intruder or the lack of a scanner start costing you real time (and money). Don't buy it on day one.
How it all fits into a typical session:
That loop —observe in the history, hypothesis in Repeater, scale in Intruder— is 90% of the job. Internalizing it takes repetition: practice it with the theory in the Academy and by reproducing real flaws in the labs, where every request you intercept corresponds to a genuinely documented bug.
Beyond the Proxy/Repeater/Intruder/Decoder quartet, Burp comes with utilities that save you work:
You don't have to master all of them from day one. Start with Proxy and Repeater; you'll pick up the rest when a specific case calls for it.
The stumbles that repeat for everyone who starts out:
Internalize the workflow calmly and Burp will go from overwhelming to essential. The best way to practice it is on real cases: every BBLABS lab is a request to intercept and a flaw to confirm.
Is Burp Suite legal?
The tool is 100% legal. What matters is what you use it against: you can only intercept and attack systems you're authorized for (a bug bounty program, a contracted pentest or your own labs).
Burp or OWASP ZAP?
ZAP is the free and open alternative, very capable. But Burp is the de facto industry standard and almost all training and writeups assume Burp. Learn Burp first.
Can I do bug bounty with just the Community version?
Yes. Many hunters started (and earned their first bounties) with Community. Pro accelerates, it doesn't enable.
Why doesn't it intercept HTTPS?
Almost always it's the CA certificate not being imported. Repeat the http://burp → download and import cacert.der step, or just use Burp's embedded browser.
Burp Suite is the tool that turns "using a website" into "talking to the server". Install it, configure the proxy on 127.0.0.1:8080, import the CA certificate and learn the Proxy → Repeater → Intruder loop until it's automatic. You don't need the Pro version to get started, nor to know everything at once: you need to practice it with real cases. Internalize the workflow by reproducing labs of real flaws backed by the theory in the Academy, and Burp will stop being an intimidating menu and become an extension of your hands.
hunters training
labs from real reports
completions
in bounties practiced
Create your free account and practice on labs based on real reports that paid out thousands of euros. The Academy is free forever.
No card · free Academy · cancel anytime
Learn to identify and exploit IDOR (Insecure Direct Object Reference) vulnerabilities in web applications. From the basics to writing effective reports.
Everything you need to build a professional bug bounty setup: from choosing your operating system to automating reconnaissance.
A complete guide to getting started on HackerOne: from creating your account to submitting your first vulnerability report. Tips for beginners.