Guides
  1. Integrations

Rapid7 Cloud Native Application Protection Platform

Integrating your Rapid7 CNAPP platform with Compyl enhances your capability to protect complex cloud and container environments from misconfiguration, policy violations, threats, and identity and access management (IAM) challenges.

🚧

User Access Types

  • Domain Admin or Organization Admin users can generate API keys from their user profile.
  • Basic users can only generate API keys from their user profile if explicitly granted the API Key Generation Allowed permission.
  • Domain and Organization Admins can grant this permission after a user has been created from the Update User window (Settings → User Management → Users → Action → Update User).

Generating a Rapid7 CNAPP API Key

  1. Log into your Rapid7 account as an Administrator.

  2. Navigate to Settings → User Management → API Keys.

  3. Choose + Add API Key.

    💡

    Note

    User keys inherit the permissions of the user who creates the API key.


  1. In the panel that appears:

    • Select the organization (if applicable).
    • Enter a descriptive name for the key (e.g. Compyl Integration)
    • Decide on whether or not to deactivate any old API Keys
    • Choose an Expiration Date
    • Click Submit.

  2. Copy the API key from the popup. This is the only time it will be visible.


  1. Click Done.

❗️

Warning

You must copy the API key immediately after generating it. You won't be able to retrieve it again later.


Identifying Your Base URL

Your Rapid7 CNAPP Base URL should follow this format: https://org-id-here.customer.divvycloud.com where org-id-here is your specific Rapid7 Cloud Security URL.


Add Configuration

  1. Navigate to the Integrations tab using the left-hand menu, find Integration Name, and select +Add Configuration.


  1. Next, fill in the details below and select Continue.


    Name: Enter the name of the integration.

    is Enabled: Toggle button to ensure data is populated into Compyl.

    Base URL: This is automatically populated as above.

    Key: The API Token you generated above.

  2. Choose your Endpoints and Begin Validation to validate your connection.

  3. Select any Blueprints you wish to associate with this integration.



  4. After you hit Continue, you'll see a summary screen. Click Return to Integrations to complete the configuration.


Once you have completed filling out the form click Return to Integrations.

You'll know the integration is successfully added when the status updates to Complete.


Data is synced on a recurring schedule configured by your Compyl administrator. Each sync pulls the latest data from all enabled endpoints.

To query the data from the integration, refer to the Blueprints article.


Updated 2 months ago

Did this page help you?