CollaboratorPlusPlus

CollaboratorPlusPlus

Rilasciato come open source da NCC Group Plc - http://www.nccgroup.com/

Sviluppato da Corey Arthur, [email protected]

http://www.github.com/nccgroup/CollaboratorPlusPlus

Questo progetto è rilasciato sotto AGPL, vedere LICENSE per maggiori informazioni

Scarica le release qui.

Contesto

Questo strumento mira a estendere le funzionalità Collaborator esistenti fornite da Burp Suite, offrendo una serie di funzioni che migliorano la qualità della vita (quality of life) e l'implementazione di un meccanismo di autenticazione per proteggere le installazioni private di Collaborator, pur rimanendo compatibile con tutte le estensioni esistenti che generano e interrogano i contesti Collaborator.

CollaboratorPlusPlus agisce come proxy tra Burp e il server Collaborator configurato, consentendo la cattura dei contesti Collaborator utilizzati dal client. CollaboratorPlusPlus può quindi memorizzare e visualizzare i contesti osservati e le relative interazioni recuperate in un'interfaccia centrale. Inoltre, i vecchi contesti possono essere interrogati manualmente, consentendo di recuperare le interazioni anche dopo la chiusura della finestra del client Collaborator.

Meccanismo di autenticazione

Oltre all'estensione Burp, il progetto Collaborator++ include anche un componente di autenticazione lato server opzionale per autenticare le richieste di polling in arrivo prima di inoltrarle al server Collaborator. Può essere implementato dai proprietari di server Burp Collaborator privati per limitare il polling solo a coloro che conoscono il segreto condiviso.

Quando Burp richiede l'elenco delle interazioni ricevute dal server Collaborator, l'estensione crittografa le richieste di polling con lo schema di crittografia AES256-CBC, utilizzando il segreto condiviso per generare la chiave di crittografia. Se il segreto condiviso è corretto, il server di autenticazione è in grado di decrittare la richiesta e inoltrarla al server Collaborator per recuperare le interazioni per la data istanza di Collaborator. La risposta viene quindi crittografata con il segreto condiviso prima di essere inviata al client Burp.

Utilizzando il segreto condiviso per crittografare la trasmissione tra il client Burp e il server di autenticazione, il segreto condiviso non deve essere trasmesso insieme alla richiesta, consentendo di mantenere la riservatezza anche nei casi in cui sia necessario utilizzare la comunicazione HTTP tra client e server.

Collaborator++ - Client

Esecuzione del client

1. Aggiungi l'estensione a Burp
   • Nota: è lo stesso JAR del server.
2. Specifica l'indirizzo e la porta su cui il server Collaborator è in ascolto nella configurazione dell'estensione.
3. Opzionale: se stai utilizzando un server Collaborator Auth, specifica il segreto condiviso e abilita l'autenticazione nella configurazione dell'estensione.
4. Avvia il server locale; questo configurerà automaticamente anche le impostazioni di Collaborator all'interno di Burp.
5. Opzionale: esegui il controllo di integrità di Collaborator in Burp per assicurarti che tutto funzioni.

Impostazioni aggiuntive

Alcune impostazioni aggiuntive sono state aggiunte a Collaborator Auth per comodità.

Usa SSL: Attiva/disattiva l'uso di SSL tra client e server. Assicurati che anche il server sia configurato per utilizzare SSL sulla porta di destinazione.

Ignora errori di certificato: Disabilita i controlli di validità dei certificati. Consente l'uso di certificati autofirmati / scaduti.

Abilita verifica hostname SSL: Non controllare che l'hostname del certificato corrisponda al dominio di destinazione.

Blocca server Collaborator pubblico: Impedisce l'uso accidentale del server Burp Collaborator pubblico. Aggiunge una voce DNS per "burpcollaborator.net" a 127.0.0.1 nella configurazione di risoluzione hostname di Burp.

Collaborator Auth - Server

Esecuzione del server

1. Esegui java -jar CollaboratorPlusPlus.jar per generare la configurazione predefinita.
   • Nota: è lo stesso JAR del client.
2. Modifica il file generato per puntare alla tua istanza privata di Collaborator e scegli un segreto appropriato.
3. Esegui di nuovo il server e specifica la configurazione da utilizzare java -jar CollaboratorPlusPlus.jar YOURCONFIGFILE.properties

