bridgecrew/checkov-k8s

Checkov Kubernetes Runtime Scanning 镜像文档

1. 镜像概述和主要用途

Checkov 是一款基础设施即代码（IaC）静态代码分析工具，主要提供部署前的基础设施配置合规性扫描能力。本镜像专注于 Kubernetes 环境的运行时场景，支持对集群中已部署的资源（如 Deployment、Pod、Service 等）进行静态代码分析，帮助用户在运行时识别资源配置中的安全风险和合规性问题，提供即时反馈。

2. 核心功能和特性

• 静态代码分析：对 Kubernetes 资源配置进行语法和语义层面的合规性检查，覆盖安全最佳实践（如非 root 用户运行、敏感信息加密等）。
• 运行时资源扫描：针对 Kubernetes 集群运行时环境，直接扫描集群内活跃的资源对象，无需依赖预部署的代码文件。
• 即时结果反馈：通过 Kubernetes Job 部署后可快速执行扫描并输出结果，便于实时掌握资源合规状态。
• 无文件依赖适配：传统 Checkov 扫描依赖文件路径定位不合规项，运行时扫描针对无文件场景优化，直接关联 Kubernetes 资源对象（如名称、命名空间）。

3. 使用场景和适用范围

• Kubernetes 集群合规性监控：定期或按需检查集群内资源配置是否符合企业安全规范。
• 部署后验证：资源部署完成后，快速验证实际运行配置与预期合规标准的一致性。
• 故障排查辅助：结合扫描结果定位因配置不当导致的运行时问题（如权限过高、资源限制缺失等）。
• 安全审计支持：为集群安全审计提供客观的配置合规性依据。

4. 详细的使用方法和配置说明

4.1 部署为 Kubernetes Job

通过 Kubernetes Job 部署 Checkov，实现对集群资源的运行时扫描：

4.1.1 部署 Job 资源

执行以下命令部署官方提供的 Checkov Job 配置：

bash
kubectl apply -f https://raw.githubusercontent.com/bridgecrewio/checkov/master/kubernetes/checkov-job.yaml

该配置会在 checkov 命名空间下创建 Job，默认扫描集群内所有命名空间的资源。

4.1.2 查看 Job 状态

部署后，通过以下命令确认 Job 是否正常运行：

bash
kubectl get jobs -n checkov

预期输出示例：

NAME      COMPLETIONS   DURATION   AGE
checkov   1/1           30s        2m

4.1.3 获取扫描结果

通过 Job 日志查看扫描详情和不合规项：

bash
kubectl logs job/checkov -n checkov

日志将包含资源名称、命名空间及具体不合规配置项（如 [ERROR] Container 'app' runs as root user）。

4.2 配置说明

当前版本的 Checkov 运行时扫描 Job 无需额外环境变量或配置参数，默认使用内置规则集。如需自定义扫描范围（如指定命名空间）或规则（如排除特定检查项），可通过修改 Job 配置文件中的 args 字段实现，示例：

yaml
spec:
  template:
    spec:
      containers:
      - name: checkov
        image: bridgecrew/checkov:latest
        args: ["--namespace", "default", "--skip-check", "CKV_K8S_123"]  # 扫描 default 命名空间，跳过规则 CKV_K8S_123

具体参数可参考 Checkov 官方文档 的命令行参数说明。