Added manual testing mode

Author: federicodotta

src/burp/BurpExtender.java

@@ -109,6 +109,22 @@ public interface IBurpExtenderCallbacks
      */
     OutputStream getStderr();
 
+    /**
+     * This method prints a line of output to the current extension's standard
+     * output stream.
+     *
+     * @param output The message to print.
+     */
+    void printOutput(String output);
+
+    /**
+     * This method prints a line of output to the current extension's standard
+     * error stream.
+     *
+     * @param error The message to print.
+     */
+    void printError(String error);
+
     /**
      * This method is used to register a listener which will be notified of
      * changes to the extension's state. <b>Note:</b> Any extensions that start
@@ -121,6 +137,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerExtensionStateListener(IExtensionStateListener listener);
 
+    /**
+     * This method is used to retrieve the extension state listeners that are
+     * registered by the extension.
+     *
+     * @return A list of extension state listeners that are currently registered
+     * by this extension.
+     */
+    List<IExtensionStateListener> getExtensionStateListeners();
+
+    /**
+     * This method is used to remove an extension state listener that has been
+     * registered by the extension.
+     *
+     * @param listener The extension state listener to be removed.
+     */
+    void removeExtensionStateListener(IExtensionStateListener listener);
+
     /**
      * This method is used to register a listener which will be notified of
      * requests and responses made by any Burp tool. Extensions can perform
@@ -132,6 +165,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerHttpListener(IHttpListener listener);
 
+    /**
+     * This method is used to retrieve the HTTP listeners that are registered by
+     * the extension.
+     *
+     * @return A list of HTTP listeners that are currently registered by this
+     * extension.
+     */
+    List<IHttpListener> getHttpListeners();
+
+    /**
+     * This method is used to remove an HTTP listener that has been registered
+     * by the extension.
+     *
+     * @param listener The HTTP listener to be removed.
+     */
+    void removeHttpListener(IHttpListener listener);
+
     /**
      * This method is used to register a listener which will be notified of
      * requests and responses being processed by the Proxy tool. Extensions can
@@ -143,6 +193,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerProxyListener(IProxyListener listener);
 
+    /**
+     * This method is used to retrieve the Proxy listeners that are registered
+     * by the extension.
+     *
+     * @return A list of Proxy listeners that are currently registered by this
+     * extension.
+     */
+    List<IProxyListener> getProxyListeners();
+
+    /**
+     * This method is used to remove a Proxy listener that has been registered
+     * by the extension.
+     *
+     * @param listener The Proxy listener to be removed.
+     */
+    void removeProxyListener(IProxyListener listener);
+
     /**
      * This method is used to register a listener which will be notified of new
      * issues that are reported by the Scanner tool. Extensions can perform
@@ -154,6 +221,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerScannerListener(IScannerListener listener);
 
+    /**
+     * This method is used to retrieve the Scanner listeners that are registered
+     * by the extension.
+     *
+     * @return A list of Scanner listeners that are currently registered by this
+     * extension.
+     */
+    List<IScannerListener> getScannerListeners();
+
+    /**
+     * This method is used to remove a Scanner listener that has been registered
+     * by the extension.
+     *
+     * @param listener The Scanner listener to be removed.
+     */
+    void removeScannerListener(IScannerListener listener);
+
     /**
      * This method is used to register a listener which will be notified of
      * changes to Burp's suite-wide target scope.
@@ -163,6 +247,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerScopeChangeListener(IScopeChangeListener listener);
 
+    /**
+     * This method is used to retrieve the scope change listeners that are
+     * registered by the extension.
+     *
+     * @return A list of scope change listeners that are currently registered by
+     * this extension.
+     */
+    List<IScopeChangeListener> getScopeChangeListeners();
+
+    /**
+     * This method is used to remove a scope change listener that has been
+     * registered by the extension.
+     *
+     * @param listener The scope change listener to be removed.
+     */
+    void removeScopeChangeListener(IScopeChangeListener listener);
+
     /**
      * This method is used to register a factory for custom context menu items.
      * When the user invokes a context menu anywhere within Burp, the factory
@@ -174,6 +275,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerContextMenuFactory(IContextMenuFactory factory);
 
+    /**
+     * This method is used to retrieve the context menu factories that are
+     * registered by the extension.
+     *
+     * @return A list of context menu factories that are currently registered by
+     * this extension.
+     */
+    List<IContextMenuFactory> getContextMenuFactories();
+
+    /**
+     * This method is used to remove a context menu factory that has been
+     * registered by the extension.
+     *
+     * @param factory The context menu factory to be removed.
+     */
+    void removeContextMenuFactory(IContextMenuFactory factory);
+
     /**
      * This method is used to register a factory for custom message editor tabs.
      * For each message editor that already exists, or is subsequently created,
@@ -186,6 +304,23 @@ public interface IBurpExtenderCallbacks
      */
     void registerMessageEditorTabFactory(IMessageEditorTabFactory factory);
 