Nota: Per consentire richieste HTTP e HTTPS al server Collaborator++ Auth, crea due copie del file di configurazione, configurandone una per HTTP e una per HTTPS, ed esegui due istanze del server Collaborator++ Auth.

Configurazione SSL

Per abilitare l'uso di SSL, genera un certificato per il server e utilizza uno dei metodi seguenti per configurarlo.

Per entrambi i metodi, assicurati che enable_ssl sia true nel file di configurazione.

Consigliato: Configurazione semplice

1. Genera una nuova chiave privata e un certificato da usare per il server utilizzando il comando seguente, oppure usane uno esistente.
   • openssl req -newkey rsa:2048 -nodes -keyout privatekey.pem -x509 -days 365 -out certificate.pem
2. Opzionale: fai firmare il certificato da una CA attendibile.
3. Modifica il file di configurazione:
   • Imposta ssl_private_key_path sul percorso della tua chiave privata.
   • Imposta ssl_certificate_path sul percorso del tuo certificato.
   • Se la tua catena di certificati richiede un certificato intermedio:
     • Imposta ssl_intermediate_certificate_path sul percorso del tuo certificato intermedio.

Alternativa: Java Keystore

Questo metodo è stato aggiunto esclusivamente per motivi di compatibilità. Consiglio vivamente di utilizzare la configurazione semplice a meno che non ci sia un motivo per fare diversamente.

1. Modifica il file di configurazione e imposta la serializedValue per ssl_private_key_path su una stringa vuota "".
   • Questo abiliterà l'uso del keystore per la configurazione.
2. Genera una nuova chiave privata e un certificato da usare per il server utilizzando il comando seguente.
   • openssl req -newkey rsa:2048 -nodes -keyout privatekey.pem -x509 -days 365 -out certificate.pem
3. Converti la chiave e il certificato in PKCS12.
   • openssl pkcs12 -export -in certificate.pem -inkey privatekey.pem -out polling.p12 -name polling
4. Inserisci una password da utilizzare per la crittografia del file PKCS12. Questa verrà usata nel passaggio successivo!
5. Importa il file PKCS12 in un nuovo Java Keystore.
   • keytool -importkeystore -deststorepass NEW_PASSWORD_FOR_KEYSTORE -destkeypass NEW_PASSWORD_FOR_PRIVATE_KEY \
-destkeystore polling.jks -srckeystore polling.p12 -srcstoretype PKCS12 \
-srcstorepass PASS_FROM_PREVIOUS_STEP -alias polling
6. Modifica il file di configurazione per abilitare SSL, puntare il server al keystore e specificare le password utilizzate.
7. Esegui di nuovo il server e specifica la configurazione da utilizzare

Consigliato: Proteggi il vero server Collaborator

Per impedire il polling del server Collaborator senza l'uso di Collaborator Auth, l'endpoint di polling di Burp Collaborator deve essere limitato.

Questo può essere fatto usando il firewall o modificando l'interfaccia di ascolto per gli eventi di polling.

Opzione 1 - Richiedi sempre l'uso di Collaborator Auth.

Se desideri obbligare gli utenti della tua istanza Burp Collaborator ad autenticarsi indipendentemente dalla loro rete, Burp Collaborator può essere configurato per ascoltare gli eventi di polling solo sulla macchina locale (cioè da Collaborator Auth).

Questo può essere fatto cambiando l'indirizzo di ascolto di Burp Collaborator per gli eventi di polling sull'interfaccia di loopback (127.0.0.1) o usando qualcosa come iptables per scartare le richieste in arrivo.

Opzione 2 - Richiedi l'uso di Collaborator Auth solo su reti esterne.

Per consentire a Burp Collaborator di essere usato normalmente quando ci si trova nella stessa rete del server, ma richiedere l'uso di Collaborator Auth quando si è su una rete esterna, Burp Collaborator può essere configurato per ascoltare gli eventi di polling dagli indirizzi interni.

Questo può essere fatto cambiando l'indirizzo di ascolto di Burp Collaborator per gli eventi di polling sull'indirizzo interno del server (192.168.x.x, 10.x.x.x, ecc.).

Per garantire che gli eventi di polling esterni non vengano elaborati da Burp Collaborator, la porta di polling dovrebbe essere bloccata sul firewall rivolto verso Internet. In alternativa, usa iptables per scartare il traffico in arrivo da reti esterne.