返回更新列表
新发布Aug 20, 2026

checkov v3.3.12

基础设施即代码的静态分析工具,可在构建时检测跨Terraform、Kubernetes、CloudFormation和容器镜像的云配置错误、漏洞和机密信息。

分享

checkov

Maintained by Prisma Cloud build status security status code_coverage docs PyPI Python Version Terraform Version Downloads Docker Pulls slack-community

Checkov 是一款用于基础设施即代码(IaC)的静态代码分析工具,同时也是一款针对镜像和开源软件包的软件成分分析(SCA)工具。

它可扫描使用 Terraform、Terraform plan、Cloudformation、AWS SAM、Kubernetes、Helm charts、Kustomize、Dockerfile、Serverless、Bicep、OpenAPI、ARM Templates 或 OpenTofu 所配置的云基础设施,并使用基于图的扫描来检测安全与合规方面的错误配置。

它可执行软件成分分析(SCA)扫描,即针对开源软件包和镜像扫描常见漏洞与暴露(CVE)。

Checkov 还为 Prisma Cloud Application Security 提供支持,这是一个开发者优先的平台,在整个开发生命周期中将云安全编码化并加以简化。Prisma Cloud 可识别、修复并预防云资源和基础设施即代码文件中的错误配置。

目录

功能特性

  • 超过 1000 条内置策略涵盖 AWS、Azure 和 Google Cloud 的安全与合规最佳实践。
  • 扫描 Terraform、Terraform Plan、Terraform JSON、CloudFormation、AWS SAM、Kubernetes、Helm、Kustomize、Dockerfile、Serverless framework、Ansible、Bicep、ARM 和 OpenTofu 模板文件。
  • 扫描 Argo Workflows、Azure Pipelines、BitBucket Pipelines、Circle CI Pipelines、GitHub Actions 和 GitLab CI 工作流文件
  • 支持基于内存图扫描的上下文感知策略。
  • 支持用于属性策略的 Python 格式,以及用于属性策略和复合策略的 YAML 格式。
  • 检测 EC2 Userdata、Lambda 环境变量和 Terraform providers 中的 AWS 凭证。
  • 使用正则表达式、关键词和基于熵的检测来识别密钥。
  • 评估 Terraform Provider 设置,以规范通过 Terraform 管理的 IaaS、PaaS 或 SaaS 的创建、管理和更新。
  • 策略支持将变量评估为其可选的默认值。
  • 支持对已接受的风险或误报进行行内抑制,以减少重复的扫描失败。还支持通过 CLI 进行全局跳过。
  • 输出目前支持 CLI、CycloneDX、JSON、JUnit XML、CSV、SARIF 和 github markdown,并提供修复指南的链接。

截图

CLI 中的扫描结果

scan-screenshot

Jenkins 中的定时扫描结果

jenikins-screenshot

快速开始

环境要求

  • Python >= 3.10, <=3.13
  • Terraform >= 0.12

安装

要安装 pip,请遵循官方文档

pip3 install checkov

某些环境(例如 Debian 12)可能需要你在虚拟环境中安装 Checkov

# Create and activate a virtual environment
python3 -m venv /path/to/venv/checkov
cd /path/to/venv/checkov
source ./bin/activate

# Install Checkov with pip
pip install checkov

# Optional: Create a symlink for easy access
sudo ln -s /path/to/venv/checkov/bin/checkov /usr/local/bin/checkov

或使用 Homebrew(macOS 或 Linux)

brew install checkov

启用 bash 自动补全

source <(register-python-argcomplete checkov)

升级

如果你使用 pip3 安装了 checkov

pip3 install -U checkov

或使用 Homebrew

brew upgrade checkov

配置输入文件夹或文件

checkov --directory /user/path/to/iac/code

或指定一个或多个文件

checkov --file /user/tf/example.tf

或

checkov -f /user/cloudformation/example1.yml -f /user/cloudformation/example2.yml

或者一个 json 格式的 terraform plan 文件

terraform init
terraform plan -out tf.plan
terraform show -json tf.plan  > tf.json
checkov -f tf.json

注意:terraform show 的输出文件 tf.json 将是单行。 因此,Checkov 报告的所有发现都将位于第 0 行。

check: CKV_AWS_21: "Ensure all data stored in the S3 bucket have versioning enabled"
	FAILED for resource: aws_s3_bucket.customer
	File: /tf/tf.json:0-0
	Guide: https://docs.prismacloud.io/en/enterprise-edition/policy-reference/aws-policies/s3-policies/s3-16-enable-versioning

如果你已经安装了 jq,可以使用以下命令将 json 文件转换为多行格式:

terraform show -json tf.plan | jq '.' > tf.json

扫描结果会友好得多。

checkov -f tf.json
Check: CKV_AWS_21: "Ensure all data stored in the S3 bucket have versioning enabled"
	FAILED for resource: aws_s3_bucket.customer
	File: /tf/tf1.json:224-268
	Guide: https://docs.prismacloud.io/en/enterprise-edition/policy-reference/aws-policies/s3-policies/s3-16-enable-versioning

分类