Informazioni

ZenBuster è uno strumento di enumerazione URL multi-thread e multi-piattaforma scritto in Python da Zach Griffin (@0xTas).

Ho scritto questo strumento per approfondire la mia familiarità con Python e per aumentare la mia comprensione degli strumenti di cybersecurity in generale. ZenBuster potrebbe non essere il tool più veloce o completo del suo genere. È comunque semplice da usare, discretamente flessibile e in pratica solo marginalmente più lento di altri strumenti "collaudati" come Gobuster. Personalmente, lo sto usando per risolvere sfide CTF su piattaforme come TryHackMe e ho trovato la mia implementazione soddisfacentemente affidabile.

Questo software è destinato all'uso in sfide CTF o da parte di professionisti della sicurezza per raccogliere informazioni sui loro target:

• È in grado di enumerare tramite brute-force sia i sottodomini che le risorse URI (directory/file).
• Entrambi i metodi di enumerazione richiedono l'uso di un wordlist o dizionario appropriato.
• Funzionalità incluse:
  1. Il formato del nome host supporta standard, IPv4 e IPv6.
  2. Supporto per la registrazione dei risultati su file con -o [nomefile].
  3. Specifica di porte personalizzate per webserver non standard con -p .
  4. Estensioni di file opzionali in modalità directory con -x .
  5. Modalità silenziosa per un output meno distraente con -q.
  6. Il colore può essere disabilitato per un output meno distraente con -nc / -nl.
  7. Aggiungi alla lista dei codici di stato HTTP da ignorare (default 5xx, 404) con -ic.
  8. Ignora specifiche lunghezze di contenuto della risposta con -fl.
  9. Testato su Python versioni 3.10 e 3.11, con supporto teorico per versioni >= 3.6

ATTENZIONE/DICHIARAZIONE DI NON RESPONSABILITÀ

ZenBuster è in grado di produrre un numero potenzialmente indesiderato di richieste HTTP in breve tempo.

Gli sviluppatori e i contributori non sono responsabili per eventuali danni causati dall'uso improprio o dall'abuso di questo software.

Si prega di enumerare in modo responsabile!

Licenza

ZenBuster è concesso in licenza sotto la GNU GPLv3, vedi qui per maggiori informazioni.

Crediti

L'arte ASCII Yin-Yang nei banner è stata creata da Joan G. Stark (jgs) e Hayley Jane Wakenshaw (hjw). Le modifiche sono state apportate da me, quando specificato con: 'zg'.

---

Presentazione

Pagina di aiuto:

Modalità di enumerazione delle directory:

Modalità di enumerazione dei sottodomini:

---

Installazione

Innanzitutto, assicurati di avere installato Python versione >= 3.6, poi clona il repository con:

git clone https://github.com/0xTas/zenbuster.git

Successivamente, cd zenbuster e, se su Linux: chmod +x zenbuster.py.

Dipendenze

ZenBuster si basa su 3 librerie esterne per funzionare ed è consigliato installarle con:

pip install -r requirements.txt

I moduli che verranno installati e i loro scopi sono i seguenti:

1. Python requests

   • La spina dorsale di ogni richiesta di enumerazione. Senza di essa, lo script non funzionerà.

2. termcolor

   • Abilita l'output colorato nel terminale. Non critico: lo script può comunque funzionare senza colore se non presente.

3. colorama (solo Windows)

   • Prepara il terminale Windows ad accettare codici colore ANSI (da Termcolor). Non critico.

Queste dipendenze possono essere installate manualmente, con pip usando requirements.txt, o tramite interazione con lo script al primo avvio.

---

Utilizzo

Una volta installate le dipendenze, puoi eseguire il programma nei seguenti modi:

Su Linux (+Mac?):

./zenbuster.py [opzioni] oppure python3 zenbuster.py [opzioni]

Su Windows:

python zenbuster.py [opzioni]

[Opzioni]

Esempi di utilizzo

./zenbuster.py -d -w /usr/share/wordlists/dirb/common.txt -u target.thm -v

python3 zenbuster.py -w ../subdomains.txt --host target.thm --ssl -O myResults.log

zenbuster -w subdomains.txt -u target.thm --quiet -ic 400, 403 (Con alias .bashrc)

---

Aggiornamento

Aggiornare ZenBuster è facile! Basta spostarsi nella cartella di installazione (cd zenbuster) e fare git pull. Questo è tutto!

---

Funzionalità/Miglioramenti Pianificati

• Aumentare i livelli opzionali di verbosità.
• Consentire la limitazione opzionale del numero di thread delle attività.
• Consentire agli utenti di modificare l'elenco dei codici di stato ignorati. FATTO.
• Consentire un maggiore controllo dell'utente su varie intestazioni delle richieste.
• Consentire l'ignoramento opzionale delle risposte in base alla lunghezza del contenuto. FATTO.
• Espandere l'enumerazione dei sottodomini per includere metodi OSINT invece del solo brute-force.
• Esplorare una soluzione più completa e leggibile per l'output colorato (possibilmente usando rich).

---

Problemi Noti/Limitazioni

• L'enumerazione di endpoint lunghi può produrre un output antiestetico a causa dell'avvolgimento delle righe su finestre di console più piccole. Si consiglia di registrare i risultati su file, specialmente su Windows.
• Se l'host target è un vHost su un webserver condiviso, l'enumerazione tramite IP potrebbe non funzionare come previsto. Usa dominio/nome host invece.
• Ignorare i codici di stato di reindirizzamento (3xx) con -ic non funziona se anche il codice di stato alla fine del percorso del reindirizzamento non viene ignorato.

---

Versione

ZenBuster è attualmente alla versione 1.3