Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 6.8 KB

README.md

File metadata and controls

35 lines (26 loc) · 6.8 KB

NeFiAS Scripts

This directory contains the following scripts:

Filename Description Author Comment/Reference
kappa_framelen.sh Calculate compressibility score (K) using a static window size (1.000) on the basis of the frame length (per flow); i.e. this script helps to detect network covert channels that modulate sizes of succeeding packets (such covert channels implement the so-called Size Modulation hiding pattern) Steffen Wendzel see documentation; essentially the same as explained in (Wendzel et al., 2019)
kappa_framelen_- multiple_winsize.sh Same as kappa_framelen.sh, but with multiple window sizes Steffen Wendzel same as kappa_framelen.sh
kappa_IAT.sh Calculate compressibility score (K) using a static window size (1.000) on the basis of inter-packet gaps (per flow); this script helps to detect network covert channels that modulate the timings between succeeding network packets (such covert channels implement the so-called Inter-packet Times hiding pattern) Steffen Wendzel see documentation; essentially the same as explained in (Keidel et al., 2018)
kappa_IAT_- multiple_winsize.sh Same as kappa_IAT.sh, but with multiple window sizes Steffen Wendzel same as kappa_IAT.sh
kappa_MQTT_topics_- multiple_winsize.sh Calculates compressibility score (K) using the appearance of MQTT topics with different window sizes. Output format: <flow (CSV)>, window-size, kappa, number-of-topic-changes-within-winsize Steffen Wendzel code was used for (Mileva et al., 2021)
kappa_TCP_- seqmod_message_- ordering_pattern.sh Calculates compressibility score (K) using different window sizes to detect the Message Ordering pattern in TCP, i.e. those covert channels that modulate the order of TCP segments Steffen Wendzel Implements exactly the coding and compression as used by (Wendzel, 2019). Also, see [*]
MQTT_Artifi- cialRecon_multi- ple_winsize.sh Calculates compressibility score (K) using the appearance of MQTT client_ids with different window sizes. Output format: <flow (CSV)>, window-size, kappa, number-of-client_id-changes-within-winsize Steffen Wendzel code was used for (Mileva et al., 2021)
eSim_IAT_frametimerelative.sh Calculates epsilon similarity scores using a static window size (2,001) on the basis of inter-packet gaps (per flow); this script helps to detect network covert channels that modulate the timings between succeeding network packets (such covert channels implement the so-called Inter-packet Times hiding pattern) Kevin Albrechts, in cooperation with Steffen Wendzel see documentation; implementation of epsilon similarity for inter-packet times pattern described by (Cabuk et al., 2004 and 2009)
eSim_Retransmission_tcpseq.sh Calculates epsilon similarity scores using a static window size (2,000) on the basis of tcp retransmissions (per flow); this script helps to detect network covert channels that use artificial (tcp) retransmissions of network packets (such covert channels implement the so-called Retransmission hiding pattern) Kevin Albrechts, in cooperation with Steffen Wendzel see documentation; implementation of epsilon similarity for retransmission pattern described by (Zillien and Wendzel, 2018)
eSim_Size_Modulation_framelen.sh Calculates epsilon similarity scores using a static window size (2,000) on the basis of packet sizes (per flow); this script helps to detect network covert channels that modulate the packet sizes of succeeding network packets (such covert channels implement the so-called Size Modulation hiding pattern) Kevin Albrechts, in cooperation with Steffen Wendzel see documentation; implementation of epsilon similarity for size modulation pattern described by (Wendzel et al., 2019)

The following scripts are NeFiAS-internal scripts and are not usable directly:

  • nefias_lib.sh (this file must be included by all other scripts and provides basic NeFiAS functionality to these scripts).

References

Notes

[*] The original paper used a window size (i.e. amount of segments considered for calculation) of 200. However, the NeFiAS script supports multiple window sizes by default. Moreover, the original paper implemented four different variants to encode the string S but only the best performing string coding is implemented in the NeFiAS script. For details, see (Wendzel, 2019).