docker-security

docker-security (dsecrat)

A from-scratch, unified container-security tool in Go — one engine, many frontends (CLI, HTTP API, web dashboard, connectors). It covers the whole container lifecycle: SBOM, vulnerability scanning, secret detection, static image and Dockerfile analysis, license and malware gates, signing/attestation verification, registry posture, CIS/NIST/PCI compliance, RBAC and cloud-IAM risk, network-egress policy, container hardening, admission control, a Docker daemon authorization plugin, continuous monitoring, and eBPF-backed runtime detection.

Standard-library scanner — the dsecrat scanner is built entirely on the Go standard library and ships as a single static binary. The optional eBPF runtime sensor (dsecrat-runtime, Linux) is the sole exception: it uses one dependency, github.com/cilium/ebpf, isolated behind a //go:build linux tag so it never enters the scanner binary.

Naming: the project is docker-security; its CLI binary and Go package are dsecrat (go install github.com/Ratnadeepdeyroy/docker-security/cmd/dsecrat@latest). The runtime daemon is dsecrat-runtime. Rule IDs are prefixed DS-RAT-….

☕ If this project is useful to you, you can buy me a coffee.

Highlights

• 18 capability modules in one engine — run all with dsecrat scan, or list them with dsecrat modules.
• Offline & deterministic — no network required for a scan; the vulnerability DB and malware/compliance packs ship embedded and are refreshable.
• CI-ready — --fail-on, SARIF/JSON/OSCAL output, a policy-as-code gate, and connectors (webhook, Slack, SIEM, MCP).
• Runtime & enforcement — Kubernetes admission webhook, Docker daemon authorization plugin, continuous watch mode, and an eBPF sensor (Linux).

Quickstart

make build        # → bin/dsecrat and bin/dsecrat-runtime
make test         # full test suite
make demo         # end-to-end: crafts a fixture image, drives every capability
make serve        # API + web dashboard + MCP on :8080 (with an inventory store)
make help         # list all targets

Or install straight from source with the Go toolchain:

go install github.com/Ratnadeepdeyroy/docker-security/cmd/dsecrat@latest
go install github.com/Ratnadeepdeyroy/docker-security/cmd/dsecrat-runtime@latest

No Docker is required to build or test.

CLI

dsecrat modules                        # list capability modules
dsecrat scan <target>                  # scan a Dockerfile / path / image tar (all modules)
dsecrat scan --format json  <target>   # json | table | sarif
dsecrat scan --fail-on high <target>   # exit non-zero on a HIGH+ finding (CI gate)
dsecrat watch --interval 5m <target>   # continuous re-scan; emit only new findings
dsecrat sbom  --format spdx <target>   # SBOM: spdx | cyclonedx
dsecrat vuln  info                     # advisory DB status (age / count / staleness)
dsecrat vuln update --ecosystems Debian,Alpine,PyPI,npm --epss --kev   # refresh advisories + EPSS + CISA KEV
dsecrat vuln update --nvd --since 30d                                  # pull/refresh from the NVD CVE API (opt-in)
dsecrat vuln cron install                                             # self-updating: install a daily refresh job
dsecrat scan --vuln-db ~/.dsecrat/vulndb.json <target>    # scan against a refreshed/custom advisory DB
dsecrat compliance report --format oscal <target>   # auditor export: json|csv|oscal|md
dsecrat verify cosign --root fulcio.pem --cert leaf.pem \
     --payload payload.json --signature sig.bin \
     --certificate-identity ... --certificate-oidc-issuer ...   # keyless verify
dsecrat admission serve                # Kubernetes admission webhook
dsecrat authz serve                    # Docker daemon authorization plugin
dsecrat serve --addr :8080             # HTTP API + web dashboard

Example:

dsecrat scan examples/Dockerfile.bad
docker save alpine:3.19 -o alpine.tar
dsecrat sbom --format cyclonedx alpine.tar > alpine.cdx.json

Capabilities

Continuous monitoring

dsecrat watch turns a one-shot scan into monitoring: it re-scans on an interval, diffs each run against the previous, and dispatches only newly-appeared findings through the configured connectors — so a stable target stays quiet and a regression (clean yesterday, vulnerable today) is surfaced immediately.

dsecrat watch --interval 5m --slack https://hooks.slack.com/... <target>

Platform support

Pure Go, CGO_ENABLED=0 → single static binaries. make release cross-builds every target into ./dist:

Every scanning capability is identical across platforms. The only OS-specific piece is live eBPF capture in dsecrat-runtime, gated behind //go:build linux; the binary builds and runs everywhere and live kernel capture activates only on Linux.

HTTP API & web dashboard

dsecrat serve --addr 127.0.0.1:8080     # then open http://localhost:8080/

curl localhost:8080/healthz
curl localhost:8080/v1/modules
curl -X POST localhost:8080/v1/scan -H 'Content-Type: application/json' -d '{
  "type": "dockerfile",
  "content": "FROM node:latest\nENV TOKEN=abc\n",
  "format": "json"
}'

The dashboard is embedded in the binary (no external assets, works offline).

Documentation

• Feature docs — one page per capability, with diagrams.
• Framework playbooks — technical hardening controls per framework.

Contributing

Issues and pull requests are welcome. The project keeps two hard rules: the scanner stays standard-library-only (the lone dependency, cilium/ebpf, is confined to the Linux eBPF runtime sensor) and every capability is tested (go test ./... must stay green on all platforms).

License & attribution

MIT © Ratnadeep Dey Roy — https://github.com/Ratnadeepdeyroy/docker-security

dsecrat is free to use, fork, embed, and sell under the MIT License. The license requires that the copyright notice (which names this project and its repository) be retained in all copies and substantial portions.

Please credit the project wherever you use it. If you build on dsecrat, ship it, or reference it, keep the NOTICE file and link back:

Powered by dsecrat — https://github.com/Ratnadeepdeyroy/docker-security

• Third-party code: the scanner is pure Go standard library. The optional eBPF runtime sensor depends on github.com/cilium/ebpf (Apache-2.0) — the one third-party license to track, and only when building dsecrat-runtime for Linux.
• Bundled & fetched data (advisories, EPSS, KEV, compliance packs, malware signatures) has its own provenance and attribution terms — see DATA_SOURCES.md.

Support

If dsecrat saves you time, please consider starring the repo ⭐ and buying me a coffee.

Star history

A ⭐ helps others discover dsecrat — see the star history.