Rapid7 InsightVM Cloud

This Integration is part of the Rapid7 InsightVM Cloud Pack.

Supported versions

Supported Cortex XSOAR versions: 6.0.0 and later.

InsightVM is a Vulnerability Management Tool which Scan your Network, Eliminate Vulnerabilities, Track and Communicate progress.

Configure Rapid7 InsightVM Cloud on Cortex XSOAR

1. Navigate to Settings > Integrations > Servers & Services.

2. Search for Rapid7 InsightVM Cloud.

3. Click Add instance to create and configure a new integration instance.

   Parameter	Required
   Username	True
   Password	True
   Trust any certificate (not secure)	False
   Server URL (e.g., https://example.net)	True
   Use system proxy settings	False

4. Click Test to validate the URLs, token, and connection.

Commands

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

insightvm-cloud-get-asset

---

Returns the assessment and details of an asset (specified by id). Only assets which the caller has access to can be returned.

Base Command

insightvm-cloud-get-asset

Input

Argument Name	Description	Required
asset_id	The identifier of the asset to retrieve the details for.	Required

Context Output

There is no context output for this command.

insightvm-cloud-get-scan

---

Retrieves the scan with the specified identifier.

Base Command

insightvm-cloud-get-scan

Input

Argument Name	Description	Required
scan_id	The identifier of the scan.	Required

Context Output

There is no context output for this command.

insightvm-cloud-get-scan-engines

---

Retrieves a page of scan engines.

Base Command

insightvm-cloud-get-scan-engines

Input

Argument Name	Description	Required
page	The index of the page to retrieve. Default is 0.	Optional
size	The number of records per page to retrieve. Default is 10.	Optional

Context Output

There is no context output for this command.

insightvm-cloud-get-health-check

---

Returns an indicator of the health of the API.

Base Command

insightvm-cloud-get-health-check

Input

Argument Name	Description	Required

Context Output

There is no context output for this command.

insightvm-cloud-search-assets

---

Returns the inventory, assessment, and summary details for a page of assets.

Base Command

insightvm-cloud-search-assets

Input

Argument Name	Description	Required
hostname	Search criteria for filtering assets returned.	Required
page	The index of the page (zero-based) to retrieve. Default is 0.	Optional
size	The number of records per page to retrieve. Default is 10.	Optional

Context Output

There is no context output for this command.

insightvm-cloud-last-sites

---

Returns the details for sites

Base Command

insightvm-cloud-last-sites

Input

Argument Name	Description	Required
page	The index of the page (zero-based) to retrieve. Default is 0.	Optional
size	The number of records per page to retrieve. Default is 10.	Optional

Context Output

There is no context output for this command.

insightvm-cloud-search-vulnerabilities

---

Returns all vulnerabilities that can be assessed.

Base Command

insightvm-cloud-search-vulnerabilities

Input

Argument Name	Description	Required
page	The index of the page to retrieve. Default is 0.	Optional
size	The number of records per page to retrieve. Default is 10.	Optional
query	query to search vulnerabilities.	Required

Context Output

There is no context output for this command.

insightvm-cloud-start-scan

---

Starts a scan.

Base Command

insightvm-cloud-start-scan

Input

Argument Name	Description	Required
asset_id	The identifiers of the assets to scan.	Required
name	The name of the scan.	Optional

Context Output

There is no context output for this command.

insightvm-cloud-stop-scan

---

Stops the scan with the specified identifier.

Base Command

insightvm-cloud-stop-scan

Input

Argument Name	Description	Required
id	The identifiers of the assets to stop scan.	Required

Context Output

There is no context output for this command.