kubescape

README

Kubescape is the first tool for testing if Kubernetes is deployed securely as defined in Kubernetes Hardening Guidance by NSA and CISA

Use Kubescape to test clusters or scan single YAML files and integrate it to your processes.

TL;DR

Install & Run

Install:

curl -s https://raw.githubusercontent.com/armosec/kubescape/master/install.sh | /bin/bash

Run:

kubescape scan framework nsa --exclude-namespaces kube-system,kube-public

If you wish to scan all namespaces in your cluster, remove the --exclude-namespaces flag.

Usage & Examples

Pre-Deployment Testing

Check your YAML files before you're deploying, simply add them at the end of command line:

kubescape scan framework nsa *.yaml

Integration with other tools

Kubescape can produce output fitting for later processing:

• JSON (-f json)
• JUnit XML (-f junit)

Examples

• Scan a running Kubernetes cluster with nsa framework

kubescape scan framework nsa --exclude-namespaces kube-system,kube-public

• Scan local yaml/json files

kubescape scan framework nsa examples/online-boutique/*

• Scan yaml/json files from url

kubescape scan framework nsa https://raw.githubusercontent.com/GoogleCloudPlatform/microservices-demo/master/release/kubernetes-manifests.yaml

• Output in json format

kubescape scan framework nsa --exclude-namespaces kube-system,kube-public --format json --output results.json

• Output in junit xml format

kubescape scan framework nsa --exclude-namespaces kube-system,kube-public --format junit --output results.xml

Helm Support

Render the helm template and pass as stdout

helm template [CHART] [flags] --generate-name --dry-run | kubescape scan framework nsa -

for example:

helm template bitnami/mysql --generate-name --dry-run | kubescape scan framework nsa -

How to build

Note: development (and the release process) is done with Go 1.16

1. Clone Project

git clone git@github.com:armosec/kubescape.git kubescape && cd "$_"

1. Build

go mod tidy && go build -o kubescape .

1. Run

./kubescape scan framework nsa --exclude-namespaces kube-system,kube-public

1. Enjoy 🤪

Under the hood

Tests

Kubescape is running the following tests according to what is defined by Kubernetes Hardening Guidance by NSA and CISA

• Non-root containers
• Immutable container filesystem
• Privileged containers
• hostPID, hostIPC privileges
• hostNetwork access
• allowedHostPaths field
• Protecting pod service account tokens
• Resource policies
• Control plane hardening
• Exposed dashboard
• Allow privilege escalation
• Applications credentials in configuration files
• Cluster-admin binding
• Exec into container
• Dangerous capabilities
• Insecure capabilities
• Linux hardening
• Ingress and Egress blocked
• Container hostPort
• Anonymous requests

Technology

Kubescape based on OPA engine: https://github.com/open-policy-agent/opa and ARMO's posture controls.

The tools retrieves Kubernetes objects from the API server and runs a set of regos snippets developed by ARMO.

The results by default printed in a pretty "console friendly" manner, but they can be retrieved in JSON format for further processing.

Kubescape is an open source project, we welcome your feedback and ideas for improvement. We’re also aiming to collaborate with the Kubernetes community to help make the tests themselves more robust and complete as Kubernetes develops.