Scanning Procedure
Table of Contents
Scanning Procedure
This article describes the vulnerability image scanning flow for deployed containers, registries, and CI.
The scanning flow is similar for both Docker and Dockerless images, except for a single difference, described in Scan reports for CRI environments.
Image scanning procedure
Prisma Cloud uses a variety of approaches that are purpose-built differently for detecting packages on images and hosts.
The Host Defender only scans applications, as well as language-based packages, if the processes are running.
The Windows Defender only scans packages that are installed with a package manager, missing Microsoft hotfixes, and .net framework applications.
The following diagram (Chart 1) shows the Defender scanning flow:
The following diagram (Chart 2) shows the twistcli scanning flow:
The steps in the scanning flow are:
- An image scanning request is initiated. This can be done by one of the following:
- Console - generates periodic scan requests (see Chart 1)
- Defender - when a new container starts (in this step we skip step 1 in Chart 1 since the Defender initiates the scan)
- twistcli - triggered manually or in the CI pipeline (see Chart 2)
- Defender harvests the image components versions to create the image manifest by scanning the image, and the Defender looks for:
- Component and version details from OS package managers.
- Executables (identified by magic signatures on the file system)notinstalled by the package manager:
- Selects the executables that are supported by Prisma Cloud.
- Identifies each executable’s version details from the binary metadata.
- Based on the information from step 2, Defender generates animage manifestand sends it to the Console.
- The Console identifies the vulnerabilities in each image by correlating the image manifest with the Intelligence Stream:
- The intelligence CVE stream is composed of per-distro CVEs (such as Red Hat and Ubuntu), un-packaged software CVEs (see supported packages and languages), and various open-source library CVEs (such as Node.js and python). The Console is continually updated by the Intelligence Stream to provide the most up-to-date results.The following table lists the manifest files known to the scanner.
Package manager | File name |
|---|---|
Go | go.sum |
Java (Gradle) | build.gradle, build.gradle.kts, gradle.properties |
Java (Maven) | pom.xml |
JavaScript (NPM) | package.json, package-lock.json, npm-shrinkwrap.json, bower.json |
Python (pip) | req*.txt |
- The correlation results are calculated, stored in a database, and displayed in the Console UI.
The Console manages the current scan state and distributes the work to Defenders.
Scan reports for CRI environments
Deployed images
— The scanning logic is the same for Dockers and Dockerless environments,
the only difference lies in the scanned object.
In Docker environments, Prisma Cloud scans images by running the image with Defender as the entrypoint.
Dockerless doesn’t support this method, so for Dockerless environments, Prisma Cloud scans the running container.
As a result, when scanning deployed images in Dockerless environments, the Defender detects the packages added to a running container only when the packages are added before the initial scan.The Console stores the CI image scan and registry scan results. An image previously scanned as a registry image will not be re-scanned by the Defender at the runtime.
Registry scan
— The scanning logic is the same for Docker and Dockerless environments
Any Container Defender running on a host with the Docker Engine container runtime or container runtime interface (CRI) can scan a registry.
Learn more about registry scanning.When a scan result for an image with a certain SHA-ID exists, the Console checks if there is a version of the Defender that is newer than the one that scanned the image. If there is a newer Defender available, then the Console sends a scan request to the Defender to re-scan the image with the same SHA-ID, if not this image is not re-scanned.
Twistcli scans
— Scans conducted by twistcli are similar for Docker and Dockless (CRI).
In both environments, twistcli scans run from outside the container image.
For Dockerless environments, Podman must be installed on the host, to allow scans to run from outside the container image. Learn more in the twistcli scan images document.