🔍 Knockpy Subdomain Scan v9.0

✅ Veloce & Async • 🔐 Recon + Brute • 🔧 Facile da Estendere

KnockPy è un tool modulare Python 3 per enumerare sottodomini tramite ricognizione passiva e forza bruta, ora con supporto async/await, prestazioni migliorate e gestione moderna di HTTP/TLS.

🚀 Funzionalità (v9)

• ✅ Scansione asincrona con httpx e risoluzione DNS
• ✅ Modulare: aggiungi facilmente nuove sorgenti passive
• 🔍 Supporta ricognizione passiva, forza bruta o entrambi
• 🎨 Output terminale formattato con Rich (tabelle, progressi, pannelli)
• 📜 Valida stato HTTP/HTTPS, certificato TLS e IP
• ⚠️ Rileva supporto TLS obsoleto (TLS 1.0/1.1) come avviso in CLI/verboso/rapporto HTML
• 🧾 Controlla AXFR (zone transfer) sul dominio radice durante scansioni in modalità dominio
• 🔎 Diagnostica --verbose per singolo dominio (DNS/TCP/TLS/catene di reindirizzamento/errori di richiesta + controlli di sicurezza)
• 💡 Supporta rilevamento DNS wildcard
• 🧪 Rapporti SQLite con catalogo interattivo (show/delete/export/search)
• 🔐 Supporta API VirusTotal e Shodan
• 🚀 Runtime ottimizzato per forza bruta con caching dell'endpoint TLS-probe (nessuna modifica ai timeout richiesta)

📦 Installazione

Dal sorgente GitHub (consigliato)

git clone https://github.com/guelfoweb/knockpy.git
cd knockpy
# consigliato: installare in un ambiente virtuale
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -U pip
pip install .

# alternativa: installare per l'utente corrente (senza venv)
# python3 -m pip install --user .

⚠️ Versione Python consigliata: 3.9+

🧱 Struttura del progetto

Il codice è organizzato per responsabilità, con facciate stabili per compatibilità all'indietro:

knockpy/
  cli.py                   # Punto di ingresso CLI (facciata/orchestrazione)
  cli_parts/
    status.py              # Rendering del pannello runtime/stato
    setup.py               # Configurazione interattiva e impostazioni runtime persistenti
    report.py              # Modalità report interattiva
    scan_flow.py           # Regole di esclusione, test di ricognizione, helper wildcard
  core.py                  # Facciata pubblica del core (compatibilità)
  engine/
    runtime.py             # Implementazione del motore di scansione
  storage.py               # Facciata pubblica dello storage (compatibilità)
  storage_parts/
    db.py                  # Persistenza/impostazioni SQLite
    export.py              # Orchestrazione esportazione rapporti
    html_report.py         # Rendering rapporto HTML
  output.py                # Rendering output terminale
  server_versions.py       # Catalogo versioni web-server
  knockpy.py               # Esportazioni modulo compatibilità

Nota sulla compatibilità:

• Import esterni preferiti: import knockpy o from knockpy import KNOCKPY.
• I moduli interni sono suddivisi in engine/, cli_parts/ e storage_parts/.

Usando pip

Solo dopo il rilascio della versione stabile su GitHub

pip install knock-subdomains

🧪 Utilizzo

knockpy -d dominio.com [opzioni]

Opzioni

Ottimizzazione delle prestazioni: --threads e --timeout

Queste due opzioni hanno il maggiore impatto sul runtime per scansioni grandi.

• --threads controlla la concorrenza (quanti target vengono elaborati in parallelo)
• --timeout controlla per quanto tempo ogni fase di rete attende prima di arrendersi

Compromesso:

• più threads = scansioni più veloci, ma maggiore carico su CPU/rete/DNS e maggior rischio di limiti di frequenza remoti
• meno timeout = scansioni più veloci, ma maggior rischio di perdere target validi ma lenti (falsi negativi)

