

<!DOCTYPE html>

<html lang="en-US">
<head>
  <meta charset="UTF-8">
  <meta http-equiv="X-UA-Compatible" content="IE=Edge">

  <link rel="stylesheet" href="/burp-but-yours/assets/css/just-the-docs-default.css">

  <link rel="stylesheet" href="/burp-but-yours/assets/css/just-the-docs-head-nav.css" id="jtd-head-nav-stylesheet">

  <style id="jtd-nav-activation">
  
    .site-nav ul li a {
      background-image: none;
    }

  </style>

  

  
    <script src="/burp-but-yours/assets/js/vendor/lunr.min.js"></script>
  

  <script src="/burp-but-yours/assets/js/just-the-docs.js"></script>

  <meta name="viewport" content="width=device-width, initial-scale=1">

  



  <!-- Begin Jekyll SEO tag v2.9.0 -->
<title>Burp, But Yours | Hands-on workshop exercises for building your own Burp Suite customizations: Bambdas and extensions.</title>
<meta name="generator" content="Jekyll v4.4.1" />
<meta property="og:title" content="Burp, But Yours" />
<meta property="og:locale" content="en_US" />
<meta name="description" content="Hands-on workshop exercises for building your own Burp Suite customizations: Bambdas and extensions." />
<meta name="twitter:description" property="og:description" content="Hands-on workshop exercises for building your own Burp Suite customizations: Bambdas and extensions." />
<link rel="canonical" href="https://portswigger.net/burp-but-yours/assets/css/just-the-docs-head-nav.css" />
<meta property="og:url" content="https://portswigger.net/burp-but-yours/assets/css/just-the-docs-head-nav.css" />
<meta property="og:site_name" content="Burp, But Yours" />
<meta property="og:type" content="website" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:title" content="Burp, But Yours" />
<script type="application/ld+json">
{"@context":"https://schema.org","@type":"WebPage","description":"Hands-on workshop exercises for building your own Burp Suite customizations: Bambdas and extensions.","headline":"Burp, But Yours","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://portswigger.net/burp-but-yours/assets/img/portswigger-logo-reversed.svg"}},"url":"https://portswigger.net/burp-but-yours/assets/css/just-the-docs-head-nav.css"}</script>
<!-- End Jekyll SEO tag -->


  <link rel="icon" href="/burp-but-yours/assets/img/favicon.ico">
<link rel="apple-touch-icon" href="/burp-but-yours/assets/img/apple-touch-icon.png">

<script defer src="/burp-but-yours/assets/js/posthog-init.js"
        data-posthog-key="__POSTHOG_PROJECT_KEY__"
        data-posthog-host="__POSTHOG_HOST__"></script>

<script>
  document.addEventListener("DOMContentLoaded", function () {
    var links = document.querySelectorAll('a[href^="http://"], a[href^="https://"]');
    for (var i = 0; i < links.length; i++) {
      var link = links[i];
      if (link.hostname !== window.location.hostname) {
        link.setAttribute("target", "_blank");
        link.setAttribute("rel", "noopener noreferrer");
      }
    }
  });
</script>

<script>
  (function () {
    var STORAGE_KEY = "color-scheme";
    var DARK = "portswigger-dark";
    var LIGHT = "default";

    function primaryStylesheet() {
      return document.querySelector('link[rel="stylesheet"]');
    }

    function applyScheme(scheme) {
      var link = primaryStylesheet();
      if (!link) return;
      link.setAttribute(
        "href",
        link.getAttribute("href").replace(
          /just-the-docs-[\w-]+\.css/,
          "just-the-docs-" + scheme + ".css"
        )
      );
    }

    function prefersDark() {
      return localStorage.getItem(STORAGE_KEY) === "dark";
    }

    if (prefersDark()) {
      applyScheme(DARK);
      document.documentElement.classList.add("dark-mode");
    }

    document.addEventListener("DOMContentLoaded", function () {
      var toggle = document.getElementById("color-scheme-toggle");
      if (!toggle) return;

      function sync() {
        var dark = prefersDark();
        document.documentElement.classList.toggle("dark-mode", dark);
        toggle.classList.toggle("is-dark", dark);
        toggle.setAttribute("aria-pressed", dark ? "true" : "false");
        toggle.setAttribute(
          "title",
          dark ? "Switch to light mode" : "Switch to dark mode"
        );
      }

      sync();

      toggle.addEventListener("click", function () {
        var dark = !prefersDark();
        localStorage.setItem(STORAGE_KEY, dark ? "dark" : "light");
        applyScheme(dark ? DARK : LIGHT);
        sync();
      });
    });
  })();
