Explore and use Lifecycle Management
Copy link

Using Lifecycle Management, you can automatically migrate Bots and Bot templates, exceptions, custom compliance packs, infrastructure as code (IaC) exception configurations, and user favorites from an Insight pending removal to its replacement. Lifecycle Management also lists Query Filters and compliance packs that are pending removal with a replacement.

ℹ️

Pending removal announcements

Any Insight, Query Filter, or compliance pack that Rapid7 is scheduling for removal is announced in the release notes .

Before you begin
Copy link

To access and use Lifecycle Management, you’ll need the following:

  • A provisioned Rapid7 Cloud Security (InsightCloudSec) tenant
  • Rapid7 Cloud Security (InsightCloudSec) permissions

Lifecycle management access details
Copy link

Cloud Security permissionsLifecycle Management access
Domain Administrator, Organization AdministratorMigrate Insights, Rollback migrations, view Deprecated items and Migration History
Domain ViewerView Deprecated Items and Migration History
Basic UserNone

Explore Lifecycle Management
Copy link

You can review Insights, Query Filters, and compliance packs that are eligible for migration in Lifecycle Management.

To open Lifecycle Management:

  1. From Command Home, go to Administration > Lifecycle Management.

Use the filters at the top to quickly view different types and statuses:

  • Types
    • Insights: A check on a specific behavior, condition, or characteristic of a cloud resource.
    • Compliance Packs: Built-in collections of related Insights focused on industry requirements and standards for all of your resources.
    • Query Filters: Specifies conditions Cloud Security (InsightCloudSec) searches for when identifying matching resources.
  • Statuses
    • Pending Removal: Scheduled for removal in a particular version of Cloud Security (InsightCloudSec). After a resource is scheduled for removal, it will be added to the Deprecated Items tab in Lifecycle Management.
    • Removed: The resource has been removed and is no longer available for use or migration.
    • Migrated: The resource has been migrated to a replacement. If you want to audit previous migration efforts, go to the Migration History tab.
ℹ️

Organization Administrator migrations

Organization Administrators only see the migrations in their Cloud Security (InsightCloudSec) organization. Domain Administrators and Viewers see the migrations in every Cloud Security (InsightCloudSec) organization for the tenant. Migrations are also per organization, so Insights that have been migrated in one organization still must be migrated in others.

Use Lifecycle Management
Copy link

If an Insight has a replacement that you can migrate to, you can migrate all Cloud Security resources that reference it.

To migrate an Insight:

  1. From Command Home, go to Administration > Lifecycle Management.
  2. Optionally, use the filters.
  3. Next to the item you want to migrate, select Action (…) > Migrate.
  4. Select the resource types you want to migrate.
  5. Optionally, clear Pause bots after migration for review to automatically pause migrated Bots. This will allow you to review any affected Bots before they run against the new Insight.
  6. Select Preview Migration. The Migration Preview window opens.
  7. Review the migration counts and any warnings to ensure it is accurate, for example, if the replacement Insight flags fewer resources.
  8. Select Confirm & Migrate.

A Migration ID displays with Export Report and Rollback options. The migration is also added to the Migration History tab.

The Migration History tab lists each migration, who ran it, the Insights involved, and how many resources moved. Select Download CSV to export the full history. You can also rollback a migration.

⚠️

Rollback limitations

Keep in mind the following when working with rollbacks:

  • Rollbacks are available 30 days after the migration
  • Only the administrator that performed the migration can roll it back
  • Rollbacks are only available until the original Insight is removed

To roll back a migration:

  1. From Command Home, go to Administration > Lifecycle Management > Migration History.
  2. Next to the migration you want to rollback, select Action (…) > Rollback.

The migrated resources are returned to the original Insight.