EyeWitness – Web-Screenshot-Tool

EyeWitness wurde entwickelt, um Screenshots von Websites zu erstellen, Server-Header-Informationen bereitzustellen und ggf. Standard-Anmeldedaten zu identifizieren. Jetzt mit Chromium-Browser für bessere Zuverlässigkeit und einfachere Installation.

🚀 Hauptfunktionen

• Plattformübergreifend – Windows, Linux und macOS
• Chromium-basiert – Zuverlässige Headless-Screenshots mit Google Chrome/Chromium
• Adaptives Ressourcenmanagement – Passt sich automatisch an die Systemfähigkeiten an
• Unterstützung für Konfigurationsdateien – Speichern Sie Ihre bevorzugten Einstellungen
• URL-Validierung – Vorabprüfung, um sicherzustellen, dass URLs gültig sind
• Fortschrittsverfolgung mit ETA – Wissen Sie genau, wann Ihr Scan abgeschlossen ist
• Verbesserte Fehlerbehandlung – Spezifische Fehlertypen mit umsetzbarer Anleitung
• Mehrere Eingabeformate – Textdateien, Nmap-XML, Nessus-XML
• Isolierte virtuelle Umgebung – Keine Systemkonflikte und PEP-668-Umgehung

🔒 Architektur der virtuellen Umgebung

EyeWitness verwendet jetzt Python-Virtualenvs für alle Installationen und bietet:

✅ Wichtige Vorteile

• Keine Systemkonflikte – Alle Python-Pakete werden in isolierter Umgebung installiert
• Keine PEP-668-Probleme – Umgeht vollständig Fehler durch „externally-managed-environment“ auf Kali/modernem Linux
• Plattformübergreifende Konsistenz – Gleicher Ansatz unter Windows, Linux und macOS
• Einfache Bereinigung – Löschen Sie das Verzeichnis eyewitness-venv/, um alles zu entfernen
• Produktionsreif – Automatische Fehlerbehandlung und Rollback bei Fehlern

🚀 So funktioniert es

1. Setup erstellt virtuelle Umgebung – Verzeichnis eyewitness-venv/ mit isoliertem Python
2. Aktivieren Sie die virtuelle Umgebung – Einfacher Befehl zum Betreten der isolierten Umgebung
3. Alle Pakete werden isoliert installiert – Null Auswirkungen auf Ihr System-Python
4. Führen Sie EyeWitness normal aus – Standard-Python-Befehle funktionieren innerhalb der virtuellen Umgebung

📁 Dateistruktur nach der Installation

EyeWitness/
├── eyewitness-venv/          # 🔒 Virtuelle Umgebung (isolierte Python-Pakete)
│   ├── bin/activate          # Linux/macOS-Aktivierungsskript
│   └── Scripts/activate.bat  # Windows-Aktivierungsskript
├── Python/
│   └── EyeWitness.py         # 📜 Hauptskript (läuft in virtueller Umgebung)
└── setup/                    # Setup-Skripte und Anforderungen

📦 Installationsoptionen

🔥 NEU: EyeWitness verwendet jetzt Python-Virtualenvs für null Konflikte und bulletproof Installation auf allen Plattformen!

Hinweis: Docker-Unterstützung befindet sich derzeit in Entwicklung. Bitte verwenden Sie vorerst die nativen Installationsoptionen unten.

🪟 Windows-Installation

Automatisiertes Setup mit Python-Virtualenv:

# 1. Öffnen Sie PowerShell als Administrator
# 2. Navigieren Sie zum EyeWitness-Verzeichnis
cd path\to\EyeWitness\setup

# 3. Führen Sie das Setup-Skript aus (erstellt virtuelle Umgebung)
.\setup.ps1

# 4. Testen Sie die Installation, indem Sie die virtuelle Umgebung aktivieren
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

Was installiert wird:

• 🔒 Isolierte Python-Virtualenv (eyewitness-venv/)
• Python-Abhängigkeiten in der virtuellen Umgebung (selenium usw.)
• Google Chrome-Browser (falls nicht vorhanden)
• ChromeDriver für Automatisierung