+    /**
+     * This method is used to retrieve the message editor tab factories that are
+     * registered by the extension.
+     *
+     * @return A list of message editor tab factories that are currently
+     * registered by this extension.
+     */
+    List<IMessageEditorTabFactory> getMessageEditorTabFactories();
+
+    /**
+     * This method is used to remove a message editor tab factory that has been
+     * registered by the extension.
+     *
+     * @param factory The message editor tab factory to be removed.
+     */
+    void removeMessageEditorTabFactory(IMessageEditorTabFactory factory);
+
     /**
      * This method is used to register a provider of Scanner insertion points.
      * For each base request that is actively scanned, Burp will ask the
@@ -198,6 +333,24 @@ public interface IBurpExtenderCallbacks
     void registerScannerInsertionPointProvider(
             IScannerInsertionPointProvider provider);
 
+    /**
+     * This method is used to retrieve the Scanner insertion point providers
+     * that are registered by the extension.
+     *
+     * @return A list of Scanner insertion point providers that are currently
+     * registered by this extension.
+     */
+    List<IScannerInsertionPointProvider> getScannerInsertionPointProviders();
+
+    /**
+     * This method is used to remove a Scanner insertion point provider that has
+     * been registered by the extension.
+     *
+     * @param provider The Scanner insertion point provider to be removed.
+     */
+    void removeScannerInsertionPointProvider(
+            IScannerInsertionPointProvider provider);
+
     /**
      * This method is used to register a custom Scanner check. When performing
      * scanning, Burp will ask the check to perform active or passive scanning
@@ -208,6 +361,23 @@ void registerScannerInsertionPointProvider(
      */
     void registerScannerCheck(IScannerCheck check);
 
+    /**
+     * This method is used to retrieve the Scanner checks that are registered by
+     * the extension.
+     *
+     * @return A list of Scanner checks that are currently registered by this
+     * extension.
+     */
+    List<IScannerCheck> getScannerChecks();
+
+    /**
+     * This method is used to remove a Scanner check that has been registered by
+     * the extension.
+     *
+     * @param check The Scanner check to be removed.
+     */
+    void removeScannerCheck(IScannerCheck check);
+
     /**
      * This method is used to register a factory for Intruder payloads. Each
      * registered factory will be available within the Intruder UI for the user
@@ -222,6 +392,25 @@ void registerScannerInsertionPointProvider(
     void registerIntruderPayloadGeneratorFactory(
             IIntruderPayloadGeneratorFactory factory);
 
+    /**
+     * This method is used to retrieve the Intruder payload generator factories
+     * that are registered by the extension.
+     *
+     * @return A list of Intruder payload generator factories that are currently
+     * registered by this extension.
+     */
+    List<IIntruderPayloadGeneratorFactory> 
+            getIntruderPayloadGeneratorFactories();
+
+    /**
+     * This method is used to remove an Intruder payload generator factory that
+     * has been registered by the extension.
+     *
+     * @param factory The Intruder payload generator factory to be removed.
+     */
+    void removeIntruderPayloadGeneratorFactory(
+            IIntruderPayloadGeneratorFactory factory);
+
     /**
      * This method is used to register a custom Intruder payload processor. Each
      * registered processor will be available within the Intruder UI for the
@@ -232,6 +421,23 @@ void registerIntruderPayloadGeneratorFactory(
      */
     void registerIntruderPayloadProcessor(IIntruderPayloadProcessor processor);
 
