Support Center

Burp Community

See what our users are saying about Burp Suite:

How do I?

New Post View All

Feature Requests

New Post View All

Burp Extensions

New Post View All

Bug Reports

New Post View All

Burp Suite Documentation

Take a look at our Documentation section for full details about every Burp Suite tool, function and configuration option.

Full Documentation Contents Burp Projects
Suite Functions Burp Tools
Options Using Burp Suite

Burp Extender

Burp Extender lets you extend the functionality of Burp Suite in numerous ways.

Extensions can be written in Java, Python or Ruby.

API documentation Writing your first Burp Suite extension
Sample extensions View community discussions about Extensibility
  1. Support Center
  2. BApp Store
  3. Add Custom Header

Add Custom Header

Add or update custom HTTP headers from session handling rules. This is especially useful for JSON Web Tokens (JWT).

Basic usage, with a hard-coded value:

  1. Select the Add Custom Header tab and enter the header name and hard-coded value.
  2. Select Project Options -> Sessions
  3. Add a Session Handling rule
  4. Name it and select Add, Invoke a Burp Extension extension
  5. Make sure the scope is correct. If you're just trying this out, you can use Include all URLs, but set a proper scope for regular use.
  6. Select the Add Custom Header option from the list in the following screen

You can also use a dynamic value. In this case:

  1. Record a macro that fetches the dynamic value
  2. In the session handling rule, create an action to Run a macro and select the macro
  3. Enable After running the macro, invoke a Burp extension action handler and select Add Bearer Token
  4. In Add Customer Header enter a regular expression that extracts the value from the macro response
Author Lorenzo Grespan
Version 1.0
Last updated 18 September 2018

You can install BApps directly within Burp, via the BApp Store feature in the Burp Extender tool. You can also download them from here, for offline installation into Burp.

Download BApp

Please note that extensions are written by third party users of Burp, and PortSwigger Web Security makes no warranty about their quality or usefulness for any particular purpose.

Go back to BappStore