Panoptic

Panopticは、パストラバーサル（パス横断）脆弱性を通じて一般的なログファイルや設定ファイルの探索・取得を自動化する、オープンソースのペネトレーションテストツールです。

機能

• 設定可能なワーカープールによる非同期同時スキャン （--concurrency）
• パラメータベース、パスベース、POST、Cookie、ヘッダー、JSON ボディインジェクションによる一般的なログ・設定ファイルの自動発見
• 任意のインジェクションポイントを指定するFUZZマーカー — FUZZ を --header または --data の値に配置します
• ファイルパスをデコードするエンドポイント向けのBase64エンコード （--base64）
• 以降のスキャンを制限するオプション付きの自動OS検出
• 誤検知を減らすためのステータスコードフィルタリングを備えた ヒューリスティックなレスポンス比較
• 動的なケースインジェクション — /etc/passwd を解析してホームディレクトリの ファイルを、mysql-bin.index を解析してbinlogファイルを特定
• 複数の出力形式: テキスト (rich)、JSON、CSV （--output-format）
• 長時間実行スキャンの再開/チェックポイント対応 （--resume-file）
• 永続的な設定のためのTOML設定ファイル（--config）
• 複数のトラバーサルバイパス技術: プレフィックス、ポストフィックス、 乗数、スラッシュ置換、二重エンコード
• 検証付きのHTTP/HTTPSおよびSOCKS5プロキシサポート
• ランダムまたはカスタムのUser-Agent、Cookie、ヘッダーサポート
• バナー、ログ、機械可読出力（数値・ブール値のJSONボディ値を含む）における 認証情報のマスキング
• POSIXでは所有者のみの 0600 パーミッション、OSが対応する場合は 最終パス要素のシンボリックリンク保護により機密アーティファクトを堅牢化
• リモートURL検証付きの自己更新（--update）

必要条件

• Python 3.10+
• Git
• 依存関係: Python 3.10では httpx[socks]、rich、rich-argparse、 tomli

インストール

git clone https://github.com/lightos/Panoptic.git
cd Panoptic
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .
panoptic --version

Windowsのコマンドプロンプトでは .venv\Scripts\activate.bat でアクティベートし、PowerShellでは .venv\Scripts\Activate.ps1 を使用します。editableインストールにより、Panopticは --update のためにこのチェックアウトに接続されたままになるため、ディレクトリはそのままにしておいてください。pip install panoptic を実行しないでください: そのPyPI名は無関係のプロジェクトのものです。

開発用:

python -m pip install -e ".[dev]"

使用方法

panoptic --url "http://target/include.php?file=test.txt"

使用例

基本的なパラメータベースLFI

panoptic --url "http://target/include.php?file=test.txt"
panoptic --url "http://target/include.php?file=test.txt&id=1" \
  --param file

POSTデータインジェクション

panoptic --url "http://target/include.php" \
  --data "file=test.txt&id=1" --param file

パスベースLFI

panoptic --url "http://target/view.php/test.txt" --path-based

Base64エンコードされたパラメータ

panoptic --url "http://target/load.php?file=dGVzdC50eHQ=" \
  --base64 --auto

Cookieインジェクション（FUZZマーカー）

panoptic --url "http://target/page.php" \
  --header "Cookie: lang=FUZZ" --auto

JSONボディインジェクション（FUZZマーカー）

panoptic --url "http://target/api/load" \
  --data '{"file":"FUZZ"}' --auto

カスタムヘッダーインジェクション（FUZZマーカー）

panoptic --url "http://target/page.php" \
  --header "X-Template: FUZZ" --auto

拡張子パラメータ

panoptic --url "http://target/view.php?file=test&type=txt" \
  --param file --ext-param type

プレフィックスによるフィルターバイパス

panoptic --url "http://target/filtered.php?file=test.txt" \
  --prefix "....//....//....//....//"

フィルタリングされたスキャン

panoptic --url "http://target/include.php?file=test.txt" \
  --os "*NIX" --type conf
panoptic --url "http://target/include.php?file=test.txt" \
  --software PostgreSQL

再開機能付きJSON出力

panoptic --url "http://target/include.php?file=test.txt" \
  --output-format json --output-file results.json \
  --resume-file scan.checkpoint

SSLエラーを無視するプロキシ

panoptic --url "https://target/include.php?file=test.txt" \
  --proxy "socks5://127.0.0.1:9050" --invalid-ssl

利用可能なフィルターの一覧表示

panoptic --list software
panoptic --list category
panoptic --list os

包括的スキャン

panoptic --url "http://target/include.php?file=test.txt" \
  --auto --all-versions --concurrency 8

FUZZマーカー

--header または --data の値のどこかに FUZZ を配置して、インジェクションポイントを指定します。Panopticはスキャン中に FUZZ を各ファイルパスに置き換えます。これにより、--param では到達できないインジェクションポイントをテストできます:

インジェクションタイプ	例
Cookie値	--header "Cookie: theme=FUZZ"
カスタムヘッダー	--header "X-Include: FUZZ"
JSONボディ	--data '{"template":"FUZZ"}'
ネストされた値	--header "Cookie: sid=abc; lang=FUZZ"

FUZZ が存在する場合、--param は不要です。

設定

Panopticは永続的な設定のためのTOML設定ファイルをサポートしています:

panoptic --url "http://target/include.php?file=test.txt" \
  --config ~/.config/panoptic/config.toml

デフォルトの設定場所: ~/.config/panoptic/config.toml（存在する場合は --config を指定しなくても自動的に読み込まれます）。

[defaults]
# Any long option name (with dashes as underscores) is accepted here,
# including the target and output destinations.
url = "http://target/include.php?file=test.txt"
concurrency = 8
verbose = true
automatic = true
all_versions = true
output_format = "json"
output_file = "results.json"
log_file = "scan.log"
resume_file = "scan.checkpoint"

[proxy]
url = "socks5://127.0.0.1:9050"

[headers]
user_agent = "Mozilla/5.0"
cookie = "sid=foobar; auth=1"
values = ["X-Forwarded-For: 127.0.0.1"]

優先順位: CLI引数 > 設定ファイル > 組み込みデフォルト。

設定でサポートされるターゲットおよび出力オプション

[defaults] テーブルはパフォーマンス調整だけでなく、あらゆるスキャンオプションを受け入れます。具体的には以下を永続化できます:

• url — デフォルトのターゲット（実行ごとに --url で上書き可能）
• output_format、output_file — 機械可読な結果の出力先
• log_file — コンソール出力をファイルにミラーリング
• resume_file — 再開可能なスキャンのチェックポイント位置

Panopticが書き込む機密アーティファクト（ログファイル、結果/リスト出力ファイル、--write-files で保存されたファイル）は、POSIXでは所有者のみの 0600 パーミッションに強制されます。O_NOFOLLOW を公開しているプラットフォームでは、最終パス要素に既存のシンボリックリンクがある場合も原子的に拒否されます。O_NOFOLLOW がないプラットフォームでは、Panopticはオープン前のシンボリックリンク/ジャンクション確認をベストエフォートで行いますが、この確認ではレース状態を排除できません。WindowsのモードビットはNTFS ACLを設定しないため、アーティファクトに機密データが含まれる可能性がある場合は、適切に制限されたディレクトリを使用してください。

コマンドラインでの設定ブール値の上書き

すべてのブールフラグには --no- の対応物があり、設定ファイルで true に設定された値を、ファイルを編集せずに1回の実行だけオフにできます:

# config.toml sets verbose = true and automatic = true
panoptic --url "http://target/x.php?file=test.txt" --no-verbose --no-auto

省略されたブールフラグは（false にデフォルト設定されるのではなく）未設定のままになるため、フラグまたはその --no- 形式を明示的に指定しない限り、設定値が使用されます。

プロキシ

HTTP(S)またはSOCKSプロキシ経由でトラフィックをルーティングします:

panoptic --url "https://target/x.php?file=test.txt" \
  --proxy "socks5://127.0.0.1:9050"

• 対応スキーム: http://、https://、socks5://、socks5h:// （socks5h はプロキシ経由でDNSを解決します — TorやローカルDNSリークの 回避に有用です）。SOCKS4は基盤となるHTTPクライアントではサポートされて いません。スキームとホストはスキャン開始前に検証されます。
• SOCKSサポートはデフォルトでインストールされる httpx[socks] エクストラに由来します。
• デフォルトでは、Panopticは標準の HTTP_PROXY / HTTPS_PROXY / NO_PROXY 環境変数を尊重します。--ignore-proxy を指定するとこれらを バイパスして直接接続します（環境で設定されたプロキシも無効になります）。
• 独自のCAを持つプロキシを介してHTTPSをインターセプトする場合は、 --invalid-ssl と組み合わせてください。これにより証明書検証が無効になり、 信頼できないネットワークでは安全ではありません。

バージョン展開（--all-versions）

同梱されているパスの一部はバージョンテンプレートです（例: [JBOSS] と記述されたJBossリリースディレクトリ）。デフォルトでは、リテラルな [JBOSS] パスは実際のファイルに一致し得ないため、これらのテンプレート行はスキップされます。--all-versions を渡すと、各テンプレートが同梱のバージョンリストに対して展開され、既知のバージョンごとに1つの具体的なパスが追加されます — はるかに大規模ですが、より徹底的なスキャンになります:

panoptic --url "http://target/x.php?file=test.txt" --auto --all-versions

レスポンス比較