🐧 Linux-Installation

Produktionsreifes Setup mit Python-Virtualenv:

# 1. Navigieren Sie zum Setup-Verzeichnis
cd EyeWitness/setup

# 2. Führen Sie das Setup-Skript aus (erstellt virtuelle Umgebung)
sudo ./setup.sh

# 3. Testen Sie die Installation, indem Sie die virtuelle Umgebung aktivieren
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Was installiert wird:

• 🔒 Isolierte Python-Virtualenv (eyewitness-venv/)
• Alle Python-Pakete in der virtuellen Umgebung (umgeht PEP 668 vollständig)
• Chromium-Browser und ChromeDriver über Systempakete
• Unterstützung für virtuelle Anzeige (xvfb)

🎯 Vorteile:

• ✅ Keine PEP-668-Konflikte – Virtuelle Umgebung umgeht alle Einschränkungen
• ✅ Keine Probleme mit Systempaketen – Alle Python-Abhängigkeiten isoliert
• ✅ Einfache Bereinigung – Einfach das Verzeichnis eyewitness-venv/ löschen
• ✅ Produktionsreif – Automatischer Rollback bei Installationsfehlern

Unterstützte Linux-Distributionen:

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

🍎 macOS-Installation

Homebrew-basiertes Setup mit Python-Virtualenv:

# 1. Installieren Sie Chrome über Homebrew
brew install --cask google-chrome

# 2. Navigieren Sie zum Setup-Verzeichnis und führen Sie Setup aus
cd EyeWitness/setup
sudo ./setup.sh

# 3. Testen Sie die Installation, indem Sie die virtuelle Umgebung aktivieren
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Was installiert wird:

• 🔒 Isolierte Python-Virtualenv (eyewitness-venv/)
• Python-Abhängigkeiten in der virtuellen Umgebung
• Chrome-Browser (über Homebrew)
• ChromeDriver für Automatisierung

🎯 Verwendungsbeispiele

🚀 So verwenden Sie EyeWitness

Nachdem Sie das Setup-Skript ausgeführt haben, aktivieren Sie die virtuelle Umgebung und führen Sie EyeWitness aus:

🐧 Linux/macOS:

# 1. Aktivieren Sie die virtuelle Umgebung
source eyewitness-venv/bin/activate

# 2. Führen Sie EyeWitness aus (Sie befinden sich jetzt in der isolierten Umgebung)
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. Wenn fertig, deaktivieren Sie die virtuelle Umgebung
deactivate

🪟 Windows:

# 1. Aktivieren Sie die virtuelle Umgebung
eyewitness-venv\Scripts\activate.bat

# 2. Führen Sie EyeWitness aus (Sie befinden sich jetzt in der isolierten Umgebung)
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. Wenn fertig, deaktivieren Sie die virtuelle Umgebung
deactivate

📄 Konfigurationsdateien

# Aktivieren Sie zuerst die virtuelle Umgebung
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Erstellen Sie eine Beispiel-Konfigurationsdatei
python Python/EyeWitness.py --create-config

# Verwenden Sie eine Konfigurationsdatei
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 URL-Validierung

# Aktivieren Sie zuerst die virtuelle Umgebung
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# URLs validieren ohne Screenshots
python Python/EyeWitness.py -f urls.txt --validate-urls

# Validierung überspringen (mit Vorsicht verwenden)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ Erweiterte Optionen

# Aktivieren Sie zuerst die virtuelle Umgebung
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Threads basierend auf Ihrem System anpassen (Standard: automatisch erkannt)
python Python/EyeWitness.py -f urls.txt --threads 5

# Timeout für langsame Verbindungen erhöhen
python Python/EyeWitness.py -f urls.txt --timeout 30

# Verzögerungen und Jitter hinzufügen
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

# Proxy verwenden
python Python/EyeWitness.py -f urls.txt --proxy-ip 127.0.0.1 --proxy-port 8080

# Benutzerdefiniertes Ausgabeverzeichnis
python Python/EyeWitness.py -f urls.txt -d /path/to/output