Skip to content

winstons76/Citrus

 
 

Repository files navigation

Overview

Citrus: an intrusion detection framework which is adept at tackling emerging threats through the collection and
labelling of live attack data, as well as real-time classification of malicious behaviour via the utilisation of machine learning algorithms.

Citrus is composed of several inter-connected components, and the architecture is presented below:

Citrus Overview

As illustrated, the Citrus architecture is composed of distinct components which interface with services deployed within the network, as well as remote services located on the Internet. The southernmost components within the figure represent these services which provide Citrus crucial input data necessary for its operation. Furthermore, they are also utilised for output operations, such as saving labelled telemetry to disk for future dissemination within the research community.

The northernmost components represent the two modules implemented to aid CTI gathering and real time anomaly detection. Clementine is a component within Citrus which rapidly identifies malicious behaviour occurring within the local network through the utilisation of machine learning models. The Tangerine component within Citrus, performs automatic intrusion detection data set labelling through correlation with cyber threat intelligence service providers.

CTI Services

Additionally, Citrus supports a variety of cyber threat intelligence services to correlate and label suspect telemetry including:

  • Greynoise
  • Maltiverse
  • Shodan
  • OTX
  • Zoomeye
  • HybridAnalysis
  • Apility
  • AbuseIPDB

The relationships derived from these services are mapped into a graphical representation using NetworkX library. Based upon these relationships and the formation of graph-based feature clusters, captured telemetry is labelled to contribute to an intrusion detection data set, LUFlow '20. An example of the nodes and their corresponding labels is presented below:

Labelled clusters

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%