IMG_5265.jpg

Kaustubh Rai

Burp Suite is a cybersecurity tool, known for its security testing capabilities. It allows for detailed analysis and testing of web applications, network services, and other digital assets, to identify vulnerabilities through a combination of automated and manual methods. A key feature introduced in version v2023.6 is BChecks, available in the Professional version. This feature allows users to create custom security scans by scripting tests tailored to their requirements.This blog will cover how BChecks improve Burp Suite's functionality for more effective security testing. We'll look at their impact on the scanning engine and their significance for testers at any experience level. Learn how utilizing BChecks can enhance your approach to security testing.<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/bltb0c8bcbfe7b8e87b/65a6d6c5d48d3d2fd5cebcb4/image9.png
" alt="Burp suite bcheck-reported-issues" title="Burp suite bcheck-reported-issues | Contentstack"/><h2>Understanding BChecks: Beyond Standard Scanning</h2>Burp Suite has long facilitated vulnerability scanning through its built-in scanner and the diverse extensions available on the BApp Store. However, the introduction of BChecks marks an advancement in the realm of customization for security testing.Traditionally, while using Burp Suite's Vulnerability Scanner and extensions, users often faced limitations regarding the number of extensions they could enable, primarily due to memory constraints. Overloading with extensions could lead to system performance issues, restricting the scope of simultaneous scans.BChecks circumvent the limitations traditionally encountered with extensions. These scripted checks, running seamlessly within the Burp Suite environment, offer the versatility of extensions without the associated system impact. You can now create a multitude of BChecks to operate concurrently without burdening the system. They continuously monitor and flag security issues, clearly marked as "BCheck generated" in the Target and Dashboard, offering a streamlined and efficient security testing process.This new feature broadens the scope of what can be tested and enhances efficiency. Testers can conduct more targeted and effective scans by tailoring BChecks to specific security concerns or vulnerabilities. This targeted approach is not just a step up in customization; it represents a leap toward more intelligent, adaptive, and efficient security testing.<h2>The Evolution of Security Testing with Scripting: Traditional Methods vs. BChecks Approach</h2>Security testing has always been a game of cat and mouse, with tools and techniques constantly evolving to keep pace with emerging threats.Traditional security testing often relied on predefined scans and manual efforts. This method, while effective, had limitations in adaptability and scalability. Traditional methods often required writing extensive functions and extensions in specific programming languages, a process that could be daunting for those not well-versed in these languages. This approach often involved meticulous planning, trial and error, and significant time investment, especially when multiple functions or extensions were needed.With BChecks, the dynamics have changed. With their simple scripting language, BChecks allow for the creation of checks for almost anything imaginable, significantly reducing the time and effort involved in scripting specific functions or developing full extensions. For an in-depth understanding of BCheck's scripting language, refer to the <a href="https://portswigger.net/burp/documentation/scanner/bchecks/bcheck-definition-reference">BCheck Definition Reference</a>.The ability to write scripts that directly address specific vulnerabilities or testing scenarios transforms the scanner from a generic tool into a precision instrument tailored to individual needs.Key Comparisons:<ul><li>Complexity of Development: BChecks offers a user-friendly scripting language instead of the Traditional Methods of requiring in-depth knowledge, accessible even to those with limited coding experience.</li><li>Time Investment: Bchecks offers quick creation and deployment, streamlining the whole process.</li><li>Resource Efficiency: BChecks minimizes system impact, allowing for multiple checks simultaneously without degrading performance.</li><li>Community Collaboration: Traditional Methods are limited to scope for community due to complexity and specificity whereas BChecks encourages community involvement enhancing the tool's capabilities through collaborative efforts.</li></ul><h2>Diving into the Capabilities of BChecks</h2>BChecks offers a suite of capabilities that enhance the scope and efficacy of security testing. Some of these key features empower testers to conduct comprehensive and targeted security assessments:Conditional Logic: BChecks enable conditional statements, allowing checks to be executed based on specific criteria. This capability ensures that scans are both relevant and efficient, focusing on areas of potential vulnerability.Syntax:<pre> 1] if [condition] then [action] end if 2] if [condition 1] then [action 1] else if [condition 2] then [action 2] end if 3] if [condition] then [action]	 else then [action 2]	 end if 	</pre>Example: Create a check that reports an issue if the response contains any headers that give information about its server.<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blte1593b53cdcc32c5/65a6d6c4cfd28438f5f1ba77/image1.png
" alt="Burp-suite-conditional logic" title="Burp-suite-conditional logic | Contentstack"/>Regular Expression (Regex) Matching: With regex support, BChecks can precisely identify patterns in HTTP requests and responses. This precision is crucial in detecting complex vulnerabilities and specific security issues. BChecks supports Java-style regex. "2[0-9][0-9]"Syntax:&nbsp;<pre>`{variable} matches "[regex]"`</pre>Example: Detect email addresses in responses<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blt2543c7b2b58d0d4a/65a6d6c4a0613d607a5294b1/image8.png
" alt="Burpe suite regular expression" title="Burpe suite regular expression | Contentstack"/>Custom HTTP Requests: BChecks allow the sending of custom HTTP requests, facilitating the testing of unique or unconventional attack vectors that standard scans might miss.Syntax:<pre>send request: method: "GET"</pre>Example: Check for exposed admin panels<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blta8e95b6e7b26f03e/65a6d6c3d7d856f824b4e0f7/image10.png
" alt="Burpe suite custom http request" title="Burpe suite custom http request | Contentstack"/>Interaction with Burp Collaborator: BChecks can interact with Burp Collaborator for advanced testing scenarios, such as out-of-band vulnerability detection, enhancing the ability to uncover hidden or hard-to-detect issues.Syntax:<pre>`{generate_collaborator_address()}`</pre>Example: Detect blind XSS vulnerabilities.<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blt3f0ee77927a746f1/65a6d6c45d5135b026fb8478/image6.png
" alt="Burp suite detect blind xss" title="Burp suite detect blind xss | Contentstack"/>Programmatic Payload Delivery: Testers can use BChecks to programmatically trigger payloads upon discovering insertion points, allowing for dynamic and responsive testing strategies.Syntax:<pre>`send payload: appending: "test payload"`</pre>Example: Test for reflected XSS.<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blt45bdb0f1a0b7a4e6/65a6d6c4cdbb960770c4f590/image4.png
" alt="Burp suite programmatic payload" title="Burp suite programmatic payload | Contentstack"/>Custom Issue Reporting: BChecks provides the functionality to raise findings with detailed descriptions, severity levels, and remediation advice. This feature aids in the clear communication and prioritization of identified issues.Syntax:<pre>`report issue: severity: confidence: remediation: detail:`</pre>Example: Report issues for any AWS Keys found in response.<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blt4bce84577dfaaa29/65a6d6c48c124a068c1592c9/image3.png
" alt="Burp suite custom issue reporting" title="Burpe suite custom issue reporting | Contentstack"/>Helper Functions: The scripting language includes helper functions for common operations like MD5, SHA1, SHA256 hashing, and Base64 encoding/decoding, streamlining the script writing process.Syntax:<pre>{base64_encode(string)}, sha1(String), sha256(String), md5(String)</pre>Example: Encode sensitive data before transmission.<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blt9d8a347d8dcd4fae/65a6d6c47fc000439c222feb/image2.png
" alt="Burpe suite helper function" title="Burpe suite helper function | Contentstack"/><h2>Crafting Effective BChecks: Tips and Best Practices</h2>Crafting effective BChecks requires a blend of technical know-how and strategic thinking. Some tips to create a basic Bcheck script are:<ol><li>Start with a Clear Objective: Define what you want to achieve with your BCheck script. Understanding the specific vulnerability or issue you are targeting is crucial.</li><li>Keep It Simple: Start with simple checks and gradually build complexity. Avoid overcomplicating scripts as it can lead to inefficiencies.</li><li>Test Thoroughly: Regularly test and refine your scripts to ensure they are effective and do not produce false positives.</li><li>Stay Updated: Keep abreast of the latest security trends and update your scripts accordingly.</li><li>Leverage Community Resources: Use examples from the <a href="https://github.com/PortSwigger/BChecks">BChecks GitHub repository</a> as references and inspiration.</li></ol><h2>Creating a Basic BCheck Script:</h2>Let's create a simple BCheck script that detects whether a website’s login page uses HTTP instead of HTTPS, a potential security risk.Here are the steps:<img src="https://images.contentstack.io/v3/assets/blt7359e2a55efae483/blt975763de7d53a56d/65a6d6c36af46740b78f9562/image7.png
" alt="Burpe suite Bcheck script creation" title="Burpe suite Bcheck script creation | Contentstack"/><ul><li>Define the Metadata: Start by defining basic information about your check.</li></ul><pre> metadata: language: v1-beta name: "Insecure Login Check" description: "Detects if login pages are served over HTTP" author: "Your Name" </pre><ul><li>Set Up Trigger Condition (steps 2 and 3 combined): Specify the trigger that should run for each host. You can define the logic you need to implement and the subsequent actions.</li></ul><pre>given host then</pre><ul><li>Send a request and check the response (steps 4 and 5 combined): Send a request to the login page and check if it’s served over HTTP. In case you encounter any issues, you can report them.</li></ul><pre> send request called login_page_check: method: "GET" path: "/login" if {login_page_check.response.url.protocol} is "http" then report issue: severity: medium confidence: certain detail: "Login page served over insecure HTTP." remediation: "Switch to HTTPS to secure the login page." end if </pre>This script is a basic example, but it illustrates creating a BCheck – from defining the metadata to scripting the logic and reporting issues.&nbsp;Following similar steps and applying the best practices, you can develop a wide range of custom BChecks to enhance your security testing with Burp Suite Professional.For more working examples demonstrating various use cases, visit <a href="https://portswigger.net/burp/documentation/scanner/bchecks/worked-examples">Portswigger’s Worked Examples</a>.<h2>The Community Angle: Sharing and Collaboration</h2>BChecks offers technical prowess and opens avenues for community collaboration and knowledge sharing. This aspect is critical in the ever-evolving cybersecurity landscape, where collective wisdom can significantly amplify individual efforts.The <a href="https://github.com/PortSwigger/BChecks">BChecks GitHub repository</a> offers a wide array of solutions and ideas for security testing. Exploring these scripts allows you to gain insights into diverse security testing scenarios and methodologies.Review scripts from other professionals and contribute your BChecks to the repository. The community can cover various vulnerabilities and scenarios by sharing and adapting scripts.Reviewing scripts from others, and contributing your own BChecks enriches this knowledge base. I invite you to explore and contribute to <a href="https://github.com/KaustubhRai/bchecks" target="_blank">my BChecks Collection on GitHub</a>. Here, I share my own scripts and encourage the community to engage, share feedback, and contribute their findings.<h2>Future-Proofing Security Testing with BChecks</h2>The role of BChecks in security testing is poised to expand. Expect BChecks to integrate deeper levels of automation, enabling even more complex security testing scenarios with minimal manual intervention.Incorporating AI in creating custom BChecks to predict and identify emerging vulnerabilities, adapting the testing process in real-time.As the user community grows, various scripts and use cases will emerge.By offering this customization, efficiency, and community collaboration, BChecks enables security professionals to conduct more targeted, effective, and comprehensive security assessments.We encourage you to experiment with BChecks, share your experiences, and contribute to the growing body of knowledge in the Burp Suite community. Here’s the repository where you can contribute to BChecks - <a href="https://github.com/PortSwigger/BChecks">https://github.com/PortSwigger/BChecks</a>. Whether enhancing existing scripts or developing new ones, your contribution is a step towards a more secure digital world.

