MISP2Sentinel with Upload Indicators API

pull/84/head
Koen Van Impe 2023-08-25 15:15:36 +02:00
parent 87a53e94cc
commit 9406089f73
5 changed files with 19 additions and 9 deletions

View File

@ -1,6 +1,6 @@
---
title: MISP to Microsoft Sentinel integration with Upload Indicators API
date: 2023-08-13
date: 2023-08-26
layout: post
authors:
- Koen Van Impe
@ -21,19 +21,29 @@ The new MISP to Microsoft (previously Azure) Sentinel or [misp2sentinel](https:/
Read the installation and configuration documentation at [misp2sentinel](https://github.com/cudeso/misp2sentinel) for more details.
## Azure App
Basically, you need
You stil require an Azure App with the proper permissions to upload the indicators.
- An **Azure App**, with the proper read and write permissions on your Microsoft Sentinel workspace and a **Data Connector**;
- A MISP **API key** to pull data out of MISP;
- A Python3 virtual environment with the necessary libraries (including [MISP-STIX](https://github.com/MISP/misp-stix))
## Data connector at Content Hub
## Microsoft Azure Market Place
The [misp2sentinel](https://github.com/cudeso/misp2sentinel) is available via the Microsoft Sentinel Content Hub at [ADD](ADD)
[misp2sentinel](https://github.com/cudeso/misp2sentinel) is available via the Market Place or [Microsoft Sentinel Content Hub](https://portal.azure.com/#create/microsoftsentinelcommunity.azure-sentinel-solution-misp2sentinel), along with the corresponding data connector.
![misp2sentinel.png-2](/img/blog/misp2sentinel-2.png)
![misp2sentinel.png-1](/img/blog/misp2sentinel-1.png)
## Azure Function
Next to a "traditional" MISP installation, there is also an option to do the integration via an [Azure Function](https://github.com/cudeso/misp2sentinel/tree/main/AzureFunction). The code is contributed by [Infernux](https://github.com/lnfernux) and provides you a great approach to have the integration running directly within Sentinel.
## STIX
The Upload Indicators API of Microsoft is STIX based. The integration relies on [MISP-STIX](https://github.com/MISP/misp-stix) to handle the conversion between MISP and STIX format. For reference, [STIX](https://stixproject.github.io/), is a structured language for describing threat information to make sharing information between systems easier.
![base-MISP2Sentinel.png](/img/blog/base-MISP2Sentinel.png)
![misp2sentinel.png](/img/blog/misp2sentinel.png)
From a functional point of view, all indicators that can be synchronised via the Graph API, can also be synchronised via the Upload Indicators API. There are some features missing in the STIX implementation of Sentinel and as a result some context information (identity, attack patterns) is lost. But it is only a matter of time before these are implemented on the Sentinel side, after which you can fully benefit from the STIX conversion.
@ -45,12 +55,12 @@ In addition to the change to STIX, the new API also supports **Sentinel Workspac
If you used the old Graph API version then it's worth having a look at the new [configuration settings](https://github.com/cudeso/misp2sentinel#configuration-changes) and [requirements](https://github.com/cudeso/misp2sentinel/blob/main/requirements.txt).
## Azure Function
## GitHub repository
Next to a "traditional" MISP installation, there is also an option to do the integration via an [Azure Function](https://github.com/cudeso/misp2sentinel/tree/main/AzureFunction). The code is contributed by [Infernux](https://github.com/lnfernux) and provides you a great approach to have the integration running directly within Sentinel.
The code and documentation is at [https://github.com/cudeso/misp2sentinel](https://github.com/cudeso/misp2sentinel).
## Workflow
For those interested in the underlying code, the 'workflow' of the integration is outlined in this diagram.
![base-MISP2Sentinel-workflow.png](/img/blog/base-MISP2Sentinel-workflow.png)
![misp2sentinel-workflow.png](/img/blog/misp2sentinel-workflow.png)

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

View File

Before

Width:  |  Height:  |  Size: 185 KiB

After

Width:  |  Height:  |  Size: 185 KiB

View File

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB