CoWitness

CoWitness è uno strumento progettato per funzionare come server HTTP, HTTPS e DNS. Permette di servire pagine web, registrare richieste HTTP e personalizzare le risposte DNS. Questo README fornisce una panoramica delle funzionalità e le istruzioni su come compilare e utilizzare lo strumento CoWitness.

Funzionalità

• HTTP Server: CoWitness include un server HTTP che ascolta sulla porta 80. Può servire file statici dalla directory di lavoro corrente. Ogni richiesta HTTP viene registrata, includendo l'indirizzo IP del client, la risorsa richiesta e lo user agent.

• HTTPS Server: Oltre al server HTTP, CoWitness fornisce anche un server HTTPS che ascolta sulla porta 443. Analogamente al server HTTP, serve file statici e registra ogni richiesta.

• DNS Server: CoWitness funge da server DNS, ascoltando sulla porta 53. Permette di personalizzare le risposte DNS, inclusi i record NS e A. Le richieste DNS vengono registrate, includendo l'indirizzo IP del client e il dominio richiesto.

• Logging: CoWitness crea file di log per le richieste HTTP e DNS. I log vengono aggiunti ai file esistenti, permettendo di tracciare e analizzare l'attività del server.

• Quiet Mode: CoWitness può funzionare in modalità silenziosa passando l'argomento -q dalla riga di comando. In questa modalità, il banner ASCII art non verrà visualizzato.

Prerequisiti 📝

Prima di utilizzare CoWitness, assicurati di avere i seguenti requisiti:

• Il linguaggio di programmazione Go installato sul tuo sistema, scaricalo QUI — è richiesta la versione go 1.21 se si compila dai sorgenti.
• Accesso a Internet per scaricare le dipendenze Go.
• Un server remoto con un indirizzo IP pubblico.

Compilazione 👨🏼‍🔧

Segui questi passaggi per installare e compilare CoWitness:

1. Clona il repository di CoWitness da GitHub:

git clone https://github.com/your-username/CoWitness.git

2. Entra nella directory di CoWitness:

cd CoWitness

3. Compila l'eseguibile di CoWitness:

make -f Makefile build

Questo comando compila il codice sorgente di CoWitness e crea un file eseguibile per amd64 e arm64.

Installazione 👨🏻‍💻

Per utilizzare CoWitness su un server remoto, segui questi passaggi:

1. Scegli un nome di dominio per il tuo ambiente di test.
2. Configura un server remoto e ottieni un indirizzo IP pubblico per esso.
3. Registra i tuoi name server in modo che puntino all'indirizzo IP pubblico. (Consulta la documentazione del tuo registrar per le istruzioni su come configurare i name server.)
4. Crea glue record per associare l'indirizzo IP al tuo server remoto. Questo passaggio può variare a seconda del tuo provider DNS. Consulta la loro documentazione per le indicazioni su come creare glue record.
5. Assicurati che le porte 80 e 53 siano disponibili sul server remoto. Configura eventuali firewall o impostazioni di rete per consentire connessioni in entrata su queste porte.
6. Trasferisci l'eseguibile di CoWitness sul server remoto utilizzando un metodo sicuro come SCP o SFTP.

Connettiti al server remoto tramite SSH:

ssh username@your-server-ip

Un modo semplice per installare cowitness è ottenere il pacchetto di build automatica da qui che puoi poi scaricare con curl o wget sul tuo sistema, oppure trasferire il file tramite scp dal tuo sistema.

cowitness

Personalizzazione ⚒️

Puoi personalizzare CoWitness in base alle tue esigenze specifiche. Ecco alcune possibili modifiche:

• Cambiare le porte predefinite: Consulta la guida all'uso per i flag da riga di comando per modificare le porte predefinite.

• Modificare i percorsi dei file di log: Puoi cambiare i percorsi per i file di log HTTP e DNS (http.log e dns.log) aggiornando le chiamate a os.OpenFile nel codice sorgente.

Community e Contributi

Accogliamo con favore contributi e feedback dalla community. Se incontri problemi o hai suggerimenti per miglioramenti, apri una issue o invia una pull request sul nostro repository GitHub!

Licenza

CoWitness è rilasciato sotto la MIT License.