</script>


</head>

<body>
  <a class="skip-to-main" href="#main-content">Skip to main content</a>
  <svg xmlns="http://www.w3.org/2000/svg" class="d-none">
  <symbol id="svg-link" viewBox="0 0 24 24">
  <title>Link</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-link">
    <path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"></path><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"></path>
  </svg>
</symbol>

  <symbol id="svg-menu" viewBox="0 0 24 24">
  <title>Menu</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-menu">
    <line x1="3" y1="12" x2="21" y2="12"></line><line x1="3" y1="6" x2="21" y2="6"></line><line x1="3" y1="18" x2="21" y2="18"></line>
  </svg>
</symbol>

  <symbol id="svg-arrow-right" viewBox="0 0 24 24">
  <title>Expand</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-chevron-right">
    <polyline points="9 18 15 12 9 6"></polyline>
  </svg>
</symbol>

  <!-- Feather. MIT License: https://github.com/feathericons/feather/blob/master/LICENSE -->
<symbol id="svg-external-link" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-external-link">
  <title id="svg-external-link-title">(external link)</title>
  <path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"></path><polyline points="15 3 21 3 21 9"></polyline><line x1="10" y1="14" x2="21" y2="3"></line>
</symbol>

  
    <symbol id="svg-doc" viewBox="0 0 24 24">
  <title>Document</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-file">
    <path d="M13 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V9z"></path><polyline points="13 2 13 9 20 9"></polyline>
  </svg>
</symbol>

    <symbol id="svg-search" viewBox="0 0 24 24">
  <title>Search</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="feather feather-search">
    <circle cx="11" cy="11" r="8"></circle><line x1="21" y1="21" x2="16.65" y2="16.65"></line>
  </svg>
</symbol>

  
  
    <!-- Bootstrap Icons. MIT License: https://github.com/twbs/icons/blob/main/LICENSE.md -->
<symbol id="svg-copy" viewBox="0 0 16 16">
  <title>Copy</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard" viewBox="0 0 16 16">
    <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1h1a1 1 0 0 1 1 1V14a1 1 0 0 1-1 1H3a1 1 0 0 1-1-1V3.5a1 1 0 0 1 1-1h1v-1z"/>
    <path d="M9.5 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3zm-3-1A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3z"/>
  </svg>
</symbol>
<symbol id="svg-copied" viewBox="0 0 16 16">
  <title>Copied</title>
  <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-clipboard-check-fill" viewBox="0 0 16 16">
    <path d="M6.5 0A1.5 1.5 0 0 0 5 1.5v1A1.5 1.5 0 0 0 6.5 4h3A1.5 1.5 0 0 0 11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3Zm3 1a.5.5 0 0 1 .5.5v1a.5.5 0 0 1-.5.5h-3a.5.5 0 0 1-.5-.5v-1a.5.5 0 0 1 .5-.5h3Z"/>
    <path d="M4 1.5H3a2 2 0 0 0-2 2V14a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V3.5a2 2 0 0 0-2-2h-1v1A2.5 2.5 0 0 1 9.5 5h-3A2.5 2.5 0 0 1 4 2.5v-1Zm6.854 7.354-3 3a.5.5 0 0 1-.708 0l-1.5-1.5a.5.5 0 0 1 .708-.708L7.5 10.793l2.646-2.647a.5.5 0 0 1 .708.708Z"/>
  </svg>
