Skip to main content

How to integrate Rapid7 (InsightVM) account?

Overview​

To authenticate with Rapid7, you will need the following:

  • Base URL
  • Username and Password

Step 1: Log in to Rapid7 / InsightVM Console​

  1. Visit your Rapid7 InsightVM / Command Platform console URL.
  2. Log in using your user credentials (username & password).
  3. If your user / account has 2-Factor Authentication enabled, complete the 2FA process.

Step 2: Determine Your Role / Permissions​

  • Your account should have sufficient permissions to generate API keys or use Basic Auth.
  • For API key generation: you often need to be an Organization Admin, Domain Admin, or have specific permissions enabled.
  • For Basic Auth + 2FA: you will need correct credentials and possibly a console-level user with scan rights.

Step 3: Generate an API Key​

  1. After login, go to Administration (or Settings) in the Rapid7 / Command Platform UI.
  2. Navigate to API Keys or Manage API Keys.
  3. Click New User Key (for personal key) or New Organization Key (if you are organization admin) depending on what scope you need.
  4. Give the key a descriptive name. You may need to select the organization/context.
  5. Generate the key. Copy it immediately, because after leaving the page you will not be able to retrieve the key again.