Skip to content

Latest commit

 

History

History
46 lines (36 loc) · 1.64 KB

analyzers.md

File metadata and controls

46 lines (36 loc) · 1.64 KB

Cortex Analyzers

Analyzers are autonomous applications managed by and run through the Cortex core engine. Analyzers have their own dedicated GitHub repository. They are included in the Cortex binary, RPM and DEB packages but you have to get them from the repository if you need to update them after installing one of those packages (which is necessary when new analyzers are released or new versions of existing ones are made available) ordecide to build Cortex from sources.

Pre-requisites

Currently, all provided analyzers are written in Python. They don't require any build phase but their dependencies have to be installed. Before proceeding, you'll need to install the system package dependencies that are required by some of them:

apt-get install python-pip python2.7-dev ssdeep libfuzzy-dev libfuzzy2 libimage-exiftool-perl libmagic1 build-essential libssl-dev

Each analyzer comes with its own, pip compatible requirements.txt file. You can install all requirements with the following commands:

cd analyzers
sudo pip install $(sort -u */requirements.txt)

From repository

If you want to use up-to-date analyzers, you can clone the GitHub repository:

git clone https://github.com/CERT-BDF/Cortex-Analyzers

Next, you'll need to tell Cortex where to find the analyzers. Currently, all the analyzers must be in the same directory. Add the following to the Cortex configuration file (application.conf):

analyzer {
  path = ["path/to/analyzers"]
}

Configuration

Analyzers are configured using web interface. You need orgAdmin role to configure and enable analyzers.