Misp – open source threat intelligence platform
MISP – Threat Intelligence Sharing Platform
Latest Release CI Action Gitter Twitter Localization Contributors License
MISP is an open source software solution for collecting, storing, distributing and sharing cyber security indicators and threats about cyber security incidents analysis and malware analysis. MISP is designed by and for incident analysts, security and ICT professionals or malware reversers to support their day-to-day operations to share structured information efficiently.
The objective of MISP is to foster the sharing of structured information within the security community and abroad. MISP provides functionalities to support the exchange of information but also the consumption of said information by Network Intrusion Detection Systems (NIDS), LIDS but also log analysis tools, SIEMs.
MISP, Malware Information Sharing Platform and Threat Sharing, core functionalities are:
- An efficient IOC and indicators database allowing to store technical and non-technical information about malware samples, incidents, attackers and intelligence.
- Automatic correlation finding relationships between attributes and indicators from malware, attack campaigns or analysis. The correlation engine includes correlation between attributes and more advanced correlations like Fuzzy hashing correlation (e.g. ssdeep) or CIDR block matching. Correlation can also be enabled or event disabled per attribute.
- A flexible data model where complex objects can be expressed and linked together to express threat intelligence, incidents or connected elements.
- Built-in sharing functionality to ease data sharing using different model of distributions. MISP can automatically synchronize events and attributes among different MISP instances. Advanced filtering functionalities can be used to meet each organization’s sharing policy including a flexible sharing group capacity and an attribute level distribution mechanisms.
- An intuitive user-interface for end-users to create, update and collaborate on events and attributes/indicators. A graphical interface to navigate seamlessly between events and their correlations. An event graph functionality to create and view relationships between objects and attributes. Advanced filtering functionalities and warning lists to help the analysts to contribute events and attributes and limit the risk of false-positives.
- storing data in a structured format (allowing automated use of the database for various purposes) with an extensive support of cyber security indicators along fraud indicators as in the financial sector.
- export: generating IDS, OpenIOC, plain text, CSV, MISP XML or JSON output to integrate with other systems (network IDS, host IDS, custom tools), Cache format (used for forensic tools), STIX (XML and JSON) 1 and 2, NIDS export (Suricata, Snort and Bro/Zeek) or RPZ zone. Many other formats can be easily added via the misp-modules.
- import: bulk-import, batch-import, import from OpenIOC, GFI sandbox, ThreatConnect CSV, MISP standard format or STIX 1.1/2.0. Many other formats easily added via the misp-modules.
- Flexible free text import tool to ease the integration of unstructured reports into MISP.
- A gentle system to collaborate on events and attributes allowing MISP users to propose changes or updates to attributes/indicators.
- data-sharing: automatically exchange and synchronize with other parties and trust-groups using MISP.
- delegating of sharing: allows a simple pseudo-anonymous mechanism to delegate publication of event/indicators to another organization.
- Flexible API to integrate MISP with your own solutions. MISP is bundled with PyMISP which is a flexible Python Library to fetch, add or update events attributes, handle malware samples or search for attributes. An exhaustive restSearch API to easily search for indicators in MISP and exports those in all the format supported by MISP.
- Adjustable taxonomy to classify and tag events following your own classification schemes or existing classification. The taxonomy can be local to your MISP but also shareable among MISP instances.
- Intelligence vocabularies called MISP galaxy and bundled with existing threat actors, malware, RAT, ransomware or MITRE ATT&CK which can be easily linked with events and attributes in MISP.
- Expansion modules in Python to expand MISP with your own services or activate already available misp-modules.
- Sighting support to get observations from organizations concerning shared indicators and attributes. Sighting can be contributed via MISP user-interface, API as MISP document or STIX sighting documents.
- STIX support: import and export data in the STIX version 1 and version 2 format.
- Integrated encryption and signing of the notifications via GnuPG and/or S/MIME depending on the user’s preferences.
- Real-time publish-subscribe channel within MISP to automatically get all changes (e.g. new events, indicators, sightings or tagging) in ZMQ (e.g. misp-dashboard) or Kafka publishing.
Exchanging info results in faster detection of targeted attacks and improves the detection ratio while reducing the false positives. We also avoid reversing similar malware as we know very fast that other teams or organizations have already analyzed a specific malware.
A sample event encoded in MISP:
Website / Support
Checkout the website for more information about MISP software, standards, tools and communities.
Information, news and updates are also regularly posted on the MISP project twitter account or the news page.
MISP user-guide (MISP-book) is available online or as PDF or as EPUB or as MOBI/Kindle.
For the installation guide see the INSTALL or download section.
If you are interested to contribute to the MISP project, review our contributing page. There are many ways to contributeand participate to the project.
Please see our Code of conduct.
Feel free to fork the code, play with it, make some patches and send us the pull requests via the issues.
Feel free to contact us, create issues, if you have questions, remarks or bug reports.
There is one main branch:
- 2.4 (current stable version): what we consider as stable with frequent updates as hot-fixes.
and features are developed in separated branches and then regularly merged into the 2.4 stable branch.
This software is licensed under GNU Affero General Public License version 3
- Copyright (C) 2012-2022 Christophe Vandeplas
- Copyright (C) 2012 Belgian Defence
- Copyright (C) 2012 NATO / NCIRC
- Copyright (C) 2013-2022 Andras Iklody
- Copyright (C) 2015-2022 CIRCL – Computer Incident Response Center Luxembourg
- Copyright (C) 2016 Andreas Ziegler
- Copyright (C) 2018-2022 Sami Mokaddem
- Copyright (C) 2018-2022 Christian Studer
- Copyright (C) 2015-2022 Alexandre Dulaunoy
- Copyright (C) 2018-2022 Steve Clement
- Copyright (C) 2020-2022 Jakub Onderka
For more information, the list of authors and contributors is available.
MISP – Open Source Threat Intelligence Platform
MISP – Open Source Threat Intelligence and Sharing Platform (formerly known as Malware Information Sharing Platform) is developed as free software/open source by a group of developers from CIRCL and many other contributors.
CIRCL operates several MISP instances (for different types of constituents) in order to improve automated detection and responsiveness to targeted and cybersecurity attacks in Luxembourg and outside. MISP is a platform for sharing threat indicators, threat intelligence within private and public sectors.
Private organisations, organisations, private researchers or CERTs can request access to their respective MISP community.
What is MISP?
A platform for sharing, storing and correlating Indicators of Compromises of targeted attacks but also threat intelligence such as threat actor information, financial fraud information and many more.
MISP – Open Source Threat Intelligence and Sharing Platform allows organizations to share information such as threat intelligence, indicators, threat actor information or any kind of threat which can structured in MISP. MISP users benefit from the collaborative knowledge about existing malware or threats. The aim of this trusted platform is to help improving the counter-measures used against targeted attacks and set-up preventive actions and detection.
CIRCL MISP information sharing communities – a trusted platform with multiple goals
The objective of the CIRCL MISP – Open Source Threat Intelligence and Sharing Platform is to:
- Facilitate the storage of technical and non-technical information about seen malware and attacks
- Create automatically relations between malware and their attributes
- Store data in a structured format (allowing automated use of the database to feed detection systems or forensic tools)
- Generate rules for Network Intrusion Detection System (NIDS) that can be imported on IDS systems (e.g. IP addresses, domain names, hashes of malicious files, pattern in memory)
- Share malware and threat attributes with other parties and trust-groups
- Improve malware detection and reversing to promote information exchange among organizations (e.g. avoiding duplicate works)
- Create a platform of trust – trusted information from trusted partners
- Store locally all information from other instances (ensuring confidentiality on queries)
For more information: Information Sharing and Cyber Security – The Benefits of the Malware Information Sharing Platform (MISP).
How does MISP work?
Malware Information Sharing Platform is accessible from different interfaces like a web interface (for analysts or incident handlers) or via a ReST API (for systems pushing and pulling IOCs). The inherent goal of MISP is to be a robust platform that ensures a smooth operation from revealing, maturing and exploiting the threat information.
How to request access?
If you work for private organisations, organisations, CERTs, if you are a trusted security vendor or researcher, you can request access by contacting us. The registration and access requires the use of at least one PGP key per organization.
What are the rules?
The access is free-of-charge. The objective is to stimulate sharing practises among public and private actors. The access is mainly bound to distribution as described in the traffic light protocol.
How the information is shared among the MISP instances worldwide?
In MISP, there are 4 options regarding distributing events and their respective attributes:
- Your organisation only
- This community only
- Connected communities
- All communities
There is also a set of sharing groups accessible to various members per sector (such as Financial sector).
In the diagram above, you can see an overview of the MISP instances operated by CIRCL. As the distribution is inherent to the connectivity among the MISP instances, participants should keep in mind the overall connectivity to select the appropriate distribution category.
How can I access the MISP API?
When you connect to the MISP platform, there is a specific menu dedicated to automation and export. CIRCL developed a Python library to access MISP API called PyMISP. The API can be used to feed internal security devices (e.g. IDS, SIEM or alike) in order to improve detection. The PyMISP python library documentation is available.
Do I need to install MISP?
No. When you have access to a CIRCL MISP instance, you have an intuitive web interface to find and add threats and indicators. You can directly use the application without the need to install your own MISP instance. The API can be also used with a variety of other security devices if you need to integrate the threats and indicators in your infrastructure (SIEMs, IDS, A/V console, …).
Nevertheless having your own MISP instance has multiple benefits. If you have the capabilities to do so, we strongly recommend a local installation of a MISP instance while syncing with your partners such as CIRCL MISP sharing communities.
I had access to a CIRCL MISP platform but I lost my credentials
If you are part of an organization in MISP, you can ask your MISP organizational admin to reset your password. If not, you can contact CIRCL to reset the credentials.
I found a bug in MISP, what should I do?
If you have found a bug in MISP, we advise you to open an issue on the MISP GitHub issue page. If this is a security vulnerability that cannot be disclosed publicly, contact CIRCL.
Is there a MISP user guide?
A MISP user guide can be found online. The MISP user guide is also available in PDF format, epub format or Kindle mobi format.
Is there any MISP training?
We regularly organize MISP trainings and the MISP training materials are publicly available.