</symbol>

  
</svg>

  
    <header class="side-bar">
  <div class="site-header">
    <a href="/burp-but-yours/" class="site-title lh-tight">
  <img class="site-logo-img site-logo-light" src="/burp-but-yours/assets/img/portswigger-logo-reversed.svg" alt="" aria-hidden="true" />
  <img class="site-logo-img site-logo-dark" src="/burp-but-yours/assets/img/portswigger-logo.svg" alt="" aria-hidden="true" />

<span class="site-title-text">Burp, But Yours</span>
</a>
    <button id="menu-button" class="site-button btn-reset" aria-label="Menu" aria-expanded="false">
      <svg viewBox="0 0 24 24" class="icon" aria-hidden="true"><use xlink:href="#svg-menu"></use></svg>
    </button>
  </div>

  <nav aria-label="Main" id="site-nav" class="site-nav">
  <ul class="nav-list"><li class="nav-list-item nav-section-heading" role="presentation">
        <span class="nav-section-heading-label">Get started</span>
      </li><li class="nav-list-item"><a href="/burp-but-yours/" class="nav-list-link">Home</a></li><li class="nav-list-item"><a href="/burp-but-yours/slides/" class="nav-list-link">Presentation</a></li><li class="nav-list-item"><a href="/burp-but-yours/downloads/" class="nav-list-link">Downloads & Resources</a></li><li class="nav-list-item"><a href="/burp-but-yours/programming-concepts/" class="nav-list-link">Programming Concepts</a></li><li class="nav-list-item nav-section-heading" role="presentation">
        <span class="nav-section-heading-label">Workshops</span>
      </li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Bambda Workshop submenu" aria-expanded="false">
            <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
          </button><a href="/burp-but-yours/bambda-workshop/" class="nav-list-link">Bambda Workshop</a><ul class="nav-list"><li class="nav-list-item">
                <a href="/burp-but-yours/bambda-workshop/walkthrough/a/" class="nav-list-link">Exercise A: Proxy History Intelligence</a>
              </li><li class="nav-list-item">
                <a href="/burp-but-yours/bambda-workshop/walkthrough/b/" class="nav-list-link">Exercise B: JWT Triage</a>
              </li><li class="nav-list-item">
                <a href="/burp-but-yours/bambda-workshop/walkthrough/c/" class="nav-list-link">Exercise C: Custom Scan Checks</a>
              </li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Extension Workshop submenu" aria-expanded="false">
            <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
          </button><a href="/burp-but-yours/extension-workshop/" class="nav-list-link">Extension Workshop</a><ul class="nav-list"><li class="nav-list-item">
                <a href="/burp-but-yours/extension-workshop/walkthrough/a/" class="nav-list-link">Exercise A: Custom Editor Tab</a>
              </li><li class="nav-list-item">
                <a href="/burp-but-yours/extension-workshop/walkthrough/b/" class="nav-list-link">Exercise B: Custom Scan Check</a>
              </li><li class="nav-list-item">
                <a href="/burp-but-yours/extension-workshop/walkthrough/c/" class="nav-list-link">Exercise C: Session Handling</a>
              </li></ul></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Demo targets submenu" aria-expanded="false">
            <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
          </button><a href="/burp-but-yours/extension-workshop/demos/" class="nav-list-link">Demo targets</a><ul class="nav-list"><li class="nav-list-item">
                <a href="/burp-but-yours/extension-workshop/demos/json-demo/" class="nav-list-link">JSON demo server (Exercise A target)</a>
              </li><li class="nav-list-item">
                <a href="/burp-but-yours/extension-workshop/demos/totp-demo/" class="nav-list-link">TOTP demo server (Exercise C target)</a>
              </li></ul></li><li class="nav-list-item nav-section-heading" role="presentation">
        <span class="nav-section-heading-label">Go further</span>
      </li><li class="nav-list-item"><a href="/burp-but-yours/free-build-time/" class="nav-list-link">Free Build Time</a></li><li class="nav-list-item"><button class="nav-list-expander btn-reset" aria-label="Advanced concepts submenu" aria-expanded="false">
            <svg viewBox="0 0 24 24" aria-hidden="true"><use xlink:href="#svg-arrow-right"></use></svg>
          </button><a href="/burp-but-yours/advanced-concepts/" class="nav-list-link">Advanced concepts</a><ul class="nav-list"><li class="nav-list-item">
                <a href="/burp-but-yours/advanced-concepts/bambdas/" class="nav-list-link">Bambdas</a>
              </li><li class="nav-list-item">
                <a href="/burp-but-yours/advanced-concepts/extensions/" class="nav-list-link">Extensions</a>
              </li></ul></li></ul>
