
Scanner de vulnerabilidades web em Python: SQL injection, XSS, path traversal, cabeçalhos de segurança. Crawler, dashboard Flask, relatório em PDF.
Scanner de vulnerabilidades web. Faz o crawling de um site, encontra formulários e parâmetros, e os testa contra SQL injection, XSS refletido, path traversal e cabeçalhos de segurança ausentes. Produz um relatório no terminal, um PDF e tem um dashboard Flask.
Projeto de aprendizagem. Escrevi-o para entender como funcionam esses
ataques na prática, depois de ter estudado a teoria. O código é gerado com
assistência de IA e declaro isso: o que eu fiz foi o teste e a
correção dos falsos positivos, que estão documentados em
docs/DESIGN_NOTES.md.
Apenas em aplicações suas ou com autorização por escrito. Escanear sites de terceiros sem permissão é ilegal na maioria das jurisdições.
O que NÃO faz, mesmo que os payloads estejam nos arquivos: SQL injection time-based e XSS stored. O time-based requer medir a latência contra uma baseline e em rede ruidosa produz falsos positivos com demasiada facilidade; o stored requer enviar em uma página e verificar em outra, coisa que o crawler atual não faz. Enquanto não houver o código, não os declaro entre as features.
git clone https://github.com/torchiachristian/VulnScan
cd VulnScan
pip install -r requirements.txt
python3 src/database.py
# scansione base
python3 src/scanner.py http://localhost:8080
# con report PDF
python3 src/scanner.py http://localhost:8080 --pdf report.pdf
# dashboard web su http://127.0.0.1:5000
python3 src/web/app.py
# DVWA in docker
docker run -p 80:80 vulnerables/web-dvwa
# credenziali admin/password, livello di sicurezza "Low"
Ou OWASP Juice Shop. No repositório também há dois apps Flask mínimos em
tests/: um deliberadamente vulnerável e um seguro, usados para verificar que a
ferramenta encontra as vulnerabilidades reais sem inventar falsas.
A primeira versão do detector baseado em booleanos fazia assim:
if len(response_true.text) != len(response_false.text):
# -> SQL Injection, Critical
Bastava um byte de diferença entre a resposta à condição verdadeira e a à condição falsa para declarar uma SQL injection crítica.
O problema é que duas requisições idênticas à mesma página quase nunca dão a mesma resposta: tokens CSRF, timestamps, contadores de visitas, banners. Escrevi um app Flask sem nenhum banco de dados e com o input sempre escapado, com um token aleatório dentro como qualquer site tem, e a ferramenta encontrou isto:
[6] SQL Injection (Critical)
Evidence: Response length difference: 268 vs 300
Uma SQL injection numa aplicação que não tem banco de dados. Duas requisições idênticas para a mesma página retornavam 262 e 241 bytes, então a verificação disparava mesmo sem payload.
Agora o detector mede primeiro quanto a página varia sozinha com a mesma entrada, depois considera uma diferença apenas se ela superar esse ruído por uma margem e se o resultado for coerente em várias tentativas, sempre na mesma direção. Se a página for demasiado instável para medir, retorna nada em vez de adivinhar.
Na mesma aplicação segura agora não sinaliza mais nada, e numa aplicação com uma SQL injection verdadeira continua a encontrá-la.
src/
├── crawler/web_crawler.py scoperta di pagine e form
├── detectors/
│ ├── http_utils.py costruzione richieste e misura del rumore
│ ├── sql_injection.py error-based e boolean-based
│ ├── xss.py XSS riflesso
│ ├── path_traversal.py directory traversal
│ └── security_headers.py header mancanti
├── reporting/pdf_generator.py report PDF
├── web/app.py dashboard Flask
├── scanner.py pipeline principale
└── database.py SQLite
payloads/ payload per tipo di attacco
tests/ app di prova (vulnerabile e sicura) + test
O crawler não lida com autenticação, portanto vê apenas a parte pública de uma aplicação. Não há rate limiting: contra um site real deve ser usado com cautela. Os payloads são genéricos e não tentam contornar WAFs. O boolean-based continua sendo a heurística mais frágil das duas técnicas SQL e, por isso, o relatório sempre informa o ruído medido e o limiar utilizado, para que quem lê possa avaliar.
MIT. Use-o de forma ética.