Info: Questa guida è pensata per utenti senza esigenze particolari, che desiderano un'esperienza semplice e pronta all'uso.

Ogni release si presenta in una cartella denominata riotpot con un binario eseguibile (anch'esso) chiamato riotpot e una cartella plugins piena di vari servizi (o honeypot a bassa interazione). È importante mantenere la struttura interna delle cartelle affinché RIoTPot funzioni correttamente.

📁 riotpot
    ┕ riotpot
    ┕ 📁 plugins

1. Per prima cosa, scarica la release che preferisci dalla pagina delle release. Scegli quella adatta al tuo sistema operativo (OS).
2. Estrai la cartella riotpot.
3. Esegui il binario riotpot. Questo avvierà RIoTPot con l'API abilitata, tutti i plugin pronti all'uso e il server UI.
   • L'API e l'UI sono accessibili tramite l'indirizzo localhost:2022

Info: Questa guida è pensata per utenti avanzati che si trovano a proprio agio in ambienti di sviluppo.

Requisiti

• Golang - Necessario per compilare il progetto
• Node - Necessario per compilare l'UI

Opzionali:

• Git - Utilizzato per scaricare il codice sorgente
• Make - Per eseguire comandi già pronti

1. Scarica il codice sorgente di RIoTPot da GitHub. Apri una console e digita la seguente riga.

   root@kitploit:~

   git clone [email protected]:aau-network-security/riotpot.git
   

2. Naviga nella cartella in cui hai scaricato il codice sorgente di RIoTPot e installa i pacchetti node richiesti.

   root@kitploit:~

   npm install
   

3. Se hai installato Make, abbiamo incluso diversi helper di comando per assisterti nella compilazione del progetto. Per semplificare, puoi eseguire due semplici comandi che compileranno il binario di RIoTPot e i plugin (e li posizioneranno nella cartella corretta).

   root@kitploit:~

   # Compila il server
   make build-ui
   # Compila RIoTPot e i plugin
   make riotpot-build
   

NOTA: L'UI utilizza Vite per compilare il progetto. Se preferisci usare un altro compilatore, potresti dover apportare alcune modifiche da solo.

Info: Questa guida è pensata per utenti avanzati che preferiscono utilizzare RIoTPot in un ambiente virtuale.

Requisiti

• Docker - Utilizzato per creare un'immagine di un'istanza di RIoTPot e del server UI.
• Docker-compose - Utilizzato per creare un singolo container con un'istanza di RIoTPot, l'UI e altre applicazioni e servizi.

I principali vantaggi di utilizzare questa configurazione sono le funzionalità di sicurezza aggiuntive con modifiche minime alla configurazione del container e ai container stessi. Ad esempio, possiamo definire reti private virtuali separate e reti overlay per nascondere, isolare e incapsulare RIoTPot e altri servizi adiacenti. Inoltre, i container ci consentono di associare i servizi utilizzando il nome dell'indirizzo docker anziché il loro IP, il che è molto comodo. Infine, possiamo generare e arrestare container separati su richiesta senza influenzare altri servizi.

D'altra parte, la virtualizzazione è presumibilmente più impegnativa rispetto all'utilizzo di applicazioni su hardware reale. Sebbene una singola istanza di RIoTPot sia relativamente leggera, è importante considerare gli svantaggi introdotti dalla virtualizzazione e dall'emulazione hardware (ad esempio, ritardi di risposta).

Attenzione: Tecnicamente parlando, un aggressore dedicato potrebbe rendersi conto che RIoTPot è in realtà un honeypot analizzando e confrontando i ritardi di risposta introdotti dalla virtualizzazione rispetto ai server reali (!!). Sebbene questo tipo di fingerprinting degli honeypot sia stato studiato in precedenza, i risultati per i servizi Internet comuni sono ancora inconcludenti (ad esempio, HTTP, Telnet e SSH), a causa della mercificazione dei servizi di hosting cloud che utilizzano macchine virtuali e configurazioni dettagliate dei server.

Il file docker-compose include servizi aggiuntivi per migliorare l'esperienza di RIoTPot. La tabella seguente riassume l'elenco dei servizi e delle applicazioni inclusi in questo container.

Servizi