Skip to content

Latest commit

 

History

History
131 lines (99 loc) · 12 KB

README.md

File metadata and controls

131 lines (99 loc) · 12 KB

Sysdig Secure Inline Scan Action

🚧 Warning: To use the Legacy Scanning Engine Action, please use version v3.* and visit the previous README.

This action performs analysis on a specific container image and posts the result to Sysdig Secure. For more information about Sysdig CLI Scanner, see Sysdig Secure documentation.

Inputs

Input Description Default
cli-scanner-url URL to sysdig-cli-scanner binary download. The action will detect the runner OS and architecture. For more info about the Sysdig CLI Scanner download visit the official documentation.
mode Mode of operation. Can be "vm" or "iac". vm
cli-scanner-version Custom sysdig-cli-scanner version to download. If using iac mode, minimum required version is 1.9.0. Please note that for VM mode the Action has only been tested with the current default version and it is not guaranteed that it will work as expected with other versions. 1.13.0
registry-user Registry username to authenticate to while pulling the image to scan.
registry-password Registry password to authenticate to while pulling the image to scan.
stop-on-failed-policy-eval Fail the job if the Policy Evaluation is Failed.
stop-on-processing-error Fail the job if the Scanner terminates execution with errors.
severity-at-least Filtering option to only report vulnerabilities with at least the specified severity. Can take critical, high, medium, low, negligible or any. Default value "any" for no filtering. For example, if severity-at-least is set to medium, only Medium, High or Critical vulnerabilities will be reported. any
group-by-package Enable grouping the vulnerabilities in the SARIF report by package. Useful if you want to manage security per package or condense the number of findings.
standalone Enable standalone mode. Do not depend on Sysdig backend for execution, avoiding the need of specifying 'sysdig-secure-token' and 'sysdig-secure-url'. Recommended when using runners with no access to the internet. May require to specify custom cli-scanner-url and db-path.
db-path Specify the directory for the vulnerabilities database to use while scanning. Useful when running in standalone mode.
skip-upload Skip uploading scanning results to Sysdig Secure.
skip-summary Skip generating Summary.
use-policies Specify Sysdig Secure VM Policies to evaluate the image.
override-pullstring Custom PullString to give the image when scanning and uploading. Useful when building images in a pipeline with temporary names. The custom PullString will be used to identify the scanned image in Sysdig Secure.
image-tag Tag of the image to analyse.
sysdig-secure-token API token for Sysdig Scanning authentication. (Required if not in Standalone mode.)
sysdig-secure-url Sysdig Secure Endpoint URL. Defaults to https://secure.sysdig.com. Please, visit the official documentation for more details on endpoints and regions. https://secure.sysdig.com
sysdig-skip-tls Skip TLS verification when calling Sysdig Secure endpoints.
extra-parameters Additional parameters to be added to the CLI Scanner. Note that these may not be supported with the current Action.
recursive Recursively scan all folders within the folder specified in the iacScanPath.
minimum-severity Minimum severity to fail when scanning in IaC mode.
iac-scan-path Path to the IaC files to scan.

SARIF Report

The action generates a SARIF report that can be uploaded using the codeql-action/upload-sarif action.

You need to assign an ID to the Sysdig Scan Action step, like:

    ...

    - name: Scan image
      id: scan
      uses: sysdiglabs/scan-action@v5
      with:
        ...

and then add another step for uploading the SARIF report, providing the path in the sarif_file parameter:

    ...
      - name: Upload SARIF file
        if: success() || failure() 
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: ${{ github.workspace }}/sarif.json

The if: success() || failure() option makes sure the SARIF report is uploaded even if the scan fails and interrupts the workflow. (Q: Why not always()? A: That would allow for canceled jobs as well.)

Example usages

Build and scan image locally using Docker, and upload SARIF report

    ...

    - name: Build the Docker image
      run: docker build . --file Dockerfile --tag sysdiglabs/dummy-vuln-app:latest

    - name: Scan image
      id: scan
      uses: sysdiglabs/scan-action@v5
      with:
          image-tag: sysdiglabs/dummy-vuln-app:latest
          sysdig-secure-token: ${{ secrets.SYSDIG_SECURE_TOKEN }}

      - name: Upload SARIF file
        if: success() || failure() 
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: ${{ github.workspace }}/sarif.json

Pull and scan an image from a registry

    ...

    - name: Scan image
      uses: sysdiglabs/scan-action@v5
      with:
        image-tag: "sysdiglabs/dummy-vuln-app:latest"
        sysdig-secure-token: ${{ secrets.SYSDIG_SECURE_TOKEN }}

Scan infrastructure using IaC scan

    ...

    - name: Scan infrastructure
      uses: sysdiglabs/scan-action@v5
      with:
        sysdig-secure-token: ${{ secrets.SYSDIG_SECURE_TOKEN }}
        cli-scanner-version: 1.9.0
        mode: iac
        iac-scan-path: ./terraform

Fail pipeline when Policy Evaluation is failed or scanner fails to run

    ...

    - name: Scan image
      uses: sysdiglabs/scan-action@v3
      with:
        image-tag: "sysdiglabs/dummy-vuln-app:latest"
        sysdig-secure-token: ${{ secrets.SYSDIG_SECURE_TOKEN }}
        stop-on-failed-policy-eval: true
        stop-on-processing-error: true