Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 13: Schwachstellen-Scanner – trivy, grype, docker scout

Ziel: Du scannst Images, Quellcode und Konfiguration mit trivy, trennst mit syft und grype SBOM-Erzeugung und Scan und kennst docker scout als Alternative. · Dauer: ca. 90 min · Voraussetzung: Tag 12

Briefing

  • Ein Scanner listet die Pakete im Image (Betriebssystem und Sprachen) und gleicht sie mit einer Schwachstellen-Datenbank ab. Ergebnis: CVEs mit Schweregrad und – wenn es eine gibt – der Version mit Fix.
  • trivy (Aqua Security) ist das Taschenmesser: Images, Ordner, Konfiguration, Secrets, SBOMs. grype (Anchore) scannt nur – aber auch SBOMs von syft.
  • docker scout ist Dockers eigener Dienst; das CLI-Plugin braucht Docker und ein Docker-Konto.
  • Datenbanken sind groß (trivy 1.6 GB, grype 3.2 GB entpackt) und ändern sich täglich. Alle CVE-Zahlen in diesem Kapitel sind eine Momentaufnahme vom 30.10.2026.
 Image ──trivy image──────────────────────────► Befunde
       ──syft──► SBOM (CycloneDX) ──grype sbom:──► Befunde   (Pipeline: einmal SBOM,
                                  └─trivy sbom───► Befunde    beliebig oft scannen)

Drill 1: trivy – installieren und das erste Image

Steckbrief trivy
Aufgabe Schwachstellen, Fehlkonfigurationen, Secrets und Lizenzen finden
Besonderheit ein Binary für Images, Dateisysteme, Repos, IaC, SBOMs und Kubernetes
Projekt github.com/aquasecurity/trivy (Apache-2.0), Doku trivy.dev
Version im Buch 0.76.1
source ~/ct-lab/setup/env.sh
mkdir -p ~/ct-lab/tag13 && cd ~/ct-lab/tag13
cp -R "$LAB/code/notes/." . && cp -R "$LAB/code/tag12/notes/." .
trivy --version | head -1
df -h ~ | tail -1

Erwartet (gekürzt):

Version: 0.76.1
/dev/sda1        38G  6.7G   32G  18% /

Plane mindestens 5 GB frei ein. Der erste Scan lädt die Datenbank nach ~/.cache/trivy:

trivy image docker.io/library/nginx:1.30.6-alpine 2>&1 | head -24 | cut -c1-88

Erwartet (gekürzt, Zeiten und Zahlen weichen bei dir ab):

… INFO  [vulndb] Need to update DB
… INFO  [vulndb] Downloading vulnerability DB...
… INFO  [vulndb] Downloading artifact...    repo="mirror.gcr.io/aquasec/trivy-db:2"
…
… INFO  Detected OS family="alpine" version="3.24.3"
… INFO  [alpine] Detecting vulnerabilities...   os_version="3.24" repository="3.24"
…
Report Summary

┌───────────────────────────────────────────────────────┬────────┬─────────────────┬──
│                        Target                         │  Type  │ Vulnerabilities │ S
├───────────────────────────────────────────────────────┼────────┼─────────────────┼──
│ docker.io/library/nginx:1.30.6-alpine (alpine 3.24.3) │ alpine │       49        │
└───────────────────────────────────────────────────────┴────────┴─────────────────┴──

Danach folgt Total: 49 (UNKNOWN: 0, LOW: 44, MEDIUM: 2, HIGH: 2, CRITICAL: 1) und eine breite Tabelle je Befund: Paket, CVE, Schweregrad, Status, installierte Version, Version mit Fix, Titel. Standardmäßig sucht trivy nach Schwachstellen und Secrets; --scanners vuln spart die Secret-Suche. Kompakter geht es über JSON:

trivy image -q --severity HIGH,CRITICAL -f json docker.io/library/nginx:1.30.6-alpine \
  | jq -r '.Results[].Vulnerabilities[]? | [.Severity, .PkgName, .InstalledVersion,
           .FixedVersion, .VulnerabilityID] | join(" ")'

Erwartet:

CRITICAL brotli-libs 1.2.0-r1 1.2.1-r0 CVE-2026-111497
HIGH curl 8.22.0-r0 8.23.0-r0 CVE-2026-92392
HIGH libcurl 8.22.0-r0 8.23.0-r0 CVE-2026-92392

Alle drei haben einen Fix in Alpine – ein neu gebautes nginx-Image wird sie los.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Woher trivy das Image nimmt

