Version 2024.7 - Add support for JSON parsing / manipulation and othe…

…r miscellaneous improvements.
PortSwigger · Jul 31, 2024 · d3a5a11 · d3a5a11
1 parent 90ae436
commit d3a5a11
Show file tree

Hide file tree

Showing 365 changed files with 17,895 additions and 7,056 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,11 @@
+# Changelog
+
+## v2024.7
+
+- Added JSON parsing / manipulation support with *JsonUtils* and *JsonNode*.
+- Added ability to control redirection behavior when issuing HTTP requests using *RedirectionMode* and *RequestOptions*.
+- Added utility methods to *HttpRequest* and *HttpResponse* which add, update or remove multiple headers.
+- Added *EditorOptions.SHOW_NON_PRINTABLE_CHARACTERS* and *EditorOptions.WRAP_LINES* which can be applied when creating RawEditors.
+- Added method to *Intruder* which enables sending of HTTP requests with an associated tab name.
+- Added *Project* which allows retrieval of the current project name.
+- Added method to *Proxy* to determine the current interception state.
diff --git a/README.md b/README.md
@@ -14,12 +14,12 @@ Available on [Maven Central](https://search.maven.org/search?q=Montoya-api) and
     <dependency>
         <groupId>net.portswigger.burp.extensions</groupId>
         <artifactId>montoya-api</artifactId>
-        <version>2023.12.1</version>
+        <version>2024.7</version>
     </dependency>
 
 <h5>Gradle</h5>
 
-    implementation 'net.portswigger.burp.extensions:montoya-api:2023.12.1'
+    implementation 'net.portswigger.burp.extensions:montoya-api:2024.7'
 
 Getting Started
 --------

diff --git a/docs/javadoc/allclasses-index.html b/docs/javadoc/allclasses-index.html
diff --git a/docs/javadoc/allpackages-index.html b/docs/javadoc/allpackages-index.html
@@ -1,15 +1,14 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (17) -->
-<title>All Packages (montoya-api 2023.12.1 API)</title>
+<!-- Generated by javadoc (21) -->
+<title>All Packages (montoya-api 2024.7 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <meta name="description" content="package index">
 <meta name="generator" content="javadoc/AllPackagesIndexWriter">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <link rel="stylesheet" type="text/css" href="script-dir/jquery-ui.min.css" title="Style">
-<link rel="stylesheet" type="text/css" href="jquery-ui.overrides.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 <script type="text/javascript" src="script-dir/jquery-3.6.1.min.js"></script>
 <script type="text/javascript" src="script-dir/jquery-ui.min.js"></script>
@@ -24,7 +23,7 @@
 <header role="banner" class="flex-header">
 <nav role="navigation">
 <!-- ========= START OF TOP NAVBAR ======= -->
-<div class="top-nav" id="navbar-top">
+<div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span></button>
 <div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
 <ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
 <li><a href="index.html">Overview</a></li>
@@ -37,9 +36,10 @@
 </ul>
 </div>
 <div class="sub-nav">
-<div class="nav-list-search"><label for="search-input">SEARCH:</label>
-<input type="text" id="search-input" value="search" disabled="disabled">
-<input type="reset" id="reset-button" value="reset" disabled="disabled">
+<div id="navbar-sub-list"></div>
+<div class="nav-list-search"><a href="search.html">SEARCH</a>
+<input type="text" id="search-input" disabled placeholder="Search">
+<input type="reset" id="reset-button" disabled value="reset">
 </div>
 </div>
 <!-- ========= END OF TOP NAVBAR ========= -->
@@ -96,41 +96,45 @@ <h1 title="All&amp;nbsp;Packages" class="title">All&nbsp;Packages</h1>
 <div class="col-last odd-row-color">&nbsp;</div>
 <div class="col-first even-row-color"><a href="burp/api/montoya/persistence/package-summary.html">burp.api.montoya.persistence</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/proxy/package-summary.html">burp.api.montoya.proxy</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/project/package-summary.html">burp.api.montoya.project</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/proxy/http/package-summary.html">burp.api.montoya.proxy.http</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/proxy/package-summary.html">burp.api.montoya.proxy</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/proxy/websocket/package-summary.html">burp.api.montoya.proxy.websocket</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/proxy/http/package-summary.html">burp.api.montoya.proxy.http</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/repeater/package-summary.html">burp.api.montoya.repeater</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/proxy/websocket/package-summary.html">burp.api.montoya.proxy.websocket</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/scanner/package-summary.html">burp.api.montoya.scanner</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/repeater/package-summary.html">burp.api.montoya.repeater</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/scanner/audit/package-summary.html">burp.api.montoya.scanner.audit</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/scanner/package-summary.html">burp.api.montoya.scanner</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/scanner/audit/insertionpoint/package-summary.html">burp.api.montoya.scanner.audit.insertionpoint</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/scanner/audit/package-summary.html">burp.api.montoya.scanner.audit</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/scanner/audit/issues/package-summary.html">burp.api.montoya.scanner.audit.issues</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/scanner/audit/insertionpoint/package-summary.html">burp.api.montoya.scanner.audit.insertionpoint</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/scanner/bchecks/package-summary.html">burp.api.montoya.scanner.bchecks</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/scanner/audit/issues/package-summary.html">burp.api.montoya.scanner.audit.issues</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/scope/package-summary.html">burp.api.montoya.scope</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/scanner/bchecks/package-summary.html">burp.api.montoya.scanner.bchecks</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/sitemap/package-summary.html">burp.api.montoya.sitemap</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/scope/package-summary.html">burp.api.montoya.scope</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/ui/package-summary.html">burp.api.montoya.ui</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/sitemap/package-summary.html">burp.api.montoya.sitemap</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/ui/contextmenu/package-summary.html">burp.api.montoya.ui.contextmenu</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/ui/package-summary.html">burp.api.montoya.ui</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/ui/editor/package-summary.html">burp.api.montoya.ui.editor</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/ui/contextmenu/package-summary.html">burp.api.montoya.ui.contextmenu</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/ui/editor/extension/package-summary.html">burp.api.montoya.ui.editor.extension</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/ui/editor/package-summary.html">burp.api.montoya.ui.editor</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/ui/menu/package-summary.html">burp.api.montoya.ui.menu</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/ui/editor/extension/package-summary.html">burp.api.montoya.ui.editor.extension</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
-<div class="col-first odd-row-color"><a href="burp/api/montoya/ui/swing/package-summary.html">burp.api.montoya.ui.swing</a></div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/ui/menu/package-summary.html">burp.api.montoya.ui.menu</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>
-<div class="col-first even-row-color"><a href="burp/api/montoya/utilities/package-summary.html">burp.api.montoya.utilities</a></div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/ui/swing/package-summary.html">burp.api.montoya.ui.swing</a></div>
+<div class="col-last even-row-color">&nbsp;</div>
+<div class="col-first odd-row-color"><a href="burp/api/montoya/utilities/package-summary.html">burp.api.montoya.utilities</a></div>
+<div class="col-last odd-row-color">&nbsp;</div>
+<div class="col-first even-row-color"><a href="burp/api/montoya/utilities/json/package-summary.html">burp.api.montoya.utilities.json</a></div>
 <div class="col-last even-row-color">&nbsp;</div>
 <div class="col-first odd-row-color"><a href="burp/api/montoya/websocket/package-summary.html">burp.api.montoya.websocket</a></div>
 <div class="col-last odd-row-color">&nbsp;</div>

diff --git a/docs/javadoc/burp/api/montoya/BurpExtension.html b/docs/javadoc/burp/api/montoya/BurpExtension.html
@@ -1,25 +1,20 @@
 <!DOCTYPE HTML>
 <html lang="en">
 <head>
-<!-- Generated by javadoc (17) -->
-<title>BurpExtension (montoya-api 2023.12.1 API)</title>
+<!-- Generated by javadoc (21) -->
+<title>BurpExtension (montoya-api 2024.7 API)</title>
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <meta name="description" content="declaration: package: burp.api.montoya, interface: BurpExtension">
 <meta name="generator" content="javadoc/ClassWriterImpl">
 <link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
 <link rel="stylesheet" type="text/css" href="../../../script-dir/jquery-ui.min.css" title="Style">
-<link rel="stylesheet" type="text/css" href="../../../jquery-ui.overrides.css" title="Style">
 <script type="text/javascript" src="../../../script.js"></script>
 <script type="text/javascript" src="../../../script-dir/jquery-3.6.1.min.js"></script>
 <script type="text/javascript" src="../../../script-dir/jquery-ui.min.js"></script>
 </head>
 <body class="class-declaration-page">
-<script type="text/javascript">var evenRowColor = "even-row-color";
-var oddRowColor = "odd-row-color";
-var tableTab = "table-tab";
-var activeTableTab = "active-table-tab";
-var pathtoroot = "../../../";
+<script type="text/javascript">var pathtoroot = "../../../";
 loadScripts(document, 'script');</script>
 <noscript>
 <div>JavaScript is disabled on your browser.</div>
@@ -28,7 +23,7 @@
 <header role="banner" class="flex-header">
 <nav role="navigation">
 <!-- ========= START OF TOP NAVBAR ======= -->
-<div class="top-nav" id="navbar-top">
+<div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span><span class="nav-bar-toggle-icon">&nbsp;</span></button>
 <div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
 <ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
 <li><a href="../../../index.html">Overview</a></li>
@@ -39,9 +34,28 @@
 <li><a href="../../../index-all.html">Index</a></li>
 <li><a href="../../../help-doc.html#class">Help</a></li>
 </ul>
+<ul class="sub-nav-list-small">
+<li>
+<p>Summary:</p>
+<ul>
+<li>Nested</li>
+<li>Field</li>
+<li>Constr</li>
+<li><a href="#method-summary">Method</a></li>
+</ul>
+</li>
+<li>
+<p>Detail:</p>
+<ul>
+<li>Field</li>
+<li>Constr</li>
+<li><a href="#method-detail">Method</a></li>
+</ul>
+</li>
+</ul>
 </div>
 <div class="sub-nav">
-<div>
+<div id="navbar-sub-list">
 <ul class="sub-nav-list">
 <li>Summary:&nbsp;</li>
 <li>Nested&nbsp;|&nbsp;</li>
@@ -56,9 +70,9 @@
 <li><a href="#method-detail">Method</a></li>
 </ul>
 </div>
-<div class="nav-list-search"><label for="search-input">SEARCH:</label>
-<input type="text" id="search-input" value="search" disabled="disabled">
-<input type="reset" id="reset-button" value="reset" disabled="disabled">
+<div class="nav-list-search"><a href="../../../search.html">SEARCH</a>
+<input type="text" id="search-input" disabled placeholder="Search">
+<input type="reset" id="reset-button" disabled value="reset">
 </div>
 </div>
 <!-- ========= END OF TOP NAVBAR ========= -->