Kubernetes Integration Open Preview

InsightVM now integrates with Kubernetes to extend your container security. With this integration, you’ll be able to see the clusters an image has been deployed to, as well as how many containers are running a specific image. You’ll increase your awareness of vulnerabilities potentially present in your containers so you can monitor and prioritize accordingly.

In this article, we’ll walk you through the steps to integrate Kubernetes with InsightVM.

Before You Begin

Verify that you have permissions to do the following:

  1. Push images to your registry.
  2. Deploy images to your Kubernetes clusters.
  3. Configure your Kubernetes host.

Insight Platform Administrator Rights

Before starting the integration, confirm that you have admin privileges for the Rapid7 Insight platform, not the Security Console.

Deployed Agents

You must have at least one deployed agent to enable the Kubernetes Monitor. If you don’t have a deployed agent, you’ll need to download one, but installation is not required.

View your deployed agents:

  1. Go to the Insight Platform home.
  2. In the left nav menu, click Data Collection Management (electrical plug icon).
  3. Look at the Agents tab, where you’ll see a number in the parenthesis. This number indicates the number of deployed agents.

If you do not have any deployed agents, you’ll need to download one, but do not need to deploy it:

  1. In the Agents tab, click Add New ^.
  2. Select Agent from the menu dropdown.
  3. Select your OS system.
  4. In the Advanced tab, click Download agent.

Integrate Kubernetes with InsightVM

After confirmation that you meet the above requirements, do the following:

  1. Go to insight.rapid7.com and sign in with your Insight account email address and password.
  2. Click Data Collection Management (electric plug icon) in the left menu.
  3. Click the Kubernetes Monitor tab.
  4. Click Integrate to be guided through the integration process.

Diagram of where to click for Steps 2 through 4

Access the Kubernetes Containers Tab

After you’ve completed the Kubernetes integration process, you can view your Kubernetes details in InsightVM. To do so:

  1. Log into InsightVM.
  2. Click Container Security in the left navigation menu.
  3. Select the Kubernetes Containers tab to view its relevant information.

View the Kubernetes Containers Tab

The Kubernetes Containers tab shows data for only running containers

If you are running a container, that data will display until you exit it. Once you stop or delete a container, data will no longer be displayed. This tab only shows information on the containers currently running in your environment.

These containers are discovered only through the Kubernetes Monitor, not the scan engine.

  1. On the Kubernetes Containers tab, select the appropriate checkbox(es) which will update the results accordingly.

  2. In the table, you’ll see the following:

  • Name - Unique identifier for the container.
  • Risk Score - A calculated value based on a number of factors, such as base impact, likelihood of compromise, and maturity of threat exposure over time.
  • Vulnerability Instance - Denotes the number of vulnerability instances found on an image.
  • Repository - Where the container resides.
  • Age - Denotes the container’s age in days, hours, minutes, and seconds.
  • ID - Unique image identifier. If there are dashes (-) in the Risk Score, Vulnerability Instance, and ID columns, this indicates that the container is running an image that has not been assessed before.

Image Scanning

To scan an image on a specific registry, you must connect that registry so it can be scanned. There are 2 ways to accomplish this:

View Images Details

  1. After filtering, click an image ID to see its details.
  2. In the dropdown menu, select one of the following options to view more details.
  • Packages
  • Layers
  • Vulnerabilities
  • Hosts - Indicates the actual machine the Docker image is running on.
  • Containers - Lists instantiated containers based on that image. Applies only to images in Kubernetes clusters.
  • Namespaces - Lists the namespaces for instantiated containers based on that image. Applies only to images in Kubernetes clusters.