Code and binary security analysis

The CloudBees platform performs an implicit security analysis, automatically triggering scans on code assets when you create a component, or when you commit changes to a linked repository. It also automatically triggers scans on binary assets whenever a workflow runs successfully with the upload artifact build step.

Findings from security scans are displayed in the Security center and in the components security summary.

Implicit code security assessment

To enable implicit code security analysis:

Select an organization. Optionally, select a component.
Select Security Marketplace.
Toggle Implicit security assessment to active.

Activate one or more code security tools, such as Checkov or Gosec. The following code security tools are currently available in the CloudBees platform:

Code security scanners

Security tool

Description

Scan type

Checkov

Scans cloud infrastructure configurations, including Terraform and Cloud Formation scripts.

Code

Gitleaks

Scans Git repositories for sensitive content, such as credentials.

Code

Gosec

An open source Golang security scanner.

Code

Njsscan

An open source Node.js security scanner.

Code

SCC Scanner

An application software language analyzer. SCC Scanner is enabled on the CloudBees platform by default.

Code

Once enabled, an implicit security scan is triggered automatically when you perform the following actions:

Create a component.
Commit a change, or create a branch, in any repository linked to a component.

Implicit code security assessment currently supports two source code management integrations: GitHub and Bitbucket Data Center.

Binary security analysis

The CloudBees platform also performs binary security analysis. Currently, it uses CloudBees platform workflows, and triggers a binary scanner such as Trivy or FindSecBugs whenever a configured workflow is invoked. The following binary security tools are currently available on the CloudBees platform:

Binary security scanners

Security tool

Description

Scan type

FindSecBugs

An open source Java security scanner. Used in the CloudBees platform to scan binary .jar files.

Binary

Grype

A vulnerability scanner for container images, SBOM, and file systems.

Binary

Syft SBOM

Generates software bills of materials (SBOMs) from containers and binaries.

Binary

Trivy

A Docker image scanner.

Binary

This capability will eventually be expanded to become implicit, using AWS and JFrog master and decorator plugins to connect to an account, scan repositories of interest, detect when new images are pushed to the repository, and trigger an implicit security scan when an image is pushed.

To trigger a binary security analysis of a file produced by a workflow, add the following to the workflow:

At this time, you can only perform a single binary scan per workflow. Triggering additional scans will override the results of the previous scan.

      - id: upload-binary
        name: Upload binary using action
        uses: https://github.com/cloudbees-io/asset-chain-utils/upload-binary@v1
        with:
          file-path: directory/subdirectory/container-image.tar(1)
          file-type: BINARY_CONTAINER(2)▼

1	Replace the contents of `file-path` with the path to your binary file. The path is relative to the CloudBees workspace. `file-path` must always point to a file.
2	Two file types are supported: `BINARY_CONTAINER`: A container image file. `BINARY_JAR`: Use this if you have a workflow that checks out Java code to build a `.jar` executable.

Once added to your workflow, every time you upload a binary file to the specified path, upload-binary triggers a secondary workflow which scans the file. It will also, if enabled, create a Software bill of materials (SBOM).

Scan findings sit alongside the code security analysis results in the Security center, attributed to a component branch.

Binary findings in the security center only relate to the last produced binary. Unlike the code asset profile for a component or branch, which is retained over time and updated with the latest results, each produced binary becomes a separate asset profile with its own set of findings, so only the latest is important.