Profili consigliati:

• scansione piccola/accurata (pochi domini): --threads 50 --timeout 5
• scansione bilanciata: --threads 150 --timeout 4
• scansione grande (10k+ domini): inizia con --threads 250 --timeout 3

Se hai bisogno sia di velocità che di completezza su elenchi molto grandi, usa una strategia a 2 passate:

1. passata veloce: --threads 250 --timeout 3
2. passata di ripetizione solo sui target mancanti/incerti: --threads 80 --timeout 5 (o superiore)

Note:

• I valori CLI sovrascrivono sempre i valori salvati nella configurazione
• I valori salvati nella configurazione (--setup) sovrascrivono le impostazioni predefinite integrate
• Le impostazioni predefinite integrate attuali sono threads=250, timeout=3

📌 Esempi

🔎 Recon + Brute

knockpy -d example.com --recon --bruteforce

🧪 Test servizi di ricognizione

knockpy -d example.com --recon --test

🔄 Aggiorna catalogo ultime versioni web-server

knockpy --update-versions

🆕 Verifica aggiornamenti Knockpy

knockpy --check-update

⚙️ Configurazione sorgenti di ricognizione (modificabile)

Al primo avvio, KnockPy crea:

~/.knockpy/recon_services.json

Puoi aggiungere/disabilitare sorgenti modificando l'array services. Puoi anche puntare a un percorso file personalizzato senza modificare il codice:

export KNOCK_RECON_SERVICES=/percorso/del/tuo/recon_services.json

Ogni servizio supporta:

• name
• enabled (true/false)
• parser
• url_template (supporta {domain}, {virustotal_key}, {shodan_key})
• requires_api (virustotal o shodan, opzionale)

Parser supportati:

• csv_first_column
• rapiddns_html_td
• json_list
• virustotal_subdomains
• shodan_subdomains

📥 Dominio da stdin

echo "example.com" | knockpy -d

🧠 Chiavi API (opzionali)

export API_KEY_VIRUSTOTAL=la-tua-chiave-api-virustotal
export API_KEY_SHODAN=la-tua-chiave-api-shodan

Puoi usare file .env:

API_KEY_VIRUSTOTAL=la-tua-chiave-api-virustotal
API_KEY_SHODAN=la-tua-chiave-api-shodan

💾 Rapporti (SQLite + Esportazione HTML interattiva)

knockpy -d example.com --recon --bruteforce
knockpy --report list
knockpy --report latest
knockpy --report

Menu rapporto interattivo:

• 1 show
• 2 delete
• 3 export
• 4 search
• 0 reset db (chiede conferma esplicita)

Esci dalla modalità rapporto:

• premi Invio su prompt azione vuoto
• oppure premi CTRL+C

🔍 Diagnostica dominio singolo

knockpy -d forum.example.com --verbose

🧪 Solo test wildcard

knockpy -d example.com --wildcard

🧬 Utilizzo API Python

KnockPy può essere usato come modulo Python:

import knockpy

result = knockpy.KNOCKPY("example.com", timeout=5.0, threads=20)
print(result["domain"], result["ip"])

oppure:

from knockpy import KNOCKPY

domain = 'example.com'

results = KNOCKPY(
    domain,
    dns="8.8.8.8",
    useragent="Mozilla/5.0",
    timeout=5,
    threads=10,
    recon=True,
    bruteforce=True,
    wordlist=None,
    silent=False
)

for entry in results:
    print(entry['domain'], entry['ip'], entry['http'], entry['cert'])

📂 Wordlist

Una wordlist predefinita è inclusa in knockpy/wordlist/wordlist.txt. Puoi fornirne una tua con --wordlist.

Test

python3 -m pytest

# (opzionale) script di esempio per test rapido
python3 examples/poc.py

📖 Licenza

Concesso in licenza sotto la licenza GPLv3.

Gianni Amato (@guelfoweb)