Package burp.api.montoya.proxy.http

Interface InterceptedRequest

All Superinterfaces:
HttpMessage, HttpRequest, InterceptedHttpMessage
public interface InterceptedRequest extends InterceptedHttpMessage, HttpRequest
HTTP request intercepted by Burp Proxy.

  • Method Details

    • annotations

      Annotations annotations()
      Returns:
      Annotations for request/response.

    • httpService

      HttpService httpService()
      HTTP service for the request.
      Specified by:
      httpService in interface HttpRequest
      Returns:
      An HttpService object containing details of the HTTP service.

    • url

      String url()
      URL for the request. If the request is malformed, then a MalformedRequestException is thrown.
      Specified by:
      url in interface HttpRequest
      Returns:
      The URL in the request.

    • method

      String method()
      HTTP method for the request. If the request is malformed, then a MalformedRequestException is thrown.
      Specified by:
      method in interface HttpRequest
      Returns:
      The HTTP method used in the request.

    • path

      String path()
      Path and File for the request. If the request is malformed, then a MalformedRequestException is thrown.
      Specified by:
      path in interface HttpRequest
      Returns:
      the path and file in the request

    • httpVersion

      String httpVersion()
      HTTP Version text parsed from the request line for HTTP 1 messages. HTTP 2 messages will return "HTTP/2"
      Specified by:
      httpVersion in interface HttpRequest
      Returns:
      Version string

    • headers

      List<HttpHeader> headers()
      HTTP headers contained in the message.
      Specified by:
      headers in interface HttpMessage
      Specified by:
      headers in interface HttpRequest
      Returns:
      A list of HTTP headers.

    • contentType

      ContentType contentType()
      Specified by:
      contentType in interface HttpRequest
      Returns:
      The detected content type of the request.

    • parameters

      List<ParsedHttpParameter> parameters()
      Specified by:
      parameters in interface HttpRequest
      Returns:
      The parameters contained in the request.

    • body

      ByteArray body()
      Body of a message as a byte array.
      Specified by:
      body in interface HttpMessage
      Specified by:
      body in interface HttpRequest
      Returns:
      The body of a message as a byte array.

    • bodyToString

      String bodyToString()
      Body of a message as a String.
      Specified by:
      bodyToString in interface HttpMessage
      Specified by:
      bodyToString in interface HttpRequest
      Returns:
      The body of a message as a String.

    • bodyOffset

      int bodyOffset()
      Offset within the message where the message body begins.
      Specified by:
      bodyOffset in interface HttpMessage
      Specified by:
      bodyOffset in interface HttpRequest
      Returns:
      The message body offset.

    • markers

      List<Marker> markers()
      Markers for the message.
      Specified by:
      markers in interface HttpMessage
      Specified by:
      markers in interface HttpRequest
      Returns:
      A list of markers.

    • toByteArray

      ByteArray toByteArray()
      Message as a byte array.
      Specified by:
      toByteArray in interface HttpMessage
      Specified by:
      toByteArray in interface HttpRequest
      Returns:
      The message as a byte array.

    • withService

      HttpRequest withService(HttpService service)
      Create a copy of the HttpRequest with the new service.
      Specified by:
      withService in interface HttpRequest
      Parameters:
      service - An HttpService reference to add.
      Returns:
      A new HttpRequest instance.

    • withPath

      HttpRequest withPath(String path)
      Create a copy of the HttpRequest with the new path.
      Specified by:
      withPath in interface HttpRequest
      Parameters:
      path - The path to use.
      Returns:
      A new HttpRequest instance with updated path.

    • withMethod

      HttpRequest withMethod(String method)
      Create a copy of the HttpRequest with the new method.
      Specified by:
      withMethod in interface HttpRequest
      Parameters:
      method - the method to use
      Returns:
      a new HttpRequest instance with updated method.

    • withAddedParameters

      HttpRequest withAddedParameters(List<HttpParameter> parameters)
      Create a copy of the HttpRequest with the added HTTP parameters.
      Specified by:
      withAddedParameters in interface HttpRequest
      Parameters:
      parameters - HTTP parameters to add.
      Returns:
      A new HttpRequest instance.

    • withAddedParameters

      HttpRequest withAddedParameters(HttpParameter... parameters)
      Create a copy of the HttpRequest with the added HTTP parameters.
      Specified by:
      withAddedParameters in interface HttpRequest
      Parameters:
      parameters - HTTP parameters to add.
      Returns:
      A new HttpRequest instance.

    • withRemovedParameters

      HttpRequest withRemovedParameters(List<HttpParameter> parameters)
      Create a copy of the HttpRequest with the removed HTTP parameters.
      Specified by:
      withRemovedParameters in interface HttpRequest
      Parameters:
      parameters - HTTP parameters to remove.
      Returns:
      A new HttpRequest instance.

    • withRemovedParameters

      HttpRequest withRemovedParameters(HttpParameter... parameters)
      Create a copy of the HttpRequest with the removed HTTP parameters.
      Specified by:
      withRemovedParameters in interface HttpRequest
      Parameters:
      parameters - HTTP parameters to remove.
      Returns:
      A new HttpRequest instance.

    • withUpdatedParameters

      HttpRequest withUpdatedParameters(List<HttpParameter> parameters)
      Create a copy of the HttpRequest with the updated HTTP parameters.
      If a parameter does not exist in the request, a new one will be added.
      Specified by:
      withUpdatedParameters in interface HttpRequest
      Parameters:
      parameters - HTTP parameters to update.
      Returns:
      A new HttpRequest instance.

    • withUpdatedParameters

      HttpRequest withUpdatedParameters(HttpParameter... parameters)
      Create a copy of the HttpRequest with the updated HTTP parameters.
      If a parameter does not exist in the request, a new one will be added.
      Specified by:
      withUpdatedParameters in interface HttpRequest
      Parameters:
      parameters - HTTP parameters to update.
      Returns:
      A new HttpRequest instance.

    • withTransformationApplied

      HttpRequest withTransformationApplied(HttpTransformation transformation)
      Create a copy of the HttpRequest with the transformation applied.
      Specified by:
      withTransformationApplied in interface HttpRequest
      Parameters:
      transformation - Transformation to apply.
      Returns:
      A new HttpRequest instance.

    • withBody

      HttpRequest withBody(String body)
      Create a copy of the HttpRequest with the updated body.
      Updates Content-Length header.
      Specified by:
      withBody in interface HttpRequest
      Parameters:
      body - the new body for the request
      Returns:
      A new HttpRequest instance.

    • withBody

      HttpRequest withBody(ByteArray body)
      Create a copy of the HttpRequest with the updated body.
      Updates Content-Length header.
      Specified by:
      withBody in interface HttpRequest
      Parameters:
      body - the new body for the request
      Returns:
      A new HttpRequest instance.

    • withAddedHeader

      HttpRequest withAddedHeader(String name, String value)
      Create a copy of the HttpRequest with the added header.
      Specified by:
      withAddedHeader in interface HttpRequest
      Parameters:
      name - The name of the header.
      value - The value of the header.
      Returns:
      The updated HTTP request with the added header.

    • withAddedHeader

      HttpRequest withAddedHeader(HttpHeader header)
      Create a copy of the HttpRequest with the added header.
      Specified by:
      withAddedHeader in interface HttpRequest
      Parameters:
      header - The HttpHeader to add to the HTTP request.
      Returns:
      The updated HTTP request with the added header.

    • withUpdatedHeader

      HttpRequest withUpdatedHeader(String name, String value)
      Create a copy of the HttpRequest with the updated header.
      Specified by:
      withUpdatedHeader in interface HttpRequest
      Parameters:
      name - The name of the header to update the value of.
      value - The new value of the specified HTTP header.
      Returns:
      The updated request containing the updated header.

    • withUpdatedHeader

      HttpRequest withUpdatedHeader(HttpHeader header)
      Create a copy of the HttpRequest with the updated header.
      Specified by:
      withUpdatedHeader in interface HttpRequest
      Parameters:
      header - The HttpHeader to update containing the new value.
      Returns:
      The updated request containing the updated header.

    • withRemovedHeader

      HttpRequest withRemovedHeader(String name)
      Removes an existing HTTP header from the current request.
      Specified by:
      withRemovedHeader in interface HttpRequest
      Parameters:
      name - The name of the HTTP header to remove from the request.
      Returns:
      The updated request containing the removed header.

    • withRemovedHeader

      HttpRequest withRemovedHeader(HttpHeader header)
      Removes an existing HTTP header from the current request.
      Specified by:
      withRemovedHeader in interface HttpRequest
      Parameters:
      header - The HttpHeader to remove from the request.
      Returns:
      The updated request containing the removed header.

    • withMarkers

      HttpRequest withMarkers(List<Marker> markers)
      Create a copy of the HttpRequest with the added markers.
      Specified by:
      withMarkers in interface HttpRequest
      Parameters:
      markers - Request markers to add.
      Returns:
      A new MarkedHttpRequestResponse instance.

    • withMarkers

      HttpRequest withMarkers(Marker... markers)
      Create a copy of the HttpRequest with the added markers.
      Specified by:
      withMarkers in interface HttpRequest
      Parameters:
      markers - Request markers to add.
      Returns:
      A new MarkedHttpRequestResponse instance.

    • withDefaultHeaders

      HttpRequest withDefaultHeaders()
      Create a copy of the HttpRequest with added default headers.
      Specified by:
      withDefaultHeaders in interface HttpRequest
      Returns:
      a new (@code HttpRequest) with added default headers

    • messageId

      int messageId()
      This method retrieves a unique ID for this request/response.
      Specified by:
      messageId in interface InterceptedHttpMessage
      Returns:
      An identifier that is unique to a single request/response pair. Extensions can use this to correlate details of requests and responses and perform processing on the response message accordingly.

    • listenerInterface

      String listenerInterface()
      This method retrieves the name of the Burp Proxy listener that is processing the intercepted message.
      Specified by:
      listenerInterface in interface InterceptedHttpMessage
      Returns:
      The name of the Burp Proxy listener that is processing the intercepted message. The format is the same as that shown in the Proxy Listeners UI - for example, "127.0.0.1:8080".

    • sourceIpAddress

      InetAddress sourceIpAddress()
      This method retrieves the IP address for the source of the intercepted message.
      Specified by:
      sourceIpAddress in interface InterceptedHttpMessage
      Returns:
      The IP address for the source of the intercepted message.

    • destinationIpAddress

      InetAddress destinationIpAddress()
      This method retrieves the IP address for the destination of the intercepted message.
      Specified by:
      destinationIpAddress in interface InterceptedHttpMessage
      Returns:
      The IP address for the destination of the intercepted message.