1. Support Center
  2. Documentation
  3. Enterprise Edition
  4. Getting started
  5. Deploying to the cloud
  6. Azure

Deploying Burp Suite Enterprise Edition on Azure

You deploy Burp Suite Enterprise Edition on Azure using the provided Azure Resource Manager template. This will also create the basic cloud environment. However, before you start the deployment process, you need to set up an external database for storing data from Burp Suite Enterprise Edition.

Set up your database

When running Burp Suite Enterprise Edition on the cloud, you need to use an external database. You can use any of our supported external databases. For beta testing, we recommend using one of Azure's dedicated services for your preferred database.

  1. Use the corresponding Azure database service to create an instance of your preferred database.
  2. Follow the instructions for setting up an external database. Make a note of the JDBC URL format. You will need to enter this in the Azure Resource Manager template later.
  3. Configure the network security settings to allow Burp Suite Enterprise Edition's IP address subnet to access the database. You can find the default allocated subnet (10.0.0.0/16) in the Azure Resource Manager template. Note that if you override this default, you will need to adjust the network security settings accordingly.

Deploy Burp Suite Enterprise Edition on Azure

You can deploy Burp Suite Enterprise Edition on Azure using the Azure Cloud Shell. The Azure Resource Manager template contains a list of parameters that you can control. Some of these have a default value that will be used automatically unless you override it.

During the setup process, you will be prompted to enter a value for each parameter that does not have a default value assigned. Alternatively, you can create a separate parameters.json file to either override the default values or to avoid having to enter each value separately in the command line.

Note: These instructions assume that you are happy with the default parameters and are not using a parameters.json file. If you are using one, the steps might vary slightly.

  1. Go to the release notes for the version of Burp Suite Enterprise Edition that you want to deploy. Copy the URI for the Azure Resource Manager template.
  2. Log in to your Azure Portal and open Azure Cloud Shell.
  3. In Azure Cloud Shell, enter the following commands in order:
    az ad sp create-for-rbac --skip-assignment -o json > auth.json
    appId=$(jq -r ".appId" auth.json)
    password=$(jq -r ".password" auth.json)
    name=$(jq -r ".name" auth.json)
    objectId=$(az ad sp show --id $appId --query "objectId" -o tsv)
    tenant=$(jq -r ".tenant" auth.json)
    cat <<EOF > credentials.json
    {
    "servicePrincipalAppId": {"value": "$appId"},
    "servicePrincipalClientSecret": {"value": "$password"},
    "servicePrincipalName": {"value": "$name"},
    "servicePrincipalObjectId": {"value": "$objectId"},
    "servicePrincipalTenant": {"value": "$tenant"}
    }
    EOF
  4. Create a new resource group by entering the following command. Enter a name for the group and the location to which this resource group belongs.
    az group create -n someName -l someLocation
  5. Deploy to your resource group by entering the following command. Enter the resource group name that you specified in the previous step and enter any name to help identify the deployment later, for example, burp-suite-enterprise. yourTemplateURI is the URI that you copied from the Burp Suite Enterprise Edition release notes.
    az deployment group create -g yourGroupName -n yourDeploymentName --template-uri yourTemplateURI --parameters @credentials.json
    Note: If you're using a custom parameters.json file, you need to pass this in here by appending --parameters @parameters.json
  6. When prompted, enter the username, password, and email address that you want to use as the admin user. These are the credentials that you will use to log in and perform the initial setup of Burp Suite Enterprise Edition once it has been deployed.
  7. After you confirm the admin credentials, you will be prompted to enter the JDBC URL and the credentials for your external database.
  8. When the deployment is finished, go to your Azure Portal and navigate to "Resource Groups" .
  9. Select the resource group that you created earlier.
  10. Click on the resource called appgwpublicip****. Copy the "IP Address" property and open it in your browser. You should be taken to the Burp Suite Enterprise Edition login page.
  11. Log in using the admin username and password that you specified earlier. When prompted, activate your license. You are now ready to start using Burp Suite Enterprise Edition.