EyeWitness - Herramienta de Capturas de Pantalla Web

EyeWitness está diseñada para tomar capturas de pantalla de sitios web, proporcionar información del encabezado del servidor e identificar credenciales por defecto si se conocen. Ahora impulsada por el navegador Chromium para mayor fiabilidad y una instalación más sencilla.

🚀 Características Clave

• Soporte multiplataforma - Windows, Linux y macOS
• Impulsado por Chromium - Capturas de pantalla headless fiables con Google Chrome/Chromium
• Gestión adaptativa de recursos - Se ajusta automáticamente a las capacidades del sistema
• Soporte de archivos de configuración - Guarda tus ajustes preferidos
• Validación de URLs - Comprobaciones previas para asegurar que las URLs son válidas
• Seguimiento de progreso con ETA - Saber exactamente cuándo finalizará tu escaneo
• Manejo mejorado de errores - Tipos de error específicos con orientación práctica
• Múltiples formatos de entrada - Archivos de texto, XML de Nmap, XML de Nessus
• Entorno virtual aislado - Sin conflictos del sistema y omisión de PEP 668

🔒 Arquitectura de Entorno Virtual

EyeWitness ahora utiliza entornos virtuales de Python para todas las instalaciones, proporcionando:

✅ Beneficios Clave

• Sin conflictos del sistema - Todos los paquetes de Python instalados en un entorno aislado
• Sin problemas de PEP 668 - Evita completamente los errores de "externally-managed-environment" en Kali/Linux moderno
• Consistencia multiplataforma - Mismo enfoque en Windows, Linux y macOS
• Limpieza sencilla - Elimina el directorio eyewitness-venv/ para borrar todo
• Listo para producción - Manejo automático de errores y reversión en caso de fallos

🚀 Cómo Funciona

1. El setup crea el entorno virtual - Directorio eyewitness-venv/ con Python aislado
2. Activar el entorno virtual - Comando simple para entrar al entorno aislado
3. Todos los paquetes instalados de forma aislada - Cero impacto en tu Python del sistema
4. Ejecutar EyeWitness normalmente - Los comandos estándar de Python funcionan dentro del entorno virtual

📁 Estructura de Archivos Después de la Instalación

EyeWitness/
├── eyewitness-venv/          # 🔒 Entorno virtual (paquetes Python aislados)
│   ├── bin/activate          # Script de activación Linux/macOS
│   └── Scripts/activate.bat  # Script de activación Windows
├── Python/
│   └── EyeWitness.py         # 📜 Script principal (se ejecuta en el entorno virtual)
└── setup/                    # Scripts de instalación y requisitos

📦 Opciones de Instalación

🔥 NUEVO: EyeWitness ahora utiliza entornos virtuales de Python para cero conflictos e instalación a prueba de balas en todas las plataformas.

Nota: El soporte para Docker está actualmente en desarrollo. Por favor, usa las opciones de instalación nativas a continuación por ahora.

🪟 Instalación en Windows

Configuración automática con entorno virtual de Python:

# 1. Abrir PowerShell como Administrador
# 2. Navegar al directorio de EyeWitness
cd ruta\a\EyeWitness\setup

# 3. Ejecutar el script de configuración (crea el entorno virtual)
.\setup.ps1

# 4. Probar la instalación activando el entorno virtual
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

Qué se instala:

• 🔒 Entorno virtual de Python aislado (eyewitness-venv/)
• Dependencias de Python en el entorno virtual (selenium, etc.)
• Navegador Google Chrome (si no está presente)
• ChromeDriver para automatización

🐧 Instalación en Linux

Configuración lista para producción con entorno virtual de Python:

# 1. Navegar al directorio de setup
cd EyeWitness/setup

# 2. Ejecutar el script de configuración (crea el entorno virtual)
sudo ./setup.sh

# 3. Probar la instalación activando el entorno virtual
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Qué se instala:

• 🔒 Entorno virtual de Python aislado (eyewitness-venv/)
• Todos los paquetes de Python en el entorno virtual (omite completamente PEP 668)
• Navegador Chromium y ChromeDriver mediante paquetes del sistema
• Soporte de pantalla virtual (xvfb)

🎯 Beneficios:

• ✅ Sin conflictos PEP 668 - El entorno virtual evita todas las restricciones
• ✅ Sin problemas de paquetes del sistema - Todas las dependencias de Python aisladas
• ✅ Limpieza sencilla - Solo elimina el directorio eyewitness-venv/
• ✅ Listo para producción - Reversión automática en caso de fallos de instalación

Distribuciones Linux compatibles:

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

🍎 Instalación en macOS

Configuración basada en Homebrew con entorno virtual de Python:

# 1. Instalar Chrome mediante Homebrew
brew install --cask google-chrome

# 2. Navegar al directorio de setup y ejecutar la configuración
cd EyeWitness/setup
sudo ./setup.sh

# 3. Probar la instalación activando el entorno virtual
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

Qué se instala:

• 🔒 Entorno virtual de Python aislado (eyewitness-venv/)
• Dependencias de Python en el entorno virtual
• Navegador Chrome (mediante Homebrew)
• ChromeDriver para automatización

🎯 Ejemplos de Uso

🚀 Cómo Usar EyeWitness

Después de ejecutar el script de configuración, activa el entorno virtual y ejecuta EyeWitness:

🐧 Linux/macOS:

# 1. Activar el entorno virtual
source eyewitness-venv/bin/activate

# 2. Ejecutar EyeWitness (ahora estás en el entorno aislado)
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 /ruta/a/salida

# 3. Al finalizar, desactivar el entorno virtual
deactivate

🪟 Windows:

# 1. Activar el entorno virtual
eyewitness-venv\Scripts\activate.bat

# 2. Ejecutar EyeWitness (ahora estás en el entorno aislado)
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:\ruta\a\salida

# 3. Al finalizar, desactivar el entorno virtual
deactivate

📄 Archivos de Configuración

# Activar el entorno virtual primero
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Crear un archivo de configuración de ejemplo
python Python/EyeWitness.py --create-config

# Usar un archivo de configuración
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 Validación de URLs

# Activar el entorno virtual primero
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Validar URLs sin tomar capturas de pantalla
python Python/EyeWitness.py -f urls.txt --validate-urls

# Omitir validación (usar con precaución)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ Opciones Avanzadas

# Activar el entorno virtual primero
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Ajustar hilos según tu sistema (por defecto: detección automática)
python Python/EyeWitness.py -f urls.txt --threads 5

# Aumentar tiempo de espera para conexiones lentas
python Python/EyeWitness.py -f urls.txt --timeout 30

# Añadir retrasos y fluctuación
python Python/EyeWitness.py -f urls.txt --delay 2 --jitter 5

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

# Directorio de salida personalizado
python Python/EyeWitness.py -f urls.txt -d /ruta/a/salida