😎 Want to contribute? 😇

Kubescape is a K8s open-source tool providing a Kubernetes single pane of glass, including risk analysis, security compliance, RBAC visualizer, and image vulnerabilities scanning. Kubescape scans K8s clusters, YAML files, and HELM charts, detecting misconfigurations according to multiple frameworks (such as the NSA-CISA, MITRE ATT&CK®), software vulnerabilities, and RBAC (role-based-access-control) violations at early stages of the CI/CD pipeline, calculates risk score instantly and shows risk trends over time.

It has become one of the fastest-growing Kubernetes tools among developers due to its easy-to-use CLI interface, flexible output formats, and automated scanning capabilities, saving Kubernetes users and admins precious time, effort, and resources. Kubescape integrates natively with other DevOps tools, including Jenkins, CircleCI, Github workflows, Prometheus, and Slack, and supports multi-cloud K8s deployments like EKS, GKE, and AKS.

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

Install on windows

Install on macOS

Install on NixOS or Linux/macOS via nix

Install using Go

kubescape scan --submit --enable-host-scan --verbose

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 more robust and complete as Kubernetes develops.

We invite you to our team! We are excited about this project and want to return the love we get.

Want to contribute? Want to discuss something? Have an issue?

• Feel free to pick a task from the issues, roadmap or suggest a feature of your own. Contact us directly for more information :)
• Open an issue, we are trying to respond within 48 hours
• Join us in the discussion on our discord server!

Kubescape docs

• Kubescape playground

• Overview
• How To Secure Kubernetes Clusters With Kubescape And Armo
• Scan Kubernetes YAML files
• Scan Kubescape on an air-gapped environment (offline support)
• Managing exceptions in the Kubescape SaaS version
• Configure and run customized frameworks
• Customize control configurations. Kubescape CLI, Kubescape SaaS

iwr -useb https://raw.githubusercontent.com/kubescape/kubescape/master/install.ps1 | iex

Set-ExecutionPolicy RemoteSigned -scope CurrentUser

  # your other config ...
  environment.systemPackages = with pkgs; [
    # your other packages ...
    kubescape
  ];

  # your other config ...
  home.packages = with pkgs; [
    # your other packages ...
    kubescape
  ];

kubescape scan --submit --enable-host-scan  --verbose

Read here more about the enable-host-scan flag

kubescape scan framework nsa --submit

kubescape scan framework mitre --submit

kubescape scan control "Privileged container"

kubescape scan --include-namespaces development,staging,production

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

kubescape scan *.yaml --submit

kubescape scan https://github.com/kubescape/kubescape --submit

kubescape scan --verbose

Add the --format-version v2 flag

kubescape scan --format json --format-version v2 --output results.json

kubescape scan --format junit --output results.xml

kubescape scan --format pdf --output results.pdf

kubescape scan --format prometheus

Full documentation

kubescape scan --exceptions examples/exceptions/exclude-kube-namespaces.json

kubescape scan </path/to/directory> --submit

Kubescape will load the default value file

Video tutorial

It is possible to run Kubescape offline!

1. Download and save in local directory, if path not specified, will save all in ~/.kubescape

kubescape download artifacts --output path/to/local/dir

2. Copy the downloaded artifacts to the air-gaped/offline environment

3. Scan using the downloaded artifacts

kubescape scan --use-artifacts-from path/to/local/dir

You can also download a single artifact and scan with the --use-from flag

1. Download and save in file, if file name is not specified, will save in ~/.kubescape/<framework name>.json

kubescape download framework nsa --output /path/nsa.json

2. Copy the downloaded artifacts to the air-gaped/offline environment

3. Scan using the downloaded framework

kubescape scan framework nsa --use-from /path/nsa.json

Please follow the instructions here helm chart repo

Scan the YAML files while writing them using the vs code extension

View Kubescape scan results directly in Lens IDE using kubescape Lens extension

You can use the sample files below to setup your VS code environment for building and debugging purposes.

// .vscode/settings.json
{
    "go.testTags": "static",
    "go.buildTags": "static",
    "go.toolsEnvVars": {
        "CGO_ENABLED": "1"
    }
}

// .vscode/launch.json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch Package",
            "type": "go",
            "request": "launch",
            "mode": "auto",
            "program": "${workspaceFolder}/main.go",
            "args": [
                "scan",
                "--logger",
                "debug"
            ],
            "buildFlags": "-tags=static"
        }
    ]
}

Kubescape is based on the OPA engine and ARMO's posture controls.

The tools retrieve Kubernetes objects from the API server and run a set of rego's snippets developed by ARMO.

The results by default are 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 more robust and complete as Kubernetes develops.