Bambda Workshop
Hands-on exercises for the Burp, But Yours workshop.
Write Bambdas that solve real proxy-history problems, then test them against Web Security Academy labs.
Table of contents
What is a Bambda?
Bambdas are Java lambda expressions that run inline in Burp Suite. The types are:
- Table filters: control which rows appear in proxy history, logger, or site map.
- Custom columns: add new columns to those tables to surface data you care about.
- Match and replace rules: modify requests and responses passing through the proxy.
- Custom actions: extract, transform, or act on data in Burp Repeater.
- Custom scan checks: create active and passive scan checks in Java.
Table filters work in both Burp Suite Community Edition and Professional. All other types require Burp Suite Professional.
Resources:
- Bambdas documentation
- Community scripts: github.com/PortSwigger/bambdas
- AI Bambda Generator (BApp Store): drafts a Bambda from a plain-English description using Burp AI (needs Burp AI credits)
Loading a Bambda
To load a filter:
- Go to Proxy > HTTP history.
- Click the filter bar at the top to open the HTTP history filter window.
- Go to the Script mode tab.
- Paste your code and click Apply & close.
To add a custom column:
- Go to Proxy > HTTP history.
- Click the options menu (the vertical ⋮ icon above the table) and click Add custom column.
- Paste your code and click Apply.
To edit or delete a custom column:
- Open the options menu (⋮) and click Table layout.
- Find the column by name.
- Click Edit column or Delete column.
Table layout also shows and hides columns; reorder them by dragging the column headers.
To debug, use the Bambda output console: anything you log with logging.logToOutput(...) appears there. See using the output console.
Select an exercise
Each walkthrough is a self-contained brief with a step-by-step approach and hints you can reveal as needed. Start with any exercise and work through as many as you like.
Tip: Stuck, or want a starting point? If you have Burp AI credits, the AI Bambda Generator BApp drafts a Bambda from a plain-English description. You can also try using Burp AT, Burp’s agentic AI.
Read and understand what either tool produces first. The aim is to learn the approach, not only to run it.
Exercise A: Proxy History Intelligence Beginner
Surface response-header metadata that Burp has no default column for. Build a custom column that extracts the X-Cache header, so you can see at a glance which responses came from the cache versus the origin, and a companion filter that keeps only the cache hits.
Exercise B: JWT Triage Intermediate
Spot JWT-bearing requests in proxy history and expose token metadata at a glance. Build a filter that keeps only requests carrying a JWT, and a custom column that Base64url-decodes the token’s header segment and surfaces its alg claim, so weak algorithm configurations stand out without opening a single request.
Exercise C: Custom Scan Checks Advanced
(Advanced / stretch, Professional only.) Write two scan-check Bambdas that report issues Burp’s built-in scanner doesn’t: a passive check that raises an issue when a response leaks information, and an active check that injects a payload and confirms a finding from the response. Then make each issue actionable with a meaningful name, severity, confidence, and detail.