Free build time
A collection of things to build during the free build block, or after the workshop. Pick something that solves a real problem in your testing workflow. Thatβs where the best extensions come from.
Legend: π’ quick win Β· π‘ a sessionβs work Β· π΄ ambitious
Bambdas come in several types: table filters, custom columns, match and replace, custom actions (Repeater), and custom scan checks. Extensions can do all of that and far more via the Montoya API. Donβt feel limited by the examples. You can build far beyond them.
Table of contents
Where to look when you get stuck
| Resource | Link |
|---|---|
| Bambdas documentation | portswigger.net/β¦/bambdas |
| Community Bambdas (reference) | github.com/PortSwigger/bambdas |
| Montoya API JavaDoc | portswigger.github.io/β¦/javadoc |
| Extension examples | github.com/PortSwigger/β¦-examples |
| Extension starter project | github.com/PortSwigger/extension-template-project |
If youβre stuck on the API, the CLAUDE.md in the extension template is built to paste into an AI assistant alongside your idea. See the βUsing an LLM to generate your extensionβ section of the extension workshop README.
See also the Downloads & Resources page for prerequisites and further reading.
Bambda ideas
Table filters
- π’ Hide noise: drop requests for static assets (
.css,.js,.png,.woff, fonts, analytics beacons) so history shows only the interesting traffic. - π’ In-scope only, without Burp scope: show only requests whose host matches a regex you control, even before you set Burp scope.
- π’ Error spotter: show only responses with status
>= 500, or4xxthat arenβt404. - π’ Big responses: show only responses over N kilobytes (candidate data leaks, verbose error pages).
- π’ Slow responses: surface requests whose round-trip time crosses a threshold (timing oracle candidates).
- π‘ Reflected parameters: show rows in which a query/body parameter value appears verbatim in the response body (XSS/reflection triage).
- π‘ Auth state diff: show only requests that carry a session cookie but got a
401/403back (broken access control candidates). - π‘ Interesting content types: show only
application/json,xml,octet-stream, or anything that isnβt HTML. - π‘ Secrets in responses: flag rows whose body matches patterns for AWS keys, JWTs, private keys,
BEGIN RSA, bearer tokens, Google API keys. - π‘ Set-Cookie without flags: show responses that set a cookie missing
HttpOnly,Secure, orSameSite. - π‘ CORS interesting: show responses with
Access-Control-Allow-Origin: *or a reflectedOrigin. - π‘ Method anomalies: show
PUT,DELETE,PATCH, orTRACErequests only. - π΄ Parameter pollution: show requests that contain the same parameter name more than once.
- π΄ GraphQL traffic: show only requests whose body looks like a GraphQL query/mutation.
Custom columns
- π’ Response time: surface round-trip latency as a sortable column.
- π’ Body size: response length in bytes/KB.
- π’ Server / X-Powered-By / X-Runtime: fingerprint tech stack at a glance.
- π’ Content-Type: pull the type into its own column.
- π‘ Cookie count: number of cookies set in the response.
- π‘ Reflected param name: show which parameter was reflected, not just that one was.
- π‘ JWT
alg: decode the token header and show the algorithm (weak-config triage). - π‘ JWT
expcountdown: decode the payload and show time-to-expiry. - π‘ CSP presence/score: show whether a Content-Security-Policy exists and how strict it looks.
- π‘ Auth scheme: Basic / Bearer / Digest / none, parsed from the
Authorizationheader. - π‘ Parameter count: number of query + body parameters (large requests are worth inspecting).
- π΄ WAF/CDN guess: infer Cloudflare, Akamai, and similar from response headers and surface it.
- π΄ Entropy score: compute Shannon entropy of a token/parameter to flag likely secrets.
Match and replace
- π’ Force verbose errors: inject
X-Debug: trueor similar on every request to trigger stack traces. - π’ Spoof mobile: swap the
User-Agentto a mobile device to reach a different code path. - π’ Pin a header: always add a custom tenant/feature-flag header (
X-Tenant-Id,X-Feature: beta). - π‘ Strip caching: remove
If-None-Match/If-Modified-Sinceso you always get fresh200s, not304s. - π‘ Cache-buster: append a random query param to bust CDN caches while testing.
- π‘ Downgrade content negotiation: rewrite
Accept-Encodingto identity so responses are uncompressed and readable. - π‘ Origin reflection probe: set
Origin:to an attacker domain on every request to test CORS reflection. - π΄ Conditional rewrite: only modify requests to a specific host or path (logic inside the Bambda, not just a static rule).
Custom actions: Repeater
- π’ Base64 decode selection: decode the highlighted bytes and print the result to the output console.
- π’ URL-decode / HTML-decode selection: quick one-click decoders.
- π‘ JWT decoder: take the selected JWT, decode header + payload, and print both as pretty JSON.
- π‘ Timestamp converter: find Unix timestamps in the request and print them as readable dates.
- π‘ Hash the selection: MD5/SHA-1/SHA-256 the highlighted bytes (useful for cache keys, ETags, signatures).
- π‘ Extract all links: pull every URL out of a response body and list them.
- π‘ Generate TOTP: compute a current TOTP code from a hardcoded secret and print it for pasting.
- π‘ Parameter inventory: list every parameter (query, body, cookie) in the request with its source.
- π΄ Re-sign the request: recompute an HMAC signature over the (modified) request and show the value to paste back in.
- π΄ Decode proprietary blob: decode a custom/serialized format in the selection and print the structured result.
Custom scan checks
- π‘ Passive: secret leak: raise an issue when a response body contains an API key / private key / token pattern.
- π‘ Passive: verbose error: flag stack traces, SQL errors, framework debug pages.
- π‘ Passive: missing security headers: report responses lacking
CSP,X-Frame-Options,HSTS. - π‘ Passive: insecure cookies: flag
Set-CookiewithoutHttpOnly/Secure/SameSite. - π‘ Active: reflected probe: inject a unique marker and report if it returns unencoded.
- π΄ Active: error-based injection: send payloads that provoke distinguishable error responses and report on the signature.
- π΄ Active: time-based oracle: send a payload that should delay the response and report if latency spikes.
Extension ideas
Extensions reach the parts of Burp that Bambdas canβt: persistent UI, background work, Intruder, Collaborator, project storage. Any Bambda idea can become a richer extension; the ideas here genuinely need the full API.
Message editor tabs
- π’ JSON pretty-printer: a tab that indents minified JSON responses (the workshop example).
- π‘ JWT inspector tab: decode and display header + payload as formatted JSON, with the
alg/exphighlighted. - π‘ Base64/Hex auto-decoder: a tab that detects and decodes encoded blobs in the body.
- π‘ Protobuf / MessagePack viewer: render a binary body in a readable structure.
- π΄ GraphQL explorer tab: pretty-print the query, list operations, show variables separately.
- π΄ Diff tab: show this response diffed against the previous one for the same endpoint.
Session handling rules
- π‘ Auto-TOTP injector: generate and inject a fresh TOTP on requests to the login endpoint (workshop example, extended).
- π‘ Request signer: recompute an HMAC/JWS signature for each request so you can tamper freely and still pass signature checks across tools.
- π‘ Auto-renew bearer token: detect
401s, hit the refresh endpoint, and update the session with the new token. - π΄ Nonce/CSRF handler: scrape a fresh CSRF token (via a macro) and inject it into the next request automatically.
Proxy / HTTP handlers
- π‘ Header injector with UI: add/strip headers configured from a settings panel (not hardcoded).
- π΄ Traffic recorder: log every request/response to a structured file (JSONL/HAR) for offline analysis.
Scanner
- π‘ Custom pack of passive checks: bundle several passive checks (secrets, headers, cookies) into one extension.
- π΄ Custom active check: a real injection check with baseline comparison to cut false positives.
- π΄ Custom provider for insertion points: teach Burp to inject into a custom header, a JSON field, or a serialized blob it wouldnβt normally treat as a parameter.
Intruder
- π‘ Payload generator: feed Intruder a custom sequence (incrementing IDs, date ranges, wordlist transforms).
- π‘ Payload processor: sign/encode/timestamp each payload before Burp sends it.
- π΄ Stateful payload generator: generate the next payload based on the previous response (for example, follow pagination).
Collaborator
- π΄ OOB canary: register a Collaborator payload, inject it across requests, and alert when it gets a hit (SSRF/blind injection).
- π΄ DNS exfil detector: watch for Collaborator interactions tied to specific test cases and correlate them back.
UI / workflow
- π‘ Context-menu toolkit: right-click actions you might find useful.
- π‘ Notes panel: a suite tab where you jot findings tied to the current request, persisted in the project file.
- π‘ Scope dashboard: a suite tab summarising hosts seen, status-code spread, and tech fingerprints.
- π΄ Checklist tracker: a suite tab with your pentest methodology checklist that auto-ticks items based on traffic seen.
Integrations & reporting
- π‘ Slack/Discord notifier: POST a message when a high-severity issue is found.
- π‘ Jira/ticket creator: turn a selected issue into a ticket via API.
- π΄ Markdown report generator: export findings (with request/response evidence) to a formatted report file.
- π΄ SARIF exporter: emit findings in SARIF so they drop into a CI security dashboard.
AI-powered: Burp AI
- π‘ Issue triage: send each new issue to Burp AI and tag the ones it judges interesting (auth flows, error leaks, hidden endpoints).
- π΄ Payload suggester: ask Burp AI to propose injection payloads tailored to the parameter and tech stack it sees.
- π΄ Finding write-up: turn a confirmed issueβs evidence into a drafted report section via Burp AI.
Off the beaten path
- π΄ Auto-grouped site map: cluster similar requests (same endpoint, different IDs) in your own tab to collapse history noise.
- π΄ Replay differ: re-send a saved request on a timer and alert when the response changes (config drift / deploy detector).
- π΄ WebSocket inspector: capture and pretty-print WebSocket frames in a dedicated tab.