EyeWitness - Webスクリーンショットツール

EyeWitness はウェブサイトのスクリーンショットを撮影し、サーバーヘッダー情報を提供し、既知のデフォルト認証情報を特定するために設計されています。今後はChromiumブラウザを採用し、信頼性の向上とインストールの容易化を実現しました。

🚀 主な機能

• クロスプラットフォーム対応 - Windows、Linux、macOS
• Chromiumベース - Google Chrome/Chromiumによる信頼性の高いヘッドレススクリーンショット
• 適応型リソース管理 - システムの能力に応じて自動調整
• 設定ファイルのサポート - 好みの設定を保存可能
• URL検証 - 事前チェックでURLの有効性を確認
• 進捗状況と残り時間の表示 - スキャンの完了時刻を正確に把握
• 強化されたエラーハンドリング - 具体的なエラータイプと対処方法の提案
• 複数の入力形式 - テキストファイル、Nmap XML、Nessus XML
• 分離された仮想環境 - システム競合ゼロ、PEP 668バイパス

🔒 仮想環境アーキテクチャ

EyeWitnessはすべてのインストールでPython仮想環境を使用するようになりました。これにより以下が実現されます：

✅ 主なメリット

• システム競合なし - すべてのPythonパッケージが分離された環境にインストール
• PEP 668問題なし - Kali/最新Linuxにおける"externally-managed-environment"エラーを完全にバイパス
• クロスプラットフォームの一貫性 - Windows、Linux、macOSで同じアプローチ
• 簡単なクリーンアップ - eyewitness-venv/ディレクトリを削除するだけで全て削除
• 本番環境対応 - 障害時の自動エラーハンドリングとロールバック

🚀 動作の仕組み

1. セットアップが仮想環境を作成 - eyewitness-venv/ディレクトリに分離されたPython
2. 仮想環境を有効化 - 分離環境に入るための簡単なコマンド
3. すべてのパッケージが分離してインストール - システムPythonへの影響ゼロ
4. EyeWitnessを通常通り実行 - 仮想環境内で標準的なPythonコマンドが動作

📁 インストール後のファイル構造

EyeWitness/
├── eyewitness-venv/          # 🔒 仮想環境（分離されたPythonパッケージ）
│   ├── bin/activate          # Linux/macOS 有効化スクリプト
│   └── Scripts/activate.bat  # Windows 有効化スクリプト
├── Python/
│   └── EyeWitness.py         # 📜 メインスクリプト（仮想環境内で実行）
└── setup/                    # セットアップスクリプトと要件

📦 インストールオプション

🔥 新機能: EyeWitnessはPython仮想環境を使用することで、全プラットフォームで競合ゼロ、確実なインストールを実現！

注意: Dockerサポートは現在開発中です。当面は以下のネイティブインストールオプションをご利用ください。

🪟 Windows インストール

Python仮想環境を使用した自動セットアップ:

# 1. PowerShellを管理者として開く
# 2. EyeWitnessディレクトリに移動
cd path\to\EyeWitness\setup

# 3. セットアップスクリプトを実行（仮想環境を作成）
.\setup.ps1

# 4. 仮想環境を有効化してインストールをテスト
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

インストールされるもの:

• 🔒 分離されたPython仮想環境 (eyewitness-venv/)
• 仮想環境内のPython依存関係（selenium など）
• Google Chromeブラウザ（存在しない場合）
• 自動化用のChromeDriver

🐧 Linux インストール

Python仮想環境を使用した本番環境対応セットアップ:

# 1. セットアップディレクトリに移動
cd EyeWitness/setup

# 2. セットアップスクリプトを実行（仮想環境を作成）
sudo ./setup.sh

# 3. 仮想環境を有効化してインストールをテスト
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

インストールされるもの:

• 🔒 分離されたPython仮想環境 (eyewitness-venv/)
• 仮想環境内のすべてのPythonパッケージ（PEP 668を完全にバイパス）
• システムパッケージ経由のChromiumブラウザとChromeDriver
• 仮想ディスプレイサポート（xvfb）

🎯 メリット:

• ✅ PEP 668競合なし - 仮想環境がすべての制限をバイパス
• ✅ システムパッケージの問題なし - すべてのPython依存関係を分離
• ✅ 簡単なクリーンアップ - eyewitness-venv/ディレクトリを削除するだけ
• ✅ 本番環境対応 - インストール失敗時の自動ロールバック

サポートされているLinuxディストリビューション:

• Ubuntu 20.04+ / Linux Mint
• Debian 10+ / Kali Linux
• CentOS 8+ / RHEL / Rocky Linux
• Arch Linux / Manjaro
• Alpine Linux

🍎 macOS インストール

HomebrewベースのPython仮想環境セットアップ:

# 1. HomebrewでChromeをインストール
brew install --cask google-chrome

# 2. セットアップディレクトリに移動してセットアップを実行
cd EyeWitness/setup
sudo ./setup.sh

# 3. 仮想環境を有効化してインストールをテスト
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

インストールされるもの:

• 🔒 分離されたPython仮想環境 (eyewitness-venv/)
• 仮想環境内のPython依存関係
• Chromeブラウザ（Homebrew経由）
• 自動化用のChromeDriver

🎯 使用例

🚀 EyeWitnessの使い方

セットアップスクリプトを実行後、仮想環境を有効化してEyeWitnessを実行します:

🐧 Linux/macOS:

# 1. 仮想環境を有効化
source eyewitness-venv/bin/activate

