misp-book/galaxy/README.md

103 lines
6.1 KiB
Markdown
Raw Normal View History

2016-12-23 15:05:42 +01:00
<!-- toc -->
## Galaxies
Galaxies in MISP are a method used to express a large object called cluster that can be attached to MISP events or attributes. A cluster can be composed of one or more elements. Elements are expressed as key-values.
There are default vocabularies available in MISP galaxy but those can be overwritten, replaced or updated as you wish. Vocabularies are from existing standards (like STIX, Veris, MISP and so on) or custom ones.
Existing clusters and vocabularies can be used as-is or as a template. MISP distribution can be applied to each cluster to permit a limited or broader distribution scheme.
2017-04-02 17:09:52 +02:00
The objective is to have a common set of clusters for organizations starting analysis but that can be expanded to localized information (which is not shared) or additional information (that can be shared).
2016-12-23 15:05:42 +01:00
2017-04-02 17:09:52 +02:00
[MISP galaxy](https://github.com/MISP/misp-galaxy) are available on Github.
2016-12-23 15:05:42 +01:00
### Managing Galaxies in MISP
2017-04-02 17:09:52 +02:00
> [warning] You need to have a specific role to manage Galaxies on a MISP instance.
Galaxies management is accessed using the Galaxies link on the top menu.
![MenuGalaxy](./figures/GalaxyMenu.png)
A list with all the galaxies existing on the server will appear.
![GalaxyView](./figures/GalaxyView.png)
Each galaxy can be explored using the icon at the end of the line.
![GalaxyList](./figures/GalaxyList.png)
Here is shown the metadata of the selected galaxy as well as a table with each available value as well as some complementary data such as a description of the value or the activity, that is to say the evolution of the use of each value.
Galaxies can be reimported from the submodules by cliking the "Update Galaxies" link on either the galaxies list or while browsing a specific galaxy. A popup will appear to confirm the reimportation.
![GalaxyUpdate](./figures/GalaxyUpdate.png)
All galaxies will always be updated, even while browsing a specific galaxy.
2016-12-23 15:05:42 +01:00
### Using Galaxies in MISP Events - Example
2017-04-02 17:09:52 +02:00
For this example, we will try to add a cluster to an existing event. This cluster will contains informations about threat actor known as Sneaky Panda.
2016-12-23 15:05:42 +01:00
![EventWithoutCluster](./figures/EventWithoutCluster.png)
2017-01-07 15:39:57 +01:00
Here on the event view, we notice a blue frame under the metadatas with the title "Galaxies" and a button "Add new cluster". Let's click on the latter to begin.
2016-12-23 15:05:42 +01:00
![GalaxyPopup](./figures/GalaxyPopup.png)
A popup will appear proposising to explore a particular galaxy or all at the same time. Here, as we know we want to as a threat actor, we will choose the second option and scroll to find Sneaky Panda (We are courageous, aren't we?).
![NoSneakyPanda](./figures/NoSneakyPanda.png)
2017-01-07 15:39:57 +01:00
Wait. No Sneaky Panda? Hm that's strange. Or maybe it is only registred as a alias. Let's have a look! To do so we will use the search field which stay on top of the list. So what do we get? Beijing Group, is it an alias of our threat actor.
2016-12-23 15:05:42 +01:00
![Search](./figures/Search.png)
Pointing the cursor on it will give us the answer.
![Alias](./figures/Alias.png)
We have a match. So we select it and here we go.
![NewThreatActor](./figures/NewThreatActor.png)
Clicking on the magnifying glass next to Threat actor redirects to the list of all threat actors
Clicking on the magnifying glass next to Beijing Group redirects us to a page about this group
Clicking on the addition symbole on the left of Beijing Group extends the module.
### Available Galaxies
#### Clusters
2017-01-07 15:39:57 +01:00
[Exploit-kit](https://github.com/MISP/misp-galaxy/blob/master/clusters/exploit-kit.json) - Exploit-Kit is an enumeration of some exploitation kits used by adversaries. The list includes document, browser and router exploit kits. It's not meant to be totally exhaustive but aim at covering the most seen in the past 5 years.
[Microsoft Activity Group](https://github.com/MISP/misp-galaxy/blob/master/clusters/microsoft-activity-group.json) - Activity groups as described by Microsoft.
2017-04-02 17:09:52 +02:00
[Preventive Measure](https://github.com/MISP/misp-galaxy/blob/master/clusters/preventive-measure.json) - Preventive measures.
[Ransomware](https://github.com/MISP/misp-galaxy/blob/master/clusters/ransomware.json) - Ransomware galaxy based on https://docs.google.com/spreadsheets/d/1TWS238xacAto-fLKh1n5uTsdijWdCEsGIM0Y0Hvmc5g/pubhtml
2017-01-07 15:39:57 +01:00
[TDS - Traffic Direction System](clusters/tds.json) - TDS is a list of Traffic Direction System used by adversaries.
2016-12-23 15:05:42 +01:00
[Threats Actors](https://github.com/MISP/misp-galaxy/blob/master/clusters/threat-actor.json) - Known or estimated adversary groups targeting organizations and employees. Adversary groups are regularly confused with their initial operation or campaign. Threat actors are characteristics of malicious actors (or adversaries) representing a cyber attack threat including presumed intent and historically observed behaviour.
2017-01-07 15:39:57 +01:00
[Tools](https://github.com/MISP/misp-galaxy/blob/master/clusters/tool.json) - Enumeration of software tools used by adversaries. The list includes malware but also common software regularly used by the adversaries.
2016-12-23 15:05:42 +01:00
#### Vocabularies
2017-01-07 15:39:57 +01:00
##### Common
2017-04-02 17:09:52 +02:00
[certainty-level](https://github.com/MISP/misp-galaxy/blob/master/vocabularies/common/certainty-level.json) -
2016-12-23 15:05:42 +01:00
Certainty level of an associated element or cluster
##### threat-actor
2017-04-02 17:09:52 +02:00
[intended-effect](https://github.com/MISP/misp-galaxy/blob/master/vocabularies/threat-actor/intended-effect.json) - default STIX vocabulary for expressing the intended effect of a threat actor
[motivation](https://github.com/MISP/misp-galaxy/blob/master/vocabularies/threat-actor/motivation.json) - default STIX vocabulary for expressing the motivation of a threat actor
[planning-and-operational-support](https://github.com/MISP/misp-galaxy/blob/master/vocabularies/threat-actor/planning-and-operational-support.json) - default STIX vocabulary for expressing the planning and operational support functions available to a threat actor.
[sophistication](https://github.com/MISP/misp-galaxy/blob/master/vocabularies/threat-actor/sophistication.json) - default STIX vocabulary for expressing the subjective level of sophistication of a threat actor.
[type](https://github.com/MISP/misp-galaxy/blob/master/vocabularies/threat-actor/type.json) - default STIX vocabulary for expressing the subjective type of a threat actor.