burp

インタフェース ISessionHandlingAction

public interface ISessionHandlingAction

拡張がこのインタフェースを実装して、IBurpExtenderCallbacks.registerSessionHandlingActionerPayloadProcessor()を呼び出すと、カスタムセッションハンドリングアクションに登録できます。登録された各アクションはセッションハンドリングルールのUI内で使用でき、ユーザはルールのアクションとして選択できます。ユーザはアクションの直接呼び出しも、マクロを実行した後の呼び出しもできます。

メソッドのサマリー

修飾子と型	メソッドと説明
java.lang.String	getActionName() Burpがセッションハンドリングアクションの名前を取得する際に使用します。
void	performAction(IHttpRequestResponse currentRequest, IHttpRequestResponse[] macroItems) セッションハンドリングアクションが実行されるときに呼び出されます。

メソッドの詳細

getActionName

java.lang.String getActionName()

Burpがセッションハンドリングアクションの名前を取得する際に使用します。拡張が生成するアクションを実行するようユーザが選択する際、セッションハンドリングルールエディタ内のオプションとして、これが表示されます。

戻り値:

アクションの名前。

performAction

void performAction(IHttpRequestResponse currentRequest,
                   IHttpRequestResponse[] macroItems)

セッションハンドリングアクションが実行されるときに呼び出されます。それ自身のアクションとして、またはマクロ実行後のサブアクションとして発生する可能性があります。

パラメータ:

currentRequest - 現在処理されているベースリクエスト。アクションはこのオブジェクトに照会してベースリクエストの詳細を取得できます。必要に応じて追加のリクエストを発行し、このオブジェクトのセッターメソッドでベースリクエストを更新できます。

macroItems - アクションがマクロ実行後に呼び出された場合、このパラメータにはマクロを実行した結果が入ります。それ以外の場合は、nullです。アクションはマクロアイテムの詳細を使用して、マクロの独自の分析をし、非標準なセッションハンドリングトークンを導出する、などが可能です。