Custom Scans

Checkov is delivered with a set of built-in policies that checks for compliance and security best practices at its core. In addition, Checkov enables loading of extra checks, that give the user a possibility to author and execute custom policies.


Let’s assume we have the following directory structure:


And that we have a unique need to enforce bucket ACL policies only when the tag Scope=PCI is present.
In other words, as security-aware engineers, we want the following bucket definition will trigger a failed check result:

# Snippet from
resource "aws_s3_bucket" "credit_cards_bucket" {
  region        = var.region
  bucket        = local.bucket_name
  acl           = "public-read"
  force_destroy = true

  tags = {
    Scope = "PCI",

For that we will need to add a new check to ensure PCI related S3 buckets will stay private. So we will create a new python folder named my_extra_checks containing our new check

└── my_extra_checks

First time setup of your custom checks folder requires a file

from os.path import dirname, basename, isfile, join
import glob
modules = glob.glob(join(dirname(__file__), "*.py"))
__all__ = [ basename(f)[:-3] for f in modules if isfile(f) and not f.endswith('')]

And we will fill the matching logic in

from lark import Token

from checkov.terraform.checks.resource.base_resource_check import BaseResourceCheck
from checkov.common.models.enums import CheckResult, CheckCategories

class S3PCIPrivateACL(BaseResourceCheck):
    def __init__(self):
        name = "Ensure PCI Scope buckets has private ACL (enable public ACL for non-pci buckets)"
        id = "CKV_AWS_999"
        supported_resources = ['aws_s3_bucket']
        # CheckCategories are defined in models/
        categories = [CheckCategories.BACKUP_AND_RECOVERY]
        super().__init__(name=name, id=id, categories=categories, supported_resources=supported_resources)

    def scan_resource_conf(self, conf):
            Looks for ACL configuration at aws_s3_bucket and Tag values:
        :param conf: aws_s3_bucket configuration
        :return: <CheckResult>
        if 'tags' in conf.keys():
            environment_tag = Token("IDENTIFIER", "Scope")
            if environment_tag in conf['tags'][0].keys():
                if conf['tags'][0][environment_tag] == "PCI":
                    if 'acl' in conf.keys():
                        acl_block = conf['acl']
                        if acl_block in [["public-read"], ["public-read-write"], ["website"]]:
                            return CheckResult.FAILED
        return CheckResult.PASSED

scanner = S3PCIPrivateACL()

Now that we have the new custom check in place, we can run Checkov and verify the results:

# install from pypi using pip
pip install checkov

# select an input folder that contains your terraform files and enable loading of extra checks
checkov -d . --external-checks-dir my_extra_checks


Check: "Ensure PCI Scope buckets has private ACL (enable public ACL for non-pci buckets)"
	FAILED for resource: aws_s3_bucket.credit_cards_bucket
	File: /

		80 | resource "aws_s3_bucket" "credit_cards_bucket" {
		81 | region        = var.region
		82 | bucket        = local.bucket_name
		83 | acl           = "public-read"
		84 | force_destroy = true
		85 | 
		86 | tags = {
		87 | Scope = "PCI",
		88 | 
		89 | }
		90 | }