EyeWitness - Outil de Capture d'Écran Web

EyeWitness est conçu pour prendre des captures d'écran de sites web, fournir des informations sur les en-têtes du serveur et identifier les identifiants par défaut si connus. Désormais propulsé par le navigateur Chromium pour une meilleure fiabilité et une installation plus facile.

🚀 Fonctionnalités clés

• Prise en charge multiplateforme - Windows, Linux et macOS
• Propulsé par Chromium - Captures d'écran headless fiables avec Google Chrome/Chromium
• Gestion adaptative des ressources - S'ajuste automatiquement aux capacités du système
• Prise en charge des fichiers de configuration - Sauvegardez vos paramètres préférés
• Validation des URL - Vérifications préalables pour garantir la validité des URL
• Suivi de progression avec ETA - Sachez exactement quand votre analyse sera terminée
• Gestion améliorée des erreurs - Types d'erreurs spécifiques avec des conseils exploitables
• Formats d'entrée multiples - Fichiers texte, XML Nmap, XML Nessus
• Environnement virtuel isolé - Zéro conflit système et contournement PEP 668

🔒 Architecture d'environnement virtuel

EyeWitness utilise désormais des environnements virtuels Python pour toutes les installations, offrant :

✅ Avantages clés

• Aucun conflit système - Tous les paquets Python installés dans un environnement isolé
• Aucun problème PEP 668 - Contourne complètement les erreurs "externally-managed-environment" sur Kali/Linux moderne
• Cohérence multiplateforme - Même approche sur Windows, Linux et macOS
• Nettoyage facile - Supprimez le répertoire eyewitness-venv/ pour tout retirer
• Prêt pour la production - Gestion automatique des erreurs et restauration en cas d'échec

🚀 Comment ça marche

1. L'installation crée un environnement virtuel - Répertoire eyewitness-venv/ avec Python isolé
2. Activez l'environnement virtuel - Commande simple pour entrer dans l'environnement isolé
3. Tous les paquets installés en isolation - Zéro impact sur votre Python système
4. Exécutez EyeWitness normalement - Les commandes Python standard fonctionnent dans l'environnement virtuel

📁 Structure des fichiers après installation

EyeWitness/
├── eyewitness-venv/          # 🔒 Environnement virtuel (paquets Python isolés)
│   ├── bin/activate          # Script d'activation Linux/macOS
│   └── Scripts/activate.bat  # Script d'activation Windows
├── Python/
│   └── EyeWitness.py         # 📜 Script principal (s'exécute dans l'environnement virtuel)
└── setup/                    # Scripts d'installation et dépendances

📦 Options d'installation

🔥 NOUVEAU : EyeWitness utilise désormais des environnements virtuels Python pour zéro conflit et une installation à toute épreuve sur toutes les plateformes !

Remarque : Le support Docker est actuellement en développement. Veuillez utiliser les options d'installation natives ci-dessous pour l'instant.

🪟 Installation Windows

Configuration automatisée avec environnement virtuel Python :

# 1. Ouvrez PowerShell en tant qu'administrateur
# 2. Naviguez vers le répertoire EyeWitness
cd chemin\vers\EyeWitness\setup

# 3. Exécutez le script d'installation (crée un environnement virtuel)
.\setup.ps1

# 4. Testez l'installation en activant l'environnement virtuel
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

Ce qui est installé :

• 🔒 Environnement virtuel Python isolé (eyewitness-venv/)
• Dépendances Python dans l'environnement virtuel (selenium, etc.)
• Navigateur Google Chrome (si absent)
• ChromeDriver pour l'automatisation

🐧 Installation Linux

Configuration prête pour la production avec environnement virtuel Python :

# 1. Naviguez vers le répertoire d'installation
cd EyeWitness/setup

# 2. Exécutez le script d'installation (crée un environnement virtuel)
sudo ./setup.sh

# 3. Testez l'installation en activant l'environnement virtuel
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Ce qui est installé :

• 🔒 Environnement virtuel Python isolé (eyewitness-venv/)
• Tous les paquets Python dans l'environnement virtuel (contourne complètement PEP 668)
• Navigateur Chromium et ChromeDriver via les paquets système
• Support d'affichage virtuel (xvfb)

🎯 Avantages :

• ✅ Aucun conflit PEP 668 - L'environnement virtuel contourne toutes les restrictions
• ✅ Aucun problème de paquets système - Toutes les dépendances Python isolées
• ✅ Nettoyage facile - Supprimez simplement le répertoire eyewitness-venv/
• ✅ Prêt pour la production - Restauration automatique en cas d'échec d'installation

Distributions Linux supportées :

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

🍎 Installation macOS

Configuration basée sur Homebrew avec environnement virtuel Python :

# 1. Installez Chrome via Homebrew
brew install --cask google-chrome

# 2. Naviguez vers le répertoire d'installation et exécutez l'installation
cd EyeWitness/setup
sudo ./setup.sh

# 3. Testez l'installation en activant l'environnement virtuel
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Ce qui est installé :

• 🔒 Environnement virtuel Python isolé (eyewitness-venv/)
• Dépendances Python dans l'environnement virtuel
• Navigateur Chrome (via Homebrew)
• ChromeDriver pour l'automatisation

🎯 Exemples d'utilisation

🚀 Comment utiliser EyeWitness