+    /**
+     * This method is used to retrieve the Intruder payload processors that are
+     * registered by the extension.
+     *
+     * @return A list of Intruder payload processors that are currently
+     * registered by this extension.
+     */
+    List<IIntruderPayloadProcessor> getIntruderPayloadProcessors();
+
+    /**
+     * This method is used to remove an Intruder payload processor that has been
+     * registered by the extension.
+     *
+     * @param processor The Intruder payload processor to be removed.
+     */
+    void removeIntruderPayloadProcessor(IIntruderPayloadProcessor processor);
+
     /**
      * This method is used to register a custom session handling action. Each
      * registered action will be available within the session handling rule UI
@@ -243,6 +449,23 @@ void registerIntruderPayloadGeneratorFactory(
      */
     void registerSessionHandlingAction(ISessionHandlingAction action);
 
+    /**
+     * This method is used to retrieve the session handling actions that are
+     * registered by the extension.
+     *
+     * @return A list of session handling actions that are currently registered
+     * by this extension.
+     */
+    List<ISessionHandlingAction> getSessionHandlingActions();
+
+    /**
+     * This method is used to remove a session handling action that has been
+     * registered by the extension.
+     *
+     * @param action The extension session handling action to be removed.
+     */
+    void removeSessionHandlingAction(ISessionHandlingAction action);
+
     /**
      * This method is used to unload the extension from Burp Suite.
      */
@@ -267,7 +490,9 @@ void registerIntruderPayloadGeneratorFactory(
 
     /**
      * This method is used to customize UI components in line with Burp's UI
-     * style, including font size, colors, table line spacing, etc.
+     * style, including font size, colors, table line spacing, etc. The action
+     * is performed recursively on any child components of the passed-in
+     * component.
      *
      * @param component The UI component to be customized.
      */
@@ -392,6 +617,13 @@ void sendToIntruder(
             byte[] request,
             List<int[]> payloadPositionOffsets);
 
+    /**
+     * This method can be used to send data to the Comparer tool.
+     *
+     * @param data The data to be sent to Comparer.
+     */
+    void sendToComparer(byte[] data);
+
     /**
      * This method can be used to send a seed URL to the Burp Spider tool. If
      * the URL is not within the current Spider scope, the user will be asked if
@@ -570,7 +802,8 @@ byte[] makeHttpRequest(
      * @param issues The Scanner issues to be reported.
      * @param file The file to which the report will be saved.
      */
-    void generateScanReport(String format, IScanIssue[] issues, java.io.File file);
+    void generateScanReport(String format, IScanIssue[] issues, 
+            java.io.File file);
 
     /**
      * This method is used to retrieve the contents of Burp's session handling
@@ -669,6 +902,23 @@ byte[] makeHttpRequest(
      */
     String[] getBurpVersion();
 
+    /**
+     * This method retrieves the absolute path name of the file from which the
+     * current extension was loaded.
+     *
+     * @return The absolute path name of the file from which the current
+     * extension was loaded.
+     */
+    String getExtensionFilename();
+
+    /**
+     * This method determines whether the current extension was loaded as a
+     * BApp (a Burp App from the BApp Store).
+     *
+     * @return Returns true if the current extension was loaded as a BApp.
+     */
+    boolean isExtensionBapp();
+
     /**
      * This method can be used to shut down Burp programmatically, with an
      * optional prompt to the user. If the method returns, the user canceled the

src/burp/IBurpExtenderCallbacks.java

@@ -29,6 +29,14 @@ public interface ICookie
      */
     String getDomain();
 
+    /**
+     * This method is used to retrieve the path for which the cookie is in
+     * scope.
+     *
+     * @return The path for which the cookie is in scope or null if none is set.
+     */
+    String getPath();
+
     /**
      * This method is used to retrieve the expiration time for the cookie.
      *

src/burp/ICookie.java

@@ -18,9 +18,8 @@
 public interface IHttpRequestResponsePersisted extends IHttpRequestResponse
 {
     /**
-     * This method is used to permanently delete the saved temporary files. It
-     * will no longer be possible to retrieve the request or response for this
-     * item.
+     * This method is deprecated and no longer performs any action.
      */
+    @Deprecated
     void deleteTempFiles();
 }