analyze-code-security-scc
Description
This GitHub action identifies insecure configurations in Infrastructure as Code (IaC) files for Google Cloud resources. This action requires Terraform plan files in JSON format for scanning.
Use this action to detect and remediate issues in IaC files for Google Cloud before you deploy the resources.
This action lets you:
- Scan IaC template files (such as Terraform plan files).
- Display issues with their severity as a SARIF Report in the GitHub Workspace after a scan completes.
- Define severity-based failure criteria for passing or failing the build.
This is not an officially supported Google product, and it is not covered by a
Google Cloud support contract. To report bugs or request features in a Google
Cloud product, please contact Google Cloud
support.
[!IMPORTANT]
This action requires the Security Command Center Premium tier or Enterprise
tier. In the Premium tier, you must be a subscription customer to use this
action. You must activate Security Command Center at the organization level to
use this feature.
[!CAUTION]
Don’t enter any sensitive information such as passwords and other personal identifiable information in the Terraform plan files.
Prerequisites
This action requires a Google Cloud service account which has the Security Posture Shift-Left Validator role or the Security Posture Admin role on the Google Cloud organization that includes the IaC resources. For more information, see Authorization.
This action runs using Node 24. If you are using self-hosted GitHub Actions
runners, you must use a runner
version that supports this
version or later.
Usage
jobs:
job_id:
permissions:
contents: 'read'
id-token: 'write'
steps:
- uses: 'actions/checkout@v4'
- id: 'auth'
uses: 'google-github-actions/auth@v3'
with:
workload_identity_provider: 'projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider'
service_account: 'my-service-account@my-project.iam.gserviceaccount.com'
- id: 'analyze-code-security-scc'
uses: 'google-github-actions/analyze-code-security-scc@v1'
with:
organization_id: '123456789'
scan_file_ref: './tf_plan.json'
iac_type: 'terraform'
scan_timeout: '1m'
ignore_violations: false
failure_criteria: 'High:1,Medium:1,Low:1,Operator:or'
fail_silently: false
- if: |-
${{ !cancelled() && steps.analyze-code-security-scc.outputs.iac_scan_result_sarif_path != '' }}
uses: 'actions/upload-artifact@v4'
with:
name: 'sarif'
path: '${{ steps.analyze-code-security-scc.outputs.iac_scan_result_sarif_path }}'
Inputs
organization_id: (Required) Google Cloud organization ID for the organization which includes the
resources that you want to modify. For example, '1234'.
scan_file_ref: (Required) Path to a file, relative to the local workspace, for the IaC file to scan.
For example:
./tf_plan.json
or
./artifacts/tf_plan.json
iac_type: (Required, default: terraform) The IaC template type. Currently only Terraform is supported.
scan_timeout: (Optional, default: 3m) The maximum time before the scanning stops. The value must be between "1m"
and 10m.
ignore_violations: (Optional) Whether violations found in IaC file should be ignored when determining
the build status. This input doesn't apply to violations that are related
to generating SARIF reports and determining the iac_scan_result.
failure_criteria: (Optional, default: Critical:1, High:1, Medium:1, Low:1, Operator:OR) The failure criteria that determines the workflow build status. You can
set a threshold for the number of critical, high, medium, and low severity
issues and use an aggregator (either and or or) to evaluate the
criteria.
To determine whether a build has failed, the threshold for each severity
is evaluated against the count of issues with that severity in the IaC
scan results and then severity level evaluations are aggregated using
AND or OR to arrive at failure_criteria value. You must include an
aggregator in the string. The aggregator value is case-sensitive.
For example, if you set the failure criteria to HIGH:1,LOW:1,OPERATOR:OR,
the workflow fails if there is 1 or more HIGH severity findings or 1 or
more LOW severity findings. If you set the failure criteria to
HIGH:1,LOW:1,OPERATOR:AND, the workflow fails if there is 1 or more HIGH
severity findings and 1 or more LOW severity findings.
If the failure_criteria evaluates to true, the workflow is marked as
FAILED. Otherwise, the workflow is marked as SUCCESS.
fail_silently: (Optional) If set to true, the workflow will not fail in case of any internal error
including invalid credentials and plugin dependency failure.
Note: This GitHub Action will always fail in case of any input validation
errors.
Outputs
Authorization
Use google-github-actions/auth
to authenticate the action. You can use Workload Identity Federation or
Service account key JSON for authentication.
jobs:
job_id:
permissions:
contents: 'read'
id-token: 'write'
steps:
- id: 'auth'
uses: 'google-github-actions/auth@v3'
with:
workload_identity_provider: 'projects/123456789/locations/global/workloadIdentityPools/my-pool/providers/my-provider'
service_account: 'my-service-account@my-project.iam.gserviceaccount.com'
- id: 'analyze-code-security-scc'
uses: 'google-github-actions/analyze-code-security-scc@v1'
Supported asset types and policies
For information about supported asset types and policies, see IaC Validation - Supported assets and policies.