Burp Suite is a cybersecurity tool, known for its security testing capabilities. It allows for detailed analysis and testing of web applications, network services, and other digital assets, to identify vulnerabilities through a combination of automated and manual methods. A key feature introduced in version v2023.6 is BChecks, available in the Professional version. This feature allows users to create custom security scans by scripting tests tailored to their requirements.

This blog will cover how BChecks improve Burp Suite's functionality for more effective security testing. We'll look at their impact on the scanning engine and their significance for testers at any experience level. Learn how utilizing BChecks can enhance your approach to security testing.

Understanding BChecks: Beyond Standard Scanning

Burp Suite has long facilitated vulnerability scanning through its built-in scanner and the diverse extensions available on the BApp Store. However, the introduction of BChecks marks an advancement in the realm of customization for security testing.

Traditionally, while using Burp Suite's Vulnerability Scanner and extensions, users often faced limitations regarding the number of extensions they could enable, primarily due to memory constraints. Overloading with extensions could lead to system performance issues, restricting the scope of simultaneous scans.

BChecks circumvent the limitations traditionally encountered with extensions. These scripted checks, running seamlessly within the Burp Suite environment, offer the versatility of extensions without the associated system impact. You can now create a multitude of BChecks to operate concurrently without burdening the system. They continuously monitor and flag security issues, clearly marked as "BCheck generated" in the Target and Dashboard, offering a streamlined and efficient security testing process.

