---
title: Rapid7 Insight
slug: authentication-guides/rapid7-insight
docTags: 
createdAt: 2026-10-05T04:47:53.054Z
---

# Introduction

This guide tells you how to authenticate the **Rapid7 Insight** connector in Swimlane using HTTP Basic Authentication.

You will obtain your **Account ID** and **API Key** from the IntSights platform and configure the connector in Swimlane.

The Rapid7 Insight connector uses these credentials to authenticate requests and retrieve indicator of compromise (IOC) information.

## Prerequisites

### Rapid7 Insight Access Requirements

You must have:

- Access to the IntSights platform.
- Access to the **Subscription** page.
- An Account ID.
- A valid API Key.
- Appropriate permissions to access the API.

### Required Credentials

During setup, you will collect:

- URL
- Account ID
- API Key

For the Swimlane connector, the **Account ID** is entered in the username field and the **API Key** is entered in the password field.

## Rapid7 Insight Setup

Take the following steps to obtain the required credentials:

1. Log in to your **IntSights** cloud platform.
2. Navigate to the **Subscription** page.
3. Locate your **Account ID**.
4. Copy and securely save the Account ID.
5. Locate your **API Key**.
6. Copy and securely save the API Key.
7. Identify the API URL for your environment.

:::hint{type="info"}
The API Key is the same key used for connectivity between the IntSights virtual appliance and the cloud platform. If an API Key was generated previously, you can reuse it for REST API connectivity.
:::

## 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 **Rapid7 Insight** from the **Asset type** list.
6. Fill in the **Asset Settings** and **Asset Input** as shown:

| **Field**   | **Description**                                          | **Required/Optional** |
| ----------- | -------------------------------------------------------- | --------------------- |
| url         | URL of the target Rapid7 Insight API host.               | Required              |
| username    | IntSights Account ID.                                    | Required              |
| password    | IntSights API Key.                                       | Required              |
| verify\_ssl | Enable or disable SSL certificate verification.          | Optional              |
| http\_proxy | Proxy configuration used to route requests, if required. | Optional              |

Fields with \* marks are required.

7. Click **Create**.

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

## Troubleshooting

- If authentication fails, verify that the **Account ID** entered in the username field is correct.
- Verify that the **API Key** entered in the password field is valid.
- If you previously generated an API Key for IntSights virtual appliance connectivity, verify that the existing key is still active.
- If you receive an authorization error, verify that your account has the appropriate API permissions.
- If the connector cannot reach Rapid7 Insight, verify the url value and network connectivity.
- If you receive an SSL certificate error, verify the verify\_ssl configuration.
- If your environment uses a proxy, verify that the http\_proxy value is correct.

**Result:** You have successfully authenticated the **Rapid7 Insight** connector in Swimlane.

## Sources

- **Rapid7 Threat Command Documentation**
  [https://docs.rapid7.com/threat-command/](https://docs.rapid7.com/threat-command/)
- **Rapid7 Insight Platform**
  [https://insight.rapid7.com/](https://insight.rapid7.com/)
- **AirMDR Rapid7 Integration Documentation**
  [https://docs.airmdr.com/Integrations/Rapid7](https://docs.airmdr.com/Integrations/Rapid7)