Info: Esta guía está destinada a usuarios sin necesidades especiales, que desean una experiencia simple lista para usar.

Cada lanzamiento viene en una carpeta llamada riotpot con un binario ejecutable (también) llamado riotpot y una carpeta plugins llena de múltiples servicios (o honeypots de baja interacción). Es importante mantener la estructura de carpetas interna para que RIoTPot funcione correctamente.

📁 riotpot
    ┕ riotpot
    ┕ 📁 plugins

1. Primero, descargue la versión de su elección desde la página de lanzamientos. Elija la que necesite para su sistema operativo (SO).
2. Extraiga la carpeta riotpot.
3. Ejecute el binario riotpot. Esto iniciará RIoTPot con la API habilitada, todos los plugins listos para usar y el servidor UI.
   • La API y la UI son accesibles a través de la dirección localhost:2022

Info: Esta guía está destinada a usuarios avanzados cómodos en entornos de desarrollo.

Requisitos

• Golang - Necesario para construir el proyecto
• Node - Necesario para construir la UI

Opcional:

• Git - Se usa para descargar el código fuente
• Make - Para ejecutar comandos ya preparados

1. Descargue el código fuente de RIoTPot desde GitHub. Abra una consola e introduzca la siguiente línea.

   root@kitploit:~

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

2. Navegue a la carpeta donde descargó el código fuente de RIoTPot e instale los paquetes de node requeridos.

   root@kitploit:~

   npm install
   

3. Si tiene instalado Make, hemos incluido varios ayudantes de comandos para asistirle en la construcción del proyecto. Para simplificar, puede ejecutar dos comandos simples que construirán el binario de RIoTPot y los plugins (y los colocarán en la carpeta correcta).

   root@kitploit:~

   # Construir el servidor
   make build-ui
   # Construir RIoTPot y los plugins
   make riotpot-build
   

NOTA: La UI utiliza Vite para construir el proyecto. Si prefiere usar otro constructor, es posible que necesite hacer algunos cambios primero por su cuenta.

Info: Esta guía está destinada a usuarios avanzados que prefieren usar RIoTPot en un entorno virtual.

Requisitos

• Docker - Se usa para construir una imagen de una instancia de RIoTPot y el servidor UI.
• Docker-compose - Se usa para crear un solo contenedor con una instancia de RIoTPot, la UI y otras aplicaciones y servicios.

Las principales ventajas de usar esta configuración son las características de seguridad adicionales con cambios mínimos en la configuración del contenedor y los contenedores en sí. Por ejemplo, podemos definir redes privadas virtuales separadas y redes superpuestas para ocultar, aislar y encapsular RIoTPot y otros servicios adyacentes. Además, los contenedores nos permiten vincular servicios usando su nombre de dirección de Docker en lugar de su IP, lo cual es muy conveniente. Por último, podemos iniciar y detener contenedores separados bajo demanda sin afectar otros servicios.

Por otro lado, la virtualización es posiblemente más exigente que usar aplicaciones en hardware real. Si bien una sola instancia de RIoTPot es relativamente liviana, es importante considerar las desventajas introducidas por la virtualización y la emulación de hardware (por ejemplo, retrasos en las respuestas).

Advertencia: Técnicamente hablando, un atacante dedicado puede darse cuenta de que RIoTPot es en realidad un honeypot analizando y comparando los retrasos de tiempo de respuesta introducidos por la virtualización con servidores reales (!!). Aunque este tipo de huella digital de honeypot se ha estudiado antes, los resultados para servicios comunes de Internet aún no son concluyentes (por ejemplo, HTTP, Telnet y SSH), debido a la mercantilización de los servicios de alojamiento en la nube que utilizan máquinas virtuales y configuraciones detalladas de servidores.

El archivo docker-compose incluye servicios adicionales para mejorar la experiencia de RIoTPot. La siguiente tabla resume la lista de servicios y aplicaciones incluidos en este contenedor.

Servicios