buby 1.3.3-java → 1.5.0-java

metadata

@@ -1,18 +1,34 @@
 --- !ruby/object:Gem::Specification
 name: buby
 version: !ruby/object:Gem::Version
-  version: 1.3.3
   prerelease:
+  version: 1.5.0
 platform: java
 authors:
 - Eric Monti, tduehr
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2012-12-14 00:00:00.000000000 Z
-dependencies: []
+date: 2013-04-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.1
+    none: false
+  prerelease: false
+  type: :development
 description: Buby is a mashup of JRuby with the popular commercial web security testing tool Burp Suite from PortSwigger.  Burp is driven from and tied to JRuby with a Java extension using the BurpExtender API.  This extension aims to add Ruby scriptability to Burp Suite with an interface comparable to the Burp's pure Java extension interface.
-email: emonti@matasano.com, td@matasano.com
+email: td@matasano.com
 executables:
 - buby
 extensions: []
@@ -24,22 +40,104 @@ files:
 - History.txt
 - README.rdoc
 - Rakefile
-- VERSION
+- VERSION.yml
 - bin/buby
 - buby.gemspec
-- java/buby.jar
-- java/src/BurpExtender.java
-- java/src/burp/IBurpExtender.java
-- java/src/burp/IBurpExtenderCallbacks.java
-- java/src/burp/IHttpRequestResponse.java
-- java/src/burp/IMenuItemHandler.java
-- java/src/burp/IScanIssue.java
-- java/src/burp/IScanQueueItem.java
+- ext/buby/burp/BurpExtender.java
+- ext/burp_interfaces/burp/IBurpExtender.java
+- ext/burp_interfaces/burp/IBurpExtenderCallbacks.java
+- ext/burp_interfaces/burp/IContextMenuFactory.java
+- ext/burp_interfaces/burp/IContextMenuInvocation.java
+- ext/burp_interfaces/burp/ICookie.java
+- ext/burp_interfaces/burp/IExtensionHelpers.java
+- ext/burp_interfaces/burp/IExtensionStateListener.java
+- ext/burp_interfaces/burp/IHttpListener.java
+- ext/burp_interfaces/burp/IHttpRequestResponse.java
+- ext/burp_interfaces/burp/IHttpRequestResponsePersisted.java
+- ext/burp_interfaces/burp/IHttpRequestResponseWithMarkers.java
+- ext/burp_interfaces/burp/IHttpService.java
+- ext/burp_interfaces/burp/IInterceptedProxyMessage.java
+- ext/burp_interfaces/burp/IIntruderAttack.java
+- ext/burp_interfaces/burp/IIntruderPayloadGenerator.java
+- ext/burp_interfaces/burp/IIntruderPayloadGeneratorFactory.java
+- ext/burp_interfaces/burp/IIntruderPayloadProcessor.java
+- ext/burp_interfaces/burp/IMenuItemHandler.java
+- ext/burp_interfaces/burp/IMessageEditor.java
+- ext/burp_interfaces/burp/IMessageEditorController.java
+- ext/burp_interfaces/burp/IMessageEditorTab.java
+- ext/burp_interfaces/burp/IMessageEditorTabFactory.java
+- ext/burp_interfaces/burp/IParameter.java
+- ext/burp_interfaces/burp/IProxyListener.java
+- ext/burp_interfaces/burp/IRequestInfo.java
+- ext/burp_interfaces/burp/IResponseInfo.java
+- ext/burp_interfaces/burp/IScanIssue.java
+- ext/burp_interfaces/burp/IScanQueueItem.java
+- ext/burp_interfaces/burp/IScannerCheck.java
+- ext/burp_interfaces/burp/IScannerInsertionPoint.java
+- ext/burp_interfaces/burp/IScannerInsertionPointProvider.java
+- ext/burp_interfaces/burp/IScannerListener.java
+- ext/burp_interfaces/burp/IScopeChangeListener.java
+- ext/burp_interfaces/burp/ISessionHandlingAction.java
+- ext/burp_interfaces/burp/ITab.java
+- ext/burp_interfaces/burp/ITempFile.java
+- ext/burp_interfaces/burp/ITextEditor.java
 - lib/buby.rb
