misp-book/taxonomy
hibouu 034352aa16 update of taxonomy's part 2016-08-18 23:50:21 +02:00
..
figures update of taxonomy's part 2016-08-18 23:50:21 +02:00
README.md update of taxonomy's part 2016-08-18 23:50:21 +02:00

README.md

Taxonomies

In MISP 2.4, a flexible mechanism has been introduced to support various taxonomy of classification.

You can access the taxonomy by going into 'Event Actions' and select 'List Taxonomies'.

MISP Taxonomy index

The following taxonomies can be used in MISP (as local or distributed tags) or in other tools willing to share common taxonomies among security information sharing tools.

Overview of the MISP taxonomies

The following taxonomies are described:

  1. Admiralty Scale: The Admiralty Scale (also called the NATO System) is used to rank the reliability of a source and the credibility of an information.

A taxonomy contains a series of tags that can use as normal tags in your MISP instance.

Tagging is a simple way to attach a classification to an event. In the early version of MISP, tagging was local to an instance. Classification must be globally used to be efficient. After evaluating different solutions of classification, we build a new scheme using the concept of machine tags.

Taxonomy is a classification of informations. Her, we classified Tags. Taxonomies are implemented in a simple JSON format. Anyone can create their own taxonomy or reuse an existing one.

Taxonomys are in an independent git repository [https://github.com/MISP/misp-taxonomies]

These can be freely reused and integrated in other threat intel tools.

The advantage is that you even set a specific tag as being exportable. This means that you can export your classification with other MISP instance and share the same taxonomies. Tagging is a simple way to attach a classification to an event.

Classification must be globally used to be efficient.

If you want to enable a specific taxonomy, you can click on the cross to enable it.

enableTaxonomy

Then you can even cherry-pick the tags you want to use on the system. If you want to use the whole taxonomy, select all and then click on the cross in the top left.

Contributing to Taxonomy

It is quite easy. Create a JSON file describing your taxonomy as triple tags.

(e.g. check an existing one like Admiralty Scale), create a directory matching your name space, put your machinetag file in the directory and pull your request. Publishing your taxonomy is as easy as a simple git pull request on misp-taxonomies (https://github.com/MISP/misp-taxonomies). That's it. Everyone can benefit from your taxonomy and can be automatically enabled in information sharing tools like MISP.

Reserved Taxonomy

The following taxonomy namespaces are reserved and used internally to MISP.

  • galaxy mapping taxonomy with cluster:element:"value".

Adding Taxonomy in MISP

How are taxonomies integrated in MISP?

MISP administrator have only to import (or even cherry pick) the namespace or predicates they want to use as tag.

Tags can be exported to other instances.

Tags are also accessible via the MISP REST API.

For more information, "Information Sharing and Taxonomies Practical Classification of Threat Indicators using MISP" presentation given to the last MISP training in Luxembourg.

Adding a private taxonomy

$ cd /var/www/MISP/app/files/taxonomies/
$ mkdir privatetaxonomy
$ vi machinetag.json

Create a JSON file Create a JSON file describing your taxonomy as triple tags.

Once you are happy with your file go to MISP Web GUI taxonomies/index and update the taxonomies, the newly created taxonomy should be visible, now you need to activate the tags within your taxonomy.

How using Taxonomy in MISP

Filtering the distribution of events among MISP instances

Applying rules for distribution based on tags:

Other use cases using MISP taxonomies

Tags can be used to set events for further processing by external tools (e.g. VirusTotal auto-expansion using Viper).

Ensuring a classification manager classes the events before release (e.g. release of information from air-gapped/classified networks).

Enriching IDS export with tags to fit your NIDS deployment.

MISP warning lists: The dilemma of false-positive

  • False-positive is a common issue in threat intelligence sharing.

  • Its often a contextual issue:

    • false-positive might be different per community of users sharing information.

    • organization might have their own view on false-positive.

  • Based on the success of the MISP taxonomy model, we build misp-warninglists. They are lists of well-known indicators that can be associated to potential false positives, errors or mistakes. They are Simple JSON files.

MISP warning lists

The warning lists are integrated in MISP to display an info/warning box at the event and attribute level. This can be enabled at MISP instance level. Default warning lists can be enabled or disabled like known public resolver, multicast IP addresses, hashes for empty values, rfc1918, TLDs or known google domains. The warning lists can be expanded or added in JSON locally or via pull requests (https://github.com/MISP/misp-warninglists). Warning lists can be also used for critical or core infrastructure warning, personally identifiable information...

  • Sighting support (thanks to NCSC-NL) is integrated in MISP allowing to auto expire IOC based on user detection.

  • Adjusting taxonomies (adding/removing tags) based on their score or visibility via sighting.

  • Simple taxonomy editors to help non-technical users to create their taxonomies.

  • Filtering mechanisms in MISP to rename or replace taxonomies/tags at pull and push synchronisation.

  • More public taxonomies to be included