Info : Ce guide est destiné aux utilisateurs sans besoins particuliers, qui souhaitent une expérience simple et prête à l’emploi.

Chaque version se présente dans un dossier nommé riotpot contenant un binaire exécutable (également) nommé riotpot et un dossier plugins rempli de multiples services (ou honeypots à faible interaction). Il est important de conserver la structure interne des dossiers pour que RIoTPot fonctionne correctement.

📁 riotpot
    ┕ riotpot
    ┕ 📁 plugins

1. Téléchargez d’abord la version de votre choix depuis la page des versions. Choisissez celle correspondant à votre système d’exploitation (OS).
2. Extrayez le dossier riotpot.
3. Exécutez le binaire riotpot. Cela démarrera RIoTPot avec l’API activée, tous les plugins prêts à l’emploi et le serveur UI.
   • L’API et l’interface utilisateur sont accessibles via l’adresse localhost:2022

Info : Ce guide est destiné aux utilisateurs avancés à l’aise dans les environnements de développement.

Prérequis

• Golang - Requis pour construire le projet
• Node - Requis pour construire l’interface utilisateur

Optionnel :

• Git - Utilisé pour télécharger le code source
• Make - Pour exécuter des commandes préconfigurées

1. Téléchargez le code source de RIoTPot depuis GitHub. Ouvrez une console et saisissez la ligne suivante.

   root@kitploit:~

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

2. Naviguez vers le dossier où vous avez téléchargé le source de RIoTPot et installez les paquets node requis.

   root@kitploit:~

   npm install
   

3. Si vous avez installé Make, nous avons inclus plusieurs aides de commande pour vous assister dans la construction du projet. Pour faire simple, vous pouvez exécuter deux commandes simples qui construiront le binaire RIoTPot et les plugins (et les placeront dans le bon dossier).

   root@kitploit:~

   # Construire le serveur
   make build-ui
   # Construit RIoTPot et les plugins
   make riotpot-build
   

NOTE : L’interface utilisateur utilise Vite pour construire le projet. Si vous préférez utiliser un autre constructeur, vous devrez peut-être apporter quelques modifications par vous-même.

Info : Ce guide est destiné aux utilisateurs avancés qui préfèrent utiliser RIoTPot dans un environnement virtuel.

Prérequis

• Docker - Utilisé pour construire une image d’une instance RIoTPot et du serveur UI.
• Docker-compose - Utilisé pour créer un seul conteneur avec une instance RIoTPot, l’interface utilisateur et d’autres applications et services.

Les principaux avantages de cette configuration sont les fonctionnalités de sécurité supplémentaires avec des modifications minimales de la configuration du conteneur et des conteneurs eux-mêmes. Par exemple, nous pouvons définir des réseaux privés virtuels séparés et des réseaux superposés pour cacher, cloisonner et encapsuler RIoTPot et d’autres services adjacents. De plus, les conteneurs permettent de lier des services en utilisant leur nom d’adresse Docker plutôt que leur IP, ce qui est très pratique. Enfin, nous pouvons démarrer et arrêter des conteneurs séparés à la demande sans affecter les autres services.

D’un autre côté, la virtualisation est sans doute plus exigeante que l’utilisation d’applications sur du métal nu. Bien qu’une seule instance de RIoTPot soit relativement légère, il est important de prendre en compte les inconvénients introduits par la virtualisation et l’émulation matérielle (par exemple, les délais de réponse).

Attention : Techniquement, un attaquant déterminé pourrait réaliser que RIoTPot est en fait un honeypot en analysant et en comparant les délais de réponse introduits par la virtualisation par rapport à de vrais serveurs (!!). Bien que ce type d’empreinte de honeypot ait été étudié auparavant, les résultats pour les services Internet courants restent non concluants (par exemple, HTTP, Telnet et SSH), en raison de la généralisation des services d’hébergement cloud utilisant des machines virtuelles et des configurations de serveur détaillées.

Le fichier docker-compose inclut des services supplémentaires pour améliorer l’expérience RIoTPot. Le tableau suivant résume la liste des services et applications regroupés dans ce conteneur.

Services

Service	Image	Port	Détails
MQTT	eclipse-mosquitto	1883	Serveur MQTT Mosquito
HTTP	httpd	80	Serveur HTTP classique
Modbus	oitc/modbus-server	502	Serveur Modbus
OCPP	ocpp1.6-central-system	443	OCPP v1.6 (utilisé dans les bornes de recharge de voitures)

Applications

Application	Image	Détails
TCPDump	kaazing/tcpdump	Enregistreur de paquets. Stocke le trafic réseau dans des fichiers .pcap

Le conteneur peut être configuré en trois étapes simples :

1. Téléchargez le code source de RIoTPot depuis GitHub. Ouvrez une console et saisissez la ligne suivante.

   root@kitploit:~

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

2. Naviguez vers le dossier où vous avez téléchargé le source de RIoTPot.

3. Avec Docker en cours d’exécution : si vous avez Make installé, exécutez la commande suivante. Sinon, exécutez une commande docker-compose en utilisant le fichier docker-compose inclus dans le dossier build/docker.

   • Avec make
   root@kitploit:~

   # Avec make
   make up
   

   • Avec Docker-compose
   root@kitploit:~

   # Avec docker-compose
   docker-compose -p riotpot -f build/docker/docker-compose.yaml up -d --build