This new feature broadens the scope of what can be tested and enhances efficiency. Testers can conduct more targeted and effective scans by tailoring BChecks to specific security concerns or vulnerabilities. This targeted approach is not just a step up in customization; it represents a leap toward more intelligent, adaptive, and efficient security testing.

The Evolution of Security Testing with Scripting: Traditional Methods vs. BChecks Approach

Security testing has always been a game of cat and mouse, with tools and techniques constantly evolving to keep pace with emerging threats.

Traditional security testing often relied on predefined scans and manual efforts. This method, while effective, had limitations in adaptability and scalability. Traditional methods often required writing extensive functions and extensions in specific programming languages, a process that could be daunting for those not well-versed in these languages. This approach often involved meticulous planning, trial and error, and significant time investment, especially when multiple functions or extensions were needed.

With BChecks, the dynamics have changed. With their simple scripting language, BChecks allow for the creation of checks for almost anything imaginable, significantly reducing the time and effort involved in scripting specific functions or developing full extensions. For an in-depth understanding of BCheck's scripting language, refer to the 

The ability to write scripts that directly address specific vulnerabilities or testing scenarios transforms the scanner from a generic tool into a precision instrument tailored to individual needs.

BChecks offers a suite of capabilities that enhance the scope and efficacy of security testing. Some of these key features empower testers to conduct comprehensive and targeted security assessments:

