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

Ottimizzazione delle Prestazioni

EyeWitness rileva automaticamente le risorse del sistema e si adatta di conseguenza:

• Numero di thread basato sui core della CPU (2 × core, max 20)
• Monitoraggio della memoria per prevenire sovraccarichi di sistema
• Controllo dello spazio su disco prima di iniziare

Formato del File di Configurazione

Crea un file di configurazione per salvare le tue impostazioni preferite:

{
    "threads": 10,
    "timeout": 30,
    "delay": 0,
    "jitter": 0,
    "user_agent": "User Agent Personalizzato",
    "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
}

Risoluzione dei Problemi

Problemi Comuni

Chromium/ChromeDriver non trovato:

• Tutte le piattaforme: Riesegui lo script di setup - installa i browser automaticamente
• Linux: sudo ./setup.sh nella directory setup/
• Windows: .\setup.ps1 come amministratore nella directory setup\
• macOS: sudo ./setup.sh nella directory setup/ (dopo brew install --cask google-chrome)

Problemi con l'ambiente virtuale:

• Elimina la directory eyewitness-venv/ e riesegui lo script di setup
• Assicurati che Python 3.7+ sia installato con il supporto del modulo venv
• Verifica di aver eseguito lo script di setup con privilegi di Amministratore/root adeguati

Timeout di connessione:

• Aumenta il timeout: --timeout 60
• Controlla le impostazioni del firewall
• Verifica che il target sia raggiungibile

Utilizzo elevato di memoria:

• Riduci i thread: --threads 5
• Elabora gli URL in lotti più piccoli
• Chiudi altre applicazioni

Errori di permessi:

• Linux/macOS: Controlla i permessi dei file
• Windows: Esegui come amministratore se necessario

Messaggi di Errore

Tutti gli errori ora includono passaggi specifici per la risoluzione. Ad esempio:

• Errori di timeout suggeriscono impostazioni proxy e aumento del timeout
• Errori di connessione forniscono controlli del firewall e di rete
• Errori di risorse mostrano l'utilizzo della memoria e raccomandazioni

Output

EyeWitness genera:

• report.html - Report principale con screenshot
• screens/ - Immagini degli screenshot
• source/ - Codice sorgente della pagina
• ew.db - Database SQLite per la capacità di ripresa

Funzionalità del Report

• Risultati categorizzati (Alto Valore, CMS, Dispositivi di Rete, etc.)
• Rilevamento credenziali predefinite
• Analisi delle intestazioni
• Ricercabile e ordinabile

Requisiti

• Python 3.7+ con supporto del modulo venv (standard nella maggior parte delle installazioni Python)
• Privilegi di amministratore/root per l'installazione (pacchetti di sistema e creazione dell'ambiente virtuale)
• Connessione Internet per il download dei pacchetti
• Browser Chromium/Chrome (installato automaticamente dallo script di setup)
• ChromeDriver (installato automaticamente dallo script di setup)

📝 Nota: Lo script di setup gestisce automaticamente tutte le dipendenze. Hai solo bisogno di Python 3.7+ e privilegi di amministratore.

Modifiche dall'Originale

Questo fork include una modernizzazione significativa:

• API Selenium deprecate corrette
• Dipendenze archiviate sostituite (fuzzywuzzy → rapidfuzz)
• Gestione degli errori completa aggiunta
• Supporto multipiattaforma migliorato
• Monitoraggio delle risorse aggiunto
• Supporto Docker in sviluppo
• Supporto per file di configurazione aggiunto
• Esperienza utente migliorata

Contatti

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

Licenza

EyeWitness è concesso in licenza sotto la GNU General Public License v3.0.