概要

ZenBusterは、Zach Griffin (@0xTas) によってPythonで書かれた、マルチスレッド・マルチプラットフォームのURL列挙ツールです。

このツールは、Pythonへの理解を深め、サイバーセキュリティツール全般への理解を高めるために作成しました。 ZenBusterは、同種のツールの中で最速でも最も包括的でもないかもしれません。しかし、シンプルで使いやすく、そこそこ柔軟性があり、実際にはGobusterのような「実績のある」ツールと比べてわずかに遅いだけです。 個人的には、TryHackMeのようなプラットフォームでのCTFチャレンジを解くために使用しており、実装は満足できる信頼性があると感じています。

このソフトウェアは、CTFチャレンジでの使用、またはセキュリティ専門家がターゲットに関する情報を収集するために使用されることを意図しています。

• サブドメインのブルートフォース列挙と、URIリソース（ディレクトリ/ファイル）の列挙が可能です。
• どちらの列挙方法も、適切なワードリストまたは辞書ファイルが必要です。
• 機能:
  1. ホスト名の形式は標準、IPv4、IPv6に対応。
  2. -o [ファイル名] で結果をファイルに記録する機能。
  3. -p <ポート> で標準外のウェブサーバーにカスタムポートを指定。
  4. ディレクトリモードでのオプションのファイル拡張子指定: -x <拡張子>。
  5. -q で出力を抑制するクワイエットモード。
  6. -nc / -nl でカラーを無効にし、出力を邪魔にならないように設定。
  7. -ic で無視するHTTPステータスコードのリストに追加（デフォルトは5xx、404）。
  8. -fl で特定のレスポンスコンテンツ長を無視。
  9. Python 3.10および3.11でテスト済み、3.6以上は理論的に対応。

注意事項/免責事項

ZenBusterは、短時間に望ましくない数のHTTPリクエストを生成する可能性があります。

開発者および貢献者は、本ソフトウェアの誤用や乱用によって生じたいかなる損害についても責任を負いません。

責任を持って列挙してください！

ライセンス

ZenBusterはGNU GPLv3ライセンスの下でライセンスされています。詳細はこちらをご覧ください。

クレジット

バナーの陰陽ASCIIアートは、Joan G. Stark (jgs) と Hayley Jane Wakenshaw (hjw) によって作成されました。 変更は、'zg' と指定された場合に私が行いました。

---

ショーケース

ヘルプページ:

ディレクトリ列挙モード:

サブドメイン列挙モード:

---

インストール

まず、Pythonバージョン >= 3.6 がインストールされていることを確認し、以下のコマンドでリポジトリをクローンします：

git clone https://github.com/0xTas/zenbuster.git

次に、cd zenbuster とし、Linuxの場合は chmod +x zenbuster.py を実行します。

依存関係

ZenBusterは動作するために3つの外部ライブラリに依存しており、以下のコマンドでインストールすることを推奨します：

pip install -r requirements.txt

インストールされるモジュールとその目的は以下の通りです：

1. Python requests

   • 各列挙リクエストの根幹。これがないとスクリプトは動作しません。

2. termcolor

   • カラー化されたターミナル出力を有効にします。必須ではなく、これがなくてもスクリプトは色なしで動作可能。

3. colorama (Windowsのみ)

   • WindowsターミナルがANSIカラーコード（Termcolorから）を受け入れるように準備します。必須ではありません。

これらの依存関係は、手動で、pipを使ってrequirements.txtから、または初回実行時のスクリプトとの対話によってインストールできます。

---

使い方

依存関係がインストールされたら、以下の方法でプログラムを実行できます。

Linux（+Mac？）の場合

./zenbuster.py [options] or python3 zenbuster.py [options]

Windowsの場合

python zenbuster.py [options]

[オプション]

使用例

./zenbuster.py -d -w /usr/share/wordlists/dirb/common.txt -u target.thm -v

python3 zenbuster.py -w ../subdomains.txt --host target.thm --ssl -O myResults.log

zenbuster -w subdomains.txt -u target.thm --quiet -ic 400, 403（.bashrcエイリアスを使用）

---

アップデート

ZenBusterのアップデートは簡単です！インストールフォルダに移動して（cd zenbuster）、git pull を実行するだけです。以上です！

---

計画中の機能/改善点

• オプションの詳細度のレベルを増やす。
• タスクのスレッド数をオプションで制限できるようにする。
• ユーザーが無視するステータスコードのリストを変更できるようにする。 完了。
• ユーザーがさまざまなリクエストヘッダーをより細かく制御できるようにする。
• コンテンツ長に基づいてレスポンスをオプションで無視できるようにする。 完了。
• サブドメイン列挙をブルートフォースだけでなくOSINT手法も含むように拡張。
• 派手なカラー出力のための、より包括的でソース可読性の高いソリューションを検討（richを使用する可能性あり）。

---

既知の問題/制限

• 長いエンドポイントを列挙すると、小さなコンソールウィンドウで行の折り返しにより見苦しいターミナル出力になる可能性があります。ファイルにログを記録することを推奨します。特にWindowsでは。
• ターゲットホストが共有ウェブサーバー上のvHostの場合、IP経由の列挙は期待通りに機能しない可能性があります。代わりにドメイン/ホスト名を使用してください。
• -ic でリダイレクトステータスコード（3xx）を無視しても、リダイレクト先のパスのステータスコードも無視されない場合は機能しません。

---

バージョン

ZenBusterは現在バージョン1.3です。