# Burpsuite

Burp Suite is a web proxy tool that can be used to facilitate web Application pentest.\
It comes in a [community free version](https://portswigger.net/burp/communitydownload) or a [paid pro version](https://portswigger.net/burp/pro).\
It has features and extensions that allow you to customize it.\
This course is made from my notes of [Agarri's](https://www.agarri.fr/en/) training (that I highly recommend if you have the opportunity) and notes from my practice.

## Use your own projects settings (burp Pro only)

* Launch burp
* Create a new project and choose "New Project on disk"

![New Project on disk](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-8e37abeb6052daba6653bb91799cf3071bd5500a%2F2024-01-05-09-12-36.png?alt=media)

* Click Next and then select "Load from configuration file"
* Choose your json file and click open

![project settings](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-1774809985a2d50770170cb35016e2a724cc1a86%2F2024-01-05-09-02-39.png?alt=media)

* Check the box "Default to the above in future" (if you need this configuration for your other projects)

![Default for projects](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-1bb5b198c0032977d55713a544cf59d70fe8745a%2F2024-01-05-09-04-38.png?alt=media)

* And then click start

## Use your own users settings

## Regex

Regular expression are really convenient for burp customizations\
You can use [regex101](https://regex101.com/) to familiarize yourself with regex.

> Note: Burp uses Java regex.

## Tips and tricks

### Change body encoding

* Possible to change the body encoder if you want to change a form to multipart. You just need to right clicj on the request and select "Change Body Encoding"

![Change body encoding](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-e3e9ffe0317d7f27509be9c9bd73c0faa40d6524%2F2023-05-23-17-37-58.png?alt=media)

### Choose dedicated RAM amount

* You can do this in `BurpSuitePro.vmoptions`

```bash
# Enter one VM parameter per line
# For example, to adjust the maximum memory usage to 512 MB, uncomment the following line:
# -Xmx512m
# To include another file, uncomment the following line:
# -include-options [path to other .vmoption file]

-XX:MaxRAMPercentage=50
-include-options user.vmoptions
```

### Disable Web interface

To be stealthier, you can disable the web interface (`http://burp`).

### Show help

When you click on `?` you can get the help dedicated to the feature you are currently using. This is also available if you are not connected to internet.

### Rename tab

* You can reaname your tabs. For example in the repeater, you just have to double click on it and you can rename it like this.

![Renamed tab](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-cd4ae468c0a963185a930431bdcad2bb7c06e9a6%2F2023-05-23-17-45-20.png?alt=media)

* You can group tabs together

![Group tabs](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-00dd2a2b4ccc396c043f56f30406b10c4d891422%2F2023-05-23-17-46-58.png?alt=media)

### Useful key shortcuts

> Some of these have to be set up, you can then keep a json file with your settings and export it.

* Switch between top-level tabs `Ctrl Shift (D|T|P|I|R|L|E)`
* Send to a tool, then switch to its tab `Ctrl (R|I) then Ctrl Shift (R|I)` (Here R is for repeater and I for intruder)
* Cycle through 2nd-level tabs `Ctrl Equals and Ctrl Right_Parenthesis`
* Close (and re-open) 2nd-level tabs `Ctrl [Shift] W`
* URL encoding `Ctrl [Shift] U`
* HTML encoding `Ctrl [Shift] H`
* Base64 encoding `Ctrl [Shift] B`
* Close pop-up `Alt F4`
* Colorize (with the last color used) `Ctrl K`
* Add a comment `Ctrl Shift K`
* Copy request as URL `Ctrl Shift C`
* Paste URL as request `Ctrl Shift V`
* Cut | Copy | Paste `Ctrl (X|C|V)`
* Undo | Redo `Ctrl (Z|Y)`
* Select all `Ctrl A`
* Search among 2nd-level tabs `Ctrl Shift S` (Repeater, Intruder and Collaborator)
* Jump to the search field `Ctrl Tab`
* Search for the highlighted text `Ctrl S`
* Go to the (previous|next) match `Ctrl (Left|Right)`
* Go to top \[and extend selection] `Ctrl [Shift] Home`
* Go to bottom \[and extend selection] `Ctrl [Shift] End`

#### Repeater

* Issue request `Ctrl G`
* Paste URL as request `Ctrl Shift V`
* Use the history `Ctrl Shift (Left|Right)`

#### Intruder

* Start attack `Ctrl Space`
* Add payload position marker `Ctrl M`
* Clear all markers `Ctrl Shift M`

#### Scanner

* Open scan launcher `Ctrl Shift Space`
* Open launcher with selected insertion point `Ctrl Shift Enter`

#### Collaborator

* Switch to Collaborator `Ctrl Shift O`
* Insert unique Collaborator payload `Ctrl O`

#### Proxy Interception

* Switch interception status `Ctrl T`
* Drop message `Ctrl D`
* Forward message `Ctrl F`
* Forward request + intercept response `Ctrl Shift F`

### Color lines

You can color line in the history just by clicking on the id and choosing which color

### Match and replace rules

#### Possible use cases

* Make authentication easier
* Write `XSS` instead of the actual payload
* Disable CSP reporting (useful for bug bounties)

![Disable CSP reporting](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-7e6e65c864231dfdb37727086224e30a59fa49d9%2F2023-05-23-18-19-25.png?alt=media)

#### 304 NOT MODIFIED

* You can check these in `match replace rules` to avoid `304 NOT MODIFIED`

![Match replace](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-0b9206271b1914fec117d1e58cab42bc71fead92%2F2023-05-23-18-13-12.png?alt=media)

#### Fallback to XHR

"When initializing a WebSocket connection \[...] the server will respond with a HTTP/1.1 101 header. Using Burp, you can use a match and replace rule in the proxy settings to change the response to a HTTP 500.\
This will trick the client into believing that the WebSocket connection is not supported and force it to fall back to XHR."

> Sean de Regge quoted by Agarri\_fr

### Export

We can export just the repeater part of a burp project

### Burp wordlist

In Burp's wordlist de burp there are placeholders like this `{base}`\
We have to change in payload processing and choose the value for the placeholder.

### Burp authentication failures

_If the application you are testing uses platform authentication (which normally shows as a popup login dialog within your browser), and you get authentication failure messages when your browser is configured to use Burp, then you need to configure Burp to handle the platform authentication instead of your browser._\
&#xNAN;_&#x47;o to the User options > Connections tab, and the Platform Authentication section._\
&#xNAN;_&#x41;dd a new entry for each hostname used by your application, configuring the authentication type and your credentials._\
&#xNAN;_&#x49;f you aren't sure of the authentication type, then first try NTLMv2, then NTLMv1, and then the other types._\
&#xNAN;_&#x59;ou may need to close all browser windows and open a new browser window, to prevent any browser caching from interfering with the authentication process._\
&#xNAN;_&#x43;heck that you are not overriding these settings in the Project options > Connections tab._

[Source](https://portswigger.net/burp/documentation/desktop/troubleshooting)

Check out this article that explains how to set up [ntlm authentication on burp](https://portswigger.net/support/configuring-ntlm-with-burp-suite)

### Auth failure because of TLS certificate not trusted

* If you get this error\
  ![image](https://user-images.githubusercontent.com/96747355/186006726-17dde00d-57a4-4ec4-bcc5-78f9f1e9fa3e.png)\
  ![image](https://user-images.githubusercontent.com/96747355/186006632-bc0f20f9-a0af-4775-8b0a-b1a7b346183c.png)
* You might need to set up owasp zap as upstream proxy. Check out [this article on nettitude labs](https://labs.nettitude.com/tutorials/how-to-fix-burp-suite-ssltls-connection-problems/) to set it up.

## Burp confidence Level explained

* Certain: The issue is definitely present.
* Firm: The issue is probably present, but this could be a false positive.
* Tentative: The issue is potentially present but there is a high chance that this could be a false positive.
* [Source](https://forum.portswigger.net/thread/issue-type-certain-confirm-and-tentative-what-does-this-mean-b01d4f6d)

## Tool to optimize burp scan

* [Burp suite pro scan profiles](https://github.com/TheGetch/Burp-Suite-Pro-Scan-Profiles) is a tool to optimize your burp scan and make them focus on specific vulnerabilities

## Discover Content

Go to Target -> Site map -> Right Click on target -> Engagement tools -> Discover content

It can be useful and less time consuming to select a specific endpoint and the root of the server.

![Discover content](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-7c30abeb4ad0830e788eeba16e9ef8fe508f5283%2F2024-01-12-16-00-08.png?alt=media)

Add the settings you wish (Make sure that this option is checked "Add discovered content to suite site map" ) and then click on "Session is not running".

### More infos on discover content

* [Burpsuite - Lisandre: scroll straight to "Spider / Discover Content (hidden pages or directories)"](https://lisandre.com/cheat-sheets/burp-suite#target)
* [How good is Burp’s API Scanning? - Chandrapal Badshah](https://medium.com/burpsuite-guide/how-good-is-burps-api-scanning-558eaea8bddf)

## Tips on specific attacks

### Brute force Basic Authorization token

Basic Authorization tokens are based on token containing a `user:password` encoded in base64.\
To make a bruteforce attack on this token:

1.  Take a request with an auth token and send it to the intruder

    ![Send to intruder](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-9e5c098bf873542a1fb9fdab8f62539d06040db4%2F2023-10-27-18-13-03.png?alt=media)
2.  Decode the token from base64

    ![Decode base64](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-48776ad8d07a9fa1333d6e25cdc262b3625c9874%2F2023-10-27-18-14-29.png?alt=media)
3.  Add it as a variable

    ![Add variable](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-faa3acb2fd3a59eadfc3eff533eab1578feecf95%2F2023-10-27-18-15-56.png?alt=media)
4.  Go to the payload tab. You can choose brute forcer or simple list or whichever you prefer to generate the password

    ![Payload type](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-35b26135f7f3dba82d9d50ff339bbd245778ad48%2F2023-10-27-18-18-41.png?alt=media)
5.  The most important thing is to first add a prefix through payload processing rules

    ![Prefix](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-5606ab46d1782a5dc7c9bf49fe2d243eb61d4725%2F2023-10-27-18-20-05.png?alt=media)
6.  And then add another rule to encode the payload in base64

    ![Encode](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-6c12f3d19982859079b7244f07b6abe7428176b8%2F2023-10-27-18-20-48.png?alt=media)
7.  Remove the `=` signe in the payload encoding

    ![Remove =](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-4989aa8b061dace13674963ca423670d38a2ee74%2F2023-10-27-18-21-57.png?alt=media)
8. Start the attack

> Source: [whitelist1.com](https://www.whitelist1.com/2018/04/http-basic-authentication-bruteforce.html)

## Extensions

### wsdler

If we have find a wsdl file we can parse it: `right click (in the request) > wsdler > parse wsdl`

### Jwteditor

* works like jwt.io

### Logger++

* Very convenient for API search
* Grep Values

### Hackvertor

* Replacement of the built-in Decoder
* You can set variable to gain time
* You can accumulate multiple conversions using xml-like tags

#### Use variables

* Creation

```xml
<@set_varname(false|true)>foobar<@/set_varname>
```

> If the parameter is set to `true` , then the variable is global

* Usage

```xml
<@get_varname/>
```

### Request minimizer

Very useful for a report and CSRF. It is going to remove everything that does not alter the response

### Paramalyzer

Very convenient for big scopes. You will get a lits of parameters

![Paramalyzer](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-55b624c597b0c3b21c5c14369a99c8fe2b8c41fb%2F2023-05-23-18-41-39.png?alt=media)

### Auth Analyzer

* One of my personal favorites :D
* You set up a basic user for the extension
* You connect with an admin user (this way you can access more things)
* You browse
* The extension will parallel browse and check if it can access everything you look at
* It sets variables and you can also use a var for a csrf token this way you can check if it actually prevents csrf

![Variables](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-4a0f4a9199036dd8b855f85249f6180f19661ae2%2F2023-05-23-18-44-45.png?alt=media)

* It can also be useful to add a non authenticated user you just need to add a fake cookie like this

![fake cookie](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-fd87c8e913ae7024feee4acc7aa2da194936a58a%2F2023-05-23-18-45-45.png?alt=media)

* As the browing is done in parallel it is perfect to avoid generating too much traffic.
* In the end we get results as below and we can compare which user can access what.

![results](https://1679624655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEkk28J0B2BeDMuesRMr1%2Fuploads%2Fgit-blob-1e7adeb5a39aa8c9ec965305f00e1f00136e7c27%2F2023-05-23-18-47-32.png?alt=media)

> The original tab is the one with the traffic I generated and the others are for the other users

### Other useful burp Extensions

* [SAML Raider](https://portswigger.net/bappstore/c61cfa893bb14db4b01775554f7b802e)
* [Retire.js](https://github.com/retirejs/retire.js/)
* [Backslash Powered Scanner](https://portswigger.net/bappstore/9cff8c55432a45808432e26dbb2b41d8)
* [JSON Web Token Attacker](https://portswigger.net/bappstore/82d6c60490b540369d6d5d01822bdf61)
* [Autorize](https://portswigger.net/bappstore/f9bbac8c4acf4aefa4d7dc92a991af2f)
* [Scan manual Insertion point](https://portswigger.net/bappstore/ca7ee4e746b54514a0ca5059329e926f)

## Resources

### Blogs and references

{% embed url="https://www.agarri.fr/docs/nsec23-burp_tips_n_tricks.pdf" %}
Tips and tricks for Burp Suite Pro - Agarri
{% endembed %}

{% embed url="https://dustri.org/b/detecting-and-annoying-burp-users.html" %}
Detecting and annoying Burp users by J. Voisin
{% endembed %}

### Practice

{% embed url="https://portswigger.net/web-security" %}
Web Security Academy - Portswiger
{% endembed %}

### Wordlists

{% embed url="https://wordlists.assetnote.io/" %}
Assetnote Wordlists
{% endembed %}
