EyeWitness - Ferramenta de Captura de Tela Web

EyeWitness é projetado para capturar telas de sites, fornecer informações de cabeçalho do servidor e identificar credenciais padrão, se conhecidas. Agora alimentado pelo navegador Chromium para melhor confiabilidade e instalação mais fácil.

🚀 Principais Recursos

• Suporte multiplataforma - Windows, Linux e macOS
• Alimentado por Chromium - Capturas de tela headless confiáveis com Google Chrome/Chromium
• Gerenciamento adaptável de recursos - Ajusta automaticamente às capacidades do sistema
• Suporte a arquivos de configuração - Salve suas configurações preferidas
• Validação de URL - Verificações pré-voo para garantir que as URLs sejam válidas
• Acompanhamento de progresso com ETA - Saiba exatamente quando sua varredura será concluída
• Tratamento de erros aprimorado - Tipos de erro específicos com orientação acionável
• Múltiplos formatos de entrada - Arquivos de texto, XML do Nmap, XML do Nessus
• Ambiente virtual isolado - Zero conflitos no sistema e bypass do PEP 668

🔒 Arquitetura de Ambiente Virtual

EyeWitness agora usa ambientes virtuais Python para todas as instalações, proporcionando:

✅ Principais Benefícios

• Sem conflitos no sistema - Todos os pacotes Python instalados em ambiente isolado
• Sem problemas de PEP 668 - Ignora completamente erros de "externally-managed-environment" no Kali/Linux moderno
• Consistência multiplataforma - Mesma abordagem no Windows, Linux e macOS
• Limpeza fácil - Exclua o diretório eyewitness-venv/ para remover tudo
• Pronto para produção - Tratamento automático de erros e reversão em caso de falhas

🚀 Como Funciona

1. A configuração cria o ambiente virtual - Diretório eyewitness-venv/ com Python isolado
2. Ative o ambiente virtual - Comando simples para entrar no ambiente isolado
3. Todos os pacotes instalados em isolamento - Impacto zero no seu Python do sistema
4. Execute o EyeWitness normalmente - Comandos Python padrão funcionam dentro do ambiente virtual

📁 Estrutura de Arquivos Após a Instalação

EyeWitness/
├── eyewitness-venv/          # 🔒 Ambiente virtual (pacotes Python isolados)
│   ├── bin/activate          # Script de ativação Linux/macOS
│   └── Scripts/activate.bat  # Script de ativação Windows
├── Python/
│   └── EyeWitness.py         # 📜 Script principal (executado no ambiente virtual)
└── setup/                    # Scripts de configuração e requisitos

📦 Opções de Instalação

🔥 NOVO: EyeWitness agora usa ambientes virtuais Python para zero conflitos e instalação à prova de balas em todas as plataformas!

Nota: O suporte a Docker está atualmente em desenvolvimento. Use as opções de instalação nativa abaixo por enquanto.

🪟 Instalação no Windows

Configuração automatizada com ambiente virtual Python:

# 1. Abra o PowerShell como Administrador
# 2. Navegue até o diretório do EyeWitness
cd caminho\para\EyeWitness\setup

# 3. Execute o script de configuração (cria o ambiente virtual)
.\setup.ps1

# 4. Teste a instalação ativando o ambiente virtual
cd ..
eyewitness-venv\Scripts\activate.bat
python Python\EyeWitness.py --single https://example.com

O que é instalado:

• 🔒 Ambiente virtual Python isolado (eyewitness-venv/)
• Dependências Python no ambiente virtual (selenium, etc.)
• Navegador Google Chrome (se não estiver presente)
• ChromeDriver para automação

🐧 Instalação no Linux

Configuração pronta para produção com ambiente virtual Python:

# 1. Navegue até o diretório de configuração
cd EyeWitness/setup

# 2. Execute o script de configuração (cria o ambiente virtual)
sudo ./setup.sh

# 3. Teste a instalação ativando o ambiente virtual
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

O que é instalado:

• 🔒 Ambiente virtual Python isolado (eyewitness-venv/)
• Todos os pacotes Python no ambiente virtual (ignora completamente o PEP 668)
• Navegador Chromium e ChromeDriver via pacotes do sistema
• Suporte a display virtual (xvfb)

🎯 Benefícios:

• ✅ Sem conflitos de PEP 668 - O ambiente virtual ignora todas as restrições
• ✅ Sem problemas de pacotes do sistema - Todas as dependências Python isoladas
• ✅ Limpeza fácil - Basta excluir o diretório eyewitness-venv/
• ✅ Pronto para produção - Reversão automática em falhas de instalação

Distribuições Linux Suportadas:

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

🍎 Instalação no macOS

Configuração baseada em Homebrew com ambiente virtual Python:

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

# 2. Navegue até o diretório de configuração e execute o setup
cd EyeWitness/setup
sudo ./setup.sh

# 3. Teste a instalação ativando o ambiente virtual
cd ..
source eyewitness-venv/bin/activate
python Python/EyeWitness.py --single https://example.com

O que é instalado:

• 🔒 Ambiente virtual Python isolado (eyewitness-venv/)
• Dependências Python no ambiente virtual
• Navegador Chrome (via Homebrew)
• ChromeDriver para automação

🎯 Exemplos de Uso

