--- title: "Rapid7 InsightVM" slug: "rapid7-insightvm" updated: 2025-11-12T21:20:37Z published: 2025-11-12T21:20:37Z canonical: "docs.databee.buzz/rapid7-insightvm" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # Rapid7 InsightVM InsightVM brings together Rapid7’s library of vulnerability research knowledge, exploit knowledge from Metasploit, global attacker behaviour, internet-wide scanning data, exposure analytics, and real-time reporting. For detailed information, please refer to the [InsightVM’s official documentation](https://www.rapid7.com/products/insightvm/). **Integration Method:** API **Tables**: Account Change (3001), API Activity (6003), Authentication (3002), User Access Management (3005), Device Inventory Info (5001), Detection Findings (2004) This integration supports the following events. | **Event** | **Description** | | --- | --- | | Assets Events | Returns the inventory, assessment, and summary details for a page of assets. Only assets which the caller has access to are returned. | | Vulnerabilities Events | Returns all vulnerabilities that can be assessed. | | Audit Events | User created, activated, updated, successful login/logout, role assigned/removed. | This integration supports the following versions. | InsightVM Version Tested | 7.7.0 | | --- | --- | | InsightVM API version | V3 | # ## Prerequisites - The User should have **Administrator** privileges to the [InsightVM](https://insight.rapid7.com/login) Platform for creating API tokens - The User should have access to the DataBee console ## Configuration Overview 1. Generate an API token on the InsightVM console with the required scopes. 2. Add the [Rapid7 InsightVM data feed](/user-manual/docs/rapid7-insightvm#databee-configuration) integration in the DataBee console with the required API token. | **DataBee Parameter** | **InsightVM Parameter** | | --- | --- | | Token | Organization Key | ## InsightVM Configuration Start by creating an API Token for the integration. 1. Login to your [Insight Platform](https://insight.rapid7.com/login) account which has **admin privileges**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-6bnurtsd.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 2. In the left side bar, click **ADMINISTRATION**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-4az3m60v.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 3. Under **SETTINGS**, navigate to **Company Settings** page, select **Audit Log** and **enable** the toggle button and note down the **** and [refer](https://docs.rapid7.com/insight/product-apis/#supported-regions) for region placeholder choices. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-uldg189e.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) > [!NOTE] > **Note:** > > Enabling this toggle button is necessary to pull audit events logs through API. 4. On the left side bar, expand **API KEY MANAGEMENT** drop down and choose **Organization Keys.** On the “Organization Keys” page select **Generate New Organization Key**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-jn66drxb.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 5. On the **Generate New Organization Key** prompt, choose your **organization** from the drop down and enter a **name** for the key and hit **Submit** button at the bottom. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-0xs21qxc.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 6. On the **Copy Your API Key Now** prompt, make sure to copy the key by hitting the **Copy** button. It will be required when configuring the data feed. Once it’s been copied, click **Done**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-l73ox59o.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-nqc3u7a8.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) > [!NOTE] > **Note:** > > API Key will not be available later to be copied. 7. Verify the key created is visible on the console. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-qde374ah.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 8. On the left side bar, expand **USER MANAGEMENT** section and choose **Users** and click **Create New User** button. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-tajzbz96.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 9. On the **Create User** prompt, fill in the user details below and click the **Create User** button. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-bm382g1e.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) - **Email Address** - This address must be a valid email format, such as example@domain.com - **First Name** - **Last Name** - **Timezone** - By default **UTC** is selected. Please change, if required - **Platform Administrator Privileges** - If user is wanted to be a platform administrator, please enable the check box 10. Created user information will be displayed on the page. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-8m1m73tw.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 11. On the left side bar, under **User Management** click **Users** and confirm the created user is listed. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-4a02qyio.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) > [!NOTE] > **Note:** > > Steps 8, 9, 10 and 11 enable audit logs to be pulled through API calls. “Asset Events” & “Vulnerability Events” logs will be available only, if you have “RAPID7 INSIGHTVM” agents installed on any. This is a [Rapid7 Command platform](https://docs.rapid7.com/insight/) where we can generate keys and pull subscribed event logs. ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-zreakbsp.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 2. Search for the **Rapia7 InsightVm** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-87ba2le5.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-n9xm8qyj.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 4. Enter feed contact information and click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-ln1g0dse.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 5. In the configuration page, confirm the following: - **API Base URL:** (Make sure to replace [<**data-storage-region>**](https://docs.rapid7.com/insight/product-apis/#supported-regions), with actual value. This is the base URL that DataBee will interact with) - **Authorization Method**: Bearer Token - **Token**: Paste the **Organization Key** generated earlier in the InsightVM console. - **Event types**: Preselected for all the event types that integration pulls. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/rapid7_insightvm-image-mbhatzlv.png?sv=2026-02-06&spr=https&st=2026-10-27T09%3A58%3A03Z&se=2026-10-27T10%3A58%3A03Z&sr=c&sp=r&sig=AaMePueG8MziI7tl8dw%2Bk3s5Y9M40S%2BQyCjxwLnny6k%3D) 6. Click **Submit**. ## Troubleshooting Tips - Ensure the Organization Key is pasted correctly. Since you cannot view the Organization Key after the 1st time, re-create the Key, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed. - Ensure the is entered correctly. #