Après avoir exécuté le script d'installation, activez l'environnement virtuel et exécutez EyeWitness :

🐧 Linux/macOS :

# 1. Activez l'environnement virtuel
source eyewitness-venv/bin/activate

# 2. Exécutez EyeWitness (vous êtes maintenant dans l'environnement isolé)
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 /chemin/vers/sortie

# 3. Une fois terminé, désactivez l'environnement virtuel
deactivate

🪟 Windows :

# 1. Activez l'environnement virtuel
eyewitness-venv\Scripts\activate.bat

# 2. Exécutez EyeWitness (vous êtes maintenant dans l'environnement isolé)
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:\chemin\vers\sortie

# 3. Une fois terminé, désactivez l'environnement virtuel
deactivate

📄 Fichiers de configuration

# Activez d'abord l'environnement virtuel
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Créez un fichier de configuration exemple
python Python/EyeWitness.py --create-config

# Utilisez un fichier de configuration
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 Validation des URL

# Activez d'abord l'environnement virtuel
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Validez les URL sans prendre de captures d'écran
python Python/EyeWitness.py -f urls.txt --validate-urls

# Ignorer la validation (à utiliser avec prudence)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ Options avancées

# Activez d'abord l'environnement virtuel
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Ajustez le nombre de threads en fonction de votre système (par défaut : détection automatique)
python Python/EyeWitness.py -f urls.txt --threads 5

# Augmentez le délai d'attente pour les connexions lentes
python Python/EyeWitness.py -f urls.txt --timeout 30

# Ajoutez des délais et de la gigue
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

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

# Répertoire de sortie personnalisé
python Python/EyeWitness.py -f urls.txt -d /chemin/vers/sortie

# Reprendre une analyse précédente
python Python/EyeWitness.py --resume /chemin/vers/sortie/ew.db

Réglage des performances

EyeWitness détecte automatiquement les ressources de votre système et s'ajuste en conséquence :

• Nombre de threads basé sur les cœurs CPU (2 × cœurs, max 20)
• Surveillance de la mémoire pour éviter la surcharge du système
• Vérification de l'espace disque avant de commencer

Format du fichier de configuration

Créez un fichier de configuration pour enregistrer vos paramètres préférés :

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

Dépannage

Problèmes courants

Chromium/ChromeDriver introuvable :

• Toutes les plateformes : Réexécutez le script d'installation - il installe les navigateurs automatiquement
• Linux : sudo ./setup.sh dans le répertoire setup/
• Windows : .\setup.ps1 en tant qu'administrateur dans le répertoire setup\
• macOS : sudo ./setup.sh dans le répertoire setup/ (après brew install --cask google-chrome)

Problèmes d'environnement virtuel :

• Supprimez le répertoire eyewitness-venv/ et réexécutez le script d'installation
• Assurez-vous que Python 3.7+ est installé avec le support du module venv
• Vérifiez que vous avez exécuté le script d'installation avec les privilèges Administrateur/root appropriés

Délais d'attente de connexion :

• Augmentez le délai d'attente : --timeout 60
• Vérifiez les paramètres du pare-feu
• Vérifiez que la cible est accessible

Utilisation élevée de la mémoire :

• Réduisez le nombre de threads : --threads 5
• Traitez les URL par lots plus petits
• Fermez les autres applications

Erreurs de permission :

• Linux/macOS : Vérifiez les permissions des fichiers
• Windows : Exécutez en tant qu'administrateur si nécessaire

Messages d'erreur

Toutes les erreurs incluent désormais des étapes de dépannage spécifiques. Par exemple :

• Les erreurs de délai d'attente suggèrent des paramètres de proxy et l'augmentation du délai d'attente
• Les erreurs de connexion fournissent des vérifications de pare-feu et de réseau
• Les erreurs de ressources affichent l'utilisation de la mémoire et des recommandations

Sortie

EyeWitness génère :

• report.html - Rapport principal avec captures d'écran
• screens/ - Images des captures d'écran
• source/ - Code source des pages
• ew.db - Base de données SQLite pour la reprise

Fonctionnalités du rapport

• Résultats catégorisés (Haute valeur, CMS, Périphériques réseau, etc.)
• Détection des identifiants par défaut
• Analyse des en-têtes
• Recherchable et triable

Prérequis

• Python 3.7+ avec le support du module venv (standard dans la plupart des installations Python)
• Privilèges Administrateur/root pour l'installation (paquets système et création d'environnement virtuel)
• Connexion Internet pour le téléchargement des paquets
• Navigateur Chromium/Chrome (installé automatiquement par le script d'installation)
• ChromeDriver (installé automatiquement par le script d'installation)

📝 Remarque : Le script d'installation gère toutes les dépendances automatiquement. Vous avez seulement besoin de Python 3.7+ et des privilèges administrateur.

Changements par rapport à l'original

Ce fork inclut une modernisation significative :

• Correction des API Selenium obsolètes
• Remplacement des dépendances archivées (fuzzywuzzy → rapidfuzz)
• Ajout d'une gestion complète des erreurs
• Amélioration du support multiplateforme
• Ajout de la surveillance des ressources
• Support Docker en développement
• Ajout du support des fichiers de configuration
• Amélioration de l'expérience utilisateur

Contact

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

Licence

EyeWitness est sous licence GNU General Public License v3.0.