
Protobufベースのアプリケーション向けのリバースエンジニアリングおよびファジングツールセット
Protobuf はシリアライゼーション形式であり、Google によって開発され、Android、Web、デスクトップなど、ますます多くのアプリケーションで使用されています。これはデータ構造を宣言するための言語で構成され、ターゲットの実装に応じてコードや別の種類の構造にコンパイルされます。
pbtk (Protobuf toolkit) は、統一された GUI からアクセスできる本格的なスクリプト群であり、主に 2 つの機能を提供します:
プログラムから Protobuf 構造を抽出し、読み取り可能な .proto に変換して戻す機能。さまざまな実装をサポートします:
データの編集、リプレイ、ファジングを Protobuf ネットワークエンドポイントに対して行う機能。便利なグラフィカルインターフェースを通じて、Protobuf メッセージのフィールドをライブで編集し、結果を表示できます。
PBTK には Python ≥ 3.10、GTK 4、Adwaita ≥ 1.8、Python-Protobuf 3、および抽出スクリプトを実行するためのいくつかの実行可能プログラム (chromium、jad、dex2jar など) が必要です。
Ubuntu ユーザーは snap を使用してインストールできます:
$ sudo snap install pbtk
$ pbtk
Archlinuxユーザーはパッケージから直接インストールできます:
$ yay -S pbtk-git
$ pbtk
ほとんどの他のディストリビューションでは、直接実行することをお勧めします:
# For Ubuntu/Debian derivates:
sudo apt install python3-pip git openjdk-8-jre gir1.2-adw-1 \
blueprint-compiler gir1.2-gtk-4.0 gir1.2-soup-3.0 python3-gobject
# Then, using UV:
sudo snap install --classic astral-uv
uv tool install pbtk
pbtk
# Or using pipx:
sudo apt install pipx
pipx install pbtk
pbtk
Windows もサポートされています。pbtk 2.x は GTK 4 で動作しますが、pbtk 1.x(最終バージョンは 1.1.5)は Qt 5 で動作していました。
GUI を実行すると、実行しようとしている操作に応じて、不足しているものについて警告が表示されます。
GUI はメインスクリプトから起動できます:
pbtk
以下のスクリプトは GUI なしで単独でも使用できます:
pbtk-jar-extract [-h] input_file [output_dir]
pbtk-from-binary [-h] input_file [output_dir]
pbtk-web-extract [-h] input_url [output_dir] # 2026年時点で動作させるには更新が必要
snap からインストールした場合、正確なコマンドは異なります:
pbtk.jar-extract [-h] input_file [output_dir]
pbtk.from-binary [-h] input_file [output_dir]
pbtk.web-extract [-h] input_url [output_dir]
GUI はメインスクリプトから起動できます:
uv sync # Download dependencies to the .venv folder
source .venv/bin/activate # Put the local scripts in $PATH for the current shell session
uv tool install -e . # Put the local scripts in $PATH all time
cp -a .github/hooks/* .git/hooks/ # Needed for contributing to code
pbtk
以下のスクリプトは、GUIなしで単独でも使用できます:
pbtk-jar-extract [-h] input_file [output_dir]
pbtk-from-binary [-h] input_file [output_dir]
pbtk-web-extract [-h] input_url [output_dir] # 2026年時点で動作させるには更新が必要
Androidアプリケーションをリバースエンジニアリングしているとしましょう。お気に入りのデコンパイラでアプリを少し調べ、HTTPS経由でPOSTデータとしてProtobufを典型的な方法で転送していることに気づきました。
PBTKを開くと、意味のある形で迎えられます:

最初のステップは、.protoファイルをテキスト形式にすることです。Androidアプリを対象にしているなら、APKをドロップして待つだけで魔法のようにやってくれます!(非常に特殊な実装でない限り)

これが完了したら、~/.pbtk/protos/<あなたのAPK名> に移動します(コマンドラインからでも、ウェルカム画面下部のボタンでファイルブラウザを開いてでも、お好みの方法で)。アプリの.protoファイルは確かにすべてここにあります。
デコンパイラに戻ると、興味のあるHTTPSエンドポイントに送信されるデータを構築するクラスを見つけました。それは生成コードで構成されたクラスを呼び出してProtobufメッセージをシリアライズしています。

この後者のクラスは、.protoディレクトリ内に完全に一致するものがあるはずです(つまり com.foo.bar.a.b は com/foo/bar/a/b.proto に一致します)。いずれにせよ、その名前をgrepすれば参照できるはずです。
素晴らしい:次はステップ2で、目的の入力.protoを選択し、エンドポイントに関する情報を入力します。

また、mitmproxyやWiresharkでキャプチャし、16進数エンコード形式で貼り付けた、このエンドポイントに送信された生のProtobufデータのサンプルを提供することもできます。
ステップ3は、ボタンをクリックして何が起こるかを見るという楽しい部分です!Protobuf構造内のすべてのフィールドを表すツリービューがあります(repeatedフィールドには「+」が付き、requiredフィールドにはチェックボックスがありません)。

フィールドにホバーするだけでフォーカスできます。フィールドが整数型の場合、マウスホイールで増減できます。enumの情報もホバー時に表示されます。
これで完了です!これで各フィールドの意味を判断できます。縮小化されたコードから.protoを抽出した場合、フィールド名をクリックして、気づいた意味に応じて名前を変更できます。
ハッピーリバーシング! 👌 🎉
PBTKは抽出した.proto情報を ~/.pbtk/protos/(Windowsでは %APPDATA%\pbtk\protos)に保存します。
通常のファイルブラウザやテキストエディタを使って、このディレクトリから直接データを移動、取り出し、名前変更、編集、削除できます。これが想定された方法であり、PBTKに干渉することはありません。
HTTPベースのエンドポイントは、JSONオブジェクトとして ~/.pbtk/endpoints/ に保存されます。これらのオブジェクトはリクエスト/レスポンス情報のペアの配列であり、次のようになります:
[{
"request": {
"transport": "pburl",
"proto": "www.google.com/VectorTown.proto",
"url": "https://www.google.com/VectorTown",
"pb_param": "pb",
"samples": [{
"pb": "!....",
"hl": "fr"
}]
},
"response": {
"format": "other"
}
}]
PBTK は内部的に 2 種類のプラグイン可能なモジュールを使用します。それは extractor と transport です。
Extractor は src/pbtk/extractors/*.py で定義されています。これらは次のように、デコレータを前に付けたメソッドとして定義されます:
@register_extractor(
name='my_extractor',
readable_name='My Extractor',
description='Extract Protobuf structures from Foobar code (*.foo, *.bar)',
depends={'binaries': ['foobar-decompiler']},
)
def my_extractor(path):
# Load contents of the `path` input file and do your stuff...
# Then, yield extracted .protos using a generator:
for i in do_your_extraction_work():
yield ExtractorOutputFile(proto_name + '.proto', proto_contents)
# Other kinds of information can be yield, such as endpoint information or progress to display.
トランスポートは src/pbtk/utils/transports.py で定義されています。これらは次のように、デコレータを前に付けたクラスとして定義されます:
@register_transport
class MyTransport(Transport):
name = 'my_transport'
description = 'Protobuf as raw POST data'
ui_data_form = 'hex strings'
def __init__(self, pb_param: None, url: str):
self.url = url
def serialize_sample(self, sample: str) -> str:
# We got a sample of input data from the user.
# Verify that it is valid in the form described through "ui_data_form" parameter, fail with an exception or return False otherwise.
# Optionally modify this data prior to returning it.
bytes.fromhex(sample)
return sample
def load_sample(self, sample: str, pb_msg: Message):
# Parse input data into the provided Protobuf object.
pb_msg.ParseFromString(bytes.fromhex(sample))
def create_request(
self, pb_data: Message, tab_data: None
) -> Soup.Message:
# Create a HTTP request using the provided URL and Protobuf object,
# and optionally other transport-specific side data.
msg = Soup.Message.new('POST', self.url)
msg.set_request_body_from_bytes(
None, GLib.Bytes.new(pb_data.SerializeToString())
)
return msg
以下の内容は今後のリリースで実装される可能性があります:
ほとんどのモジュールについて、徹底的に読みやすくコメント付きのコード(GUIシグナルの接続など、ほぼ自明な部分を除く)を作成するよう最善を尽くしましたので、ぜひ貢献してください。
pbtkはGNU GPLライセンスの下で公開されています(ここに、etc.)。
プロジェクト名の大文字・小文字表記に関する正式なルールはありません。ただ、自分の心に従うだけです ❤