Skip to content

Latest commit

 

History

History
108 lines (78 loc) · 3.46 KB

README.md

File metadata and controls

108 lines (78 loc) · 3.46 KB
Raw

MininetIDS

MininetIDS is a consolidated environment for training, testing, and deploying Machine Learning-based Intrusion Detection Systems (ML-IDS) in Software-Defined Networks (SDN). It leverages Mininet for network emulation and the Ryu controller for SDN management, providing a comprehensive platform for researchers and network security professionals to develop and evaluate advanced IDS solutions in SDN environments.

Features

  • Dataset management (import, select, analyze, preprocess)
  • Machine learning model training (Logistic Regression, KNN, Naive Bayes, Decision Tree, Random Forest)
  • Network topology management
  • Integration with Ryu controller for IDS functionality
  • Feature selection and data preprocessing tools

Included Datasets

MininetIDS comes with two pre-included datasets for testing and evaluation:

  1. MininetFlows

    • Generated using Mininet
    • Contains DoS attacks:
      • ICMP flood
      • TCP SYN flood
      • UDP flood
      • LAND attack
    • Includes normal traffic:
      • HTTP
      • TCP
      • UDP
      • ICMP

  2. NSL-KDD

    • Widely used benchmark dataset for network intrusion detection research
    • Improved version of the original KDD Cup 1999 dataset
    • Contains various types of network attacks and normal traffic

These datasets provide a starting point for testing and evaluating IDS models within the MininetIDS environment. The MininetFlows dataset offers simulated traffic that closely matches the Mininet environment, while NSL-KDD provides a standard benchmark for comparison with other IDS research.

Installation

  1. Update your system: 
    sudo apt-get update
  2. Install Git: 
    sudo apt-get install git
  3. Clone the repository: 
    git clone https://github.com/ranauzairahmed/MininetIDS.git
  4. Navigate to the project directory: 
    cd MininetIDS
  5. If you already have Mininet and Ryu working properly: 
    pip install -r requirements.txt
  6. Otherwise, make the installation script executable: 
    chmod +x install.sh
  7. Run the installation script: 
    ./install.sh

Usage

To start the MininetIDS interface, run:

python3 MininetIDS.py

This will launch the command-line interface where you can use various commands to manage datasets, train models, and control the IDS.

For a full list of commands, use the help command in the MininetIDS interface.

Example Demonstration

NSL-KDD with MininetIDS

License

MIT License

Associated with Capital University of Science & Technology

Faculty of Computing
BSCS - Final Year Project

Supervisor:

Dr. Muhammad Siraj Rathore
muhammad.siraj@cust.edu.pk
Faculty Profile
Google Scholar
ResearchGate

Group:

Rana Uzair Ahmed
ranauzairahmed.official@gmail.com
LinkedIn

Raja Tayyab Nawaz
tayyabnawaz177@gmail.com
LinkedIn

Reference

SDN Network DDoS Detection Using Machine Learning