Documentatie / Servers

Linux daemon of cronjob

Scan een host periodiek met Syft en rapporteer zonder applicatiecode te wijzigen.

Wat je nodig hebt

  • Linux met systemd of cron
  • Syft in /usr/local/bin
  • Een token als beveiligd environment-bestand
  1. 1

    Maak een minimale reporter

    Sla dit script op als /usr/local/sbin/watchtower-report, maak het uitvoerbaar voor root en bewaar WATCHTOWER_URL, WATCHTOWER_TOKEN, WATCHTOWER_ASSET en WATCHTOWER_ENVIRONMENT in /etc/cve-watch/report.env met rechten 0600. De reporter schrijft tijdelijk naar een afgeschermd bestand en verwijdert het na verzending. Gebruik de Linux-agentgids als je collectorstatus en beheerde updates nodig hebt.

    #!/usr/bin/env sh
    set -eu
    umask 077
    tmp="$(mktemp)"
    trap 'rm -f "$tmp"' EXIT
    syft dir:/ -o cyclonedx-json="$tmp"
    curl --fail-with-body "$WATCHTOWER_URL/api/inventory/sbom" \
      -H "X-Inventory-Token: $WATCHTOWER_TOKEN" \
      -H "X-Asset-Name: $WATCHTOWER_ASSET" \
      -H "X-Environment: $WATCHTOWER_ENVIRONMENT" \
      -H "X-Hostname: $(hostname -f)" \
      -H "Content-Type: application/vnd.cyclonedx+json" \
      --data-binary "@$tmp"
  2. 2

    Plan de service

    Maak /etc/systemd/system/watchtower-report.service en /etc/systemd/system/watchtower-report.timer met onderstaande inhoud. De service draait als root om systeemsoftware te kunnen lezen; beperk wie het script en het environment-bestand kan wijzigen. De timer start na boot en daarna op een vast interval. RandomizedDelaySec voorkomt gelijktijdige uploads van veel hosts.

    # /etc/systemd/system/watchtower-report.service
    [Unit]
    Description=WatchTower hostinventaris
    
    [Service]
    Type=oneshot
    EnvironmentFile=/etc/cve-watch/report.env
    ExecStart=/usr/local/sbin/watchtower-report
    
    # /etc/systemd/system/watchtower-report.timer
    [Unit]
    Description=WatchTower hostinventaris plannen
    
    [Timer]
    OnBootSec=5m
    OnUnitActiveSec=2h
    RandomizedDelaySec=15m
    Persistent=true
    
    [Install]
    WantedBy=timers.target
  3. 3

    Beperk rechten en valideer

    Geef het environment-bestand alleen leesrecht voor root, controleer de service eerst handmatig en activeer daarna de timer. Controleer de uitvoering in journalctl én de ontvangen asset onder Omgeving → Assets. Een geslaagde systemd-run bewijst nog geen volledige inventaris.

    sudo chmod 0600 /etc/cve-watch/report.env
    sudo systemctl daemon-reload
    sudo systemctl start watchtower-report.service
    sudo journalctl -u watchtower-report.service -n 50 --no-pager
    sudo systemctl enable --now watchtower-report.timer

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.

Open Watchtower