Skip to content

ppiankov/kubespectre

Repository files navigation

kubespectre

CI Go Report Card ANCC

kubespectre — Kubernetes security posture auditor. Part of SpectreHub.

What it is

  • Audits RBAC permissions, pod security standards, and network policies
  • Detects stale secrets, unused service accounts, and image provenance issues
  • Checks audit logging configuration and namespace isolation
  • Each finding includes severity for CI/CD gating and compliance reporting
  • Outputs text, JSON, SARIF, and SpectreHub formats

What it is NOT

  • Not a runtime security monitor — no eBPF, no agents
  • Not a remediation tool — read-only, never modifies cluster resources
  • Not a replacement for OPA/Gatekeeper — audits posture, not policy enforcement
  • Not a vulnerability scanner — use Trivy/Grype for CVEs

Quick start

Homebrew

brew tap ppiankov/tap
brew install kubespectre

From source

git clone https://github.com/ppiankov/kubespectre.git
cd kubespectre
make build

Usage

kubespectre audit --kubeconfig ~/.kube/config --format json

CLI commands

Command Description
kubespectre audit Audit cluster security posture
kubespectre version Print version

SpectreHub integration

kubespectre feeds Kubernetes security findings into SpectreHub for unified visibility across your infrastructure.

spectrehub collect --tool kubespectre

Safety

kubespectre operates in read-only mode. It inspects and reports — never modifies, deletes, or alters your cluster resources.

Documentation

Document Contents
CLI Reference Full command reference, flags, and configuration

License

MIT — see LICENSE.


Built by Obsta Labs

About

Kubernetes security posture auditor — RBAC, pod security, network policies, secrets, service accounts

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors