InsightVM Cloud and Console Plugins

InsightConnect integrates with two InsightVM interfaces: the Insight Cloud and the Security Console. The InsightVM Cloud Plugin uses the InsightVM Cloud API and the InsightVM Integrations API, where the InsightVM Console Plugin uses the InsightVM v3 API.

The InsightVM Cloud Plugin generally supports:

• Starting and stopping scans of one or more assets using a distributed scan engine that has been paired with the Insight Platform
• Retrieving scan and asset data from the cloud

Jump to InsightVM Cloud plugin connection configuration.

The InsightVM Console Plugin supports most all functionality available on the security console, including:

• Site configuration, site management, site-based scanning, and scan data retrieval
• Asset search, asset tag management, asset group management, and asset vulnerability and remediation data retrieval
• Vulnerability exception management

Jump to InsightVM Console plugin connection configuration.

InsightVM Cloud Plugin Connection Configuration

The InsightVM Cloud plugin requires:

• An Insight user API key
• Your Insight platform region

To create an InsightVM Cloud Plugin connection:

• From InsightConnect's home page, navigate to Settings > Plugins & Tools > Connections, click Add Connection, and select the Rapid7 InsightVM Cloud plugin from the Plugins list
• From the workflow builder, add an action step, select the plugin, select an action, and click Add a New Connection in the Choose a Connection step
• From the workflow import wizard, click Add a New Connection in the Configure Details step for the plugin

Once you've reached the connection configuration screen:

1. Name the connection
2. Select where the plugin should run, and ensure that it can communicate with the InsightVM Cloud API (https://.api.insight.rapid7.com/vm//)
3. Create a new credential, name the credential, and enter your Insight User API Key (alternatively, select an existing credential)
4. Select your region (in most cases, your InsightVM region will match your InsightConnect region and can be checked in your browser URL)
5. Click Save and check your connection to confirm it succeeds

InsightVM Console Plugin Connection Configuration

The InsightVM Console plugin requires:

• The username and password for an InsightVM console account
• The URL of your InsightVM Console (e.g., https://consoleserver.acme.com:3780)

To create an InsightVM Console Plugin connection:

• From InsightConnect's home page, navigate to Settings > Plugins & Tools > Connections, click Add Connection, and select the Rapid7 InsightVM Console plugin from the Plugins list
• From the workflow builder, add an action step, select the plugin, select an action, and click Add a New Connection in the Choose a Connection step
• From the workflow import wizard, click Add a New Connection in the Configure Details step for the plugin

Once you've reached the connection configuration screen:

1. Name the connection
2. Select where the plugin should run. Be sure it can communicate with the InsightVM Console
3. Create a new credential, name the credential, and enter your InsightVM account username and password (alternatively, select an existing credential)
4. Enter your InsightVM console URL (eg, https://consoleserver.acme.com:3780)
5. Click Save and check your connection to confirm it succeeds

Troubleshooting

The most common issue with InsightVM Console connections is connectivity between the Orchestrator and the InsightVM Console. Check your connection test for a network timeout error (eg, Connectivity test to InsightVM Console failed: No response received). This may indicate network connectivity issues between your InsightConnect Orchestrator and InsightVM Console. Work with a network administrator to establish connectivity.