Conditional Logic: BChecks enable conditional statements, allowing checks to be executed based on specific criteria. This capability ensures that scans are both relevant and efficient, focusing on areas of potential vulnerability.

 Create a check that reports an issue if the response contains any headers that give information about its server.

: With regex support, BChecks can precisely identify patterns in HTTP requests and responses. This precision is crucial in detecting complex vulnerabilities and specific security issues. BChecks supports Java-style regex. "2[0-9][0-9]"

: BChecks allow the sending of custom HTTP requests, facilitating the testing of unique or unconventional attack vectors that standard scans might miss.

: BChecks can interact with Burp Collaborator for advanced testing scenarios, such as out-of-band vulnerability detection, enhancing the ability to uncover hidden or hard-to-detect issues.

: Testers can use BChecks to programmatically trigger payloads upon discovering insertion points, allowing for dynamic and responsive testing strategies.

`send payload: appending: "test payload"`

: BChecks provides the functionality to raise findings with detailed descriptions, severity levels, and remediation advice. This feature aids in the clear communication and prioritization of identified issues.

`report issue: severity: confidence: remediation: detail:`

 Report issues for any AWS Keys found in response.

: The scripting language includes helper functions for common operations like MD5, SHA1, SHA256 hashing, and Base64 encoding/decoding, streamlining the script writing process.

{base64_encode(string)}, sha1(String), sha256(String), md5(String)

 Encode sensitive data before transmission.

Crafting Effective BChecks: Tips and Best Practices

Crafting effective BChecks requires a blend of technical know-how and strategic thinking. Some tips to create a basic Bcheck script are:

Let's create a simple BCheck script that detects whether a website’s login page uses HTTP instead of HTTPS, a potential security risk.

  description: "Detects if login pages are served over HTTP"

if {login_page_check.response.url.protocol} is "http" then

  detail: "Login page served over insecure HTTP."

  remediation: "Switch to HTTPS to secure the login page."

This script is a basic example, but it illustrates creating a BCheck – from defining the metadata to scripting the logic and reporting issues. 

Following similar steps and applying the best practices, you can develop a wide range of custom BChecks to enhance your security testing with Burp Suite Professional.

For more working examples demonstrating various use cases, visit 

The Community Angle: Sharing and Collaboration

BChecks offers technical prowess and opens avenues for community collaboration and knowledge sharing. This aspect is critical in the ever-evolving cybersecurity landscape, where collective wisdom can significantly amplify individual efforts.

 offers a wide array of solutions and ideas for security testing. Exploring these scripts allows you to gain insights into diverse security testing scenarios and methodologies.

Review scripts from other professionals and contribute your BChecks to the repository. The community can cover various vulnerabilities and scenarios by sharing and adapting scripts.

Reviewing scripts from others, and contributing your own BChecks enriches this knowledge base. I invite you to explore and contribute to 

. Here, I share my own scripts and encourage the community to engage, share feedback, and contribute their findings.

Future-Proofing Security Testing with BChecks

The role of BChecks in security testing is poised to expand. Expect BChecks to integrate deeper levels of automation, enabling even more complex security testing scenarios with minimal manual intervention.

Incorporating AI in creating custom BChecks to predict and identify emerging vulnerabilities, adapting the testing process in real-time.

As the user community grows, various scripts and use cases will emerge.

By offering this customization, efficiency, and community collaboration, BChecks enables security professionals to conduct more targeted, effective, and comprehensive security assessments.

We encourage you to experiment with BChecks, share your experiences, and contribute to the growing body of knowledge in the Burp Suite community. Here’s the repository where you can contribute to BChecks - 

. Whether enhancing existing scripts or developing new ones, your contribution is a step towards a more secure digital world.

Kaustubh Rai

Posts by Kaustubh Rai