burp

インタフェース IBurpCollaboratorClientContext

public interface IBurpCollaboratorClientContext

このインタフェースは、Burp Collaboratorクライアントコンテキストのインスタンスで、Burp Collaboratorペイロードの作成や、そのペイロードを使用した結果のネットワーク通信をCollaboratorサーバにポーリングできます。拡張はIBurpExtenderCallbacks.createBurpCollaboratorClientContext()を呼び出すと、このクラスの新規インスタンスを取得できます。各Burp Collaboratorクライアントコンテキストは、コンテキストが作成された時点のCollaboratorサーバ設定に関連付けられています。

メソッドのサマリー

修飾子と型	メソッドと説明
java.util.List<IBurpCollaboratorInteraction>	fetchAllCollaboratorInteractions() このコンテキストで生成したペイロードに起因する、Collaboratorサーバが受信したすべての通信を取得します。
java.util.List<IBurpCollaboratorInteraction>	fetchAllInfiltratorInteractions() このコンテキストで生成したペイロードに起因する、Burp Infiltratorエージェントによるすべての通信を取得します。
java.util.List<IBurpCollaboratorInteraction>	fetchCollaboratorInteractionsFor(java.lang.String payload) このコンテキストで作成した1つのペイロードに起因する、Collaboratorサーバが受信した通信を取得します。
java.util.List<IBurpCollaboratorInteraction>	fetchInfiltratorInteractionsFor(java.lang.String payload) このコンテキストで生成した1つのペイロードに起因する、Burp Infiltratorエージェントによる通信を取得します。
java.lang.String	generatePayload(boolean includeCollaboratorServerLocation) Burp Collaboratorのペイロードを新規に作成します。
java.lang.String	getCollaboratorServerLocation() Collaboratorサーバのネットワークロケーションを所得します。

メソッドの詳細

generatePayload

java.lang.String generatePayload(boolean includeCollaboratorServerLocation)

Burp Collaboratorのペイロードを新規に作成します。

パラメータ:

includeCollaboratorServerLocation - 生成するペイロードに、Collaboratorサーバの場所を含めるかどうか。

戻り値:

生成されたペイロード。

例外:

java.lang.IllegalStateException - Burp Collaboratorが無効な場合

fetchAllCollaboratorInteractions

java.util.List<IBurpCollaboratorInteraction> fetchAllCollaboratorInteractions()

このコンテキストで生成したペイロードに起因する、Collaboratorサーバが受信したすべての通信を取得します。

戻り値:

このコンテキストで生成されたペイロードに起因するCollaboratorの通信。

例外:

java.lang.IllegalStateException - Burp Collaboratorが無効な場合

fetchCollaboratorInteractionsFor

java.util.List<IBurpCollaboratorInteraction> fetchCollaboratorInteractionsFor(java.lang.String payload)

このコンテキストで作成した1つのペイロードに起因する、Collaboratorサーバが受信した通信を取得します。

パラメータ:

payload - 通信を取得するペイロード。

戻り値:

指定したペイロードから発生したCollaboratorの通信。

例外:

java.lang.IllegalStateException - Burp Collaboratorが無効な場合

fetchAllInfiltratorInteractions

java.util.List<IBurpCollaboratorInteraction> fetchAllInfiltratorInteractions()

このコンテキストで生成したペイロードに起因する、Burp Infiltratorエージェントによるすべての通信を取得します。

戻り値:

このコンテキストで生成したペイロードに起因する、Burp Infiltratorエージェントが発生させた通信。

例外:

java.lang.IllegalStateException - Burp Collaboratorが無効な場合

fetchInfiltratorInteractionsFor

java.util.List<IBurpCollaboratorInteraction> fetchInfiltratorInteractionsFor(java.lang.String payload)

このコンテキストで生成した1つのペイロードに起因する、Burp Infiltratorエージェントによる通信を取得します。

パラメータ:

payload - 通信を取得するペイロード。

戻り値:

指定したペイロードに起因する、Burp Infiltratorエージェントが発生させた通信。

例外:

java.lang.IllegalStateException - Burp Collaboratorが無効な場合

getCollaboratorServerLocation

java.lang.String getCollaboratorServerLocation()

Collaboratorサーバのネットワークロケーションを所得します。

戻り値:

Collaboratorサーバのホスト名またはIPアドレス

例外:

java.lang.IllegalStateException - Burp Collaboratorが無効な場合