Professional

Creating BChecks

  • Last updated: January 29, 2024

  • Read time: 2 Minutes

You can define BChecks yourself, using our custom definition language. This enables you to target your scans and make your testing workflow as efficient as possible.

When you create a BCheck in Burp, you can work from a range of example definitions. Each definition describes a functional BCheck. Edit these to create new BChecks that meet your requirements.

Note

You can share your BChecks and download new ones via the BChecks GitHub repository. This includes example checks created by PortSwigger, as well as BChecks developed by the Burp Suite community.

For information on contributing to the BChecks repository, see the Contributing readme page.

To create a BCheck from an example definition:

  1. Go to Extensions > BChecks.
  2. Click New > From template. The New BCheck dialog opens, which contains various example BCheck definitions.
  3. Select an example BCheck definition, then click Create using this template. The BS Code editor opens.
  4. Edit the BCheck to meet your requirements.
  5. Click Validate. Burp identifies any errors in the BCheck.
  6. Fix any errors in the BCheck.
  7. To automatically standardize the indentation and whitespace, right-click the editor and select Format BCheck. You can undo the changes with Cmd+Z or Ctrl+Z if you prefer your original layout.
  8. Save the BCheck:

    • To save the BCheck and close the BS Code editor, click Save & close. The BCheck is added to the table and enabled by default. Burp Scanner will use it when you perform an audit.
    • To save and enable the BCheck without closing the BS Code editor, click Save. You can then test the check with Burp Scanner and make changes directly to the definition.

Note

You can Save & close a BCheck that contains errors. The BCheck is added to the table, but can't be enabled. To enable the BCheck, first fix any errors in the definition.

Exporting BChecks

You can export BChecks so that you can import them into other instances of Burp. To export a BCheck:

  1. Select the BCheck and click Export .
  2. If necessary, select a directory. Click Open to see the contents of the directory.
  3. Enter a filename and click Save.

You can select and export more than one BCheck at a time. If you choose this option, the BChecks are exported with their current name.

Related pages

Was this article helpful?