1. Overview

Jenkins Freestyle projects let you create general-purpose build jobs with maximum flexibility.

2. Setting up a Freestyle project for container images

Create a Freestyle project that builds a Docker image and then scans it for vulnerability and compliance issues.

  1. Go to the Jenkins top page.

  2. Create a new project.

    1. Click New Item.

    2. In Enter an item name, enter a name for your project.

    3. Select Freestyle project.

    4. Click OK.

  3. Add a build step.

    1. Scroll down to the Build section.

    2. In the Add build step drop-down list, select Execute shell.

    3. In the Command text box, enter the following:

      echo "Creating Dockerfile..."
      echo "FROM imiell/bad-dockerfile:latest" > Dockerfile
      docker build --no-cache -t test/test-image:0.1 .
  4. Add a build step that scans the container image(s) for vulnerabilities.

    1. In the Add build step drop-down list, select Scan Prisma Cloud Images.

    2. In the Image field, select the image to scan by specifying the repository and tag.

      Use pattern matching expressions. For example, enter test/test-image*.

      If the image you want to scan is created outside of this build, or if you want to scan the image every build, even if the build might not generate an new image, then click Advanced, and select Ignore image creation time. For more information about advanced options, see here.
  5. Add a post-build action to publish the scan results in Jenkins directly.

    This post-build step depends on a file generated by the previous scan build step, which holds the scan results. This step specifically makes the results available for review in the Jenkins build tool. Note that the previous scan step already published the results in Console, and they’re ready to be reviewed there.

    1. Scroll down to Post-build Actions.

    2. In the Add post-build action drop-down menu, select Publish Prisma Cloud analysis results.

    3. In Scan Result Files, accept the default.

      Scan result files aren’t deleted by the publish step. They stay in the workspace.

  6. Click Save.

  7. Click Build Now.

  8. After the build completes, examine the results. Scan reports are available in the following locations:

    • Prisma Cloud Console: Log into Console, and go to Monitor > Vulnerabilities > Images > CI.

    • Jenkins: Drill down into the build job, then click Image Vulnerabilities to see a detailed report.

      jenkins dashboard scan results

3. Setting up a Freestyle project for serverless functions

The procedure for setting up Jenkins to scan serverless functions is similar to the procedure for container images, except you should use the Scan Prisma Cloud Functions build step.

jenkins plugin scan functions build step

Where:

  • Function Path — Path to the ZIP archive of the function to scan.

  • Function Name — (Optional) String identifier for matching policy rules in Console with the functions being scanned. When creating policy rules in Console, you can target specific rules to specific functions by function name. If this field is left unspecified, the plugin matches the function to the first rule where the function name is a wildcard.

  • AWS CloudFormation template file — (Optional) Path to CloudFormation template file in either JSON or YAML format. Prisma Cloud scans the function source code for AWS service APIs being used, compares the APIs being used to the function permissions, and reports when functions have permissions for APIs they don’t need.