-- lib/buby/extends.rb
-- lib/buby/extends/buby_array_wrapper.rb
-- lib/buby/extends/http_request_response.rb
-- lib/buby/extends/scan_issue.rb
+- lib/buby/burp_extender.rb
+- lib/buby/burp_extender/console_frame.rb
+- lib/buby/burp_extender/console_pane.rb
+- lib/buby/burp_extender/console_tab.rb
+- lib/buby/burp_extender/context_menu.rb
+- lib/buby/burp_extender/context_menu_factory.rb
+- lib/buby/burp_extender/context_menu_item.rb
+- lib/buby/burp_extender/jcheck_box_menu_item.rb
+- lib/buby/burp_extender/jmenu.rb
+- lib/buby/burp_extender/jmenu_item.rb
+- lib/buby/burp_extender/menu.rb
+- lib/buby/burp_extender/menu_item.rb
+- lib/buby/context_menu_factory.rb
+- lib/buby/cookie.rb
+- lib/buby/extender.rb
+- lib/buby/http_listener.rb
+- lib/buby/implants.rb
+- lib/buby/implants/buby_array_wrapper.rb
+- lib/buby/implants/context_menu_invocation.rb
+- lib/buby/implants/cookie.rb
+- lib/buby/implants/extension_helpers.rb
+- lib/buby/implants/http_request_response.rb
+- lib/buby/implants/intercepted_proxy_message.rb
+- lib/buby/implants/intruder_attack.rb
+- lib/buby/implants/jruby.rb
+- lib/buby/implants/message_editor.rb
+- lib/buby/implants/message_editor_controller.rb
+- lib/buby/implants/parameter.rb
+- lib/buby/implants/request_info.rb
+- lib/buby/implants/response_info.rb
+- lib/buby/implants/scan_issue.rb
+- lib/buby/implants/scan_queue_item.rb
+- lib/buby/implants/scanner_insertion_point.rb
+- lib/buby/implants/temp_file.rb
+- lib/buby/implants/text_editor.rb
+- lib/buby/intruder_payload_generator.rb
+- lib/buby/intruder_payload_generator_factory.rb
+- lib/buby/intruder_payload_processor.rb
+- lib/buby/message_editor_controller.rb
+- lib/buby/message_editor_tab.rb
+- lib/buby/message_editor_tab_factory.rb
+- lib/buby/parameter.rb
+- lib/buby/parameter/base.rb
+- lib/buby/parameter/body.rb
+- lib/buby/parameter/cookie.rb
+- lib/buby/parameter/url.rb
+- lib/buby/proxy_listener.rb
+- lib/buby/scan_issue.rb
+- lib/buby/scanner_check.rb
+- lib/buby/scanner_insertion_point.rb
+- lib/buby/scanner_insertion_point_provider.rb
+- lib/buby/scanner_listener.rb
+- lib/buby/scope_change_listener.rb
+- lib/buby/session_handling_action.rb
+- lib/buby/tab.rb
+- lib/buby/version.rb
 - samples/drb_buby.rb
 - samples/drb_sample_cli.rb
 - samples/mechanize_burp.rb
@@ -52,22 +150,20 @@ homepage: http://tduehr.github.com/buby
 licenses: []
 post_install_message:
 rdoc_options:
-- --main
+- "--main"
 - README.rdoc
 require_paths:
 - lib
-- java
-- java
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: !binary |-
         MA==
   none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: !binary |-
         MA==

data/VERSION

@@ -1 +0,0 @@
-1.3.3

data/java/src/burp/IBurpExtender.java

