Syft installeren en gebruiken
Installeer de pakketscanner, controleer het pad en maak een eerste SBOM.
Wat je nodig hebt
- Een bron die je mag lezen
- Een release voor jouw OS en CPU-architectuur
-
1
Waarvoor gebruikt Watchtower Syft?
Syft herkent pakketten en versies in hosts, directories en containerimages en maakt een CycloneDX-SBOM. De agent heeft Syft nodig voor host, filesystem, docker en docker-container. De native windows-host- en macos-host-collectors en Jenkins-manifesten kunnen zonder Syft werken.
-
2
Windows: kies een gebruikers- of systeeminstallatie
Voor een eenmalige scan onder je eigen account kun je de community-WinGet-package gebruiken. Open daarna een nieuwe terminal en controleer versie en pad. Voor een beheerde WatchTower-taak onder LocalService is een gebruikersinstallatie niet genoeg: download de officiële windows_amd64-ZIP en de bijbehorende checksum van Anchore, vergelijk de SHA-256, pak syft.exe als administrator uit onder Program Files en zet het absolute pad in agent.json. Windows vraagt mogelijk om beheerdersrechten; geef LocalService alleen lees- en uitvoerrechten. De ZIP-bestandsnaam bevat de gekozen versie.
winget install --id Anchore.Syft --source winget where syft syft versionToon beheerde Windows-installatie na checksumcontrole
# Administrator-PowerShell; vervang <versie> door de gekozen release. $version = '<versie>' $archive = "syft_${version}_windows_amd64.zip" $line = Get-Content "syft_${version}_checksums.txt" | Where-Object { $_.EndsWith(" $archive") } | Select-Object -First 1 if (-not $line -or (Get-FileHash $archive -Algorithm SHA256).Hash -ne $line.Split()[0]) { throw 'Syft-checksum klopt niet.' } Expand-Archive -LiteralPath $archive -DestinationPath "$env:ProgramFiles\WatchTower\Syft" -Force -ErrorAction Stop & icacls.exe "$env:ProgramFiles\WatchTower\Syft" /grant '*S-1-5-19:(OI)(CI)RX' | Out-Null if ($LASTEXITCODE -ne 0) { throw 'LocalService kan Syft niet lezen.' } & "$env:ProgramFiles\WatchTower\Syft\syft.exe" version # Zet dit volledige syft.exe-pad in agent.json. -
3
macOS: installeer met Homebrew
De Homebrew-package wordt door de community onderhouden. Controleer na installatie versie en absoluut pad. Een LaunchDaemon kan een andere PATH hebben dan je Terminal; zet dan het volledige pad bij syft in agent.json. Apple Silicon gebruikt meestal /opt/homebrew/bin/syft, Intel meestal /usr/local/bin/syft; gebruik het werkelijk gevonden pad.
brew tap anchore/syft brew install syft command -v syft syft version -
4
Linux: installeer de officiële binary
De officiële Anchore-installer kiest de huidige release voor de architectuur en plaatst Syft systeemwijd. Leg de uitkomst van syft version vast; kies voor een gepinde release de bestanden en ondertekende checksums uit de officiële releasepagina. Een systemd-service heeft mogelijk een andere PATH dan je shell: gebruik in agent.json bij voorkeur /usr/local/bin/syft.
curl -sSfL https://get.anchore.io/syft | sudo sh -s -- -b /usr/local/bin /usr/local/bin/syft version -
5
Maak een lokale proef-SBOM
Ga eerst naar een kleine, leesbare testmap. Het commando werkt op alle drie OS-en wanneer Syft in PATH staat en schrijft CycloneDX JSON naar de huidige map. De SBOM kan interne pakketnamen en paden bevatten; behandel haar als inventarisdata. Een volledige hostscan is zwaarder.
syft dir:. -o cyclonedx-json=sbom.cdx.json -
6
Koppel Syft aan de agent
Zet het volledige, voor de agentaccount leesbare pad naar Syft bij de JSON-key syft in agent.json. Voorbeelden: Linux
/usr/local/bin/syft, macOS het werkelijk door command -v syft gevonden pad, WindowsC:\\Program Files\\WatchTower\\Syft\\syft.exe. Verdubbel op Windows de backslashes in de JSON-string. De agent start Syft zelf voor de gekozen collectors. Controleer eerst -check-config, voer dan -once uit en beoordeel heartbeat, componenten en collectorfouten in Watchtower.
Klaar wanneer het bewijs zichtbaar is
Controleer in Watchtower of de bron recent is, het componentaantal logisch is en de releasecontext bij de juiste asset staat. Een geslaagde HTTP-call alleen is niet genoeg.