IaC セキュリティ: Checkov、Trivy、OPA のコードとしてのポリシー
セキュリティ スキャンを Terraform ループに統合: チェック用の Checkov 1000 を超えるポリシーの統計、tfsec の後継としての Trivy、および OPA/conftest 事前適用ゲートの組織のカスタム ポリシーの場合。
IaC セキュリティが重要な理由
2023 年、パロアルトネットワークスは、クラウドの 65% が侵害されたことを文書化しました。 IaC の設定ミスが原因: パブリック S3 バケット、セキュリティ グループも 寛容、ログ記録は無効、暗号化は設定されていません。特徴 これらのエラーの致命的な点は、そうです。 彼らはスケールします: Terraform モジュール 50 の環境で insecure を使用すると、50 の脆弱性が同時に作成されます。
解決策はそれです シフトレフトセキュリティ: コントロールを移動します 構成ミスが発生する前に、ワークフローのできるだけ早い段階でセキュリティを確保する 雲に到達します。この記事では、次の 3 つの補完的なツールを統合します。 広範囲をカバーする Checkov、脆弱性を発見する Trivy、および OPA カスタム組織ポリシー用。
3 つのツールとその役割
- チェコフ: AWS/Azure/GCP/K8 用の 1000 以上の組み込みポリシー。 IaCに特化。 Bridgecrew (パロアルトが買収) によって保守されています。
- 豆知識: tfsec (Aqua Security) の後継。統合スキャナー: IaC、コンテナー、依存関係、シークレット。 tfsec → Trivy 移行は 2024 年に完了。
- OPA+コンテストテスト: 汎用ポリシー エンジン。カスタム組織ルール (命名規則、必須タグ、許可されたリージョン) のポリシーを Rego に作成します。
Checkov: 1000 以上のポリシーによるセキュリティ スキャン
Checkov は、init や plan を実行せずに、Terraform (.tf) ファイルを静的に解析します。 一般的な脆弱性をカバーします: 暗号化されていないストレージ、意図しないパブリック アクセス、 ログが無効になっているため、IAM が寛容すぎます。
# Installazione
pip install checkov
# Oppure con Docker (raccomandato per CI)
docker pull bridgecrew/checkov:latest
# Scansione base di una directory Terraform
checkov -d ./environments/production --framework terraform
# Solo errori HIGH e CRITICAL (ignora LOW e MEDIUM)
checkov -d . --check HIGH,CRITICAL
# Output SARIF per integrare con GitHub Code Scanning
checkov -d . --output sarif --output-file checkov.sarif
# Skip di check specifici (con motivazione documentata)
checkov -d . --skip-check CKV_AWS_20,CKV_AWS_57
# CKV_AWS_20: bucket S3 public read - skippiamo solo se il bucket è intenzionalmente pubblico
# Esempio: codice Terraform con vulnerabilità e relativo fix
# VULNERABILE - Checkov alert: CKV_AWS_18, CKV_AWS_52, CKV_AWS_144
resource "aws_s3_bucket" "logs" {
bucket = "my-app-logs"
# MANCA: server_side_encryption_configuration
# MANCA: versioning
# MANCA: replication_configuration per disaster recovery
}
# SICURO - Tutti i check Checkov superati
resource "aws_s3_bucket" "logs" {
bucket = "my-app-logs"
}
resource "aws_s3_bucket_server_side_encryption_configuration" "logs" {
bucket = aws_s3_bucket.logs.id
rule {
apply_server_side_encryption_by_default {
sse_algorithm = "aws:kms" # CKV_AWS_19: usa KMS, non AES256
}
bucket_key_enabled = true
}
}
resource "aws_s3_bucket_versioning" "logs" {
bucket = aws_s3_bucket.logs.id
versioning_configuration {
status = "Enabled" # CKV_AWS_21
}
}
resource "aws_s3_bucket_public_access_block" "logs" {
bucket = aws_s3_bucket.logs.id
block_public_acls = true # CKV_AWS_53
block_public_policy = true # CKV_AWS_54
ignore_public_acls = true # CKV_AWS_55
restrict_public_buckets = true # CKV_AWS_56
}
resource "aws_s3_bucket_logging" "logs" {
bucket = aws_s3_bucket.logs.id
target_bucket = aws_s3_bucket.access_logs.id # CKV_AWS_18
target_prefix = "s3-access-logs/"
}
# checkov.yaml - Configurazione progetto (in root del repo)
# Skippa check non applicabili con motivazione documentata
skip-check:
- CKV_AWS_144 # S3 cross-region replication: non richiesto per log bucket interni
# Controlla solo risorse dei moduli custom (escludi moduli registry)
directory:
- modules/
# Severity minima da riportare
soft-fail-on: LOW,MEDIUM # Non fallisce la pipeline per LOW/MEDIUM
# Abilita output colorato
compact: false
Trivy: 統合 IaC スキャナー
Trivy は tfsec の後継です (2024 年に移行が完了)。 Checkov に対する利点は、Trivy がコンテナ イメージもスキャンすることです。 アプリケーションの依存関係とシークレットを同じパイプラインに含めることで、ツールの数を削減します。
# Installazione
brew install trivy # macOS
# oppure:
curl -sfL https://raw.githubusercontent.com/aquasecurity/trivy/main/contrib/install.sh | sh
# Scansione Terraform
trivy config ./environments/production
# Con severity filter
trivy config --severity HIGH,CRITICAL ./
# Output JSON per parsing
trivy config --format json --output trivy-results.json ./
# Template Terraform specifico con maggiore dettaglio
trivy config --tf-vars ./environments/production/terraform.tfvars ./environments/production
# Scansione tutto il repo: IaC + dipendenze + segreti
trivy fs ./
# Esempio output Trivy (semplificato)
# trivy config ./environments/production
2024-01-15T10:30:00Z INFO Misconfiguration Types: terraform
environments/production/main.tf (terraform)
HIGH: Resource 'aws_security_group.app' has a wide open egress rule
------------------------------------------
Via: environments/production/main.tf:45
egress {
from_port = 0
to_port = 0
protocol = "-1"
cidr_blocks = ["0.0.0.0/0"] # VULN: egress completamente aperto
}
Fix: Limita l'egress solo alle porte e destinazioni necessarie.
MEDIUM: Resource 'aws_db_instance.main' has no deletion protection
Via: environments/production/main.tf:78
deletion_protection = false # VULN: in production deve essere true
# .trivyignore - Ignora check specifici con motivazione
# Formato: CHECK_ID # Commento obbligatorio con motivazione
AVD-AWS-0025 # S3: CORS permissivo necessario per CDN pubblica
AVD-AWS-0168 # CloudFront: TLS 1.0 permesso per client legacy pre-2022
OPA と conftest: Rego を使用したポリシーのカスタム
オープン ポリシー エージェント (OPA) によって使用される汎用ポリシー エンジンです。 Kubernetes、Istio、Terraform。 コンテスト 適用されるのは CLI です OPA ポリシーから構成ファイル (Terraform プラン JSON を含む)。 OPA を使用すると、次のことが可能になります Checkov または Trivy に存在しない組織ポリシーを実装します。 命名規則、必須タグ、許可された領域、コスト制限。
# Installazione conftest
brew install conftest
# oppure:
curl -L https://github.com/open-policy-agent/conftest/releases/download/v0.49.0/conftest_0.49.0_linux_amd64.tar.gz | tar xz
# policy/terraform/naming.rego
# Policy: tutte le risorse AWS devono seguire la naming convention aziendale
package main
import future.keywords.in
# Regex per naming convention: {team}-{environment}-{name}
naming_pattern := `^[a-z]+-(?:dev|staging|production)-[a-z0-9-]+
06 - IaC セキュリティ: Checkov、Trivy、OPA のコードとしてのポリシー | Federico Calò
06 - IaC セキュリティ: Checkov、Trivy、OPA のコードとしてのポリシー | Federico Calò
Salta al contenuto principaleこんにちは!
Federico Calò
Sviluppatore Software | Divulgatore Tecnico
Creo applicazioni web moderne e strumenti digitali personalizzati per aiutare le attività a crescere attraverso l'innovazione tecnologica. La mia passione è unire informatica ed economia per generare valore reale.
自己紹介
La mia passione per l'informatica è nata tra i banchi dell'Istituto Tecnico Commerciale di Maglie, dove ho scoperto il potere della programmazione e il fascino di creare soluzioni digitali. Fin da subito, ho capito che l'informatica non era solo codice, ma uno strumento straordinario per trasformare idee in realtà.
Durante gli studi superiori in Sistemi Informativi Aziendali, ho iniziato a intrecciare informatica ed economia, comprendendo come la tecnologia possa essere il motore della crescita per qualsiasi attività. Questa visione mi ha accompagnato all'Università degli Studi di Bari, dove ho conseguito la Laurea in Informatica, approfondendo le mie competenze tecniche e la mia passione per lo sviluppo software.
Oggi metto questa esperienza al servizio di imprese, professionisti e startup, creando soluzioni digitali su misura che automatizzano processi, ottimizzano risorse e aprono nuove opportunità di business. Perché la vera innovazione inizia quando la tecnologia incontra le esigenze reali delle persone.
スキル
Analisi Dati & Modelli Previsionali
Trasformo i dati in insights strategici con analisi approfondite e modelli predittivi per decisioni informate
プロセス自動化
Creo strumenti personalizzati che automatizzano operazioni ripetitive e liberano tempo per attività a valore aggiunto
カスタムシステム
Sviluppo sistemi software su misura, dalle integrazioni tra piattaforme alle dashboard personalizzate
const federico = {
nome: "Federico Calò",
ruolo: "Sviluppatore Software",
città: "Bari, Italia",
missione: "Aiutare attraverso l'informatica",
passioni: [
"Codice Pulito",
"Innovazione",
"Crescita Continua"
]
};
ミッション
Credo fermamente che l'informatica sia lo strumento più potente per trasformare le idee in realtà e migliorare la vita delle persone.
テクノロジーの民主化
La mia missione è rendere l'informatica accessibile a tutti: dalle piccole imprese locali alle startup innovative, fino ai professionisti che vogliono digitalizzare la propria attività. Ogni realtà merita di sfruttare le potenzialità del digitale.
ITとビジネスの融合
Non è solo questione di scrivere codice: è capire come la tecnologia possa generare valore reale. Intrecciando competenze informatiche e visione economica, aiuto le attività a crescere, ottimizzare processi e raggiungere nuovi traguardi di efficienza e redditività.
カスタムソリューション
Ogni attività è unica, e così devono esserlo le soluzioni. Sviluppo strumenti personalizzati che rispondono alle esigenze specifiche di ciascun cliente, automatizzando processi ripetitivi e liberando tempo per ciò che conta davvero: far crescere il business.
テクノロジーでビジネスを変革
Che tu gestisca un negozio, uno studio professionale o un'azienda, posso aiutarti a sfruttare le potenzialità dell'informatica per lavorare meglio, più velocemente e in modo più intelligente.
お問い合わせ →Formazione & Competenze
Il mio percorso accademico e le tecnologie che padroneggio
Certificazioni Professionali
8 certificazioni conseguite
💻 Linguaggi & Tecnologie
☕Java🐍Python📜JavaScript🅰️Angular⚛️React🔷TypeScript🗄️SQL🐘PHP🎨CSS/SCSS🔧Node.js🐳Docker🌿Gitお問い合わせ
プロジェクトをお考えですか?お気軽にお問い合わせください。
* Campi obbligatori. I tuoi dati saranno utilizzati solo per rispondere alla tua richiesta.
# Risorse che richiedono naming convention
resources_requiring_naming := {
"aws_s3_bucket",
"aws_rds_instance",
"aws_elasticache_cluster",
"aws_eks_cluster",
}
# Deny se il nome non segue la convention
deny[msg] {
resource := input.resource[resource_type][resource_name]
resource_type in resources_requiring_naming
name := resource.config.bucket[0].constant_value # per S3
not regex.match(naming_pattern, name)
msg := sprintf(
"POLICY VIOLATION: %s '%s' ha nome '%s' che non rispetta la naming convention '%s'",
[resource_type, resource_name, name, naming_pattern]
)
}
# policy/terraform/tags.rego
# Policy: tag obbligatori su tutte le risorse AWS
package main
# Tag obbligatori per compliance e cost allocation
required_tags := {
"Team",
"Environment",
"CostCenter",
"ManagedBy",
}
# Risorse che devono avere tag
taggable_resources := {
"aws_instance",
"aws_s3_bucket",
"aws_rds_instance",
"aws_eks_cluster",
"aws_lambda_function",
}
deny[msg] {
resource := input.resource[resource_type][resource_name]
resource_type in taggable_resources
# Ottieni i tag dalla configurazione Terraform (formato piano JSON)
tags := resource.config.tags[0].constant_value
# Verifica che ogni tag obbligatorio sia presente
required_tag := required_tags[_]
not tags[required_tag]
msg := sprintf(
"POLICY VIOLATION: %s '%s' manca il tag obbligatorio '%s'",
[resource_type, resource_name, required_tag]
)
}
# Policy: il tag 'Environment' deve avere un valore valido
deny[msg] {
resource := input.resource[resource_type][resource_name]
resource_type in taggable_resources
tags := resource.config.tags[0].constant_value
env := tags.Environment
not env in {"dev", "staging", "production"}
msg := sprintf(
"POLICY VIOLATION: %s '%s' tag Environment='%s' non valido. Deve essere dev|staging|production",
[resource_type, resource_name, env]
)
}
# policy/terraform/regions.rego
# Policy: deploy permesso solo nelle regioni EU (GDPR compliance)
package main
allowed_regions := {"eu-west-1", "eu-west-2", "eu-central-1", "eu-south-1"}
deny[msg] {
resource := input.resource[resource_type][resource_name]
region := resource.config.region[0].constant_value
not region in allowed_regions
msg := sprintf(
"POLICY VIOLATION: %s '%s' usa la regione '%s' non permessa per compliance GDPR. Regioni ammesse: %v",
[resource_type, resource_name, region, allowed_regions]
)
}
# Uso di conftest con piano Terraform in JSON
# 1. Genera il piano Terraform in formato JSON
terraform init
terraform plan -out=tfplan
terraform show -json tfplan > tfplan.json
# 2. Esegui conftest con le policy
conftest test tfplan.json --policy policy/terraform/
# Output esempio:
# FAIL - tfplan.json - main - POLICY VIOLATION: aws_s3_bucket 'logs' manca il tag obbligatorio 'CostCenter'
# FAIL - tfplan.json - main - POLICY VIOLATION: aws_s3_bucket 'data' usa la regione 'us-east-1' non permessa per compliance GDPR
# 2 tests, 2 failures
# Test con output strutturato JSON
conftest test tfplan.json --policy policy/ --output json
# Test con namespace specifico
conftest test tfplan.json --policy policy/ --namespace main
すべてのツールと統合された CI パイプライン
# .github/workflows/security-scan.yml
name: IaC Security Scan
on:
pull_request:
paths:
- '**.tf'
- '**.tfvars'
jobs:
checkov:
name: Checkov Scan
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Checkov
uses: bridgecrewio/checkov-action@v12
with:
directory: .
framework: terraform
output_format: sarif
output_file_path: reports/checkov.sarif
soft_fail: true # Non blocca la pipeline su LOW/MEDIUM
- name: Upload SARIF to GitHub Code Scanning
uses: github/codeql-action/upload-sarif@v3
if: always()
with:
sarif_file: reports/checkov.sarif
trivy:
name: Trivy Scan
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Trivy
uses: aquasecurity/trivy-action@master
with:
scan-type: 'config'
scan-ref: '.'
format: 'sarif'
output: 'trivy.sarif'
severity: 'HIGH,CRITICAL'
exit-code: '1' # Blocca la pipeline su HIGH/CRITICAL
- name: Upload Trivy SARIF
uses: github/codeql-action/upload-sarif@v3
if: always()
with:
sarif_file: trivy.sarif
opa-policy:
name: OPA Policy Check
runs-on: ubuntu-latest
needs: [checkov, trivy]
steps:
- uses: actions/checkout@v4
- name: Setup Terraform
uses: hashicorp/setup-terraform@v3
with:
terraform_version: '1.7.5'
- name: Configure AWS Credentials
uses: aws-actions/configure-aws-credentials@v4
with:
role-to-assume: ${{ secrets.TERRAFORM_PLAN_ROLE }}
aws-region: eu-west-1
- name: Generate Terraform Plan JSON
run: |
cd environments/production
terraform init -no-color
terraform plan -out=tfplan -no-color
terraform show -json tfplan > ../../tfplan.json
- name: Install conftest
run: |
curl -L https://github.com/open-policy-agent/conftest/releases/download/v0.49.0/conftest_0.49.0_linux_amd64.tar.gz | tar xz
sudo mv conftest /usr/local/bin/
- name: Run OPA Policies
run: |
conftest test tfplan.json --policy policy/terraform/ --output json | tee opa-results.json
# Fallisce se ci sono violation
jq -e '.[] | select(.failures | length > 0)' opa-results.json && exit 1 || exit 0
カバレッジ マトリックス: どのツールがどのリスクに対応するか
| リスク | チェコフ | トリビー | オーパ |
|---|---|---|---|
| S3パブリックアクセス | はい (CKV_AWS_20) | Si | カスタム |
| 保存時の暗号化がありません | はい(チェックがたくさんあります) | Si | No |
| セキュリティグループが寛容すぎる | Si | Si | No |
| 必須タグがありません | 部分的 | No | はい (カスタム Rego) |
| 命名規則 | No | No | はい (カスタム Rego) |
| 許可されない地域 (GDPR) | No | No | はい (カスタム Rego) |
| コードの秘密 | 部分的 | はい(シークレットスキャン) | No |
| コンテナの脆弱性 | No | Si | No |
| 脆弱な依存症 | No | Si | No |
結論と次のステップ
Checkov (内蔵ワイドカバレッジ)、Trivy (統合スキャナー) の組み合わせ OPA (カスタム組織ポリシー) は、ほとんどの部分をカバーする多層防御を形成します。 IaC におけるセキュリティ リスクの一部。重要な原則は、 ツールは、無視可能な警告ではなく、PR マージをブロックする必要があります。
シリーズの次の記事
- 第7条: Terraform マルチクラウド — AWS + Azure + GCP を使用 共有モジュール: 複数のプロバイダーを管理するための抽象化レイヤーを構築します。 統一されたインターフェイスを備えています。
- 第8条: Terraform 用の GitOps — Flux TF コントローラー ドリフト検出: 継続的な調整により、Terraform を GitOps パラダイムに組み込みます。







