自分でコンパイルしたくない人向けのインストール手順:

1. GoogleのGSONライブラリをMavenからダウンロードします。 (http://central.maven.org/maven2/com/google/code/gson/gson/2.8.2/gson-2.8.2.jar) wget http://central.maven.org/maven2/com/google/code/gson/gson/2.8.2/gson-2.8.2.jar

2. Burpの Extender/Options/Java Environment で、GoogleのGSONライブラリをダウンロードしたフォルダを選択します。

3. Burpの Extender/Extensions タブから拡張機能を追加します。(拡張機能はリポジトリの dist フォルダ内のjarファイルです)。

コンパイル手順:

1. リポジトリをクローンします。

2. Burpのタブ Extender/APIs に移動し、Save interface files ボタンをクリックして、Burpのインターフェースファイルを新しいフォルダに保存します。次に、これらのファイルをクローンしたリポジトリの src/burp ディレクトリにコピーします。

3. GoogleのGSONライブラリをMavenからダウンロードします。 (http://central.maven.org/maven2/com/google/code/gson/gson/2.8.2/gson-2.8.2.jar) wget http://central.maven.org/maven2/com/google/code/gson/gson/2.8.2/gson-2.8.2.jar

extractorディレクトリから: 4. mkdir build 5. javac -cp gson-2.8.2.jar -d build src/burp/*.java 6. jar cf extractor.jar -C build burp

次に、BurpのExtenderタブでextractor.jarファイルを読み込みます。(また、GSONライブラリを保存したフォルダにBurpのパスを設定する必要があります: Burp Extender > Options > Java Environment)

Burpに Extractor という新しいタブが追加されます。

ユーザーマニュアル:

概要:

この拡張機能は、Burp Suiteに Extractor という新しいタブを追加します。

このタブ内では、リクエストまたはレスポンス内のデータがどのようなものかを表すツリーにノードを追加できます。ツリーの各リーフは、クエリまたはレスポンスが表示されるすべての場所に新しいタブを作成し、特定のリーフまでのすべての親ノードに従ってクエリデータを変換したものを表示します。

例えば、リクエストのボディが、Base64でエンコードされた文字列を含む特定のタグを持つXMLペイロードである場合、ツリーは次のようになります:

上記の設定により、すべてのリクエストとレスポンスには Body>XML:tag_name>Base64 という名前のタブが含まれるようになり、そのタブにはリクエストのボディのXMLタグ tag_name に含まれるBase64デコード済みデータが表示されます。そのタブのデータを変更すると、データがBase64エンコードされ、リクエストのボディの同じXMLタグに再び注入されます(これにより、Proxy/Interceptでリクエストをインターセプトしながら変更したり、Repeaterでペイロードを作成したりできます)。

ノードタイプ一覧:

Base64:

パラメータなし。
このノードは、渡されたデータをBase64デコードし、そのノードまたはその子ノードのいずれかでデータを変更すると、チェーンに沿って再エンコードします。

Url Decode

パラメータなし。
このノードは、渡されたデータに対して基本的なURLデコードを行います。このノードまたはその子ノード内で変更されたデータは、チェーンに沿って再エンコードされると、無効なURL文字のみが再エンコードされるため、見た目が異なる可能性があることに注意してください。

GZip

パラメータなし。
このノードは、渡されたデータをGZip解凍し、自身またはその子のいずれかが変更された場合にGZipで圧縮し直します。

BinToHex (バイナリから16進数)

パラメータなし。
このノードは、渡されたデータをバイナリから16進数文字列に変換します。自身のデータまたは子ノードのデータが変更された場合、16進数文字列からバイナリに変換し直します。

HexToBin (16進数からバイナリ)

パラメータなし。
このノードは、渡されたデータを16進数文字列からバイナリに変換します。自身のデータまたは子ノードのデータが変更された場合、バイナリから16進数文字列に変換し直します。

Url Parameter

パラメータ1つ:

• URL Parameter Name: 抽出するURLパラメータの名前を指定します。

このノードは、x-www-form-urlencoded タイプの1つのURLパラメータノードからデータを抽出します。リクエストのURLからURLパラメータを抽出するための Header の子ノードとして直接使用できるほか、ボディがURLスタイルのパラメータのみを含む場合は body の子ノードとして、あるいはURLまたは x-www-form-urlencoded パラメータを含む任意の他のノードの子として使用できます。変更されたデータは、同じ位置のパラメータに再び注入されます。

Body Parameter

パラメータ2つ:

• Parameter Name: 抽出する必要があるボディパラメータの名前。
• Boundary String: リクエストの boundary フラグの内容をこのパラメータにコピーします。(ここに追加のダッシュを付けないでください)

このノードは、multipart/form-data タイプのボディパラメータを抽出するために使用されます。変更されたデータは、同じ場所のパラメータに再び注入されます。

Cookie

パラメータ1つ:

• Cookie Name: 処理する必要があるクッキーの名前。

このノードは1つのクッキーからデータを抽出します。変更されたデータはクッキーに再び注入されます。このノードは Header ノードの直接の子として使用する必要があります。

Header Flag

パラメータ1つ:

• Header flag name: リクエストから抽出するフラグの名前。

このノードは1つのヘッダーフラグの内容を抽出します。変更されたデータはフラグに再び注入されます。このノードは Header ノードの直接の子として使用する必要があります。

XML

パラメータ1つ:

• XML node name: データを抽出するノードの名前。

このノードは、XMLノード名パラメータに一致する最初のXMLノードから値を抽出します。変更されたデータは、同じノードの値に再び注入されます。

XML Parameter

パラメータ2つ:

• XML node name: データを抽出するノードの名前。
• XML node Parameter: 抽出するパラメータ値の名前。

このノードは、XMLノード名に一致する最初のXMLノードからパラメータ値を抽出します。変更されたデータは、同じノードのパラメータに再び注入されます。

Json

パラメータ2つ:

• Name: 抽出するJSONオブジェクトの名前。
• Index (任意): オブジェクトがテーブルの場合、このインデックスを使用して抽出する部分を特定します。インデックスが指定されておらずデータがテーブルの場合は、テーブル全体が抽出されます。オブジェクトがテーブルでない場合は、このフィールドを空のままにします。

このノードはJSONペイロードからデータを抽出します。渡されたペイロードのトップレベルのデータのみを抽出できます。ただし、このノードを他のJsonノードとチェーンして、JSONオブジェクト内に埋め込まれたJSONオブジェクトを抽出できます。

AND

パラメータ1つ:

• AND with (in hex): AND演算するデータの16進数表現。

このノードは、渡されたデータとそのパラメータのデータとのAND演算を行います。ノードに渡すデータはバイナリ形式である必要があります(必要に応じて最初にHextoBinノードを使用してください)。変更されたデータはAND演算で戻されますが、AND演算子は全単射ではないため、この操作にはほとんど価値がないことに注意してください(注入し直したデータがそのコンテキストで意味を成すことは期待できません)。

OR

パラメータ1つ:

• OR with (in hex): OR演算するデータの16進数表現。

このノードは、渡されたデータとそのパラメータのデータとのOR演算を行います。ノードに渡すデータはバイナリ形式である必要があります(必要に応じて最初にHextoBinノードを使用してください)。変更されたデータはOR演算で戻されますが、OR演算子は全単射ではないため、この操作にはほとんど価値がないことに注意してください(注入し直したデータがそのコンテキストで意味を成すことは期待できません)。

XOR

パラメータ1つ:

• XOR with (in hex): XOR演算するデータの16進数表現。

このノードは、渡されたデータとそのパラメータのデータとのXOR演算を行います。ノードに渡すデータはバイナリ形式である必要があります(必要に応じて最初にHextoBinノードを使用してください)。変更されたデータはXOR演算で戻されます。

Identity :

パラメータなし
このノードは何も処理しません: 渡されたデータを表示するだけです。これは主に、ノードが挿入された特定のポイントで、ノードのチェーンに沿って渡されたデータが正しいかどうかを確認するためのコントロールポイントを追加するのに役立ちます。

Regex

パラメータ1つ:

• Regex: 1つのサブマッチを持つ正規表現

このノードは、正規表現にコンテンツを渡し、サブマッチのみを抽出します。他のノードに渡す前にノードを準備するのに役立ちます。 サンプル ==> Callback\\((.*)\\)

独自ノードの作成:

Javaで独自のノードを作成することもできます。コード内にQueryNodeXXX.javaという名前のサンプルノードファイルが用意されているので、コピー＆ペーストして名前を変更し、ファイル内の指示に従ってください。また、新しく作成したノードをGlobals.javaのリストの末尾近くに追加することを忘れないでください(何も壊したくない場合は、そのリストの最初の2行は変更しないでください)。