# 2. EyeWitnessを実行（分離環境内で実行中）
python Python/EyeWitness.py --single https://example.com
python Python/EyeWitness.py -f urls.txt
python Python/EyeWitness.py -x nmap_scan.xml
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# 3. 終了したら仮想環境を無効化
deactivate

🪟 Windows:

# 1. 仮想環境を有効化
eyewitness-venv\Scripts\activate.bat

# 2. EyeWitnessを実行（分離環境内で実行中）
python Python\EyeWitness.py --single https://example.com
python Python\EyeWitness.py -f urls.txt
python Python\EyeWitness.py -x nmap_scan.xml
python Python\EyeWitness.py -f urls.txt -d C:\path\to\output

# 3. 終了したら仮想環境を無効化
deactivate

📄 設定ファイル

# 最初に仮想環境を有効化
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# サンプル設定ファイルを作成
python Python/EyeWitness.py --create-config

# 設定ファイルを使用
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 URL検証

# 最初に仮想環境を有効化
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# スクリーンショットを撮らずにURLを検証
python Python/EyeWitness.py -f urls.txt --validate-urls

# 検証をスキップ（注意して使用）
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ 高度なオプション

# 最初に仮想環境を有効化
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# システムに応じてスレッド数を調整（デフォルト: 自動検出）
python Python/EyeWitness.py -f urls.txt --threads 5

# 低速接続向けにタイムアウトを増やす
python Python/EyeWitness.py -f urls.txt --timeout 30

# 遅延とジッターを追加
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

# プロキシを使用
python Python/EyeWitness.py -f urls.txt --proxy-ip 127.0.0.1 --proxy-port 8080

# カスタム出力ディレクトリ
python Python/EyeWitness.py -f urls.txt -d /path/to/output

# 以前のスキャンを再開
python Python/EyeWitness.py --resume /path/to/output/ew.db

パフォーマンスチューニング

EyeWitnessはシステムリソースを自動検出し、それに応じて調整します:

• CPUコア数に基づくスレッド数（コア数×2、最大20）
• システム過負荷を防ぐメモリ監視
• 開始前のディスク空き容量チェック

設定ファイル形式

好みの設定を保存する設定ファイルを作成します:

{
    "threads": 10,
    "timeout": 30,
    "delay": 0,
    "jitter": 0,
    "user_agent": "Custom User Agent",
    "proxy_ip": "127.0.0.1",
    "proxy_port": 8080,
    "output_dir": "./sessions",
    "prepend_https": false,
    "show_selenium": false,
    "resolve": false,
    "skip_validation": false,
    "results_per_page": 25,
    "max_retries": 2
}

トラブルシューティング

よくある問題

Chromium/ChromeDriverが見つからない:

• すべてのプラットフォーム: セットアップスクリプトを再実行 - ブラウザを自動的にインストールします
• Linux: sudo ./setup.sh（setup/ディレクトリ内）
• Windows: .\setup.ps1（setup\ディレクトリ内、管理者として実行）
• macOS: sudo ./setup.sh（setup/ディレクトリ内、brew install --cask google-chromeの後）

仮想環境の問題:

• eyewitness-venv/ディレクトリを削除し、セットアップスクリプトを再実行
• Python 3.7+ がvenvモジュールサポートとともにインストールされていることを確認
• セットアップスクリプトを適切な管理者/root権限で実行したことを確認

接続タイムアウト:

• タイムアウトを増やす: --timeout 60
• ファイアウォール設定を確認
• ターゲットにアクセス可能かを確認

高いメモリ使用量:

• スレッド数を減らす: --threads 5
• URLを小さなバッチで処理
• 他のアプリケーションを閉じる

権限エラー:

• Linux/macOS: ファイルの権限を確認
• Windows: 必要に応じて管理者として実行

エラーメッセージ

すべてのエラーには、具体的なトラブルシューティング手順が含まれています。例:

• タイムアウトエラーではプロキシ設定とタイムアウト増加を提案
• 接続エラーではファイアウォールとネットワークのチェックを提供
• リソースエラーではメモリ使用量と推奨事項を表示

出力

EyeWitnessが生成するもの:

• report.html - スクリーンショット付きメインレポート
• screens/ - スクリーンショット画像
• source/ - ページのソースコード
• ew.db - 再開機能のためのSQLiteデータベース

レポート機能

• カテゴリ別結果（高価値、CMS、ネットワークデバイスなど）
• デフォルト認証情報の検出
• ヘッダー分析
• 検索可能、ソート可能

要件

• Python 3.7以上（venvモジュールサポート付き、ほとんどのPythonインストールに標準搭載）
• インストール用の管理者/root権限（システムパッケージと仮想環境作成に必要）
• パッケージダウンロード用のインターネット接続
• Chromium/Chromeブラウザ（セットアップスクリプトが自動インストール）
• ChromeDriver（セットアップスクリプトが自動インストール）

📝 注意: セットアップスクリプトがすべての依存関係を自動的に処理します。必要なのはPython 3.7以上と管理者権限のみです。

オリジナルからの変更点

このフォークには大幅な近代化が含まれています:

• 非推奨のSelenium APIを修正
• アーカイブされた依存関係を置換（fuzzywuzzy → rapidfuzz）
• 包括的なエラーハンドリングを追加
• クロスプラットフォームサポートを改善
• リソース監視を追加
• Dockerサポートは開発中
• 設定ファイルサポートを追加
• ユーザーエクスペリエンスを向上

連絡先

E-Mail: GetOffensive [@] redsiege [dot] com

ライセンス

EyeWitnessはGNU General Public License v3.0の下でライセンスされています。