@@ -1,180 +0,0 @@
-package burp;
-
-/*
- * @(#)IBurpExtender.java
- *
- * Copyright PortSwigger Ltd. All rights reserved.
- * 
- * This code may be used to extend the functionality of Burp Suite and Burp
- * Suite Professional, provided that this usage does not violate the 
- * license terms for those products. 
- */
-
-/**
- * This interface allows third-party code to extend Burp Suite's functionality.
- *
- * Implementations must be called BurpExtender, in the package burp, 
- * must be declared public, and must provide a default (public, no-argument) 
- * constructor. On startup, Burp Suite searches its classpath for the class 
- * burp.BurpExtender, and attempts to dynamically load and instantiate this 
- * class. The <code>IBurpExtender</code> methods implemented will then be 
- * dynamically invoked as appropriate.<p>
- *
- * Partial implementations are acceptable. The class will be used provided at
- * least one of the interface's methods is implemented.<p>
- *
- * To make use of the interface, create a class called BurpExtender, in the 
- * package burp, which implements one or more methods of the interface, and 
- * place this into the application's classpath at startup. For example, if 
- * Burp Suite is loaded from burp.jar, and BurpProxyExtender.jar contains the 
- * class burp.BurpExtender, use the following command to launch Burp Suite and 
- * load the IBurpExtender implementation:<p>
- *
- * <PRE>    java -classpath burp.jar;BurpProxyExtender.jar burp.StartBurp</PRE>
- * 
- * (On Linux-based platforms, use a colon character instead of the semi-colon 
- * as the classpath separator.)
- */
-
-public interface IBurpExtender
-{
-    /**
-     * This method is invoked immediately after the implementation's constructor
-     * to pass any command-line arguments that were passed to Burp Suite on
-     * startup. It allows implementations to control aspects of their behaviour
-     * at runtime by defining their own command-line arguments.
-     *
-     * @param args The command-line arguments passed to Burp Suite on startup.
-     */
-    public void setCommandLineArgs(String[] args);
-    
-    /**
-     * This method is invoked by Burp Proxy whenever a client request or server
-     * response is received. It allows implementations to perform logging 
-     * functions, modify the message, specify an action (intercept, drop, etc.)
-     * and perform any other arbitrary processing.
-     *
-     * @param messageReference An identifier which is unique to a single 
-     * request/response pair. This can be used to correlate details of requests
-     * and responses and perform processing on the response message accordingly.
-     * @param messageIsRequest Flags whether the message is a client request or
-     * a server response.
-     * @param remoteHost The hostname of the remote HTTP server.
-     * @param remotePort The port of the remote HTTP server.
-     * @param serviceIsHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param httpMethod The method verb used in the client request.
-     * @param url The requested URL.
-     * @param resourceType The filetype of the requested resource, or a 
-     * zero-length string if the resource has no filetype.
-     * @param statusCode The HTTP status code returned by the server. This value
-     * is <code>null</code> for request messages.
-     * @param responseContentType The content-type string returned by the 
-     * server. This value is <code>null</code> for request messages.
-     * @param message The full HTTP message.
-     * @param action An array containing a single integer, allowing the
-     * implementation to communicate back to Burp Proxy a non-default 
-     * interception action for the message. The default value is 
-     * <code>ACTION_FOLLOW_RULES</code>. Set <code>action[0]</code> to one of 
-     * the other possible values to perform a different action.
-     * @return Implementations should return either (a) the same object received
-     * in the <code>message</code> paramater, or (b) a different object 
-     * containing a modified message.
-     */
-    public byte[] processProxyMessage(
-            int messageReference,
-            boolean messageIsRequest,
-            String remoteHost,
-            int remotePort,
-            boolean serviceIsHttps,
-            String httpMethod,
-            String url,
-            String resourceType,
-            String statusCode,
-            String responseContentType,
-            byte[] message,
-            int[] action);
-    
-    /** 
-     * Causes Burp Proxy to follow the current interception rules to determine
-     * the appropriate action to take for the message.
-     */
-    public final static int ACTION_FOLLOW_RULES = 0;
-    /** 
-     * Causes Burp Proxy to present the message to the user for manual
-     * review or modification.
-     */
-    public final static int ACTION_DO_INTERCEPT = 1;
-    /** 
-     * Causes Burp Proxy to forward the message to the remote server or client.
-     */
-    public final static int ACTION_DONT_INTERCEPT = 2;
-    /** 
-     * Causes Burp Proxy to drop the message and close the client connection.
-     */
-    public final static int ACTION_DROP = 3;
-    /**
-     * Causes Burp Proxy to follow the current interception rules to determine
-     * the appropriate action to take for the message, and then make a second
-     * call to processProxyMessage.
-     */
-    public final static int ACTION_FOLLOW_RULES_AND_REHOOK = 0x10;
-    /**
-     * Causes Burp Proxy to present the message to the user for manual
-     * review or modification, and then make a second call to
-     * processProxyMessage.
-     */
-    public final static int ACTION_DO_INTERCEPT_AND_REHOOK = 0x11;
-    /**
-     * Causes Burp Proxy to skip user interception, and then make a second call
-     * to processProxyMessage.
-     */
-    public final static int ACTION_DONT_INTERCEPT_AND_REHOOK = 0x12;
-
-    /**
-     * This method is invoked on startup. It registers an instance of the 
-     * <code>IBurpExtenderCallbacks</code> interface, providing methods that 
-     * may be invoked by the implementation to perform various actions.
-     * 
-     * The call to registerExtenderCallbacks need not return, and 
-     * implementations may use the invoking thread for any purpose.<p>
-     *
-     * @param callbacks An implementation of the 
-     * <code>IBurpExtenderCallbacks</code> interface.
-     */
-    public void registerExtenderCallbacks(burp.IBurpExtenderCallbacks callbacks);
-    
-    /**
-     * This method is invoked immediately before Burp Suite exits. 
-     * It allows implementations to carry out any clean-up actions necessary
-     * (e.g. flushing log files or closing database resources).
-     */
-    public void applicationClosing();
-    
-    /**
-     * This method is invoked whenever any of Burp's tools makes an HTTP request 
-     * or receives a response. It allows extensions to intercept and modify the 
-     * HTTP traffic of all Burp tools. For each request, the method is invoked 
-     * after the request has been fully processed by the invoking tool and is 
-     * about to be made on the network. For each response, the method is invoked
-     * after the response has been received from the network and before any 
-     * processing is performed by the invoking tool.
-     * 
-     * @param toolName The name of the Burp tool which is making the request.
-     * @param messageIsRequest Indicates whether the message is a request or 
-     * response.
-     * @param messageInfo Details of the HTTP message.
-     */
-    public void processHttpMessage(
-            String toolName, 
-            boolean messageIsRequest, 
-            IHttpRequestResponse messageInfo);
-    
-    /** 
-     * This method is invoked whenever Burp Scanner discovers a new, unique 
-     * issue, and can be used to perform customised reporting or logging of issues. 
-     * 
-     * @param issue Details of the new scan issue.
-     */
-    public void newScanIssue(IScanIssue issue);
-    
-}

