BurpSuite is a collection of tools to carry out pen testing or security auditing.  This tutorial focuses on the Community version, the free one, which features Proxy, Intruder, Repeater, Sequencer, Comparer, Extender and Decoder tools.

This tutorial shows how to install BurpSuite on Debian, how to setup your browser (in this tutorial I only show how to setup it on Firefox) and SSL certificate and how to capture packets without previous proxy configuration on the target by combining it with ArpSpoof and configuring the Invisible Proxy to listen.

To begin installing BurpSuite visit and select the Get Community option (the third one) to get BurpSuite for free.

BurpSuite Tutorial for Beginners Security

In the next screen click on “Download the latest version” orange button to continue.

BurpSuite Tutorial for Beginners Security

Click on the green Download button.

BurpSuite Tutorial for Beginners Security

Save the .sh script and give it execution permissions by running:

In this case for the current version at this date I run:

# chmod x burpsuite_community_linux_v2020_1.sh

BurpSuite Tutorial for Beginners Security

Once the execution rights were given execute the script by running:

# ./burpsuite_community_linux_v2020_1.sh

A GUI installer will prompt, press on “Next” to continue.

BurpSuite Tutorial for Beginners Security

Leave the default installation directory (/opt/BurpSuiteCommunity) unless you need a different location and press Next to continue.

BurpSuite Tutorial for Beginners Security

Seek “Create Symlink” selected and leave the default directory and press Next.

BurpSuite Tutorial for Beginners Security

The installation process will start:

BurpSuite Tutorial for Beginners Security

Once the process ends click on Finish.

BurpSuite Tutorial for Beginners Security

From your X-Window manager apps menu select BurpSuite, in my case it was located on the category “Other”.

BurpSuite Tutorial for Beginners Security

Decide if you wish to share your BurpSuite experience or not, click I Decline, or I Accept to continue.

BurpSuite Tutorial for Beginners Security

Leave Temporary Project and press Next.

BurpSuite Tutorial for Beginners Security

Leave Use Burp defaults and press Start Burp to launch the program.

BurpSuite Tutorial for Beginners Security

You’ll see BurpSuite main screen:

BurpSuite Tutorial for Beginners Security

Before proceeding, open firefox and open http://burp.

A screen similar to the shown below will show up, on the upper right corner click on CA Certificate.

BurpSuite Tutorial for Beginners Security

Download and save the certificate.

BurpSuite Tutorial for Beginners Security

On the Firefox menu click on Preferences, then click on Privacy and Security and scroll down until you find the Certificates section, then click on View Certificates as shown below:

BurpSuite Tutorial for Beginners Security

Click on Import:

BurpSuite Tutorial for Beginners Security

Select the certificate you got previously and press Open:

BurpSuite Tutorial for Beginners Security

Click on “Trust this CA to identify websites.” and press OK.

BurpSuite Tutorial for Beginners Security

Now, still on the Firefox Preferences menu click on General in the menu located in the left side and scroll down until reaching Network Settings, then click on Settings.

BurpSuite Tutorial for Beginners Security

Select Manual Proxy Configuration and in the HTTP Proxy field set the IP 127.0.0.1, checkmark the “Use this proxy server for all protocols”, then click OK.

BurpSuite Tutorial for Beginners Security

Now BurpSuite is ready to show how it can intercept traffic through it when defined as proxy. On BurpSuite click on the Proxy tab and then on the Intercept sub tab making sure intercept is on and visit any website from your firefox browser.

The request between the browser and the visited website will go through Burpsuite, allowing you to modify the packets as in a Man in the Middle attack.

BurpSuite Tutorial for Beginners Security

The example above is the classical Proxy feature show for beginners. Yet, you don’t always can configure the target’s proxy, if you did, a keylogger would be more helpful than a Man In the Middle attack.

Now we will use DNS and the Invisible Proxy feature to capture traffic from a system we can’t configure the proxy on.

To begin run Arpspoof (on Debian and based Linux systems you can install with through apt install dsniff)Once installed dsniff with arpspoof, to capture packets from the target to the router on the console run:

# sudo arpspoof -i <Interface-Device> -t <Target-IP> <Router-IP>

BurpSuite Tutorial for Beginners Security

Then to capture packets from the router to the target run in a second terminal:

# sudo arpspoof -i <Interface-Device> -t  <Router-IP> <Target-IP>

BurpSuite Tutorial for Beginners Security

To prevent blocking the victim enable IP forwarding:

# echo 1 > /proc/sys/net/ipv4/ip_forward

BurpSuite Tutorial for Beginners Security

Redirect all traffic to port 80 and 443 to your device using iptables by running the commands below:

# sudo iptables -t nat -A PREROUTING -p tcp –dport 80 -j DNAT –to-destination


192.168.43.38

# sudo iptables -t nat -A PREROUTING -p tcp –dport 443 -j DNAT –to-destination


192.168.43.38

BurpSuite Tutorial for Beginners Security

Run BurpSuite as root, otherwise some steps like enabling new proxies on specific ports won’t work:

# java jar Xmx4g /opt/BurpSuiteCommunity/burpsuite_community.jar

BurpSuite Tutorial for Beginners Security

If the following warning appears press OK to continue.

BurpSuite Tutorial for Beginners Security

Once BurpSuite is open, click on Proxy>Options and click on the Add button.

BurpSuite Tutorial for Beginners Security

Select 80 and on Specific address select your Local network IP address:

BurpSuite Tutorial for Beginners Security

Then click on Request handling tab, checkmark Support Invisible proxying (enable only if needed) and press OK.

BurpSuite Tutorial for Beginners Security

Repeat the steps above now with port 443, click on Add.

BurpSuite Tutorial for Beginners Security

Set the port 443 and again select your local network IP address.

BurpSuite Tutorial for Beginners Security

Click on Request Handling, checkmark support for invisible proxying and press OK.

BurpSuite Tutorial for Beginners Security

Mark all proxies as running and as invisible.

BurpSuite Tutorial for Beginners Security

Now from the target device visit a website, the Intercept tab will show the capture:

BurpSuite Tutorial for Beginners Security

As you can see you managed to capture packets without previous proxy configuration on the target’s browser.

I hope you found this tutorial on BurpSuite useful. Keep following LinuxHint for more tips and updates on Linux and networking.

About the author

BurpSuite Tutorial for Beginners Security

Ivan Vanney

Ivan Vanney has over 2 years as writer for LinuxHint, he is co-founder of the freelance services marketplace GIGopen.com where he works as a sysadmin.