</nav>
<div class="d-md-block d-none site-footer">
  
  
    <!-- Intentionally blank: overrides just-the-docs' default "This site uses
     Just the Docs" credit line in components/sidebar.html. -->

  
  </div>
</header>

  
  <div class="main" id="top">
    <div id="main-header" class="main-header">
  
    

<div class="search" role="search">
  <div class="search-input-wrap">
    <input type="text" id="search-input" class="search-input" tabindex="0" placeholder="Search Burp, But Yours" autocomplete="off">
    <label for="search-input" class="search-label">
      <span class="sr-only">Search Burp, But Yours</span>
      <svg viewBox="0 0 24 24" class="search-icon" aria-hidden="true"><use xlink:href="#svg-search"></use></svg>
    </label>
  </div>
  <div id="search-results" class="search-results"></div>
</div>

  
  
  
    <nav aria-label="Auxiliary" class="aux-nav">
  <ul class="aux-nav-list"><li class="aux-nav-list-item">
      <button type="button" id="color-scheme-toggle"
        class="site-button aux-nav-icon-link color-scheme-toggle"
        aria-label="Toggle dark mode" title="Switch to dark mode" aria-pressed="false">
        <svg class="icon-moon" viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"></path></svg>
        <svg class="icon-sun" viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="5"></circle><path d="M12 1v2M12 21v2M4.22 4.22l1.42 1.42M18.36 18.36l1.42 1.42M1 12h2M21 12h2M4.22 19.78l1.42-1.42M18.36 5.64l1.42-1.42"></path></svg>
      </button>
    </li><li class="aux-nav-list-item">
        <a href="https://portswigger.net/burp/documentation/desktop/extend-burp" class="site-button aux-nav-icon-link"
          aria-label="Extend Burp documentation" title="Extend Burp documentation" target="_blank" rel="noopener noreferrer"><svg viewBox="0 0 24 24" width="20" height="20" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 19.5A2.5 2.5 0 0 1 6.5 17H20"></path><path d="M6.5 2H20v20H6.5A2.5 2.5 0 0 1 4 19.5v-15A2.5 2.5 0 0 1 6.5 2z"></path></svg></a>
      </li><li class="aux-nav-list-item">
        <a href="https://github.com/PortSwigger" class="site-button aux-nav-icon-link"
          aria-label="PortSwigger on GitHub" title="PortSwigger on GitHub" target="_blank" rel="noopener noreferrer"><svg viewBox="0 0 16 16" width="20" height="20" fill="currentColor" aria-hidden="true"><path d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82a7.65 7.65 0 0 1 2-.27c.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"></path></svg></a>
      </li></ul>
</nav>

  
</div>

    <div class="main-content-wrap">
      
      <div id="main-content" class="main-content">
        <main>
          
            <h.site-nav ul li a {
  background-image: linear-gradient(-90deg, rgb(234.8, 236.82, 244.9) 0%, rgba(234.8, 236.82, 244.9, 0.8) 80%, rgba(234.8, 236.82, 244.9, 0) 100%);
}

          

          
            
          
        </main>
        
<hr>
<footer>
  

  

  <div class="d-md-none mt-4 fs-2">
    
    
      <!-- Intentionally blank: overrides just-the-docs' default "This site uses
     Just the Docs" credit line in components/sidebar.html. -->

    
  </div>
</footer>

      </div>
    </div>
    
      

<div class="search-overlay"></div>

    
  </div>

  
</body>
</html>