Woher hatte trivy das nginx-Image? Es fragt der Reihe nach Docker, containerd, Podman und zuletzt die Registry (--image-src ändert die Reihenfolge). „Docker” ist dank DOCKER_HOST aus Tag 4 schon der Podman-Socket. Ohne Socket sieht das so aus:

systemctl --user stop podman.socket podman.service
trivy image -q --scanners vuln localhost/notes-api:0.1.0 2>&1 | grep -E '^\s+\*' \
  | cut -c1-84

Erwartet:

    * docker error: unable to inspect the image (localhost/notes-api:0.1.0): Cannot con
    * containerd error: failed to list images from containerd client: connection error:
    * podman error: unable to inspect the image (localhost/notes-api:0.1.0): http error
    * remote error: Get "https://localhost/v2/": dial tcp [::1]:443: connect: connectio

Vier Quellen, vier Fehler – die Registry localhost gibt es nicht. Mit Socket klappt es:

systemctl --user start podman.socket
trivy image -q --scanners vuln localhost/notes-api:0.1.0 -f json \
  | jq -r '.Results[] | "\(.Target) \(.Type) \(.Vulnerabilities | length)"'

Erwartet:

notes-api gobinary 2

Ohne Socket bleibt das Archiv: podman save -o x.tar … und trivy image --input x.tar. Das notes-api-Binary auf scratch hat kein Betriebssystem – trivy liest die Go-Module direkt aus dem Binary. Zwei davon sind verwundbar (Drill 4).

Fortschritt speichern? Kostenlos registrieren

Drill 3: Filtern und Gates

trivy image -q --scanners vuln --severity HIGH,CRITICAL --exit-code 1 \
  docker.io/library/nginx:1.30.6-alpine >/dev/null; echo "Exit: $?"
trivy image -q --scanners vuln --severity CRITICAL --exit-code 1 \
  localhost/notes-api:0.1.0 >/dev/null; echo "Exit: $?"

Erwartet:

Exit: 1
Exit: 0

--severity filtert die Anzeige, --exit-code macht aus jedem verbleibenden Befund einen Fehler. Spannend wird --ignore-unfixed am Debian-basierten worker:

trivy image -q --scanners vuln --table-mode summary localhost/notes-worker:0.1.0 \
  | grep -E 'debian|Python ' | tr -s ' '
trivy image -q --scanners vuln --ignore-unfixed --table-mode summary \
  localhost/notes-worker:0.1.0 | grep -E 'debian|Python ' | tr -s ' '

Erwartet:

│ localhost/notes-worker:0.1.0 (debian 13.7) │ debian │ 164 │
│ Python │ python-pkg │ 8 │
│ localhost/notes-worker:0.1.0 (debian 13.7) │ debian │ 0 │
│ Python │ python-pkg │ 8 │

Keine der 164 Debian-Lücken hat heute einen Fix (Status affected bzw. fix_deferred) – du kannst sie nur abwarten oder ein kleineres Basisimage wählen. Die 8 Python-Befunde (urllib3, setuptools, msgpack) haben einen Fix. Genau diese gehören ins Gate: --ignore-unfixed --exit-code 1.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Ausnahmen mit .trivyignore

notes-api enthält golang.org/x/text v0.29.0 mit zwei HIGH-Befunden. Angenommen, das Update ist eingeplant: Bis dahin dokumentierst du die Ausnahme – mit Ablaufdatum.

cat > .trivyignore <<'EOF'
# .trivyignore – Stand Ende Tag 13: bewusst akzeptierte Befunde, je mit Grund und Ablauf
# golang.org/x/text v0.29.0 in notes-api: Update eingeplant (Ticket LAB-13)
CVE-2026-56851 exp:2026-12-31
CVE-2026-56852 exp:2026-12-31
EOF
trivy image -q --scanners vuln --exit-code 1 --show-suppressed \
  localhost/notes-api:0.1.0 | grep -E 'Total|CVE|Suppressed' | tr -s ' '
echo "Exit: ${PIPESTATUS[0]}"

Erwartet:

Total: 0 (UNKNOWN: 0, LOW: 0, MEDIUM: 0, HIGH: 0, CRITICAL: 0)
Suppressed Vulnerabilities (Total: 2)
│ golang.org/x/text │ CVE-2026-56851 │ HIGH │ ignored │ N/A │ .trivyignore │
│ │ CVE-2026-56852 │ │ │ │ │
Exit: 0

