
checkov v3.3.12
인프라를 코드로 관리하는 정적 분석 도구로, Terraform, Kubernetes, CloudFormation, 컨테이너 이미지에서 클라우드 구성 오류, 취약점, 시크릿을 빌드 시점에 탐지합니다.
Checkov는 IaC(Infrastructure as Code)를 위한 정적 코드 분석 도구이자, 이미지와 오픈 소스 패키지를 위한 소프트웨어 구성 분석(SCA) 도구입니다.
Terraform, Terraform plan, Cloudformation, AWS SAM, Kubernetes, Helm charts, Kustomize, Dockerfile, Serverless, Bicep, OpenAPI, ARM Templates 또는 OpenTofu를 사용하여 프로비저닝된 클라우드 인프라를 스캔하며, 그래프 기반 스캐닝을 통해 보안 및 규정 준수 관련 오구성을 탐지합니다.
또한 오픈 소스 패키지와 이미지에서 CVE(Common Vulnerabilities and Exposures)를 스캔하는 소프트웨어 구성 분석(SCA) 스캐닝을 수행합니다.
Checkov는 개발 라이프사이클 전반에 걸쳐 클라우드 보안을 코드화하고 간소화하는 개발자 우선 플랫폼인 Prisma Cloud Application Security의 기반이기도 합니다. Prisma Cloud는 클라우드 리소스와 IaC(Infrastructure as Code) 파일의 오구성을 식별, 수정 및 예방합니다.
목차
기능
- 1000개 이상의 내장 정책이 AWS, Azure 및 Google Cloud에 대한 보안 및 규정 준수 모범 사례를 다룹니다.
- Terraform, Terraform Plan, Terraform JSON, CloudFormation, AWS SAM, Kubernetes, Helm, Kustomize, Dockerfile, Serverless 프레임워크, Ansible, Bicep, ARM 및 OpenTofu 템플릿 파일을 스캔합니다.
- Argo Workflows, Azure Pipelines, BitBucket Pipelines, Circle CI Pipelines, GitHub Actions 및 GitLab CI 워크플로 파일을 스캔합니다.
- 인메모리 그래프 기반 스캐닝을 기반으로 하는 컨텍스트 인식 정책을 지원합니다.
- 속성 정책에 대해 Python 형식을, 속성 및 복합 정책 모두에 대해 YAML 형식을 지원합니다.
- EC2 Userdata, Lambda 환경 변수 및 Terraform 공급자에서 AWS 자격 증명을 탐지합니다.
- 정규식, 키워드 및 엔트로피 기반 탐지를 사용하여 시크릿을 식별합니다.
- Terraform을 통해 관리되는 IaaS, PaaS 또는 SaaS의 생성, 관리 및 업데이트를 규제하기 위해 Terraform 공급자 설정을 평가합니다.
- 정책은 변수를 선택적 기본값으로 평가하는 것을 지원합니다.
- 허용된 위험 또는 오탐에 대한 인라인 억제를 지원하여 반복적인 스캔 실패를 줄입니다. 또한 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)
업그레이드
checkov를 pip3로 설치한 경우
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
