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

# Reanudar un escaneo anterior
python Python/EyeWitness.py --resume /ruta/a/salida/ew.db

Ajuste de Rendimiento

EyeWitness detecta automáticamente los recursos de tu sistema y se ajusta en consecuencia:

• Número de hilos basado en núcleos de CPU (2 × núcleos, máximo 20)
• Monitorización de memoria para evitar sobrecarga del sistema
• Comprobaciones de espacio en disco antes de comenzar

Formato del Archivo de Configuración

Crea un archivo de configuración para guardar tus ajustes preferidos:

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

Solución de Problemas

Problemas Comunes

Chromium/ChromeDriver no encontrado:

• Todas las plataformas: Vuelve a ejecutar el script de configuración - instala los navegadores automáticamente
• Linux: sudo ./setup.sh en el directorio setup/
• Windows: .\setup.ps1 como Administrador en el directorio setup\
• macOS: sudo ./setup.sh en el directorio setup/ (después de brew install --cask google-chrome)

Problemas con el entorno virtual:

• Elimina el directorio eyewitness-venv/ y vuelve a ejecutar el script de configuración
• Asegúrate de tener Python 3.7+ instalado con soporte del módulo venv
• Verifica que ejecutaste el script de configuración con privilegios de Administrador/root adecuados

Tiempos de espera de conexión:

• Aumenta el tiempo de espera: --timeout 60
• Verifica la configuración del firewall
• Asegúrate de que el objetivo sea accesible

Uso elevado de memoria:

• Reduce los hilos: --threads 5
• Procesa URLs en lotes más pequeños
• Cierra otras aplicaciones

Errores de permisos:

• Linux/macOS: Verifica los permisos de archivos
• Windows: Ejecuta como Administrador si es necesario

Mensajes de Error

Todos los errores ahora incluyen pasos de solución específicos. Por ejemplo:

• Los errores de tiempo de espera sugieren configuraciones de proxy y aumentos de tiempo de espera
• Los errores de conexión proporcionan comprobaciones de firewall y red
• Los errores de recursos muestran uso de memoria y recomendaciones

Salida

EyeWitness genera:

• report.html - Informe principal con capturas de pantalla
• screens/ - Imágenes de las capturas de pantalla
• source/ - Código fuente de las páginas
• ew.db - Base de datos SQLite para capacidad de reanudación

Características del Informe

• Resultados categorizados (Alto Valor, CMS, Dispositivos de Red, etc.)
• Detección de credenciales por defecto
• Análisis de encabezados
• Buscable y ordenable

Requisitos

• Python 3.7+ con soporte del módulo venv (estándar en la mayoría de instalaciones de Python)
• Privilegios de Administrador/root para la instalación (paquetes del sistema y creación de entorno virtual)
• Conexión a Internet para descargar paquetes
• Navegador Chromium/Chrome (instalado automáticamente por el script de configuración)
• ChromeDriver (instalado automáticamente por el script de configuración)

📝 Nota: El script de configuración maneja todas las dependencias automáticamente. Solo necesitas Python 3.7+ y privilegios de administrador.

Cambios respecto al Original

Este fork incluye una modernización significativa:

• APIs de Selenium obsoletas corregidas
• Dependencias archivadas reemplazadas (fuzzywuzzy → rapidfuzz)
• Manejo integral de errores añadido
• Soporte multiplataforma mejorado
• Monitorización de recursos añadida
• Soporte Docker en desarrollo
• Soporte de archivos de configuración añadido
• Experiencia de usuario mejorada

Contacto

Correo electrónico: GetOffensive [@] redsiege [dot] com

Licencia

EyeWitness está licenciado bajo la GNU General Public License v3.0.