Botnet Simulation Framework (BSF)

Summary

The Botnet Simulation Framework tries to make the race between the botnet users and the botnet defenders more even. It offers the playing field for defenders to evaluate new botnet monitoringtechniques and countermeasures. You can create realisitic peer-to-peer network simulations and visualize them to analyse them further. The simulation part is based on OMNeT++ originally based on version 4.5.1 in this documentation the latest version was 5.6.2 which also worked. The visualization part is based on dash. In this documentation you will learn how to install all components of the BSF and get it running.

Requirements

• Operating system: Ubuntu 18.04 bionic amd64 Ubuntu Download
• OMNeT++: OMNeT++ Download
• Packages: pip

Installation Guide

OMNet++ download

First we need to download the generic archive of OMNeT++ from the link above and copy it to the directory you want to install it.

Then navigate to the directory you choose and enter this command in the shell with the version number that you downloaded in my case:

tar xvfz omnetpp-5.6.2-src.tgz

This will create an omnetpp-5.6.2 subdirectory with the OMNeT++ files in it.

Next we need to set the environment variables by editing the .bashrc file in your home dircetory for example with gedit or nano:

gedit ~/.bashrc

Add this line with the version number you downloaded at the end and save it:

export PATH=$HOME/omnetpp-5.6.2/bin:$PATH

After this we will need to restart the terminal to make the changes happen.

OMNet++ required packages

Now we come to the packages we need. If you do not want to use the terminal to install all the packages you can use Synaptic and install the via the graphical interface.

For ther Terminal we first enter:

sudo apt-get update

then come these lines to install the required packages:

sudo apt-get install build-essential gcc g++ bison flex perl
sudo apt-get install python python3 qt5-default libqt5opengl5-dev tcl-dev tk-dev
sudo apt-get install libxml2-dev zlib1g-dev default-jre doxygen graphviz libwebkitgtk-3.0-0 

Next is the installation of the osgearth development package and OpenSceneGraph:

sudo apt-get install openscenegraph-plugin-osgearth libosgearth-dev
sudo apt-get install openmpi-bin libopenmpi-dev

And the you can optional install PCAP:

sudo apt-get install libpcap-dev

dash install

To install dash for the visualization of the botnets we need python-pip installed.

sudo apt install python-pip

When this is done we just have 5 pip commands to enter:

pip install dash==1.2.0
pip install dash-daq==0.1.0
pip install networkx
pip install natsort 
pip install numpy

With this dash is installed and we are ready to get things running.

Get things running

Since BSF only uses the command line we don't need to use the UI of OMNeT++. First we need to generate our makefile with

opp_makemake -f --deep -O out -I

Sometimes the include path doesn't always get set correctly in the created makefile so edit the generated makefile with gedit for example and add the for you corrected line:

INCLUDE_PATH = I/home/username/path_to_omnet/omnetpp-5.6.2/include/

Courses

• Ausgewählte Kapitel der IT-Security (2020)

References

• https://github.com/tklab-tud/BSF
• https://omnetpp.org
• https://releases.ubuntu.com