Creating a Custom Benchmark Version for Running a Cluster Scan
Each Benchmark Version defines a set of test configuration files that define the CIS tests to be run by the kube-bench tool.
The rancher-cis-benchmark
application installs a few default Benchmark Versions which are listed under CIS Benchmark application menu.
But there could be some Kubernetes cluster setups that require custom configurations of the Benchmark tests. For example, the path to the Kubernetes config files or certs might be different than the standard location where the upstream CIS Benchmarks look for them.
It is now possible to create a custom Benchmark Version for running a cluster scan using the rancher-cis-benchmark
application.
When a cluster scan is run, you need to select a Profile which points to a specific Benchmark Version.
Follow all the steps below to add a custom Benchmark Version and run a scan using it.
1. Prepare the Custom Benchmark Version ConfigMap
To create a custom benchmark version, first you need to create a ConfigMap containing the benchmark version's config files and upload it to your Kubernetes cluster where you want to run the scan.
To prepare a custom benchmark version ConfigMap, suppose we want to add a custom Benchmark Version named foo
.
Create a directory named
foo
and inside this directory, place all the config YAML files that the kube-bench tool looks for. For example, here are the config YAML files for a Generic CIS 1.5 Benchmark Version https://github.com/aquasecurity/kube-bench/tree/master/cfg/cis-1.5Place the complete
config.yaml
file, which includes all the components that should be tested.Add the Benchmark version name to the
target_mapping
section of theconfig.yaml
:target_mapping:
"foo":
- "master"
- "node"
- "controlplane"
- "etcd"
- "policies"Upload this directory to your Kubernetes Cluster by creating a ConfigMap:
kubectl create configmap -n <namespace> foo --from-file=<path to directory foo>
2. Add a Custom Benchmark Version to a Cluster
- In the upper left corner, click ☰ > Cluster Management.
- On the Clusters page, go to the cluster where you want to add a custom benchmark and click Explore.
- In the left navigation bar, click CIS Benchmark > Benchmark Version.
- Click Create.
- Enter the Name and a description for your custom benchmark version.
- Choose the cluster provider that your benchmark version applies to.
- Choose the ConfigMap you have uploaded from the dropdown.
- Add the minimum and maximum Kubernetes version limits applicable, if any.
- Click Create.
3. Create a New Profile for the Custom Benchmark Version
To run a scan using your custom benchmark version, you need to add a new Profile pointing to this benchmark version.
- In the upper left corner, click ☰ > Cluster Management.
- On the Clusters page, go to the cluster where you want to add a custom benchmark and click Explore.
- In the left navigation bar, click CIS Benchmark > Profile.
- Click Create.
- Provide a Name and description. In this example, we name it
foo-profile
. - Choose the Benchmark Version from the dropdown.
- Click Create.
4. Run a Scan Using the Custom Benchmark Version
Once the Profile pointing to your custom benchmark version foo
has been created, you can create a new Scan to run the custom test configs in the Benchmark Version.
To run a scan,
- In the upper left corner, click ☰ > Cluster Management.
- On the Clusters page, go to the cluster where you want to add a custom benchmark and click Explore.
- In the left navigation bar, click CIS Benchmark > Scan.
- Click Create.
- Choose the new cluster scan profile.
- Click Create.
Result: A report is generated with the scan results. To see the results, click the name of the scan that appears.