trivy liest .trivyignore aus dem aktuellen Ordner (--ignorefile wählt eine andere). Nach dem Ablaufdatum gilt die Zeile nicht mehr und das Gate schlägt wieder an – so wird aus „später” kein „nie”.

Fortschritt speichern? Kostenlos registrieren

Drill 5: Code, Konfiguration und Secrets

trivy scannt auch den Projektordner – Lock-Dateien statt Image:

trivy fs -q --scanners vuln --table-mode summary . | grep -E '│ [a-z]' | tr -s ' '

Erwartet:

│ notes-api/go.mod │ gomod │ 0 │
│ notes-web/package-lock.json │ npm │ 0 │
│ notes-worker/uv.lock │ uv │ 0 │

Null bei go.mod? Die .trivyignore aus Drill 4 gilt für jeden trivy-Lauf in diesem Ordner. Mit --ignorefile '' erscheinen dieselben zwei Go-Befunde wie im Image – schon vor dem Build. trivy config prüft Dockerfiles (und Kubernetes-YAML, Terraform, Helm …) auf Fehlkonfigurationen:

trivy config -q --table-mode summary . | grep -E '│ notes' | tr -s ' '
trivy config -q notes-api/Containerfile.besser | grep -E '^DS-'

Erwartet:

│ notes-api/Containerfile.besser │ dockerfile │ 2 │
│ notes-api/Containerfile.lint │ dockerfile │ 6 │
│ notes-api/Containerfile.schlecht │ dockerfile │ 3 │
│ notes-api/Dockerfile │ dockerfile │ 0 │
│ notes-pod.yaml │ kubernetes │ 53 │
│ notes-web/Dockerfile │ dockerfile │ 1 │
│ notes-worker/Dockerfile │ dockerfile │ 1 │
DS-0002 (HIGH): Specify at least 1 USER command in Dockerfile with non-root user as
argument
DS-0026 (LOW): Add HEALTHCHECK instruction in your Dockerfile

Die Prüfungen für Dockerfiles überschneiden sich mit hadolint (Tag 12). Nebenbei hat trivy notes-pod.yaml aus Tag 2 als Kubernetes-Manifest erkannt und 53 Befunde gemeldet – trivy config notes-pod.yaml zeigt sie einzeln. Zuletzt Secrets. Ein Lab-Schlüssel, der versehentlich im Projektordner liegt:

ssh-keygen -q -t ed25519 -N '' -C lab-deploy -f notes-api/deploy_key
trivy fs -q --scanners secret notes-api | grep -A1 -E '^HIGH'
podman build -q --format docker -f notes-api/Containerfile.schlecht \
  -t localhost/notes-api:schlecht notes-api >/dev/null 2>&1
trivy image -q --scanners secret --exit-code 1 localhost/notes-api:schlecht \
  | grep -E 'added by' | cut -c1-80; echo "Exit: ${PIPESTATUS[0]}"

Erwartet:

HIGH: AsymmetricPrivateKey (private-key)
════════════════════════════════════════
 /src/deploy_key:2-6 (offset: 36 bytes) (added by 'COPY dir:a7bee93a0cc5f5462d43
Exit: 1

COPY . . hat den Schlüssel ins Image getragen; trivy nennt sogar den Layer. Die .dockerignore von notes-api schließt *.key und *.pem aus, aber nicht deploy_key. Aufräumen und das schlechte Image ohne Schlüssel neu bauen:

rm notes-api/deploy_key notes-api/deploy_key.pub
podman build -q --format docker -f notes-api/Containerfile.schlecht \
  -t localhost/notes-api:schlecht notes-api >/dev/null 2>&1
trivy image -q --scanners secret --exit-code 1 localhost/notes-api:schlecht \
  >/dev/null; echo "Exit: $?"

Erwartet:

Exit: 0

Fortschritt speichern? Kostenlos registrieren

Drill 6: Datenbank und Cache

trivy version | sed -n '1,5p'
du -sh ~/.cache/trivy/db
time trivy image -q --skip-db-update --scanners vuln --severity CRITICAL \
  docker.io/library/nginx:1.30.6-alpine | grep Total

Erwartet (gekürzt):

Version: 0.76.1
Vulnerability DB:
  Version: 2
  UpdatedAt: 2026-10-30 19:07:50.77378237 +0000 UTC
  NextUpdate: 2026-10-31 19:07:50.77378224 +0000 UTC
1.6G    /home/ubuntu/.cache/trivy/db
Total: 1 (CRITICAL: 1)

real    0m0.687s

Die Datenbank ist ein OCI-Artefakt (mirror.gcr.io/aquasec/trivy-db:2, Ersatz ghcr.io/aquasecurity/trivy-db:2); trivy lädt sie neu, sobald NextUpdate vorbei ist. --skip-db-update scannt offline mit dem vorhandenen Stand – wichtig, wenn viele Pipelines parallel laufen. --cache-dir legt den Cache woanders hin, trivy clean --vuln-db (oder --all) löscht ihn.

Fortschritt speichern? Kostenlos registrieren

Drill 7: grype – der zweite Scanner

Steckbrief grype
Aufgabe Schwachstellen in Images, Ordnern und SBOMs finden
Besonderheit scannt syft-SBOMs direkt; Risiko-Sortierung mit EPSS und KEV
Projekt github.com/anchore/grype (Apache-2.0)
Version im Buch 0.121.0
grype version | grep -E '^(Version|Syft Version|Supported DB)'
time grype db update | tail -1
grype db status | grep -E '^(Built|Status)'
du -sh ~/.cache/grype

Erwartet (gekürzt):

Version:             0.121.0
Syft Version:        v1.55.0
Supported DB Schema: 6
Vulnerability database updated to latest version!

real    4m27.467s
…
Built:     2026-10-30T06:23:28Z
Status:    valid
3.2G    /home/ubuntu/.cache/grype

grype bringt syft als Bibliothek mit und lädt seine Datenbank von grype.anchore.io. Auch grype braucht für lokale Podman-Images den Socket; die Quelle wählst du mit einem Präfix (podman:, registry:, oci-archive:, dir:, sbom:):

grype -q podman:docker.io/library/nginx:1.30.6-alpine | head -6 | cut -c1-88

Erwartet:

NAME           INSTALLED   FIXED IN   TYPE  VULNERABILITY    SEVERITY  EPSS          RIS
brotli-libs    1.2.0-r1    1.2.1-r0   apk   CVE-2026-111497  Critical  82.6% (99th)  98.
curl           8.22.0-r0   8.23.0-r0  apk   CVE-2026-92392   High      1.3% (70th)   1.0
libcurl        8.22.0-r0   8.23.0-r0  apk   CVE-2026-92392   High      1.3% (70th)   1.0
curl           8.22.0-r0   8.23.0-r0  apk   CVE-2026-92387   High      0.3% (27th)   0.3
libcurl        8.22.0-r0   8.23.0-r0  apk   CVE-2026-92387   High      0.3% (27th)   0.3

grype sortiert nach Risiko: EPSS (Wahrscheinlichkeit eines Angriffs in den nächsten 30 Tagen) und kev (steht im CISA-Katalog aktiv ausgenutzter Lücken). Die brotli-Lücke ist damit eindeutig die erste Baustelle – in der von cut gekappten Spalte RISK steht bei ihr 98.7 (kev), bei allen anderen höchstens 1.0. Gleiches Image, andere Zählung als trivy:

grype -q podman:docker.io/library/nginx:1.30.6-alpine -o json \
  | jq -r '.matches[].vulnerability.severity' | sort | uniq -c

Erwartet:

      5 Critical
     12 High
      3 Medium
     32 Unknown

trivy meldet 1 CRITICAL und 2 HIGH. Beide finden dieselben Pakete, übernehmen aber Schweregrade aus verschiedenen Quellen – trivy bevorzugt die Bewertung der Distribution und warnt mit Using severities from other vendors, wenn es ausweichen muss. Für die Pipeline zählt deshalb, welchen Scanner du mit welcher Schwelle festlegst. Gates bei grype:

grype -q podman:docker.io/library/nginx:1.30.6-alpine --fail-on critical \
  >/dev/null; echo "Exit: $?"
grype -q registry:$REG/notes/notes-api:0.1.0 --only-fixed | cut -c1-72

Erwartet:

Exit: 2
NAME               INSTALLED  FIXED IN  TYPE       VULNERABILITY  SEVERITY
golang.org/x/text  v0.29.0    0.39.0    go-module  GO-2026-5970   High
golang.org/x/text  v0.29.0    0.41.0    go-module  GO-2026-6629   High

--fail-on liefert Exit 2 (nicht 1), --only-fixed blendet Lücken ohne Fix aus. registry: liest direkt aus deiner Registry, Login aus ~/.docker/config.json. Für Go meldet grype die IDs der Go-Datenbank; --by-cve zeigt stattdessen die CVE-Nummern – dieselben wie bei trivy.

Fortschritt speichern? Kostenlos registrieren

Drill 8: SBOM einmal, Scan beliebig oft – syft + grype

Ein Scan aus dem Image dauert, weil der Scanner das Image erst auspackt und katalogisiert. In einer Pipeline erzeugst du die SBOM einmal beim Build (syft, ausführlich an Tag 14) und scannst sie dann so oft du willst – nachts, mit neuer Datenbank, ohne das Image:

syft -q podman:docker.io/library/nginx:1.30.6-alpine -o cyclonedx-json > nginx.cdx.json
ls -l nginx.cdx.json | awk '{print $5, $9}'
time grype -q sbom:nginx.cdx.json --only-fixed --fail-on critical | wc -l
trivy sbom -q --table-mode summary nginx.cdx.json | grep alpine | tr -s ' '

Erwartet:

481929 nginx.cdx.json
50

real    0m37.239s
│ nginx.cdx.json (alpine 3.24.3) │ alpine │ 24 │

Beide Scanner nehmen dieselbe CycloneDX-Datei. grype braucht trotzdem gut 30 s – die meiste Zeit kostet das Laden der 3-GB-Datenbank, nicht das SBOM. trivy findet über die SBOM 24 statt 49 Befunde: Die Paketerkennung von syft und trivy unterscheidet sich im Detail. Bleib in einer Pipeline deshalb bei einem SBOM-Werkzeug und einem Scanner pro Gate.

Als Skript für die Pipeline (liegt im Begleitcode):

cat > sbom-scan.sh <<'EOF'
#!/usr/bin/env bash
# sbom-scan.sh – Stand Ende Tag 13: SBOM einmal erzeugen, dann getrennt scannen
# Aufruf: ./sbom-scan.sh <quelle> [schwelle], z. B.
#   ./sbom-scan.sh podman:localhost/notes-api:0.1.0 high
set -euo pipefail
src=${1:?Quelle angeben, z. B. podman:localhost/notes-api:0.1.0}
fail_on=${2:-high}
name=$(basename "${src#*:}" | tr ':@' '__')
sbom="$name.cdx.json"
syft -q "$src" -o cyclonedx-json="$sbom"
echo "✔ SBOM $sbom: $(jq '.components | length' "$sbom") Komponenten"
if grype -q "sbom:$sbom" --only-fixed --fail-on "$fail_on" -o json > "$name.grype.json"
then
  echo "✔ grype: kein behebbarer Befund ab $fail_on"
else
  rc=$?
  echo "✘ grype: behebbare Befunde ab $fail_on (Exit $rc)"
  jq -r '.matches[] | [.vulnerability.severity, .artifact.name, .vulnerability.id]
         | "  " + join(" ")' "$name.grype.json" | sort -u | head -5 || true
  exit "$rc"
fi
EOF
chmod +x sbom-scan.sh && bash -n sbom-scan.sh
./sbom-scan.sh podman:localhost/notes-api:0.1.0 high; echo "Exit: $?"

Erwartet:

✔ SBOM notes-api_0.1.0.cdx.json: 10 Komponenten
✘ grype: behebbare Befunde ab high (Exit 2)
  High golang.org/x/text GO-2026-5970
  High golang.org/x/text GO-2026-6629
Exit: 2

Die SBOM bleibt als Artefakt liegen – an Tag 14 wird sie signiert an das Image gehängt.

Fortschritt speichern? Kostenlos registrieren

Drill 9: docker scout

Steckbrief docker scout
Aufgabe Images analysieren, CVEs und bessere Basisimages anzeigen
Besonderheit Docker-CLI-Plugin; Abgleich auf der Docker-Scout-Plattform, Docker-Konto nötig
Projekt docs.docker.com/scout, Binaries: github.com/docker/scout-cli
Version im Buch v1.29.0 (Plugin), Docker CE 29.9.2

docker scout ist das einzige Werkzeug im Buch, das Docker voraussetzt. Docker Desktop bringt es mit; auf Ubuntu installierst du Docker CE aus Dockers apt-Quelle und das Plugin separat (docs.docker.com/engine/install/ubuntu und docs.docker.com/scout/install):

sudo apt update && sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin \
  docker-compose-plugin

Erwartet:

Setting up containerd.io (2.4.2-3~ubuntu.26.04~resolute) ...
Setting up docker-compose-plugin (5.6.1-1~ubuntu.26.04~resolute) ...
Setting up docker-ce-cli (5:29.9.2-1~ubuntu.26.04~resolute) ...
Setting up docker-ce (5:29.9.2-1~ubuntu.26.04~resolute) ...

Damit docker ohne sudo läuft, gehört dein User in die Gruppe docker – danach neu anmelden (exit, multipass shell ct-lab) oder für die laufende Shell newgrp docker. Und: Seit Tag 4 setzt ~/.bashrc DOCKER_HOST auf den Podman-Socket. Solange die Variable gilt, spricht auch das echte docker-CLI mit Podman statt mit dem Docker-Dienst. Für diesen Drill nimmst du sie in der Shell zurück:

sudo usermod -aG docker "$USER"
newgrp docker
unset DOCKER_HOST
docker --version
systemctl cat containerd | head -1

Erwartet:

Docker version 29.9.2, build a82e528
# /usr/local/lib/systemd/system/containerd.service

Achtung: Seit Tag 6 liegt nerdctl-full unter /usr/local. Dessen containerd.service in /usr/local/lib/systemd/system hat Vorrang vor der Unit aus dem Paket containerd.io, und /usr/local/bin/containerd steht im PATH vor /usr/bin/containerd. Docker läuft also auf dem containerd von nerdctl-full. Das geht gut, solange beide Versionen zusammenpassen (hier beide 2.4.2) – nach Updates lohnt systemctl cat containerd und containerd --version. Docker 29 legt seine Images übrigens im containerd-Namespace moby ab, nerdctl in default.

Das Plugin liefert Docker als Installationsskript oder als Release-Archiv. Die Doku empfiehlt, das Skript vor dem Ausführen zu lesen:

curl -fsSL https://raw.githubusercontent.com/docker/scout-cli/main/install.sh \
  -o install-scout.sh
less install-scout.sh
sh install-scout.sh
docker scout version

Erwartet:

[info] fetching release script for tag='v1.29.0'
[info] using release tag='v1.29.0' version='1.29.0' os='linux' arch='arm64'
[info] installed /home/ubuntu/.docker/cli-plugins/docker-scout
…
Version: v1.29.0 (go1.26.10-X:jsonv2 - linux/arm64)
git commit: a05e1906e71808ff09ef3a375495b7ca6710da61

Für den manuellen Weg legt die Doku das Binary docker-scout nach $HOME/.docker/scout und trägt den Ordner als cliPluginsExtraDirs (absoluter Pfad) in ~/.docker/config.json ein. Achtung: Dort stehen seit Tag 7 auch die Registry-Logins – die Datei ergänzen, nicht überschreiben.

Sicherheit: Die Ein-Zeilen-Installation lädt ein Skript von main – ohne Pin und ohne Prüfsumme. Im Lab ist das vertretbar, beim Kunden gehört ein geprüftes, versioniertes Release ins interne Paketlager.

docker scout braucht ein Docker-Konto (docker login). Laut Doku wird die SBOM des Images mit der Datenbank der Docker-Scout-Plattform abgeglichen, die über 20 Quellen zusammenführt (u. a. NVD, GitHub Advisory Database, Alpine secdb, Debian Security Tracker, CISA KEV, EPSS).

Ohne Benutzername nutzt docker login die Anmeldung im Browser: Es zeigt einen Einmal-Code und https://login.docker.com/activate. Den Code gibst du dort im Browser ein, in dem du bei Docker Hub angemeldet bist – ein Passwort tippst du in der VM nie.

docker login

Erwartet (gekürzt):

USING WEB-BASED LOGIN
Your one-time device confirmation code is: XXXX-XXXX
Press ENTER to open your browser or submit your device code here:
https://login.docker.com/activate
Waiting for authentication in the browser…
WARNING! Your credentials are stored unencrypted in '/home/ubuntu/.docker/config.json'.
Login Succeeded

Sicherheit: Ohne Credential-Helper landet das Token im Klartext in ~/.docker/config.json – neben den Lab-Logins aus Tag 7. Beim Kunden gehört ein Credential-Store davor (docs.docker.com/go/credential-store/); im Lab meldest du dich am Ende des Tages mit docker logout wieder ab.

Die drei wichtigsten Befehle sind quickview, cves und recommendations:

docker scout quickview docker.io/library/nginx:1.30.6-alpine

Erwartet:

 Target     │  nginx:1.30.6-alpine          │    3C     7H     5M     5L    17?
   digest   │  4f7cab9e1cd0                 │
 Base image │  oisupport/staging-arm64v8:…  │    0C     0H     0M     0L     1?

Policy status  FAILED  (1/7 policies met)
Health score  E  (17%)

 Status │                     Policy                     │           Results
────────┼────────────────────────────────────────────────┼──────────────────────
 !      │ Image runs as the root user                    │
 !      │ Copyleft licensed packages found               │    35 packages
 !      │ Fixable critical or high vulnerabilities found │    3C     6H     0M     0L
 !      │ High-profile vulnerabilities found             │    1C     0H     0M     0L
 !      │ Outdated base images found                     │
 ✓      │ No unapproved base images                      │    0 deviations
 !      │ Required supply chain attestations missing     │    1 deviation

(Momentaufnahme vom 31.10.2026; Tabellen gekürzt.) Die SBOM holt docker scout hier nicht aus dem Image selbst, sondern aus der Attestation, die das nginx-Projekt am Image veröffentlicht (✓ SBOM obtained from attestation, 87 packages found). Dazu kommen Richtlinien („Policies”) der Plattform – etwa „läuft als root” –, die weder trivy noch grype kennen.

quickview (kurz qv) zeigt die CVE-Zahlen je Schweregrad für das Image und sein Basisimage. cves listet die Befunde und kann als Gate dienen:

docker scout cves --only-severity critical,high --only-fixed --exit-code \
  docker.io/library/nginx:1.30.6-alpine; echo "Exit: $?"

Erwartet:

    ✗ Detected 2 vulnerable packages with a total of 9 vulnerabilities
## Overview
 Target            │  nginx:1.30.6-alpine
   digest          │  4f7cab9e1cd0
   platform        │ linux/arm64/v8
   vulnerabilities │    3C     6H     0M     0L
   packages        │ 87
## Packages and Vulnerabilities
   2C     6H     0M     0L  curl 8.22.0-r0
    ✗ CRITICAL CVE-2026-87866
…
   1C     0H     0M     0L  brotli 1.2.0-r1
    ✗ CRITICAL CVE-2026-111497  CISA KEV
      Affected range : <1.2.1-r0
      Fixed version  : 1.2.1-r0
9 vulnerabilities found in 2 packages
  CRITICAL  3
  HIGH      6
Exit: 2

Die ungekürzte Ausgabe ist lang: Zu jedem Paket zeigt docker scout die Dockerfile-Zeile der Schicht, aus der es stammt. CISA KEV markiert Lücken, die laut der US-Behörde CISA bereits aktiv ausgenutzt werden.

--exit-code (kurz -e) liefert Exit 2, sobald Schwachstellen gefunden werden; --format kennt packages (Standard), sarif, spdx, gitlab, markdown und sbom. Die Quelle wählst du per Präfix: local:// (nur lokal), registry://, archive:// (Datei aus docker save), oci-dir://, fs:// und sbom:// – damit scannt auch docker scout eine syft-SBOM:

syft -q podman:docker.io/library/nginx:1.30.6-alpine -o spdx-json \
  | docker scout cves sbom://

Erwartet:

    ✗ Detected 6 vulnerable packages with a total of 37 vulnerabilities
## Overview
 Target            │ <stdin>
   digest          │  4620b1c0abf8
   platform        │ linux/arm64
   vulnerabilities │    5C    13H     5M     5L    34?
   packages        │ 72
## Packages and Vulnerabilities
   2C     6H     0M     0L    16?  libcurl 8.22.0-r0
…
62 vulnerabilities found in 6 packages
  CRITICAL     5
  HIGH         13

Derselbe Scanner, dasselbe Image – und trotzdem mehr Treffer: Die syft-SBOM führt libcurl als eigenes Paket neben curl, die Attestation von nginx nicht. Die Quelle der SBOM bestimmt das Ergebnis mit.

Achtung: Läuft der Podman-Socket aus Tag 4 nicht, findet syft das Image nicht (podman not available: no host address), schreibt eine leere Ausgabe – und docker scout meldet nur ERROR unknown file format. Erst systemctl --user is-active podman.socket prüfen.

Am Ende recommendations: Welche Basisimage-Version hätte weniger Lücken?

docker scout recommendations docker.io/library/nginx:1.30.6-alpine

Erwartet:

 Target   │  nginx:1.30.6-alpine
   digest │  4f7cab9e1cd0
## Recommended fixes
  Base image is  oisupport/staging-arm64v8:d26051d6531a…
Refresh base image
  ✓ This image version is up to date.
Change base image
  ✓ There are no tag recommendations at this time.

Für offizielle Images wie nginx hat docker scout oft nichts zu empfehlen: Sie bauen auf einem internen Staging-Basisimage auf, und 1.30.6 ist der aktuelle Stand. Die neun Lücken oben schließt erst ein neuer nginx-Build mit aktualisiertem curl und brotli.

--only-refresh zeigt nur neuere Builds desselben Tags, --only-update nur neuere Versionen. Für die notes-Images (Podman) gilt: docker scout sieht Dockers eigenen Image-Speicher, nicht den von Podman – der Weg führt über archive:// oder sbom://.

Die drei Scanner im Vergleich (Fakten aus Doku und Live-Test):

Merkmal trivy grype docker scout
Lizenz Apache-2.0 Apache-2.0 Docker Subscription Service Agreement
Datenbank OCI-Artefakt trivy-db, lokal (1.6 GB) grype.anchore.io, lokal (3.2 GB) Docker-Scout-Plattform
Offline ja (--skip-db-update) ja (DB vorab laden) nein (Docker-Konto nötig)
Ziele Image, fs, repo, config, secret, sbom, k8s Image, Ordner, SBOM, PURL/CPE Image, Archiv, fs, SBOM
Formate table, json, sarif, cyclonedx, spdx, … table, json, cyclonedx, sarif, template packages, sarif, spdx, gitlab, markdown, sbom
Gate --exit-code n --fail-on → Exit 2 --exit-code → Exit 2

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

Socket und die Datenbanken beider Scanner:

cd ~/ct-lab/tag13
systemctl --user is-active podman.socket
ls ~/.cache/trivy/db/
grype db status | grep -i status

Erwartet (gekürzt):

active
metadata.json
trivy.db
Status:    valid

Mit .trivyignore besteht notes-api:

trivy image -q --scanners vuln --exit-code 1 localhost/notes-api:0.1.0 >/dev/null
echo "Exit: $?"

Erwartet:

Exit: 0

sbom-scan.sh und die SBOM von notes-api:

ls -l sbom-scan.sh notes-api_0.1.0.cdx.json | cut -c1-10
jq -r .bomFormat notes-api_0.1.0.cdx.json

Erwartet:

-rw-r--r--
-rwxrwxr-x
CycloneDX

Challenge

Behebe die zwei Go-Befunde wirklich: Hebe golang.org/x/text in notes-api auf die Version mit Fix, bau localhost/notes-api:0.1.1 und zeige, dass trivy ohne .trivyignore und sbom-scan.sh mit Schwelle high bestehen.

Hinweis: go get läuft im Container golang:1.27-alpine; trivy liest --ignorefile '' als „keine Ausnahmen”.

Lösung

podman run --rm -v "$PWD/notes-api:/src:Z" -w /src \
  docker.io/library/golang:1.27-alpine \
  sh -c 'go get golang.org/x/[email protected] && go mod tidy' >/dev/null 2>&1
grep 'golang.org/x/text' notes-api/go.mod
podman build -q --format docker --build-arg VERSION=0.1.1 \
  -t localhost/notes-api:0.1.1 notes-api >/dev/null 2>&1
trivy image -q --scanners vuln --ignorefile '' --exit-code 1 \
  localhost/notes-api:0.1.1 >/dev/null; echo "Exit: $?"
./sbom-scan.sh podman:localhost/notes-api:0.1.1 high; echo "Exit: $?"

Erwartet:

    golang.org/x/text v0.41.0 // indirect
Exit: 0
✔ SBOM notes-api_0.1.1.cdx.json: 10 Komponenten
✔ grype: kein behebbarer Befund ab high
Exit: 0

Danach sind die Einträge in .trivyignore überflüssig – löschen. (Der Begleitcode code/tag13 behält die alte Version, damit die Drills oben stimmen.)

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Scanner-Datenbanken zentral spiegeln (trivy: --db-repository auf die eigene Registry; grype: GRYPE_DB_UPDATE_URL) – sonst lädt jede Pipeline Gigabytes und trifft Rate-Limits.
  • SBOM beim Build erzeugen und mit dem Image ablegen (Tag 14); nachts mit frischer Datenbank erneut scannen – neue CVEs tauchen auch ohne neuen Build auf.
  • Gate auf behebbare Befunde ab HIGH (--ignore-unfixed bzw. --only-fixed), Ausnahmen nur mit Ablaufdatum und Ticket; Schweregrade weichen zwischen Scannern ab.
  • Secret-Scan gehört in den Pre-Commit-Hook und ins Image-Gate – was einmal in einer Registry lag, gilt als kompromittiert.
  • docker scout: Datenschutz und Lizenz klären – SBOM-Daten werden auf der Docker-Scout-Plattform abgeglichen; für Air-Gap-Umgebungen ungeeignet.