
checkov v3.3.28
基础设施即代码的静态分析工具,可在构建时检测跨Terraform、Kubernetes、CloudFormation和容器镜像的云配置错误、漏洞和机密信息。
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 中的扫描结果

Jenkins 中的定时扫描结果

快速开始
环境要求
- 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
