EyeWitness - Strumento per Screenshot Web

EyeWitness è progettato per scattare screenshot di siti web, fornire informazioni sulle intestazioni del server e identificare credenziali predefinite se note. Ora basato sul browser Chromium per una maggiore affidabilità e installazione più semplice.

🚀 Caratteristiche Principali

• Supporto multipiattaforma - Windows, Linux e macOS
• Basato su Chromium - Screenshot headless affidabili con Google Chrome/Chromium
• Gestione adattiva delle risorse - Si adatta automaticamente alle capacità del sistema
• Supporto file di configurazione - Salva le tue impostazioni preferite
• Validazione degli URL - Controlli preliminari per garantire che gli URL siano validi
• Monitoraggio dell'avanzamento con ETA - Sappi esattamente quando la scansione sarà completata
• Gestione errori migliorata - Tipi di errore specifici con indicazioni attuabili
• Formati di input multipli - File di testo, Nmap XML, Nessus XML
• Ambiente virtuale isolato - Zero conflitti di sistema e bypass di PEP 668

🔒 Architettura dell'Ambiente Virtuale

EyeWitness ora utilizza ambienti virtuali Python per tutte le installazioni, fornendo:

✅ Vantaggi Principali

• Nessun conflitto di sistema - Tutti i pacchetti Python installati in ambiente isolato
• Nessun problema PEP 668 - Bypassa completamente gli errori "externally-managed-environment" su Kali/Linux moderni
• Coerenza multipiattaforma - Stesso approccio su Windows, Linux e macOS
• Pulizia facile - Elimina la directory eyewitness-venv/ per rimuovere tutto
• Pronto per la produzione - Gestione automatica degli errori e rollback in caso di fallimenti

🚀 Come Funziona

1. Il setup crea l'ambiente virtuale - Directory eyewitness-venv/ con Python isolato
2. Attiva l'ambiente virtuale - Comando semplice per entrare nell'ambiente isolato
3. Tutti i pacchetti installati in isolamento - Impatto zero sul Python di sistema
4. Esegui EyeWitness normalmente - Comandi Python standard funzionano nell'ambiente virtuale

📁 Struttura dei File Dopo l'Installazione

EyeWitness/
├── eyewitness-venv/          # 🔒 Ambiente virtuale (pacchetti Python isolati)
│   ├── bin/activate          # Script di attivazione Linux/macOS
│   └── Scripts/activate.bat  # Script di attivazione Windows
├── Python/
│   └── EyeWitness.py         # 📜 Script principale (eseguito nell'ambiente virtuale)
└── setup/                    # Script di setup e requisiti

📦 Opzioni di Installazione

🔥 NOVITÀ: EyeWitness ora utilizza ambienti virtuali Python per zero conflitti e installazione a prova di proiettile su tutte le piattaforme!

Nota: Il supporto Docker è attualmente in sviluppo. Utilizza le opzioni di installazione native qui sotto per ora.

🪟 Installazione su Windows

Setup automatizzato con ambiente virtuale Python:

# 1. Apri PowerShell come amministratore
# 2. Vai alla directory EyeWitness
cd percorso\di\EyeWitness\setup

# 3. Esegui lo script di setup (crea l'ambiente virtuale)
.\setup.ps1

# 4. Testa l'installazione attivando l'ambiente virtuale
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

Cosa viene installato:

• 🔒 Ambiente virtuale Python isolato (eyewitness-venv/)
• Dipendenze Python nell'ambiente virtuale (selenium, etc.)
• Browser Google Chrome (se non presente)
• ChromeDriver per l'automazione

🐧 Installazione su Linux

Setup pronto per la produzione con ambiente virtuale Python:

# 1. Vai alla directory setup
cd EyeWitness/setup

# 2. Esegui lo script di setup (crea l'ambiente virtuale)
sudo ./setup.sh

# 3. Testa l'installazione attivando l'ambiente virtuale
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Cosa viene installato:

• 🔒 Ambiente virtuale Python isolato (eyewitness-venv/)
• Tutti i pacchetti Python nell'ambiente virtuale (bypass completo di PEP 668)
• Browser Chromium e ChromeDriver tramite pacchetti di sistema
• Supporto per display virtuale (xvfb)

🎯 Vantaggi:

• ✅ Nessun conflitto PEP 668 - L'ambiente virtuale bypassa tutte le restrizioni
• ✅ Nessun problema con pacchetti di sistema - Tutte le dipendenze Python isolate
• ✅ Pulizia facile - Basta eliminare la directory eyewitness-venv/
• ✅ Pronto per la produzione - Rollback automatico in caso di fallimenti di installazione

Distribuzioni Linux Supportate:

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

🍎 Installazione su macOS

Setup basato su Homebrew con ambiente virtuale Python:

# 1. Installa Chrome tramite Homebrew
brew install --cask google-chrome

# 2. Vai alla directory setup ed esegui il setup
cd EyeWitness/setup
sudo ./setup.sh

# 3. Testa l'installazione attivando l'ambiente virtuale
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Cosa viene installato:

• 🔒 Ambiente virtuale Python isolato (eyewitness-venv/)
• Dipendenze Python nell'ambiente virtuale
• Browser Chrome (tramite Homebrew)
• ChromeDriver per l'automazione

🎯 Esempi di Utilizzo

🚀 Come Usare EyeWitness

Dopo aver eseguito lo script di setup, attiva l'ambiente virtuale ed esegui EyeWitness:

🐧 Linux/macOS:

# 1. Attiva l'ambiente virtuale
source eyewitness-venv/bin/activate

# 2. Esegui EyeWitness (ora sei nell'ambiente isolato)
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 /percorso/di/output

# 3. Al termine, disattiva l'ambiente virtuale
deactivate

🪟 Windows:

# 1. Attiva l'ambiente virtuale
eyewitness-venv\Scripts\activate.bat

# 2. Esegui EyeWitness (ora sei nell'ambiente isolato)
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:\percorso\di\output

# 3. Al termine, disattiva l'ambiente virtuale
deactivate

📄 File di Configurazione

# Attiva prima l'ambiente virtuale
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Crea un file di configurazione di esempio
python Python/EyeWitness.py --create-config

# Usa un file di configurazione
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 Validazione degli URL

# Attiva prima l'ambiente virtuale
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Valida gli URL senza scattare screenshot
python Python/EyeWitness.py -f urls.txt --validate-urls

# Salta la validazione (usa con cautela)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ Opzioni Avanzate

# Attiva prima l'ambiente virtuale
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Regola i thread in base al sistema (predefinito: rilevamento automatico)
python Python/EyeWitness.py -f urls.txt --threads 5

# Aumenta il timeout per connessioni lente
python Python/EyeWitness.py -f urls.txt --timeout 30

# Aggiungi ritardi e jitter
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

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

# Directory di output personalizzata
python Python/EyeWitness.py -f urls.txt -d /percorso/di/output

# Riprendi una scansione precedente
python Python/EyeWitness.py --resume /percorso/di/output/ew.db