prisma-cloud-shiftleft/Prisma Cloud IaC Scan

Scan you IaC templates for security issues

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
Runtime
Deprecated runtime
namedescriptionrequireddefault
github_tokenThe GitHub Token. Required if any of the 'create*' options are turned on You can choose to use a different token than the pipeline default `GITHUB_TOKEN`. Eg: secrets.GITHUB_TOKENno${{ github.token }}
create_issueIf turned on an Issue will be created with the scan report. Note: Only created on scan failure.yesfalse
create_pull_request_checkIf turned on a Check on Pull Request will be created with the scan reportyesfalse
create_pull_request_commentIf turned on a Comment on the Pull Request will be created with the scan reportyesfalse
prisma_api_urlThe URL for Prisma Cloud varies depending on the region and cluster on which your tenant is deployed. The tenant provisioned for you is, for example, https://app2.prismacloud.io or https://app.eu.prismacloud.io. Replace 'app' in the URL with 'api' and enter it here. Refer to the Prisma Cloud REST API Reference (https://api.docs.prismacloud.io/reference#try-the-apis) for more details.yes
access_keyThe access key enables programmatic access. If you do not have a key, refer to Create and Manage Access Keys (https://docs.paloaltonetworks.com/prisma/prisma-cloud/prisma-cloud-admin/manage-prisma-cloud-administrators/create-access-keys.html) to acquire one. We recommend the actual value to be stored as a GitHub Secret and used here in the Action with secrets.PRISMA_CLOUD_ACCESS_KEYyes
secret_keyThe secret key is provided to you at the time of Access Key generation. You cannot view it on the Prisma Cloud web interface. We recommend the actual value to be stored as a GitHub Secret and used here in the Action with secrets.PRISMA_CLOUD_SECRET_KEYyes
asset_nameCan be a project name or any identifier you want to attach to the scan. Some examples are a CI/CD project name or a Git repository name. Eg: 'my-repo-name'yes
tagsPrisma Cloud tags are different from cloud tags that you might have included in your IaC templates. Prisma Cloud tags will facilitate use of upcoming Prisma Cloud features like role-based access control and policy selection. Eg: 'owner:johndoe,team:creditapp,env:dev'no
failure_criteriaEnables you to evaluate scan results against set failure criteria to obtain failed or passed verdicts. You can set the count for high, medium, and low severity issues and use 'and'/'or' operators to refine your criteria. The IaC scan API checks each severity violation number separately against scan results and applies the operator to each evaluation. The scan triggers a failure if the number of violations is greater than or equal to the failureCriteria values. The Pipeline will be set the Failed if the failure criteria matches.noHigh:1,Medium:1,Low:1,Operator:or
scan_pathPath of the directory containing the IaC files. The path is relative to the repository root.no./
use_scan_path_when_prSpecifies if files in scan_path should be scanned in context of a PR, not only changed files. Otherwise, only files changed in context of PR are scanned, which includes files outside of scan_path and excludes unchanged files in scan_path. Default is false.nofalse
upload_scan_path_onlySpecifies if only files in scan_path should be uploaded to be scanned. By default the entire GitHub workspace directory is zipped and uploaded. This option may be necessary if there are other files in the workspace directory besides IaC template files. Too many files may cause the action to timeout.nofalse
template_typeSpecify the template type. Valid values are as follows: 'TF' for Terraform 'CFT' for AWS CloudFormation 'K8S' for Kubernetesyes
template_versionSpecify the template version. Valid values are: '0.11', '0.12' and '0.13' Note: Only used for 'TF' templateType.no
variablesTemplate variables in comma separate key:value pairs. Eg: 'k1:v1,k2:v2'no
variable_filesComma separated list of variable file paths. Paths are relative to the repository root. Eg: './var1.json,./var2.json'no
result_pathThe directory relative to the workspace where scan result files will be storedno./prismacloud_iac
ignore_sslShould internal API client ignore SSL errors. Useful when using on GitHub Enterprise On-Prem behind SSL intercepting firewalls.nofalse
namedescription
iac_scan_resultOverall result of the scan. Can be one of: 1. passed - When either no issues were found or the Failure Criteria threshold was not reached 2. failed - When issues were found and the Failure Criteria threshold for was reached 3. error - When there was a scan execution error, generally due to misconfiguration or invalid templates
iac_scan_result_summarySummary describing the result of the scan
iac_scan_result_pathPath for the directory where result files should be written
iac_scan_result_issues_csv_pathPath for the detailed Issue result CSV file
iac_scan_result_errors_csv_pathPath for the detailed Error result CSV file
iac_scan_result_sarif_pathPath for the detailed result SARIF Log file
iac_scan_result_md_pathPath for the detailed result Markdown file