Skip to content
KitploitKITPLOIT
ツールエクスプロイトブログ
Log in
提出
ツールエクスプロイトブログ
提出

ハッキング、侵入テスト、サイバーセキュリティツールをあなたのセキュリティアーセナルに!

Kitploitはハッキング、サイバーセキュリティ、ペネトレーションテストのツールディレクトリです。最新のプロジェクトアップデートを見つけて、脆弱性の発見、システム分析、テストの自動化、セキュリティの強化を行いましょう。

フィードお問い合わせプライバシー© 2026 Kitploit

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
pbtk — Protobufベースのアプリケーション向けのリバースエンジニアリングおよびファジングツールセット | Kitploit
ツール/GitHubGitHub/marin-m/pbtk
Androidセキュリティ動的分析 (サンドボックス)ペイロード生成リバースエンジニアリングウェブセキュリティファジングモバイルセキュリティバイナリ解析
GitHubmarin-m/pbtk

pbtk

Protobufベースのアプリケーション向けのリバースエンジニアリングおよびファジングツールセット

リポジトリを見る
1.7k200813日前Kitploit レビュー済み
共有
ウェブサイト

pbtk - Protobufアプリのリバースエンジニアリング

Protobuf はシリアライゼーション形式であり、Google によって開発され、Android、Web、デスクトップなど、ますます多くのアプリケーションで使用されています。これはデータ構造を宣言するための言語で構成され、ターゲットの実装に応じてコードや別の種類の構造にコンパイルされます。

pbtk (Protobuf toolkit) は、統一された GUI からアクセスできる本格的なスクリプト群であり、主に 2 つの機能を提供します:

  • プログラムから Protobuf 構造を抽出し、読み取り可能な .proto に変換して戻す機能。さまざまな実装をサポートします:

    • すべての主要な Java ランタイム (base、Lite、Nano、Micro、J2ME)、Proguard を完全サポート、(2026: これは今でも問題なく動作しますが、主に古い APK に対してです)
    • 埋め込みリフレクションメタデータを含むバイナリ (典型的には C++、時には Java やその他のほとんどのバインディング)、(2026: これは今でも問題なく動作します)
    • JsProtoUrl ランタイムを使用する Web アプリケーション。(2026: これにはアップデートが必要です)
  • データの編集、リプレイ、ファジングを Protobuf ネットワークエンドポイントに対して行う機能。便利なグラフィカルインターフェースを通じて、Protobuf メッセージのフィールドをライブで編集し、結果を表示できます。

The pbtk editor GUI

インストール

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 は、対象の Protobuf 実装またはプラットフォームから .proto 構造を抽出することをサポートします。

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.
  • トランスポートは、Protobuf データをネットワーク経由でデシリアライズ、再シリアライズ、送信する方法をサポートします。例えば、最も一般的に使用されるトランスポートは HTTP 経由の生の POST データです。

トランスポートは 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

今後の改善予定

以下の内容は今後のリリースで実装される可能性があります:

  • 自動ファジング部分の完成。
  • Javaコードからの拡張機能抽出のサポート。
  • JSPB(メインのJavaScript)ランタイムのサポート。
  • その他、サポートを希望するプラットフォームがあれば、issueを立てていただければ検討します。

ほとんどのモジュールについて、徹底的に読みやすくコメント付きのコード(GUIシグナルの接続など、ほぼ自明な部分を除く)を作成するよう最善を尽くしましたので、ぜひ貢献してください。

ライセンス

pbtkはGNU GPLライセンスの下で公開されています(ここに、etc.)。

プロジェクト名の大文字・小文字表記に関する正式なルールはありません。ただ、自分の心に従うだけです ❤

ツールをダウンロード

人気

すべて見る →

コミュニティで最も使われているツールを見つけましょう。

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 究極のOSINTツールキット:調査グラフ、信頼度スコアリング、エイリアスファミリー、マップ、タイムライン、レポート。49個のモジュール、400以上のサイト、APIキー不要。

    755
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock ワンタップ実行アプリ(CVE-2026-43499)

    510
  • 3

    ARTEX

    baarai/artex

    プランナー/ワーカーエージェント、資産グラフと探索グラフ、MITMトラフィック記録、脆弱性の再テストを備えたLLMマルチエージェント自律ペネトレーションテストプラットフォーム。

    415
  • 4

    redforge

    cybersecurity91/redforge

    ブラウザ側のレッドチームツールキット。偵察、ペイロード生成、認証情報攻撃、暗号、エンコーディング、エンゲージメントレポート向けの102のオフラインツールを備えています。

    343
  • 5

    antifox

    antifox-ai/antifox

    偵察、攻撃対象領域の探索、エクスプロイト検証、証拠に基づくレポート提供を実行するAIマルチエージェント自律ペネトレーションテストプラットフォーム。

    259
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    AIネイティブなサイバーセキュリティのためのアクションシステム。意図がガバナンスされた実行に変わり、証拠が運用記憶となり、すべての操作が次の操作を改善する。

    258

すべてのツールを探索

ツールコレクションを閲覧

すべてのツールを見る →