misp / cakephp

CakePHP (v2.x branch + updates)

MISP - Threat Intelligence Sharing Platform

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.

  ●  Core functions   ●  Website / Support   ●  PHP and MISP
  ●  Installation   ●  Documentation   ●  Contributing
  ●  License

Latest Release
CI
Gitter
Mastodon
Twitter
Localization
Contributors
License

Core functions

• 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 user-friendly 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 for 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 Mastodon account, twitter account and news page.

PHP and MISP

MISP currently requires PHP 7.4, an end-of-life version of PHP. Because of this it is recommended that you only run MISP on distributions or PHP installs that you know will get security fixes backported, like Red Hat or Debian and derratives.

MISP 3.x, currently in development will support PHP 8.x.

Installation

For test- og production installations we recommend you check out the possible options on misp-project.org/download.

Documentation

MISP user-guide (MISP-book) is available online or as PDF or as EPUB or as MOBI/Kindle.

It is also recommended to read the FAQ

Contributing

If you are interested to contribute to the MISP project, review our contributing page. There are many ways to contribute and 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.

License

This software is licensed under GNU Affero General Public License version 3

• Copyright (C) 2012-2024 Christophe Vandeplas
• Copyright (C) 2012 Belgian Defence
• Copyright (C) 2012 NATO / NCIRC
• Copyright (C) 2013-2024 Andras Iklody
• Copyright (C) 2015-2024 CIRCL - Computer Incident Response Center Luxembourg
• Copyright (C) 2016 Andreas Ziegler
• Copyright (C) 2018-2024 Sami Mokaddem
• Copyright (C) 2018-2024 Christian Studer
• Copyright (C) 2015-2024 Alexandre Dulaunoy
• Copyright (C) 2018-2022 Steve Clement
• Copyright (C) 2020-2024 Jakub Onderka

For more information, the list of authors and contributors is available.

cakephp's Issues

CA store is obsolete

The CA store in
https://github.com/MISP/cakephp/tree/cf14e6546ec44e3369e3531add11fdb946656280/lib/Cake/Config

hasn't been updated for a while. We have noticed this is creating issue for sync between MISP servers if one of them is using Let's Encrypt certificates for which the previous root CA has expired 30 Sep 2021.

This is related to https://issueexplorer.com/issue/cakephp/cakephp/15987

Using curl with this ca store causes issues while using the OS store works fine. Following the solution described in the link above and using the new Mozilla CA store fixes the sync problem

Suggestion: Better CSRF error handling (triggered with HttpOnly cookies and HTTP Header authentication)

This is a (multiple allowed):

• bug

• enhancement

• feature-discussion (RFC)

• CakePHP Version: c31bb4b - the latest version used in MISP

• Platform and Target: Debian 4.19.269-1 (2022-12-20) x86_64 GNU/Linux

What you did

HttpOnly session cookies were implemented in our MISP installation. This installation also used authentication headers (SAML2 with mellon plugin).

As a consequence, the page to "populate from " ... " Freetext import" loaded.
When submitting the attribute, the page fails with The request has been black-holed - CSRF token mismatch

What happened

We searched a lot on the MISP issue page on github and found no similar issues.

We debugged the code trying to understand the error.
We dumped the data at this place:

cakephp/lib/Cake/Controller/Component/SecurityComponent.php

Line 776 in c31bb4b

$token = $this->Session->read('_Token');

the $token appears to be null

As a consequence, the code goes here

cakephp/lib/Cake/Controller/Component/SecurityComponent.php

Line 784 in c31bb4b

throw new SecurityException('CSRF token mismatch');

and the CSRF error is triggered.

Indeed, the POST is triggered by jquery and because the session cookie in HttpOnly, the jquery code cannot access it.
Because we are using authentication headers for authentication, it reuse the authentication headers to create a new session and the CSRF code cannot work with 2 sessions instead of one.

What you expected to happen

What would have save a lot of time for us is a better error message.

We can see here a defensive programming check for requesttoken:

cakephp/lib/Cake/Controller/Component/SecurityComponent.php

Lines 779 to 782 in c31bb4b

	if (!$requestToken) {
	throw new SecurityException('Missing CSRF token');
	}

But nothing for token.
Maybe do something like:

if (!$token) {
	throw new SecurityException('No CSRF token found stored in session. Old session or HttpOnly Cookie ?');
}