The Docker Bench for Security is a script that checks for dozens of common best-practices around deploying Docker containers in production.
Find a file
2015-05-13 17:10:50 -07:00
tests Fixed the script to ignore containers with label security-benchmark 2015-05-13 17:08:12 -07:00
.gitignore First version of the CIS Docker Benchmark v1.0.0 2015-05-13 15:26:45 -07:00
docker_security_benchmark.sh Fixed the script to ignore containers with label security-benchmark 2015-05-13 17:08:12 -07:00
Dockerfile First version of the CIS Docker Benchmark v1.0.0 2015-05-13 15:26:45 -07:00
helper_lib.sh First version of the CIS Docker Benchmark v1.0.0 2015-05-13 15:26:45 -07:00
output_lib.sh First version of the CIS Docker Benchmark v1.0.0 2015-05-13 15:26:45 -07:00
README.md Updated Readme to reflect --label need 2015-05-13 17:10:50 -07:00

Docker Security Benchmark Checker

The Docker Security Benchmark Checker is a script that checks for all the automatable tests included in the CIS Docker 1.6 Benchmark. We are releasing this as a follow-up to our Understanding Docker Security and Best Practices blog post.

We are making this available as an open-source utility so the Docker community can have an easy way to self-assess their hosts and docker containers against this benchmark.

Running the benchmark

We packaged this benchmark as a small container for your convenience. Note that this container is being run with a lot of privilege -- sharing the host's filesystem, pid and network namespaces, due to portions of the benchmark applying to the running host.

The easiest way to run your hosts against the CIS Docker 1.6 benchmark is by running our pre-built container:

docker run -it --net host --pid host -v /var/run/docker.sock:/var/run/docker.sock \
-v /usr/lib/systemd:/usr/lib/systemd -v /etc:/etc --label security-benchmark \
diogomonica/docker-security-benchmark

Building the benchmark

If you wish to build and run this container yourself, you can follow the following steps:

# git clone https://github.com/diogomonica/docker-security-benchmark.git
# cd docker-security-benchmark; docker build -t docker-security-benchmark .
# docker run -it --net host --pid host -v /var/run/docker.sock:/var/run/docker.sock \
-v /usr/lib/systemd:/usr/lib/systemd -v /etc:/etc --label security-benchmark \
docker-security-benchmark

Also, this script can also be simply run from your base host by running:

# git clone https://github.com/diogomonica/docker-security-benchmark.git
# cd docker-security-benchmark; sh docker_security_benchmark.sh

This script was build to be POSIX 2004 compliant, so it should be portable across any Unix platform.