data/java/src/burp/IBurpExtenderCallbacks.java

@@ -1,373 +0,0 @@
-package burp;
-
-import java.util.List;
-import java.util.Map;
-
-/*
- * @(#)IBurpExtenderCallbacks.java
- *
- * Copyright PortSwigger Ltd. All rights reserved.
- * 
- * This code may be used to extend the functionality of Burp Suite and Burp
- * Suite Professional, provided that this usage does not violate the 
- * license terms for those products. 
- */
-
-/**
- * This interface is used by Burp Suite to pass to implementations of the 
- * <code>IBurpExtender</code> interface a set of callback methods which can 
- * be used by implementations to perform various actions within Burp Suite.
- * 
- * If an implementation of <code>IBurpExtender</code> is loaded then on startup 
- * Burp Suite will invoke the implementation's 
- * <code>registerExtenderCallbacks</code> method (if present) and pass to 
- * the implementation an instance of the <code>IBurpExtenderCallbacks</code> 
- * interface. The implementation may then invoke the methods of this instance 
- * as it sees fit in order to extend Burp Suite's functionality.<p>
- */
-
-public interface IBurpExtenderCallbacks
-{
-    /**
-     * This method can be used to issue arbitrary HTTP requests and retrieve 
-     * their responses.
-     *
-     * @param host The hostname of the remote HTTP server.
-     * @param port The port of the remote HTTP server.
-     * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param request The full HTTP request.
-     * @return The full response retrieved from the remote server.
-     * @throws java.lang.Exception
-     */
-    public byte[] makeHttpRequest(
-            String host,
-            int port,
-            boolean useHttps,
-            byte[] request) throws Exception;
-
-    /**
-     * This method can be used to send an HTTP request to the Burp Repeater 
-     * tool. The request will be displayed in the user interface, but will not 
-     * be issued until the user initiates this action.
-     *
-     * @param host The hostname of the remote HTTP server.
-     * @param port The port of the remote HTTP server.
-     * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param request The full HTTP request.
-     * @param tabCaption An optional caption which will appear on the Repeater 
-     * tab containing the request. If this value is <code>null</code> then a 
-     * default tab index will be displayed.
-     * @throws java.lang.Exception
-     */
-    public void sendToRepeater(
-            String host,
-            int port,
-            boolean useHttps,
-            byte[] request,
-            String tabCaption) throws Exception;
-
-    /**
-     * This method can be used to send an HTTP request to the Burp Intruder 
-     * tool. The request will be displayed in the user interface, and markers 
-     * for attack payloads will be placed into default locations within the 
-     * request.
-     *
-     * @param host The hostname of the remote HTTP server.
-     * @param port The port of the remote HTTP server.
-     * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param request The full HTTP request.
-     * @throws java.lang.Exception
-     */
-    public void sendToIntruder(
-            String host,
-            int port,
-            boolean useHttps,
-            byte[] request) throws Exception;
-
-
-    /**
-    * This method can be used to send an HTTP request to the Burp Intruder
-    * tool. The request will be displayed in the user interface, and markers
-    * for attack payloads will be placed into the specified locations within
-    * the request.
-    *
-    * @param host The hostname of the remote HTTP server.
-    * @param port The port of the remote HTTP server.
-    * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-    * @param request The full HTTP request.
-    * @param payloadPositionOffsets A list of index pairs representing the
-    * payload positions to be used. Each item in the list must be an int[2]
-    * array containing the start and end offset for the payload position.
-    * @throws java.lang.Exception
-    */
-    public void sendToIntruder(
-        String host,
-        int port,
-        boolean useHttps,
-        byte[] request,
-        List payloadPositionOffsets) throws Exception;
-
-    /**
-     * 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 they wish to add the URL to the scope. If the Spider is not currently 
-     * running, it will be started. The seed URL will be requested, and the 
-     * Spider will process the application's response in the normal way.
-     * 
-     * @param url The new seed URL to begin spidering from.
-     * @throws java.lang.Exception
-     */
-    public void sendToSpider(
-            java.net.URL url) throws Exception;
-
-    /**
-     * This method can be used to send an HTTP request to the Burp Scanner
-     * tool to perform an active vulnerability scan. If the request is not
-     * within the current active scanning scope, the user will be asked if
-     * they wish to proceed with the scan.
-     *
-     * @param host The hostname of the remote HTTP server.
-     * @param port The port of the remote HTTP server.
-     * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param request The full HTTP request.
-     * @return The resulting scan queue item.
-     * @throws java.lang.Exception
-     */
-    public IScanQueueItem doActiveScan(
-            String host,
-            int port,
-            boolean useHttps,
-            byte[] request) throws Exception;
-
-    /**
-     * This method can be used to send an HTTP request to the Burp Scanner
-     * tool to perform an active vulnerability scan, based on a custom list
-     * of insertion points that are to be scanned. If the request is not
-     * within the current active scanning scope, the user will be asked if
-     * they wish to proceed with the scan.
-     *
-     * @param host The hostname of the remote HTTP server.
-     * @param port The port of the remote HTTP server.
-     * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param request The full HTTP request.
-     * @param insertionPointOffsets A list of index pairs representing the
-     * positions of the insertion points that should be scanned. Each item in
-     * the list must be an int[2] array containing the start and end offsets
-     * for the insertion point.
-     * @return The resulting scan queue item.
-     * @throws java.lang.Exception
-     */
-    public IScanQueueItem doActiveScan(
-            String host,
-            int port,
-            boolean useHttps,
-            byte[] request,
-            List<int[]> insertionPointOffsets) throws Exception;
-
-    /**
-     * This method can be used to send an HTTP request to the Burp Scanner 
-     * tool to perform a passive vulnerability scan.
-     *
-     * @param host The hostname of the remote HTTP server.
-     * @param port The port of the remote HTTP server.
-     * @param useHttps Flags whether the protocol is HTTPS or HTTP.
-     * @param request The full HTTP request.
-     * @param response The full HTTP response.
-     * @throws java.lang.Exception
-     */
-    public void doPassiveScan(
-            String host,
-            int port,
-            boolean useHttps,
-            byte[] request,
-            byte[] response) throws Exception;
-    
-    /**
-     * This method can be used to query whether a specified URL is within 
-     * the current Suite-wide scope.
-     * 
-     * @param url The URL to query.
-     * @return Returns <code>true</code> if the URL is within the current 
-     * Suite-wide scope.
-     * @throws java.lang.Exception
-     */
-    boolean isInScope(java.net.URL url) throws Exception;
-    
-    /**
-     * This method can be used to include the specified URL in the Suite-wide 
-     * scope.
-     * 
-     * @param url The URL to include in the Suite-wide scope.
-     * @throws java.lang.Exception
-     */
-    void includeInScope(java.net.URL url) throws Exception;
-    
-    /**
-     * This method can be used to exclude the specified URL from the Suite-wide 
-     * scope.
-     * 
-     * @param url The URL to exclude from the Suite-wide scope.
-     * @throws java.lang.Exception
-     */
-    void excludeFromScope(java.net.URL url) throws Exception;
-
-    /**
-     * This method can be used to display a specified message in the Burp 
-     * Suite alerts tab.
-     * 
-     * @param message The alert message to display.
-     */
-    public void issueAlert(String message);
-    
-    /**
-     * This method returns details of all items in the proxy history.
-     * 
-     * @return The contents of the proxy history.
-     */
-    public IHttpRequestResponse[] getProxyHistory();
-    
-    /**
-     * This method returns details of items in the site map.
-     * 
-     * @param urlPrefix This parameter can be used to specify a URL prefix, in 
-     * order to extract a specific subset of the site map. The method performs 
-     * a simple case-sensitive text match, returning all site 
-     * map items whose URL begins with the specified prefix. If this parameter 
-     * is null, the entire site map is returned.
-     * @return Details of items in the site map.
-     */
-    public IHttpRequestResponse[] getSiteMap(String urlPrefix);
-
-
-    /**
-     * This method can be used to add an item to Burp's site map with the
-     * specified request/response details. This will overwrite the details
-     * of any existing matching item in the site map.
-     *
-     * @param item Details of the item to be added to the site map
-     */
-    public void addToSiteMap(IHttpRequestResponse item);
-
-    /**
-     * This method can be used to restore Burp's state from a specified 
-     * saved state file. This method blocks until the restore operation is 
-     * completed, and must not be called from the event thread.
-     * 
-     * @param file The file containing Burp's saved state.
-     * @throws java.lang.Exception
-     */
-    public void restoreState(java.io.File file) throws Exception;
-    
-    /**
-     * This method can be used to save Burp's state to a specified file. 
-     * This method blocks until the save operation is completed, and must not be 
-     * called from the event thread.
-     * 
-     * @param file The file to save Burp's state in.
-     * @throws java.lang.Exception
-     */
-    public void saveState(java.io.File file) throws Exception;
-    
-    /**
-     * This method parses the specified request and returns details of each
-     * request parameter.
-     * 
-     * @param request The request to be parsed.
-     * @return An array of:
-     * <code>String[] { name, value, type }</code> 
-     * containing details of the parameters contained within the request.
-     * @throws java.lang.Exception
-     */
-    public String[][] getParameters(byte[] request) throws Exception;
-    
-    /**
-     * This method parses the specified request and returns details of each
-     * HTTP header.
-     * 
-     * @param message The request to be parsed.
-     * @return An array of HTTP headers.
-     * @throws java.lang.Exception
-     */
-    public String[] getHeaders(byte[] message) throws Exception;
-    
-    /**
-     * This method returns all of the current scan issues for URLs matching the 
-     * specified literal prefix. 
-     * 
-     * @param urlPrefix This parameter can be used to specify a URL prefix, in 
-     * order to extract a specific subset of scan issues. The method performs 
-     * a simple case-sensitive text match, returning all scan issues whose URL 
-     * begins with the specified prefix. If this parameter is null, all issues 
-     * are returned.
-     * @return Details of the scan issues.
-     */
-    public IScanIssue[] getScanIssues(String urlPrefix);
-    
-    /**
-     * 
-     * This method can be used to register a new menu item which will appear 
-     * on the various context menus that are used throughout Burp Suite to 
-     * handle user-driven actions.
-     * 
-     * @param menuItemCaption The caption to be displayed on the menu item.
-     * @param menuItemHandler The handler to be invoked when the user clicks
-     * on the menu item.
-     */
-    public void registerMenuItem(
-            String menuItemCaption,
-            IMenuItemHandler menuItemHandler);
-
-    /**
-     *
-     * This method causes Burp to save all of its current configuration as a
-     * Map of name/value Strings.
-     *
-     * @return A Map of name/value Strings reflecting Burp's current
-     * configuration.
-     */
-    public Map saveConfig();
-
-    /**
-     *
-     * This method causes Burp to load a new configuration from the Map of
-     * name/value Strings provided. Any settings not specified in the Map will
-     * be restored to their default values. To selectively update only some
-     * settings and leave the rest unchanged, you should first call
-     * <code>saveConfig</code> to obtain Burp's current configuration, modify
-     * the relevant items in the Map, and then call <code>loadConfig</code>
-     * with the same Map.
-     *
-     * @param config A map of name/value Strings to use as Burp's new
-     * configuration.
-     */
-    public void loadConfig(Map config);
-
-
-    /**
-     * 
-     * This method sets the interception mode for Burp Proxy.
-     * 
-     * @param enabled Indicates whether interception of proxy messages should 
-     * be enabled.
-     */
-    public void setProxyInterceptionEnabled(boolean enabled);
-
-
-    /**
-     * This method can be used to shut down Burp programmatically, with an 
-     * optional prompt to the user. If the method returns, the user cancelled 
-     * the shutdown prompt.
-     * 
-     * @param promptUser Indicates whether to prompt the user to confirm the 
-     * shutdown.
-     */
-    public void exitSuite(boolean promptUser);
-    
-    /**
-     *  This method can be used to determine the version of the loaded burp at runtime.
-     *  This is included in the Javadoc for the extension interfaces but not the supplied interface files.
-     *  @return String array containing the product name, major version, and minor version.
-     */
-     public String[] getBurpVersion();
-
-}