https://github.com/mohab-sameh/kdd99-feature-extractor-prebuilt

https://github.com/mohab-sameh/kdd99-feature-extractor-prebuilt

Last synced: 14 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/mohab-sameh/kdd99-feature-extractor-prebuilt
• Owner: mohab-sameh
• License: mit
• Created: 2021-05-24T14:51:10.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-06-17T22:22:32.000Z (over 3 years ago)
• Last Synced: 2024-10-03T12:27:32.581Z (about 1 month ago)
• Language: C++
• Size: 2.39 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# kdd99_feature_extractor

Utility for extraction of subset of KDD '99 features [1] from realtime network traffic or .pcap file

Some feature might not be calculated exactly same way as in KDD, because there was no documentation explaining the details of KDD implementation found. Algorithms are based on some articles [2][3] and observation of values in KDD dataset. 

Features in KDD should be the same as features introduced by Lee & Stolfo in their work [2].

## Status

* Current version is not 100% guarenteed to be perfect in sense that some features might be calculated bit different algorighms than KDD '99 dataset a Lee & Stolfo used. Hovewer, it is suitable for educational purposes.

* Compiled & tested in following environments:

  * Windows 7 x64, MSCV 2015 (14), WinPcap 4.1.3

  * Windows 7 x64, MSCV 2013 (12), WinPcap 4.1.3

  * Ubuntu 12.04 x64, gcc 4.6.3, libpcap 4.2

## Features

* Subset of KDD '99 features [1]

  * Content features (columns 10-22 of KDD) are not included

* Optional extra features - IP addresses, ports, timestamp of last packet (option `-e`)

## Main components

1. Sniffer

  * Network traffic sniffer & frame parser

2. IP reassembler

  * Only IP header "summaries" 

  * Payload not reassembled (content features not extracted, it is not needed)

3. Connection/Conversation reconstructor

  * Reconstructs conversations

  * Computes intrinsic features (columns 1-9 of KDD)

4. Statistical engine

  * Computes derived features (columns 23-41 of KDD)

## Build instructions to Linux (tested on Ubuntu)

1. Create a folder to temporal build files


   `mkdir build-files`



2. Enter in the folder and compile the cache


  `cd build-files`


   `cmake -DCMAKE_BUILD_TYPE=Debug -G "CodeBlocks - Unix Makefiles" ..`



3. Exit the folder of build cache and compile the project


  `cd ..`


  `cmake --build ./build-files --target kdd99extractor -- -j 4`



4. Path to compiled project is:


  `build-files/src/kdd99extractor`



## Planned sections in this readme

* TODOs (e.g. IP checksum checking not implemented)

* Known/possible problems, bugs & limitations

## Main sources of feature documentation

[1] KDD Cup 1999 Data, http://kdd.ics.uci.edu/databases/kddcup99/kddcup99.html

[2] [Lee, W. & Stolfo, S. J. (2000), 'A framework for 

onstructing features and models for intrusion detection systems', Information and System Security 3 (4) , 227-261.](http://wenke.gtisc.gatech.edu/ids-readings/lee_dmids_frmwk.pdf)

[3] [Dybey, D. & Dubey, J. (2014), 'A Survey Intrusion Detection with KDD99 Cup Dataset', International Journal of Computer Science and Information Technology Research 2 (3), 146-157.](http://www.researchpublish.com/download.php?file=A%20Survey%20Intrusion%20Detection%20with%20KDD99-403.pdf&act=book)