iburpextender.html

这是一个HTTP和HTTPS的代理服务器

<DL>
<DD>Causes burp proxy to follow the current interception rules to determine
 the appropriate action to take for the message.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="constant-values.html#IBurpExtender.ACTION_FOLLOW_RULES">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ACTION_DO_INTERCEPT"><!-- --></A><H3>
ACTION_DO_INTERCEPT</H3>
<PRE>
static final int <B>ACTION_DO_INTERCEPT</B></PRE>
<DL>
<DD>Causes burp proxy to present the message to the user for manual
 review or modification.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="constant-values.html#IBurpExtender.ACTION_DO_INTERCEPT">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ACTION_DONT_INTERCEPT"><!-- --></A><H3>
ACTION_DONT_INTERCEPT</H3>
<PRE>
static final int <B>ACTION_DONT_INTERCEPT</B></PRE>
<DL>
<DD>Causes burp proxy to forward the message to the remote server.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="constant-values.html#IBurpExtender.ACTION_DONT_INTERCEPT">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ACTION_DROP"><!-- --></A><H3>
ACTION_DROP</H3>
<PRE>
static final int <B>ACTION_DROP</B></PRE>
<DL>
<DD>Causes burp proxy to drop the message and close the client connection.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="constant-values.html#IBurpExtender.ACTION_DROP">Constant Field Values</A></DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="setCommandLineArgs(java.lang.String[])"><!-- --></A><H3>
setCommandLineArgs</H3>
<PRE>
void <B>setCommandLineArgs</B>(java.lang.String[]&nbsp;args)</PRE>
<DL>
<DD>This method is invoked immediately after the implementation's constructor
 to pass the command-line arguments passed to the calling application on
 startup. It allows implementations to control aspects of their behaviour
 at runtime by defining their own command-line arguments
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>args</CODE> - The command-line arguments passed to the calling application
 on startup.</DL>
</DD>
</DL>
<HR>

<A NAME="processProxyMessage(int, boolean, java.lang.String, int, boolean, java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String, byte[], int[])"><!-- --></A><H3>
processProxyMessage</H3>
<PRE>
byte[] <B>processProxyMessage</B>(int&nbsp;messageReference,
                           boolean&nbsp;messageIsRequest,
                           java.lang.String&nbsp;remoteHost,
                           int&nbsp;remotePort,
                           boolean&nbsp;serviceIsHttps,
                           java.lang.String&nbsp;httpMethod,
                           java.lang.String&nbsp;url,
                           java.lang.String&nbsp;resourceType,
                           java.lang.String&nbsp;statusCode,
                           java.lang.String&nbsp;responseContentType,
                           byte[]&nbsp;message,
                           int[]&nbsp;action)</PRE>
<DL>
<DD>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.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>messageReference</CODE> - 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.<DD><CODE>messageIsRequest</CODE> - Flags whether the message is a client request or
 a server response.<DD><CODE>remoteHost</CODE> - The hostname of the remote HTTP server.<DD><CODE>remotePort</CODE> - The port of the remote HTTP server.<DD><CODE>serviceIsHttps</CODE> - Flags whether the protocol is HTTPS or HTTP.<DD><CODE>httpMethod</CODE> - The method verb used in the client request.<DD><CODE>url</CODE> - The requested URL.<DD><CODE>resourceType</CODE> - The filetype of the requested resource, or a 
 zero-length string if the resource has no filetype.<DD><CODE>statusCode</CODE> - The HTTP status code returned by the server. This value
 is <code>null</code> for request messages.<DD><CODE>responseContentType</CODE> - The content-type string returned by the 
 server. This value is <code>null</code> for request messages.<DD><CODE>message</CODE> - The full HTTP message.<DD><CODE>action</CODE> - An array containing a single integer, allowing the
 implementation to communicate back to burp 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.
<DT><B>Returns:</B><DD>Implementations should return either (a) the same object received
 in the <code>message</code> paramater, or (b) a different object 
 containing a modified message.</DL>
</DD>
</DL>
<HR>

<A NAME="registerHttpRequestMethod(java.lang.reflect.Method, java.lang.Object)"><!-- --></A><H3>
registerHttpRequestMethod</H3>
<PRE>
void <B>registerHttpRequestMethod</B>(java.lang.reflect.Method&nbsp;makeHttpRequestMethod,
                               java.lang.Object&nbsp;makeHttpRequestObject)</PRE>
<DL>
<DD>This method is invoked on startup by burp repeater. It registers a method
 that may be invoked by the implementation to issue arbitrary HTTP/S
 requests and receive responses.
 <p>

 The method registered has the following signature:<p>

 <PRE>
     public byte[] makeHttpRequest(
         String host,
         int port,
         boolean useHttps,
         byte[] request) throws Exception;
 </PRE>

 The makeHttpRequest method returns the full response from the server, or 
 throws an Exception with an informative message if any kind of error 
 occurs.<p>

 Implementations must invoke the makeHttpRequest method dynamically, for 
 example:<p>

 <PRE>
     byte[] response = (byte[]) makeHttpRequestMethod.invoke(
         makeHttpRequestObject,
         new Object[] 
         {
             "target.com",
             new Integer(80),
             new Boolean(false),
             "GET / HTTP/1.0\r\n\r\n".getBytes()
         });
 </PRE>

 The call to registerHttpRequestMethod need not return, and 
 implementations may use the invoking thread for any purpose.<p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>makeHttpRequestMethod</CODE> - A method which may be dynamically invoked by
 implementations to issue arbitrary HTTP/S requests.<DD><CODE>makeHttpRequestObject</CODE> - An object upon which the method must be
 invoked.</DL>
</DD>
</DL>
<HR>

<A NAME="applicationClosing()"><!-- --></A><H3>
applicationClosing</H3>
<PRE>
void <B>applicationClosing</B>()</PRE>
<DL>
<DD>This method is invoked immediately before the calling application exits. 
 It allows implementations to carry out any clean-up actions necessary
 (e.g. flushing log files or closing database resources)
<P>
<DD><DL>
</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/IBurpExtender.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="BurpExtender.html" title="class in &lt;Unnamed&gt;"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="index.html?IBurpExtender.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="IBurpExtender.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>

</BODY>
</HTML>