> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airmdr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rapid7

> Rapid7 provides security solutions for vulnerability management, incident detection, response, and cloud security. Rapid7 platform helps organizations identify and mitigate risks, detect threats, and respond to incidents efficiently.

### Generate Rapid 7 API & Setup Deployment Region

You will need an API key to interact with the Rapid7 InsightAppSec API.

<Steps>
  <Step title="Access Rapid7 Insight Platform">
    1. Go to the [Rapid7 Insight Platform](https://insight.rapid7.com/).
    2. Click on the gear icon (⚙️) at the page's top right corner.
    3. From the dropdown menu, select "**API Keys**".
    4. Choose the Type of API Key (User Key or Organization Key) to Generate:
       * **User Key:** Represents your user account and inherits your account’s permissions. All users can generate a User Key.
       * **Organization Key:** This key represents the entire organization and provides comprehensive access across all products. Only platform or organization administrators can generate an Organization Key.
    5. Click **Generate**.

       * For a **User Key**:​
         * Click on "New User Key."
         * In the "Generate New User Key" panel, select your organization and provide a descriptive name for the key.
         * Click "**Generate**".
       * For an **Organization Key**:​

             <Note>
               User must have Admin/Super Admin access to create Organization Key.
             </Note>

         * Click on the "Organization Keys" tab.
         * Click "New Organization Key."
         * In the "Generate New Organization Key" panel, select the organization and provide a descriptive name for the key.
         * Click "**Generate**".

           <Warning>
             Copy and securely save the generated **API token** (it won’t be shown again).
           </Warning>
  </Step>

  <Step title="Determine Data Storage Region">
    <Info>
      Each region has specific endpoints that your network must communicate with.
    </Info>

    <Tip>
      Ensure your network allows outbound connectivity to these hostnames over TCP port 443.
    </Tip>

    | Region            | Web Data                                    | Deployment Endpoint                          | API Endpoint                          | S3 (Agent Downloads)              |
    | ----------------- | ------------------------------------------- | -------------------------------------------- | ------------------------------------- | --------------------------------- |
    | United States - 1 | `exposure-analytics.insight.rapid7.com`     | `us.deployment.endpoint.ingress.rapid7.com`  | `us.api.endpoint.ingress.rapid7.com`  | `s3.amazonaws.com`                |
    | United States - 2 | `us2.exposure-analytics.insight.rapid7.com` | `us2.deployment.endpoint.ingress.rapid7.com` | `us2.api.endpoint.ingress.rapid7.com` | `s3.us-east-2.amazonaws.com`      |
    | United States - 3 | `us3.exposure-analytics.insight.rapid7.com` | `us3.deployment.endpoint.ingress.rapid7.com` | `us3.api.endpoint.ingress.rapid7.com` | `s3.us-west-2.amazonaws.com`      |
    | Canada            | `ca.exposure-analytics.insight.rapid7.com`  | `ca.deployment.endpoint.ingress.rapid7.com`  | `ca.api.endpoint.ingress.rapid7.com`  | `s3.ca-central-1.amazonaws.com`   |
    | Europe            | `eu.exposure-analytics.insight.rapid7.com`  | `eu.deployment.endpoint.ingress.rapid7.com`  | `eu.api.endpoint.ingress.rapid7.com`  | `s3.eu-central-1.amazonaws.com`   |
    | Japan             | `ap.exposure-analytics.insight.rapid7.com`  | `ap.deployment.endpoint.ingress.rapid7.com`  | `ap.api.endpoint.ingress.rapid7.com`  | `s3.ap-northeast-1.amazonaws.com` |
    | Australia         | `au.exposure-analytics.insight.rapid7.com`  | `au.deployment.endpoint.ingress.rapid7.com`  | `au.api.endpoint.ingress.rapid7.com`  | `s3.ap-southeast-2.amazonaws.com` |
  </Step>

  <Step title="Associate the UUID with Your API Key">
    Since Rapid7 does not natively provide UUIDs for API keys, you can:

    * Store the API key and UUID mapping in your internal **configuration files** or **database**.
    * Use the UUID as an identifier when logging API calls for tracking purposes.

    To get the **UUID** of an asset, use the following API call:

    ```

    curl --location 'https://{region}.api.insight.rapid7.com/idr/v2/investigations' \
    --header 'X-Api-Key: {API Key}' \
    --header 'Content-Type: application/json'
    ```
  </Step>
</Steps>

### Configure Slack in the AirMDR Integrations Dashboard

1. Navigate to [AirMDR](https://app.airmdr.com/auth/login), provide the credentials, and click **Login**.\\
   <img src="https://mintcdn.com/airmdr/wnBXbVlE7mmN9W6R/images/Duo7.png?fit=max&auto=format&n=wnBXbVlE7mmN9W6R&q=85&s=eb761cfacb91ef3d08a6f7994022f6d5" alt="Duo7 Pn" width="246" height="381" data-path="images/Duo7.png" />
2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select **Integrations**.
3. Use the search option, enter the keyword "**Rapid 7**", select the **Connections** tab, and click **Create**.\\
   <img src="https://mintcdn.com/airmdr/FFJYd5ubo0SyYsYC/images/Rapid71.png?fit=max&auto=format&n=FFJYd5ubo0SyYsYC&q=85&s=79074bd9a665752cddf8b3709ae2dd8b" alt="Rapid71 Pn" width="1271" height="260" data-path="images/Rapid71.png" />
4. Enter the generated **API** token in the Authentication Details field params, and click **Create.**\\
   <img src="https://mintcdn.com/airmdr/FFJYd5ubo0SyYsYC/images/Rapid7.png?fit=max&auto=format&n=FFJYd5ubo0SyYsYC&q=85&s=d03d343b4a95ff3f96f2f6e4250194d3" alt="Rapid7 Pn" width="883" height="730" data-path="images/Rapid7.png" />