Skip to content

Latest commit

 

History

History
87 lines (57 loc) · 2.72 KB

README.md

File metadata and controls

87 lines (57 loc) · 2.72 KB

cfn_nag GitHub Action

This action executes cfn_nag_scan linter against the repo for which the workflow is run. It exposes all the options for cfn_nag_scan (see extra_args below) and allows you to point to a specific directory containing templates to scan.

For more background on the tool, please see:

Finding Security Problems Early in the Development Process of a CloudFormation Template with "cfn-nag"

and:

cfn_nag GitHub repository

Inputs

input_path

The directory of the repo to search for violations. Default: $GITHUB_WORKSPACE

extra_args

Additional arguments to pass to cfn_nag_scan. See the usage for cfn_nag_scan for more options. Default: --print-suppression

output_path

Destination file path for cfn_nag_scan output. Default: cfn_nag.out

Example Usages

Basic

Search the root of the GitHub runner's workspace for files to scan (not recommended, incase there are other, non-template files with matching extensions).

- uses: stelligent/cfn_nag@master

Define path to search

In this form it will search the templates directory within the GitHub runner's workspace for files to scan.

- uses: stelligent/cfn_nag@master
  with:
    input_path: templates

Define path to search and add extra arguments

In addition to pointing it to search the templates directory within the GitHub runner's workspace, it will also produce the output in JSON and fail if any warnings are produced (in addition to violations).

- uses: stelligent/cfn_nag@master
  with:
    input_path: templates
    extra_args: --fail-on-warnings -o json

Define path to search and remove default extra args

Search the templates directory within the GitHub runner's workspace and remove the default --print-suppression extra argument.

- uses: stelligent/cfn_nag@master
  with:
    input_path: templates
    extra_args: ''

Define path to search and upload to code scanning

Search the templates directory and upload the results to GitHub's Code Scanning.

- uses: stelligent/cfn_nag@master
  with:
    input_path: templates
    extra_args: -o sarif
    output_path: cfn_nag.sarif
- uses: github/codeql-action/upload-sarif@v1
  with:
    sarif_file: cfn_nag.sarif

Support

To report a bug or request a feature, submit an issue through the GitHub repository via: https://github.com/stelligent/cfn_nag/issues/new

Pull requests are welcome as well: https://github.com/stelligent/cfn_nag/pulls