Rapid7 InsightVM
  • 24 Mar 2022
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Rapid7 InsightVM

  • Dark
    Light
  • PDF

Rapid7 InsightVM provides visibility and risk prioritization for vulnerabilities found in local, remote, cloud, containerized, and virtual infrastructure.

Note

Axonius uses the InsightVM Cloud Integrations API. This API refers to InsightVM API v4. If you use a previous version of InsightVM, that supports Rapid7 InsightVM API Version, use the Rapid7 Nexpose and InsightVM adapter.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Devices

Parameters

  1. Domain (required, default: us.api.insight.rapid7.com) - The domain of the Rapid7 InsightVM server. The default domain is us.api.insight.rapid7.com
  2. API Key (required, default: empty) - An API Key associated with a user account that has permissions to fetch assets.
  3. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in Domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in Domain will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in Domain will not be verified against the CA database inside of Axonius.
  4. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in Domain.
    • If not supplied, Axonius will connect directly to the value supplied in Domain.
  5. HTTPS Proxy User Name (optional, default: empty) - The user name to use when connecting to the value supplied in Domain via the value supplied in HTTPS Proxy.
    • If supplied, Axonius will authenticate with this value when connecting to the value supplied in HTTPS Proxy.
    • If not supplied, Axonius will not perform authentication when connecting to the value supplied in HTTPS Proxy.
  6. HTTPS Proxy Password (optional, default: empty) - The password to use when connecting to the value supplied in Domain via the value supplied in HTTPS Proxy.
    • If supplied, Axonius will authenticate with this value when connecting to the value supplied in HTTPS Proxy.
    • If not supplied, Axonius will not perform authentication when connecting to the value supplied in HTTPS Proxy.
  7. To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Rapid7 InisghtVM.png

Advanced Settings

Note:

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters

  1. Do not fetch devices with no MAC address and no hostname and no IP (optional, default: false) - Select this option to exclude devices with no MAC address, no hostname and no IP address from the fetch. When the option is cleared, Axonius will fetch devices even if they do not have either a MAC address, hostname or IP address.
  2. Tag Keys Include list (optional, default: false) - Specify a comma-separated list of Tag Keys in Rapid7 InsightVM. When supplied, all connections for this adapter will only fetch devices from Rapid7 InsightVM with the Tag Keys provided in this list.
  3. Do not fetch devices without Last Seen and no hostname (optional, default: false) - Select this option to exclude devices in which Last Seen or hostname information is unavailable.
  4. Do not fetch devices without a MAC address or Hostname (optional, default: false) - Select this option to exclude devices without a MAC address or hostname from the fetch. When the option is cleared, Axonius will fetch devices even if they do not have a MAC address or hostname.


NOTE

To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.


APIs

Axonius uses the InsightVM Cloud Integrations API. This API refers to InsightVM API v4. If you use a previous version of InsightVM, that supports API v3, use the Rapid7 Nexpose and InsightVM adapter.

Required Ports

Axonius must be able to communicate with the value supplied in Host Name or IP Address via the following ports:

  • TCP port 443

First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.