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

# Vorherigen Scan fortsetzen
python Python/EyeWitness.py --resume /path/to/output/ew.db

Leistungsoptimierung

EyeWitness erkennt automatisch Ihre Systemressourcen und passt sich entsprechend an:

• Thread-Anzahl basierend auf CPU-Kernen (2 × Kerne, max. 20)
• Speicherüberwachung zur Vermeidung von Systemüberlastung
• Überprüfung des verfügbaren Festplattenspeichers vor dem Start

Format der Konfigurationsdatei

Erstellen Sie eine Konfigurationsdatei, um Ihre bevorzugten Einstellungen zu speichern:

{
    "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
}

Fehlerbehebung

Häufige Probleme

Chromium/ChromeDriver nicht gefunden:

• Alle Plattformen: Führen Sie das Setup-Skript erneut aus – es installiert Browser automatisch
• Linux: sudo ./setup.sh im setup/-Verzeichnis
• Windows: .\setup.ps1 als Administrator im setup-Verzeichnis
• macOS: sudo ./setup.sh im setup/-Verzeichnis (nach brew install --cask google-chrome)

Probleme mit der virtuellen Umgebung:

• Löschen Sie das Verzeichnis eyewitness-venv/ und führen Sie das Setup-Skript erneut aus
• Stellen Sie sicher, dass Python 3.7+ mit venv-Modulunterstützung installiert ist
• Überprüfen Sie, ob Sie das Setup-Skript mit entsprechenden Administrator-/Root-Rechten ausgeführt haben

Verbindungs-Timeouts:

• Timeout erhöhen: --timeout 60
• Firewall-Einstellungen überprüfen
• Stellen Sie sicher, dass das Ziel erreichbar ist

Hohe Speichernutzung:

• Threads reduzieren: --threads 5
• URLs in kleineren Batches verarbeiten
• Andere Anwendungen schließen

Berechtigungsfehler:

• Linux/macOS: Dateiberechtigungen überprüfen
• Windows: Bei Bedarf als Administrator ausführen

Fehlermeldungen

Alle Fehler enthalten jetzt spezifische Schritte zur Fehlerbehebung. Zum Beispiel:

• Timeout-Fehler schlagen Proxy-Einstellungen und Timeout-Erhöhungen vor
• Verbindungsfehler enthalten Firewall- und Netzwerkprüfungen
• Ressourcenfehler zeigen Speichernutzung und Empfehlungen an

Ausgabe

EyeWitness generiert:

• report.html – Hauptbericht mit Screenshots
• screens/ – Screenshot-Bilder
• source/ – Quellcode der Seite
• ew.db – SQLite-Datenbank für Resume-Funktionalität

Berichtsfunktionen

• Kategorisierte Ergebnisse (High Value, CMS, Netzwerkgeräte usw.)
• Erkennung von Standard-Anmeldedaten
• Header-Analyse
• Durchsuchbar und sortierbar

Anforderungen

• Python 3.7+ mit venv-Modulunterstützung (Standard in den meisten Python-Installationen)
• Administrator-/Root-Rechte für die Installation (Systempakete und Erstellung der virtuellen Umgebung)
• Internetverbindung zum Herunterladen von Paketen
• Chromium/Chrome-Browser (wird automatisch vom Setup-Skript installiert)
• ChromeDriver (wird automatisch vom Setup-Skript installiert)

📝 Hinweis: Das Setup-Skript kümmert sich automatisch um alle Abhängigkeiten. Sie benötigen lediglich Python 3.7+ und Administratorrechte.

Änderungen gegenüber dem Original

Dieser Fork enthält eine bedeutende Modernisierung:

• Veraltete Selenium-APIs behoben
• Archivierte Abhängigkeiten ersetzt (fuzzywuzzy → rapidfuzz)
• Umfassende Fehlerbehandlung hinzugefügt
• Verbesserte plattformübergreifende Unterstützung
• Ressourcenüberwachung hinzugefügt
• Docker-Unterstützung in Entwicklung
• Unterstützung für Konfigurationsdateien hinzugefügt
• Verbesserte Benutzererfahrung

Kontakt

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

Lizenz

EyeWitness ist lizenziert unter der GNU General Public License v3.0.