Skip to main content

Checkmarx One Azure DevOps Plugin

The Checkmarx One Azure DevOps (ADO) plugin enables you to integrate the full functionality of the Checkmarx One platform into your ADO pipelines. You can use this plugin to trigger scans running Checkmarx SAST, Checkmarx SCA, IaC Security, API Security, Container Security and Software Supply Chain Security scanners as part of your CI/CD integration.

This plugin provides a wrapper around the Checkmarx One CLI Tool which creates a zip archive from your source code repository and uploads it to Checkmarx One for scanning. This provides easy integration with ADO while enabling scan customization using the full functionality and flexibility of the CLI tool.

Note

The plugin code can be found here.

Main Features

  • Configure ADO pipelines to automatically trigger scans running Checkmarx SAST, Checkmarx SCA, IaC Security, API Security, Container Security and Software Supply Chain Security scanners

  • Supports adding a Checkmarx One scan as a pre-configured task or as a YAML

  • Supports use of CLI arguments to customize scan configuration, enabling you to:

    • Customize filters to specify which folders and files are scanned

    • Apply preset query configurations

    • Customize SCA scans using Checkmarx SCA Resolver

    • Set thresholds to break build

  • Send requests via a proxy server

  • View scan results summary and trends in the ADO environment

  • Direct links from within ADO to detailed Checkmarx One scan results

  • Generate customized scan reports in various formats (JSON, HTML, PDF etc.)

  • Generate SBOM reports (CycloneDX and SPDX)

  • Supports Team Foundation Version Control (TFVC) based repos.

Prerequisites

  • You have a Checkmarx One account and you have an OAuth Client ID and Client Secret for that account (see Creating an OAuth Client for Checkmarx One Integrations) or you have a Checkmarx One API Key (see Generating an API Key).

    Note

    The following are the minimum required roles for running an end-to-end flow of scanning a project and viewing results via the CLI or plugins:

    • CxOne composite role ast-scanner

    • CxOne role view-policy-management

    • IAM role default-roles

In this section: