Pre-requisite

How do I set up Burpsuite?

To add Burpsuite into the Uleska Platform, there are 3 main steps:

1. Setup the API and key on your Burpsuite instance
2. Configure a connection in the Uleska Platform to interact with your Burpsuite instance
3. Add the Burpsuite tool into your application and version toolkit

Setup the API and key on your Burpsuite instance

For the first step, given you wish to run Burpsuite as part of your pipeline, you will have Burpsuite running on a server you control. This instance will have network access to the running systems you wish to test. It will also be accessible to the Uleska Platform so it can send instructions and retrieve results from the API, as follows:

• If you have the Uleska Platform installed on-site, you can configure your network security as relevant.
• If you are using a dedicated cloud tenant provided by Uleska, then we will have communicated the relevant IP addresses to you during setup.
• If you are using the cloud version of the Uleska Platform, you can allocate the Uleska cloud IP addresses.  Contact Uleska to obtain the IP address for your account.

On your Burpsuite installation, you will then setup an API key for Uleska to communicate. The source PortSwigger blog for this can be found at https://portswigger.net/blog/burps-new-rest-api , however the steps are as follows:

• Open BurpSuite
• Open a New Project
• Navigate to User options and then Misc
• Navigate to the REST API section
• Enable the 'Service running' option
• Change the Service URL to bind to all interfaces, or a specific interface on the host that will be accessible
• Scroll down to the API Keys section and select 'New' to add a new key
• Call the key 'Uleska' (for tracking purposes) and copy the API key value to your clipboard. Keep it so you can add it to the Uleska Platform.

Configure a connection in the Uleska Platform to interact with your Burpsuite instance

Now that you have your BurpSuite running with API enabled, let's get the Uleska Platform to talk to it.

• In the Uleska Platform, click on the Configuration menu and select the 'Connections' tab
• Click on 'Add Connection'
• From the drop down list, select 'BurpSuite'
• Add the URL of your BurpSuite instance, which will likely be the IP address (or hostname if configured) of the server hosting BurpSuite, and port 1337 (or other value if you changed it)
• For the API key, add the copied key you took when setting up the API key above.
• Click 'Save'

Add the Burpsuite tool into A toolkit

Now the Uleska Platform is setup to allow any project to be dynamically tested with your BurpSuite tool. Let's show you how to setup your applications and versions to run this.

Your version configuration will be setup for dynamic testing. Go to the dynamic documentation page to see how to set this up for any dynamic testing.

To add the BurpSuite tool into a Toolkit,

• Create a new Toolkit (or edit an existing one) by following the Creating a Toolkit guide and selecting 'Burp Suite' as a tool.

• Click Save.

Now any time you click 'Test Now' with that Toolkit, or make a request over the Uleska API or CLIwith that Toolkit, the BurpSuite tool will be included in the test run which will start a spider and security scan of the Uri for the configured version. Any results added to your vulnerabilities list.

Notes

None