kubevscan - Kubernetes security scanner based on the open-sour

项目说明

Kubevscan

What is this?

The goal of this project is to provide a scanner that continuously scans containers deployed in a Kubernetes cluster.

The project creates for each pod a scanner container based on the open-source project Trivy.

The scanner is a sidecar container injected into the pod using the open-source project k8s-sidecar-injector.

The scanner sidecar container is kube.

Installation

Set the en defined in the *setup.sh* script.
The *ORG* and *DOMAIN* are used to generated certs for the sidecar injector.
The *DEPLOYMENT* and *CLUSTER* are used to create certs directories (example DEPLOYMENT=us-east-1 and CLUSTER=PRODUCTION).

ORG=
DOMAIN=
DEPLOYMENT=
CLUSTER=

Run the setup script which installs and configures the sidecar injector into the Kubernetes cluster.

$ ./setup.sh
Starting to deploy components...

Set required in ca.conf csr-prod.conf..
Generating certs..
...

Check the sidecar injector logs.

$ kubectl logs --tail=60 -n kube-system -l k8s-app=k8s-sidecar-injector
172.18.0.1 - - [15/Oct/2020:14:29:30 +0000] "GET /health HTTP/2.0" 200 12 "" "kube-probe/1.18"
I1015 14:36:37.504124 1 main.go:131] triggering ConfigMap reconciliation
I1015 14:36:37.504153 1 watcher.go:151] Fetching ConfigMaps...
I1015 14:36:37.508225 1 watcher.go:158] Fetched 1 ConfigMaps
I1015 14:36:37.508488 1 watcher.go:179] Loaded InjectionConfig kubevscan from ConfigMap sidecar-test:kubevscan
I1015 14:36:37.508515 1 watcher.go:164] Found 1 InjectionConfigs in sidecar-test
I1015 14:36:37.508521 1 main.go:137] got 1 updated InjectionConfigs from reconciliation
I1015 14:36:37.508525 1 main.go:151] updating server with newly loaded configurations (1 loaded from disk, 1 loaded from k8s api)
I1015 14:36:37.508531 1 main.go:153] configuration replaced
172.18.0.1 - - [15/Oct/2020:14:36:40 +0000] "GET /health HTTP/2.0" 200 12 "" "kube-probe/1.18"
...

Quick Start

Deploy the test pod with the sidecar injector annotation *injector.tumblr.com/request=kubescan*

$ kubectl create -f kubernetes/debug-pod.yaml
pod/debian-debug created

Check the logs generated by Tri in */var/log/kubevscan* directory.

项目信息

开发语言：Ruby

Star 数：23

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Kubernetes security scanner based on the open-source container vulnerability scanner Trivy.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。