🚀 Como Usar o EyeWitness

Após executar o script de configuração, ative o ambiente virtual e execute o EyeWitness:

🐧 Linux/macOS:

# 1. Ative o ambiente virtual
source eyewitness-venv/bin/activate

# 2. Execute o EyeWitness (você está agora no ambiente isolado)
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 /caminho/para/saida

# 3. Quando terminar, desative o ambiente virtual
deactivate

🪟 Windows:

# 1. Ative o ambiente virtual
eyewitness-venv\Scripts\activate.bat

# 2. Execute o EyeWitness (você está agora no ambiente isolado)
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:\caminho\para\saida

# 3. Quando terminar, desative o ambiente virtual
deactivate

📄 Arquivos de Configuração

# Ative o ambiente virtual primeiro
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Crie um arquivo de configuração de exemplo
python Python/EyeWitness.py --create-config

# Use um arquivo de configuração
python Python/EyeWitness.py -f urls.txt --config ~/.eyewitness/config.json

🔍 Validação de URL

# Ative o ambiente virtual primeiro
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Valide URLs sem capturar telas
python Python/EyeWitness.py -f urls.txt --validate-urls

# Pule a validação (use com cuidado)
python Python/EyeWitness.py -f urls.txt --skip-validation

⚙️ Opções Avançadas

# Ative o ambiente virtual primeiro
source eyewitness-venv/bin/activate  # Linux/macOS
eyewitness-venv\Scripts\activate.bat # Windows

# Ajuste as threads com base no seu sistema (padrão: auto-detectado)
python Python/EyeWitness.py -f urls.txt --threads 5

# Aumente o timeout para conexões lentas
python Python/EyeWitness.py -f urls.txt --timeout 30

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

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

# Diretório de saída personalizado
python Python/EyeWitness.py -f urls.txt -d /caminho/para/saida

# Retomar uma varredura anterior
python Python/EyeWitness.py --resume /caminho/para/saida/ew.db

Ajuste de Desempenho

O EyeWitness detecta automaticamente os recursos do seu sistema e ajusta conforme necessário:

• Número de threads baseado em núcleos de CPU (2 × núcleos, máximo 20)
• Monitoramento de memória para evitar sobrecarga do sistema
• Verificações de espaço em disco antes de iniciar

Formato do Arquivo de Configuração

Crie um arquivo de configuração para salvar suas configurações preferidas:

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

Solução de Problemas

Problemas Comuns

Chromium/ChromeDriver não encontrado:

• Todas as plataformas: Execute novamente o script de configuração - ele instala navegadores automaticamente
• Linux: sudo ./setup.sh no diretório setup/
• Windows: .\setup.ps1 como Administrador no diretório setup\
• macOS: sudo ./setup.sh no diretório setup/ (após brew install --cask google-chrome)

Problemas com ambiente virtual:

• Exclua o diretório eyewitness-venv/ e execute novamente o script de configuração
• Certifique-se de que o Python 3.7+ esteja instalado com suporte ao módulo venv
• Verifique se você executou o script de configuração com privilégios adequados de Administrador/root

Timeouts de conexão:

• Aumente o timeout: --timeout 60
• Verifique as configurações de firewall
• Verifique se o destino está acessível

Alto uso de memória:

• Reduza as threads: --threads 5
• Processe URLs em lotes menores
• Feche outros aplicativos

Erros de permissão:

• Linux/macOS: Verifique as permissões de arquivo
• Windows: Execute como Administrador, se necessário

Mensagens de Erro

Todos os erros agora incluem etapas específicas de solução de problemas. Por exemplo:

• Erros de timeout sugerem configurações de proxy e aumentos de timeout
• Erros de conexão fornecem verificações de firewall e rede
• Erros de recurso mostram uso de memória e recomendações

Saída

O EyeWitness gera:

• report.html - Relatório principal com capturas de tela
• screens/ - Imagens das capturas de tela
• source/ - Código fonte da página
• ew.db - Banco de dados SQLite para capacidade de retomada

Recursos do Relatório

• Resultados categorizados (Alto Valor, CMS, Dispositivos de Rede, etc.)
• Detecção de credenciais padrão
• Análise de cabeçalho
• Pesquisável e classificável

Requisitos

• Python 3.7+ com suporte ao módulo venv (padrão na maioria das instalações Python)
• Privilégios de Administrador/root para instalação (pacotes do sistema e criação de ambiente virtual)
• Conexão com a internet para download de pacotes
• Navegador Chromium/Chrome (instalado automaticamente pelo script de configuração)
• ChromeDriver (instalado automaticamente pelo script de configuração)

📝 Nota: O script de configuração gerencia todas as dependências automaticamente. Você só precisa do Python 3.7+ e privilégios de administrador.

Mudanças em Relação ao Original

Este fork inclui modernização significativa:

• APIs Selenium obsoletas corrigidas
• Dependências arquivadas substituídas (fuzzywuzzy → rapidfuzz)
• Tratamento de erros abrangente adicionado
• Suporte multiplataforma melhorado
• Monitoramento de recursos adicionado
• Suporte a Docker em desenvolvimento
• Suporte a arquivos de configuração adicionado
• Experiência do usuário aprimorada

Contato

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

Licença

EyeWitness está licenciado sob a GNU General Public License v3.0.