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 -1Erwartet (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-88Erwartet (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-84Erwartet:
* 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 TotalErwartet (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/grypeErwartet (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-88Erwartet:
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 -cErwartet:
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-72Erwartet:
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-pluginErwartet:
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 -1Erwartet:
Docker version 29.9.2, build a82e528
# /usr/local/lib/systemd/system/containerd.service
Achtung: Seit Tag 6 liegt nerdctl-full unter
/usr/local. Dessencontainerd.servicein/usr/local/lib/systemd/systemhat Vorrang vor der Unit aus dem Paketcontainerd.io, und/usr/local/bin/containerdsteht imPATHvor/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 lohntsystemctl cat containerdundcontainerd --version. Docker 29 legt seine Images übrigens im containerd-Namespacemobyab, nerdctl indefault.
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 versionErwartet:
[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 loginErwartet (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 mitdocker logoutwieder ab.
Die drei wichtigsten Befehle sind quickview,
cves und recommendations:
docker scout quickview docker.io/library/nginx:1.30.6-alpineErwartet:
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 nurERROR unknown file format. Erstsystemctl --user is-active podman.socketprüfen.
Am Ende recommendations: Welche Basisimage-Version hätte
weniger Lücken?
docker scout recommendations docker.io/library/nginx:1.30.6-alpineErwartet:
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 statusErwartet (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.jsonErwartet:
-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-repositoryauf 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-unfixedbzw.--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.