---
title: Malware Information Sharing Platform
slug: authentication-guides/malware-information-sharing-platform
docTags: 
createdAt: 2026-07-27T12:24:38.595Z
---

## Introduction

This guide tells you how to authenticate the **MISP (Malware Information Sharing Platform)** connector in Swimlane using **API Key Authentication**.

You will generate a MISP authentication key, collect the required connection details, and configure the connector in Swimlane. The connector authenticates using an API Key passed in the **Authorization** header. The connector details referenced below are from the uploaded Swimlane connector documentation.

# Prerequisites

## MISP Access Requirements

You must have permissions to:

- Log in to your MISP instance.
- Create or manage authentication keys.
- Access the MISP REST API.
- View or manage events and attributes, depending on the connector actions you plan to use.

# Required Credentials

During setup, you will collect:

- MISP Server URL
- MISP API Key

# MISP Setup

### Take the following steps to generate an API Key:

1. Log in to your **MISP** instance.
2. From the left navigation menu, click **Administration**.
3. Select **List Auth Keys**.
4. Click **+ Add authentication key**.
5. Enter a descriptive comment for the key.
6. (Optional) Restrict the key to specific IP addresses.
7. (Optional) Set an expiration date.
8. Click **Submit**.
9. Copy the generated authentication key.
10. Store the key securely, as it will be required when configuring the Swimlane connector.

**Take the following steps to obtain the MISP URL:**

1. Open your MISP instance in a web browser.
2. Copy the base URL.

Example:

https\://misp.company.com

Do not include any API endpoints such as /attributes or /events.

# Connector Configuration in Swimlane

1. Log in to Turbine.
2. From the left-hand navigation pane, click **ORCHESTRATION** and click **Assets**.
3. Asset homepage opens.
4. Click the plus icon to open the **Configure your Connector Asset** window.
5. Select **MISP** from the **Asset type** list.
6. Fill in the **Asset Settings** and **Asset Input** as shown:

| **Field**         | **Description**                                                         | **Required/Optional** |
| ----------------- | ----------------------------------------------------------------------- | --------------------- |
| **url**           | Base URL of your MISP instance (for example, https\://misp.company.com) | Required              |
| **Authorization** | MISP API Key                                                            | Required              |
| **verify\_ssl**   | Enable/Disable SSL Verification                                         | Optional              |
| **http\_proxy**   | Optional proxy configuration                                            | Optional              |

Fields with \* marks are required.

7. Click **Create**.

::Image[]{src="https://api.archbee.com/api/optimize/n8uUzk0MM4uC57-zlHNtY/hNut4GPt9QIBVgHp5D57H_image.png" size="200" isUploading="false" width="800" height="407" darkWidth="800" darkHeight="407" showCaption="false"}

# Troubleshooting

## Authentication Failed (401 Unauthorized)

Verify that:

- The API Key is correct.
- The API Key has not expired.
- The API Key has not been revoked.

## Forbidden (403)

Verify that:

- Your MISP user has permission to access the API.
- Your account has permission to perform the connector actions.
- Your API key is allowed to access the requested resources.

## Unable to Connect

Verify that:

- The MISP URL is correct.
- The MISP server is reachable from the Swimlane instance.
- Any required firewall rules allow HTTPS traffic.

## SSL Certificate Errors

If SSL verification fails:

- Verify that the MISP server is using a trusted certificate.
- Import the CA certificate if your organization uses an internal CA.
- Disable **verify\_ssl** only for testing if permitted by your organization's security policy.

### Result

You have successfully authenticated the **MISP** connector in Swimlane.

### Sources

- MISP Automation Documentation
  [https://www.circl.lu/doc/misp/automation/](https://www.circl.lu/doc/misp/automation/)
- MISP OpenAPI Documentation
  [https://www.misp-project.org/openapi/](https://www.misp-project.org/openapi/)
- MISP Project Documentation
  [https://www.misp-project.org/documentation/](https://www.misp-project.org/documentation/)