Documentatie / Agents

Websites, CMS en frameworks inventariseren

Kies de juiste projectroot, herken pakketten en beoordeel ontdekte domeinen.

Wat je nodig hebt

  • Een Watchtower Agent met Syft voor packagescans
  • Leesrechten op de gekozen installatie- of projectroot
  • Een eigen assetnaam per volledige softwarebron
  1. 1

    Begin met een lokale preview

    De Linux-agent leest beschikbare Nginx-, Apache- en cPanel-configuraties en toont domein, documentroot of proxy-origin, bron en onzekerheid. Een gevonden domein bewijst nog geen CMS, versie of bereikbaarheid. Includes worden binnen de toegestane configuratiemappen begrensd gevolgd. Namen uit hetzelfde vhostblok worden gegroepeerd; een expliciete redirect kan adressen aan dezelfde website verbinden. Bekijk en corrigeer de mapping voordat je een scan activeert.

    watchtower-agent -discover -config /pad/naar/agent.json
  2. 2

    Proxy en container: van route naar software

    Bij websiteRegistration: candidates leest de agent de lokale proxyconfiguratie en vergelijkt de origin met draaiende Docker- of Podman-containers. Een lokaal IP-adres plus een exact gepubliceerde TCP-poort kan een container bevestigen. Een containernaam wordt alleen gebruikt wanneer de config aantoonbaar in de proxycontainer is gemount en de doelcontainer hetzelfde netwerk deelt. De agent leest alleen beperkte inspectmetadata; geen omgevingsvariabelen, wachtwoorden of volledige procesargumenten. Een Nginx Proxy Manager-include kan via de read-only containerarchive-API worden gelezen. Er wordt geen commando in de applicatiecontainer uitgevoerd.

  3. 3

    Eén website met meerdere bronagents

    Watchtower toont hetzelfde bevestigde hoofdadres binnen één omgeving als één websitegroep, ook als een proxyagent en een applicatieagent het allebei zien. Onder Dekking & bewijs staat iedere oorsprong met haar agent, installatiepad, scanmoment en afzonderlijke softwarebron. Bevestigde componenten en kwetsbaarheden van die bronnen verschijnen samen in het dossier; een kwetsbaarheid met hetzelfde advies-ID wordt in de samenvatting één keer geteld, terwijl verschillende getroffen installaties zichtbaar blijven. Open Bewerken om groepen expliciet samen te voegen of met Oorsprongen per agent apart tonen weer te scheiden. Een gedeelde domeinnaam bewijst nog niet dat beide agents dezelfde installatie lezen; de SBOM-koppeling vraagt daarom eigen agent-, groep- en rootbewijs. Bij Inventaris activeren kies je een bronagent en download je precies voor die agent één voorstel. Controleer conflicten en verouderde origins voordat je het plan toepast.

  4. 4

    Optioneel automatisch registreren met allowlists

    Standaard staat autoRegister uit. review houdt de bevestiging bij de beheerder. confirmed voegt tijdens start en volgende volledige scans alleen nieuwe, bevestigde websitebronnen toe die binnen allowedDomains en een toegestane lokale root of expliciet genoemde container vallen. Een gedeeltelijke webconfiguratiescan, redirect, onleesbare projectroot of onbekende container leidt nooit tot automatische activatie. Per ronde gelden maximaal maxNew nieuwe collectors; de agent controleert de oorsprong opnieuw, schrijft een privébackup en scant de toegevoegde collectors bij de volgende run. Gebruik kleine allowlists, sluit test-/onderhoudsdomeinen expliciet uit en controleer de agentstatus na activering. Bestaande collectors en assetnamen blijven behouden.

    {
      "discovery": {
        "websiteRegistration": "candidates",
        "autoRegister": {
          "mode": "confirmed",
          "allowedDomains": ["*.example.test"],
          "excludedDomains": ["staging.example.test"],
          "allowedRoots": ["/srv/www"],
          "allowedContainers": ["public-site"],
          "maxNew": 2
        }
      }
    }
    
  5. 5

    Begeleid activeren en een concept hervatten

    Selecteer in Websites & diensten één of meer websitegroepen en kies Activeren. De pagina laat eerst de gevonden installaties en onzekerheden zien. Kies daarna de bronagent, omgeving en eventuele uitsluitingen, controleer het voorgestelde resultaat en download per agent één JSON-plan. Een onbevestigde origin wordt niet stilzwijgend opgenomen. Je selectie en scaninstellingen blijven tijdens deze browsersessie als tenantgebonden concept bewaard; via Scanconcept hervatten in het overzicht kun je verdergaan. Bij het toepassen controleert de agent de route opnieuw, maakt hij een privébackup en bewaart hij bestaande collectors. Alleen het downloaden verandert de agentconfiguratie niet.

  6. 6

    Activeer een containerwebsite

    Open de gevonden website en kies Inventaris activeren. Controleer het doel, de container-ID, het imagedigest en de omgeving. Download het voorstel en pas het toe met -activate-websites. Een bestaande docker-container-collector wordt hergebruikt; anders komt er één collector voor die container bij. Meerdere websites kunnen dezelfde imagebron delen. De agent controleert de route opnieuw voordat hij het plan toepast. Bij een gewijzigde container of image moet je een nieuw voorstel maken. Een remote host met toevallig dezelfde poort wordt nooit gekoppeld.

    watchtower-agent -discover -config /etc/cve-watch/agent.json -website-plan /tmp/websites.json
    # Controleer websites.json en verwijder niet gewenste onderdelen.
    watchtower-agent -activate-websites /tmp/websites.json -config /etc/cve-watch/agent.json
    
  7. 7

    Wanneer blijft een containerkoppeling onbevestigd?

    De agent bevestigt de lokale container via hostprocesgegevens en houdt rekening met de eigen netwerkruimte van de proxy, localhost en IPv6. Een remote engine of niet zichtbare hostprocessen krijgen geen automatische lokale websitekoppeling. Onopgeloste host- of poortvariabelen worden gemeld; er wordt geen standaardpoort gegokt.

  8. 8

    Wat bewijst een containerinventaris?

    De softwarelijst bevat de pakketten die Syft in het bevestigde image aantreft. Watchtower controleert daarbij agent, websitegroep, omgeving, endpoint, container-ID en imagedigest tegen het ontvangen SBOM-bewijs. Dit is image-inventaris; het bewijst niet dat iedere library op dit moment geladen is. Bestanden in volumes en wijzigingen in de beschrijfbare containerlaag ontbreken in een imagescan. Gebruik voor zulke applicatiebestanden aanvullend een websitecollector op een expliciet leesbare projectroot. Een host-network-container, indirecte remote proxyketen of onduidelijke route blijft ongekoppeld totdat er passend bewijs is.

  9. 9

    Websites selecteren en beheren

    In Websites & diensten kies je één of meer rijen met de selectievakjes. De acties rechts van de filters verschijnen pas na selectie. Activeren maakt een voorstel voor bevestigde softwarebronnen; het installeert niets zonder de daaropvolgende agentstap. Archiveren verbergt een website uit het actuele overzicht en bewaart de historie. Verwijderen plaatst de website in de herstelbare prullenbak. Via Toon: Gearchiveerd of Prullenbak kun je een selectie herstellen. Beweeg met de muis over een actie of geef de knop toetsenbordfocus voor een korte uitleg. De hulp bij de paginatitel legt databron, volgende stap en gevolg van een actie uit.

  10. 10

    Als beveiligingsregels de verkenning beperken

    De agent leest poorten, processen, containerdaemon en webserverconfiguratie met de rechten van zijn eigen account. Bij ontbrekende rechten, een afgeschermde socket of een SELinux/AppArmor-regel geeft hij geen lege lijst als bewijs van volledige dekking. Bij websiteRegistration: candidates zie je onder Verzameling → Agents → Serververkenning welke laag gedeeltelijk is, wanneer dit is waargenomen en welke toegang je moet controleren. Een afzonderlijke website toont de precieze installatie- of originfout in haar dossier. Een permission denied is niet automatisch bewijs van SELinux; controleer de auditlog en de policy op de host voordat je die oorzaak vaststelt. Gebruik -doctor voor lokale voorwaarden en -discover voor een preview; herstel alleen de benodigde leesrechten en voer daarna opnieuw -once uit. De agent publiceert veilige diagnosecodes, geen raw stderr, tokens of configuratie-inhoud.

    watchtower-agent -doctor -config /etc/cve-watch/agent.json
    watchtower-agent -discover -config /etc/cve-watch/agent.json
    
  11. 11

    Interne websites en ontbrekende dekking

    De standaardlijst zet alleen technische localhost- en loopbackvermeldingen apart. Websites met een eigen domeinnaam blijven zichtbaar, ook bij onderhoud; herkenbare onderhoudsconfiguratie krijgt een aparte status en filter. Publieke statuswebsites blijven zichtbaar. Gebruik Toon: Interne vermeldingen of Inclusief interne websites voor de technische vermeldingen. Er worden geen waarnemingen verwijderd. Bij een niet bewezen origin toont het dossier de precieze fout, het onderzochte doel en de herstelactie. Een onbekende inventaris krijgt geen groene nul kwetsbaarheden. Alleen een ontvangen en aantoonbaar gekoppelde softwarebron maakt versie- en risico-inzicht mogelijk.

  12. 12

    Wat wordt werkelijk ondersteund?

    Ondersteund betekent dat de collector de genoemde geïnstalleerde metadata kan lezen wanneer de bestanden bereikbaar zijn. Het is geen belofte dat ieder pakket of iedere custom plugin wordt gevonden. Syft bepaalt de herkenning van algemene packageformaten; de agent voegt site- en runtimecontext toe. Een onbekende versie blijft onbekend.

    BronWat wordt gelezen?Grenzen
    WordPressCoreversie uit wp-includes/version.php; pluginheaders in mappen, losse PHP-plugins en mu-plugins; thema-style.cssGeïnstalleerd; activiteit alleen via een expliciete, actuele export; database-inhoud wordt niet door de agent gelezen.
    Composer / PHPGeïnstalleerde Composer 1/2-librarymetadata; composer.lock afzonderlijk als vastgelegde intentie; Syft bij filesystem-modusSymfony en Laravel volgen package-metadata. Drupal, TYPO3, Magento en Shopware krijgen gerichte Composer- en lokale extensieadapters.
    DrupalCoreconstante, contrib .info.yml en gerichte drupal/* ComposerpackagesLockversies zijn geen installatiebewijs; actieve modulestatus blijft onbekend.
    JoomlaCore- en extensie-XML uit de projectrootCustom extensies zonder versie en actieve extensiestatus blijven onbekend.
    TYPO3Lokale ext_emconf.php plus typo3/* en typo3-cms-extension ComposerpackagesOnleesbare of ontbrekende metadata geeft gedeeltelijke dekking.
    Magentoapp/code-Composerbestanden plus magento/* en magento2-* ComposerpackagesComposer-installed.json bewijst installatie; lockfile alleen niet.
    Shopwarecustom/plugins-Composerbestanden, custom/apps-manifests en productgebonden ComposerpackagesApplicatieactivatie en extensies zonder versie blijven onbekend.
    npm / JavaScriptLockfiles en geïnstalleerde npm-packagegegevens via SyftNext.js, Nuxt, React en Vue zijn packageversies; geladen runtimecode wordt hiermee niet bevestigd.
    PythonToegankelijke dist-info en package-metadata via SyftDjango, Flask en FastAPI vereisen een leesbare projectomgeving of virtualenv.
    JavaJAR-manifests en Maven-metadata via SyftEen Spring Boot- of Tomcat-deployment moet binnen target liggen.
    .NETToegankelijke deps.json en bijbehorende package-metadata via SyftEen gepubliceerde applicatie zonder deze metadata kan onvolledig zijn.
    RubyGemfile.lock en zichtbare RubyGems-metadata via SyftEen Rails-versie moet in de bereikbare bundlemetadata staan.
    OS-pakkettendpkg, RPM en apk via een aparte host- of imagecollectorEen webserverpakket hoort bij host/image; een vhost alleen toont geen pakketversie.
    Jenkins / Windows / macOSEigen Jenkins-, windows-host- en macos-host-collectorsDit zijn aparte bronnen en geen website-CMS-plugins.
  13. 13

    WordPress-kwetsbaarheden en updateadvies

    De agent levert geïnstalleerde plugin- en themaversies aan; Watchtower vergelijkt hun publieke WordPress-slug en versie op de server met WPVulnerability. Die publieke advisorybron gebruikt onder meer verwijzingen naar CVE-records en specialistische WordPress-bronnen. Er is geen extra agent of Wordfence-account nodig. Een getroffene versie verschijnt onder Kwetsbaarheden & risico’s, inclusief herstelde versie wanneer de bron die exact aangeeft. De bestaande notificatie- en ticketregels blijven van toepassing. Installeer updates zelf na controle van de bron en je eigen test-/backupprocedure.

  14. 14

    Privacy, actualiteit en ontbrekende advisorydekking

    Naar WPVulnerability wordt uitsluitend de plugin- of thema-slug gestuurd: geen domeinnaam, tenant, sitepad, token of geïnstalleerde versie. Versievergelijking gebeurt binnen Watchtower. Publieke brondata en pakketresultaten worden maximaal een uur gecachet; uitgaande bronvragen zijn begrensd op 30 per minuut. Een onbekende/private of hernoemde plugin, onleesbare bron of niet ondersteunde versiegrens krijgt geen veilige uitslag. De website toont hoeveel WordPress-componenten beoordeeld zijn en welke broncontrole nog ontbreekt. Een ontvangen inventaris is apart van een afgeronde kwetsbaarheidscontrole: een wachtrij of verwerkingsfout blijft zichtbaar bij de website. Eerdere bevindingen worden bij ontbrekende controle niet automatisch opgelost. Niet iedere plugin heeft een publieke advisory of betrouwbare upstream-identiteit. Een melding zonder ernstscore blijft als onbekend herkenbaar; er wordt geen ernst of herstelde versie gegokt.

  15. 15

    Onbekende en informatieve ernst onderscheiden

    Een advisory zonder betrouwbare score staat als Onbekend. Een bron die uitdrukkelijk CVSS 0 aanlevert, staat als Informatief. Voor een advies met een officiële CVE-identiteit probeert de server op de achtergrond een begrensde NVD-CVSS-controle; maximaal vijf CVE-identiteiten per scheduleruitvoering, met een vijfminutenritme. De UI toont score en bron bij het websiterisico. Onbereikbare bronnen, ontbrekende metrics en conflicterende scores blijven controlepunten en worden niet automatisch Laag. Een geaccepteerd maar technisch nog getroffen risico blijft als actuele impact zichtbaar. De naam, versie en hostname van je installatie worden niet voor deze scorecontrole verstuurd; alleen het publieke CVE-nummer.

  16. 16

    Voorbeeld van versiegebonden hersteladvies

    Als een advisory voor een plugin de getroffen versies als lager dan 1.5.4 opgeeft, is een aangetroffen 1.5.3 getroffen en kan 1.5.4 als herstelde versie worden getoond. Bij een grens tot en met 1.5.3 mag Watchtower geen volgende patchversie verzinnen: zonder bevestigde herstelde versie verwijst het dossier naar de bron. Inventaris bewijst installatie; pluginactiviteit, exploitatievoorwaarden en eventuele eerdere compromittering blijven afzonderlijke vragen.

  17. 17

    WordPress en WooCommerce

    Gebruik target voor de map met wp-includes/ en wp-content/. cms: wordpress leest de core, geïnstalleerde plugins zoals WooCommerce en thema’s. includePackages: true voegt bereikbare Composer- en andere Syft-packages toe. Geef een eigen asset per WordPress-installatie; meerdere domeinen op één installatie kunnen dezelfde software delen. Sluit uploads, caches en configuratiebestanden uit.

    {
      "type": "website",
      "name": "blog-components",
      "target": "/path/to/wordpress",
      "asset": "blog-production",
      "environment": "production",
      "settings": {
        "domain": "blog.example.test",
        "cms": "wordpress",
        "includePackages": true,
        "excludePaths": ["wp-config.php", "wp-content/uploads/**", "wp-content/cache/**"]
      }
    }
    
  18. 18

    Symfony, Laravel, Drupal, Magento en Shopware

    Laat settings.cms weg en zet includePackages aan. Kies als target de projectroot met composer.lock en eventueel vendor/, vaak de bovenliggende map van public/. Symfony/framework-bundle, laravel/framework, drupal/core, magento/product-community-edition en shopware/core kunnen dan als Composer-package met versie meekomen wanneer de metadata aanwezig is. De agent leest nu geen eigen Drupal-modulelijst, Magento-moduleconfiguratie of Shopware-pluginregister buiten Composer; markeer deze dekking als aanvullend werk.

    {
      "type": "website",
      "name": "portal-packages",
      "target": "/path/to/project",
      "asset": "portal-production",
      "environment": "production",
      "settings": {
        "domain": "portal.example.test",
        "includePackages": true,
        "excludePaths": ["var/cache/**", "var/log/**", ".env*"]
      }
    }
    
  19. 19

    TYPO3, Joomla, PrestaShop, OpenCart en Shopify

    Voor zelfgehoste TYPO3-, Joomla-, PrestaShop- en OpenCart-projecten kun je een websitecollector met includePackages: true en zonder cms instellen op de projectroot. Watchtower neemt alleen pakketten mee die Syft in bereikbare Composer-, npm- of andere ondersteunde metadata herkent. Een volledige lijst van niet via een package-manager geïnstalleerde extensies/modules is hiervoor nog niet beschikbaar. Shopify is gehost buiten de eigen server: een lokale agent kan de Shopify-core en geïnstalleerde apps niet uit het filesystem inventariseren; daarvoor is een afzonderlijke, geautoriseerde Shopify-API-koppeling nodig.

  20. 20

    Next.js, Nuxt, React, Vue en andere npm-projecten

    Gebruik dezelfde websitecollector met includePackages: true en richt target op de projectroot met package-lock.json, yarn.lock, pnpm-lock.yaml of geïnstalleerde packages. Laat cms weg. De agent claimt alleen de door Syft aangetroffen packageversies; een gebundelde statische frontend kan minder metadata bevatten dan de buildomgeving. Koppel een build-SBOM als aanvullende bron wanneer de server alleen gecompileerde bestanden bevat.

    {
      "type": "website",
      "name": "frontend-packages",
      "target": "/path/to/frontend",
      "asset": "frontend-production",
      "environment": "production",
      "settings": {
        "domain": "app.example.test",
        "includePackages": true,
        "excludePaths": [".env*", "logs/**"]
      }
    }
    
  21. 21

    Python, Ruby, Java en .NET websites

    Richt target op de uitgevoerde installatie of het gepubliceerde buildresultaat, met respectievelijk dist-info/virtualenv, Gemfile.lock, JAR/WAR-metadata of deps.json. Laat cms weg en zet includePackages aan. Als de runtime buiten de webroot staat, moet target naar die project- of deploymentmap wijzen. Syft herkent alleen bereikbare metadata; aanvullende host- en containercollectors geven OS- en imagepakketten.

  22. 22

    Automatisch registreren of handmatig bevestigen

    discovery.websiteRegistration staat standaard op off: -discover blijft lokaal en je kunt met -proposal een bewerkbaar collectorvoorstel maken. De waarde candidates stuurt read-only vhostwaarnemingen naar Watchtower, waar ze als voorlopige websites met dekkingsmelding verschijnen. Ook een domein zonder documentroot blijft zichtbaar. Alleen het publiceren van een website-SBOM creëert een softwareasset; een configuratiewaarneming alleen doet dat niet. Een beheerder selecteert websitegroepen en controleert het scanvoorstel. Bij de geactiveerde sitecollector bevestigt Watchtower de softwarekoppeling aan de hand van groeps-ID, installatiepad, omgeving en ontvangen SBOM. Alleen een overeenkomstige assetnaam is onvoldoende.

    "discovery": {
      "websiteRegistration": "candidates",
      "maxWebsites": 128
    }
    
  23. 23

    Beoordeel fouten en onvolledig bewijs

    Een domein zonder documentroot blijft zichtbaar met de melding Geen documentroot of bevestigde origin. Een niet-gevolgde include of onleesbare configuratie krijgt een dekkingsmelding. Controleer de webserverconfig, rechten en de origin; koppel pas daarna een asset. Watchtower maakt geen pluginversie of CVE-impact op basis van alleen een domein- of HTTP-fingerprint.

  24. 24

    Van gevonden website naar software-inventaris: kies de installatie

    Controleer de gevonden documentroot of proxy-origin. De agent moet de bestanden van de echte applicatie kunnen lezen. Bij WordPress is target de map met wp-includes en wp-content. Bij Symfony en andere Composer-projecten kies je de projectroot met composer.lock en vendor, vaak één niveau boven public. Bij een reverse proxy zoek je eerst de achterliggende applicatie op: alleen de proxyconfig scannen levert geen applicatiepackages. Een pad binnen een container is niet automatisch hetzelfde pad op de host.

  25. 25

    Voeg één websitecollector toe aan je bestaande configuratie

    Gebruik het passende JSON-voorbeeld hierboven en voeg het object toe aan de bestaande collectors-lijst. Behoud de overige collectors, agentidentiteit en authenticatie. Kies een vaste assetnaam voor de installatie en dezelfde omgeving als de website. Kies één hoofddomein als meerdere aliassen dezelfde installatie gebruiken; voeg voor die aliassen geen identieke sitecollectors toe. Zet includePackages aan voor een aanvullende Syft-packagescan. De agentaccount heeft lees- en maptoegangsrechten nodig op de installatie; geef alleen de benodigde rechten.

  26. 26

    Optioneel: schrijf een voorstel naar een nieuw bestand

    Dit commando schrijft een nieuwe bewerkbare configuratie en laat het actieve bestand staan. Het voorstel kan ook host- en containercollectors toevoegen; controleer daarom de volledige collectors-lijst en verwijder ongewenste of dubbele scans. Sitevoorstellen gebruiken leesbare ontdekte installaties en projectroots. Voor alleen websites heeft het kleinere -website-plan de voorkeur; dat bevat geen host- of containercollectors en geen agenttoken. Het voorstel bevat de authenticatie uit de invoerconfig: bewaar het privé. Het aanmaken van het voorstel uploadt geen inventaris en activeert het bestand niet.

    watchtower-agent -discover -config /path/to/agent.json -proposal /path/to/agent.proposed.json
    
  27. 27

    Controleer de configuratie en voer één inventarisrun uit

    Voer dit uit na het aanpassen van je configuratie. check-config controleert JSON en routing, maar test geen leesrechten, Syft of verbinding. once voert alle ingestelde collectors uit en uploadt hun inventaris naar de ingestelde Watchtower-server. Controleer per collector of inventory published verschijnt en of de run zonder fout eindigt. Gebruik vervolgens ditzelfde configuratiepad in je bestaande agentservice of planner voor periodieke scans; een voorstel wordt niet automatisch de actieve serviceconfiguratie.

    watchtower-agent -check-config -config /path/to/agent.json
    watchtower-agent -once -config /path/to/agent.json
    
  28. 28

    Eenvoudig activeren vanuit Watchtower

    Open Websites & diensten en selecteer websitegroepen van één agent en omgeving. Kies Activeren. Controleer de installaties, package-scan en uitsluitingen; Onbevestigde origins blijven met een herstelmelding staan en worden niet in het voorstel opgenomen. Bevestigde containerorigins krijgen een imagecollectorvoorstel. Download het scanvoorstel en plaats het op de server waar deze agent draait. Het bestand bevat geen token. De download start nog geen scan.

    watchtower-agent -config /path/to/agent.json -activate-websites /path/to/watchtower-websites.json
    
  29. 29

    Of gebruik uitsluitend de command-line

    Het eerste commando ontdekt lokaal websitegroepen en schrijft een nieuw scanvoorstel voor leesbare installaties. Controleer het bestand en verwijder ongewenste sites. Het tweede commando vergelijkt de groepen en installatiepaden opnieuw met de lokale waarnemingen, controleert Syft indien nodig, maakt een privébackup van de bestaande agentconfig en slaat de sitecollectors atomair op. Bestaande overige collectors blijven behouden. Daarna scant het uitsluitend de geactiveerde sites. Het voorstel is gebonden aan de agentId; een verouderde of afwijkende oorsprong wordt geweigerd.

    watchtower-agent -config /path/to/agent.json -discover -website-plan /path/to/watchtower-websites.json
    watchtower-agent -config /path/to/agent.json -activate-websites /path/to/watchtower-websites.json
    
  30. 30

    Periodiek scannen en gericht opnieuw verzamelen

    Een draaiende agent leest geldige collectorwijzigingen binnen circa 30 seconden opnieuw in. Wijzig je transport, authenticatie of agentidentiteit, herstart dan de service. De bestaande interval en jitter bepalen de periodieke scans. De activatieopdracht voert zelf de eerste gerichte scan uit; een configuratieherlading alleen start geen dubbele scan. Gebruik het volgende commando om later alle ingestelde websitecollectors opnieuw uit te voeren. Andere host- en containercollectors worden hierbij overgeslagen.

    watchtower-agent -config /path/to/agent.json -once -websites-only
    
  31. 31

    Versies, bevindingen en dekking openen

    Iedere websitegroep is doorklikbaar, ook vóór activering. Overzicht toont applicatie, origins, agentstatus en ontbrekend bewijs. Software & versies bevat de ontvangen componenten met filters op type, ecosysteem, versie, oorsprong, bron en actuele of verdwenen componenten. Kwetsbaarheden & risico’s gebruikt bewezen matches met de site-inventaris. Dekking & bewijs toont configuratie, leesbaarheid, catalogisering en runtimewaarnemingen. Historie toont eerdere snapshots, versieverschillen en handmatige groepsbeslissingen. Een lege lijst bij ontbrekend bewijs betekent geen veilige website.

  32. 32

    Aliassen en meerdere origins beheren

    Domeinen uit hetzelfde Nginx server_name- of Apache VirtualHost-blok delen één groep. Een gedeelde bestandsnaam of root alleen voegt geen onafhankelijke vhosts samen. Kies Groepering beheren om hoofdadres te wijzigen, groepen samen te voegen, aliassen toe te voegen of adressen af te splitsen. Handmatige keuzes blijven na rescans behouden. Automatische aliassen die bij een volledige waarneming verdwijnen, verdwijnen uit het actuele overzicht; historische referenties blijven bestaan. Een gedeeltelijke scan verwijdert geen onbewezen ontbrekende adressen.

  33. 33

    Een verplaatste actuele installatie configureren

    Verwijst de webserverconfig naar een oud pad terwijl de actuele bestanden op een andere locatie staan? Leg de exacte padmapping vast in de agentconfig. De agent bewaart het geconfigureerde pad en leest de werkelijke installatie. Controleer eerst dat deze bestanden daadwerkelijk de actuele bron zijn: een backup mag geen actuele software-impact opleveren. Een padmapping bevestigt ook niet welke runtime de site uitvoert. Ontbreekt de applicatie op deze host volledig, gebruik dan een agent op de echte origin of een passende build-/containerbron.

    {
      "discovery": {
        "websiteRegistration": "candidates",
        "webRootMappings": {
          "/legacy/sites": "/srv/sites"
        }
      }
    }
    
  34. 34

    PHP-, Java-, .NET- en Node.js-runtimeversies beoordelen

    De agent verbindt een lokale FPM-socket of loopback proxy-poort met het zichtbare luisterende proces. Op Linux gebruikt PHP de buildmetadata of het pakket van de werkelijk gekoppelde FPM-executable, Java de release-metadata van die JVM, .NET de geladen libcoreclr-versie en Node.js uitsluitend de versie van het pakket dat aantoonbaar eigenaar is van de luisterende executable. Op macOS kan lsof een lokale listener en de inode van de executable bevestigen; versiegegevens volgen dan uit een versioned installatiepad, JDK-release of geladen libcoreclr. Op Windows koppelt de agent een lokale TCP-listener via PID en executable-versie aan Java, .NET, Node.js of PHP; een Windows-service wordt alleen vermeld wanneer precies één service bij dat PID hoort. Een vereiste versie uit runtimeconfig.json krijgt het label Vereist; gebruik onbevestigd. Onleesbare processen, remote origins en niet-bevestigde containerprocessen blijven Onbekend. Een CLI-versie of imagetag alleen bewijst geen gebruikte site-runtime.

  35. 35

    IIS-websites en app pools op Windows

    De Windows-agent leest de actieve IIS applicationHost.config begrensd en groepeert bindings van één IIS-site als adressen van dezelfde website. Per site ziet hij de fysieke root en de app pool. managedRuntimeVersion van die app pool toont hij als vereiste CLR-configuratie, niet als exact gebruikte .NET-versie. Als het workerproces w3wp.exe aan die app pool kan worden gekoppeld en een geladen coreclr.dll of clr.dll met versie zichtbaar is, toont hij daarnaast een bevestigde runtime. Een .runtimeconfig.json is ook alleen een vereiste versie. Ontbrekende leesrechten op IIS-configuratie of workerproces leveren gedeeltelijke dekking op; de agent raadt geen runtime. Stel discovery.websiteRegistration in op candidates om deze websitewaarnemingen naar Watchtower te sturen. Er is voor deze release geen fysieke Windows-testhost beschikbaar: parser-, proces- en pakketfixtures en een Windows-crossbuild zijn uitgevoerd; controleer op jouw IIS-host met -discover en -doctor.

  36. 36

    Lokale WordPress-manifesten en package-identiteit

    Een package.json direct in een WordPress-plugin- of themamap beschrijft vaak het eigen ontwikkelproject. Dat bewijst geen gelijknamig npm-registryproduct. De websitecollector behoudt naam en versie als inventaris, maar verwijdert onbevestigde registry-purls en afgeleide CPE’s. Dependencies onder node_modules blijven afzonderlijk herkenbaar. Dit voorkomt een onterechte kwetsbaarheidsmatch met een ander gelijknamig npm-pakket.

  37. 37

    WordPress-activiteit uit een expliciete export

    Stel bij een WordPress-site settings.wordpressActivationFile in. Een vertrouwde beheerautomatisering maakt de export maximaal eens per 24 uur en markeert complete alleen wanneer alle plugin- en themastatussen voor de opgegeven site zijn opgehaald. Bij multisite zet je de gewenste hostnamen in settings.wordpressSites en levert de export een compleet item per site. De agent leest het bestand begrensd, verifieert tijd en sites en koppelt uitsluitend de slugs aan eerder vastgestelde geïnstalleerde versies. Ontbreekt de export, is hij te oud of onvolledig, dan blijft de activiteit onbekend. De agent start geen WordPress-code of WP-CLI en verzendt geen credentials. Je kunt de export bijvoorbeeld vanuit een vertrouwde WP-CLI-taak opbouwen met wp plugin list --fields=name,status,version --format=json --skip-update-check en wp theme list --fields=name,status,version --format=json --skip-update-check; die taak draait onder eigen applicatierechten. WP-CLI met --skip-plugins laadt volgens de officiële documentatie nog altijd must-use plugins; voer zo’n export daarom alleen uit in een vertrouwde omgeving. In Software & versies filter je op actief, inactief of onbekend.

    {
      "settings": {
        "domain": "portal.example.test",
        "cms": "wordpress",
        "wordpressActivationFile": "/etc/watchtower/site-activation.json",
        "wordpressSites": ["portal.example.test", "shop.example.test"]
      }
    }
    
  38. 38

    Voorbeeld van het afzonderlijke activatie-exportbestand

    Dit JSON-object staat in het bestand van settings.wordpressActivationFile. generatedAt is het echte exportmoment in UTC; gebruik geen vaste voorbeelddatum in productie. complete is alleen true na een volledige, geslaagde statusopvraag van de betreffende site.

    {
      "schema": 1,
      "generatedAt": "2026-11-04T09:00:00Z",
      "sites": [
        {"domain": "portal.example.test", "complete": true, "activePlugins": ["akismet"], "activeThemes": ["site-theme"]},
        {"domain": "shop.example.test", "complete": true, "activePlugins": ["shop-plugin"], "activeThemes": ["shop-theme"]}
      ]
    }
    
  39. 39

    Drupal, Joomla, TYPO3, Magento en Shopware instellen

    Gebruik voor ieder product een websitecollector op de echte projectroot en kies settings.cms: drupal, joomla, typo3, magento of shopware. Drupal leest een coreconstante en versies uit contrib .info.yml; Joomla core- en extensie-XML; TYPO3 lokale ext_emconf.php; Magento lokale app/code-Composerbestanden; Shopware custom/plugins-Composerbestanden en app-manifests. Drupal, TYPO3, Magento en Shopware lezen ook gericht geïnstalleerde Composerpackages voor hun core en uitbreidingen. Hiervoor is geen Syft nodig; zet includePackages: true voor de bredere dependencyinventaris. Een ontbrekende installed.json levert hooguit vastgelegde lockversies op, zichtbaar als installatie onbevestigd. Lokale extensies zonder bevestigde registry-identiteit hebben onvolledige kwetsbaarheidsdekking; actief/inactief wordt voor deze vijf producten niet uit een database gegokt. De agent voert geen PHP, Composer of applicatiecode uit.

    {
      "type": "website",
      "name": "portal-cms",
      "target": "/srv/www/portal",
      "asset": "portal-production",
      "environment": "production",
      "settings": {
        "domain": "portal.example.test",
        "cms": "drupal",
        "includePackages": true,
        "packageMode": "auto"
      }
    }
    
  40. 40

    Projectroot en cms-waarde per product

    Kopieer het vorige collectorvoorbeeld en verander settings.cms en target. Drupal: drupal, root met core of web/core. Joomla: joomla, root met administrator/manifests/files/joomla.xml. TYPO3: typo3, projectroot met typo3conf/ext of packages. Magento: magento, root met app/etc/config.php en app/code. Shopware: shopware, root met custom/plugins of custom/apps. Een target op alleen de publieke submap kan Composer-metadata buiten die map missen. Een scan onderzoekt maximaal 512 lokale extensiemanifests en meldt onleesbare paden en ontbrekende versies; hij kapt geen bewezen versies stil af. Controleer met -discover, -check-config en -once -websites-only.

  41. 41

    Websites selecteren, archiveren en verwijderen

    Selecteer een of meer websites met de selectievakjes. Boven de lijst verschijnt dan de actiebalk, naast de filters. Activeren maakt het bestaande scanvoorstel; Archiveren verbergt de groep uit het actuele overzicht. Verwijderen verplaatst de groep naar een herstelbare prullenbak. Agentrescans maken een handmatige archivering of verwijdering niet ongedaan; ook nieuwe aliassen van dezelfde bekende bron krijgen de bestaande keuze. Gebruik Toon → Gearchiveerd of Prullenbak en Herstellen om de groep terug te zetten. Software- en kwetsbaarheidshistorie worden niet gewist. Bulkacties zijn beperkt tot zichtbare referenties binnen je workspace en vereisen beheerrechten.

  42. 42

    Kwetsbaarheden en versiekleuren lezen

    De lijst toont actuele unieke kwetsbaarheden per website, gegroepeerd op hoogste ernst met een icoon en tekstlabel. Een kwetsbaarheid die zowel een runtime als een framework raakt telt als één websitekwetsbaarheid, maar beide componentlocaties blijven zichtbaar. Op Overzicht krijgt elke bevestigde versie zijn eigen hoogste actuele ernst en een link naar de kwetsbaarheden. PHP, Java/.NET en frameworks gebruiken dezelfde matcher; een aanwezige versienaam alleen vormt geen kwetsbaarheidsbewijs. Lockfile-versies zonder bevestigde installatie blijven apart en tellen niet als bewezen website-impact. Nul matches betekent geen veiligverklaring; ontbrekende inventaris krijgt geen kunstmatige nul.

  43. 43

    Een website bewerken

    Gebruik Bewerken rechts van de websitetitel voor een herkenbare naam, hoofdadres, aliassen, samenvoegen of splitsen. De naam verandert alleen de weergave; de assetrouting en agentidentiteit blijven aan de inventaris gekoppeld. Archiveer oude of verplaatste bronwaarnemingen om ze uit het actuele overzicht te halen. Historie blijft beschikbaar via het filter Gearchiveerd en een rescan maakt een handmatige archivering niet ongedaan. Scanpaden en de runtime-route komen uit de agent- en webserverconfiguratie op de origin.

  44. 44

    De exacte oorzaak van ontbrekende versies zien

    Wat ontbreekt er? toont per oorsprong de diagnosecode, de daadwerkelijk gecontroleerde map of runtime-route en een herstelstap. root_missing betekent dat de map niet bestaat; root_permission_denied betekent onvoldoende lees- of doorlooprechten; root_not_directory betekent dat het pad geen map is. runtime_socket_missing en runtime_listener_missing betekenen dat de geconfigureerde FPM-route niet luistert; runtime_endpoint_unresolved betekent een onopgeloste variabele. runtime_process_hidden betekent dat de agent de listener ziet maar niet de procesidentiteit mag lezen. Een leesbare map zonder sitecollector krijgt website_collector_missing; ontbrekend ontvangen groeps-/rootbewijs krijgt website_evidence_missing. Werk oudere agents bij als de exacte fout nog niet is meegestuurd.

  45. 45

    Alleen de actieve Nginx-configuratie volgen

    Standaard begint Nginx-discovery bij /etc/nginx/nginx.conf en volgt de begrensde includes. Niet-geïncludeerde backupbestanden worden zo niet als actuele sites gelezen. discovery.webConfigPaths kan expliciete configuratiebestanden of mappen bevatten. Geef bij voorkeur het hoofdconfiguratiebestand op. Een map is een expliciete scan van beschikbare configuratiebestanden in die map en kan dus ook nog niet geladen vhosts bevatten. De agent meldt welke bestanden of includes niet gelezen zijn; hij voert nginx -t niet uit en herlaadt de webserver niet.

    {
      "discovery": {
        "websiteRegistration": "candidates",
        "webConfigPaths": ["/etc/nginx/nginx.conf"]
      }
    }
    
  46. 46

    De agent op de werkelijke website-origin plaatsen

    Een kopie van de bestanden op een andere server bewijst geen actuele publieke website of gebruikte PHP-runtime. Vergelijk de actieve webserverconfiguratie, proxy-route en documentroot op de origin. Gebruik daar een bestaande agent met websitecollectors en een eigen bronasset. Corrigeer een verkeerd pad met een expliciete mapping; corrigeer een verkeerde host door op de origin te verzamelen. Koppel nooit automatisch de PHP-CLI-versie of een willekeurige aanwezige FPM-versie aan een site. Bij FPM in een procesnamespace leest de agent buildmetadata alleen wanneer de luisterende executable hetzelfde inode heeft als de executable bij die metadata. Ontbrekende rechten blijven een expliciete dekkingsbeperking.

  47. 47

    Composer-projecten gericht uitlezen

    Met includePackages: true en packageMode: auto leest de agent bij Composer-projecten gericht de projectmetadata. Hij zoekt de vendormap via settings.composerVendorDir, anders COMPOSER_VENDOR_DIR van het agentproces, anders config.vendor-dir in composer.json, anders vendor. Een buildomgeving die de agent niet kan zien, moet je expliciet vertalen naar deze instelling. Alleen composer/installed.json in die map wordt gelezen; oude vendor2-mappen worden niet vanzelf meegenomen. Geïnstalleerde packages krijgen hun exacte versies en onderlinge dependencies uit die metadata. composer.lock is een terugvalbron voor vastgelegde versies, inclusief gedeclareerde ontwikkelpackages; deze krijgen zichtbaar Installatie onbevestigd en tellen niet als bewezen actuele websitematches. Als installed.json beschikbaar is, worden ontbrekende dev-packages niet uit het lockfile aangevuld. De agent voert geen Composer, PHP, scripts of plugins uit. Kies packageMode: filesystem alleen als je ook software buiten de Composer-projectmetadata wilt verzamelen. Een gerichte Composer-scan vereist geen Syft-installatie; brede scans en andere packagebronnen kunnen Syft wel nodig hebben.

    "settings": {
      "domain": "portal.example.test",
      "includePackages": true,
      "packageMode": "auto"
    }
    
  48. 48

    Een aangepaste Composer-vendormap

    Dit voorbeeld hoort in composer.json van de applicatie. De agent leest het automatisch; je hoeft dezelfde map niet nog eens in de agentconfiguratie te zetten. Alleen als de echte installatie via een niet-zichtbare build-/omgevingsoverride een andere map gebruikt, stel je settings.composerVendorDir expliciet in. installed.json uit die geselecteerde map gaat vóór composer.lock voor daadwerkelijk geïnstalleerde versies.

    {
      "config": {
        "vendor-dir": "dependencies"
      }
    }
    
  49. 49

    Grote inventarissen begrenzen zonder pakketten te verliezen

    De agent dedupliceert gelijke pakketidentiteiten vóór de limiet. Verschillende versies blijven afzonderlijk. settings.maxComponents is standaard 2048 en accepteert 1–10000; kies bijvoorbeeld 4096 voor een grote plugin met veel dependencies. De JSON-uploadlimiet blijft 4 MiB. Bij overschrijding verschijnt het aantal als collectorfout; de agent kapt geen unieke componenten stil af. compactSbom verwijdert ongebruikte Syft-eigenschappen, met behoud van purl/CPE, versie, broncataloger, paden en dependencies. Een geslaagde scan vervangt de packages binnen de geconfigureerde scope; expliciete uitsluitingen en bewust overgeslagen symlinks worden als dekking vermeld. Het totale document blijft gedeeltelijk, en echte leesfouten wissen geen oudere packages. Controleer een oude vendor-/backupmap vóór uitsluiting: de actieve autoloader bepaalt welke installatie de app gebruikt.

    "settings": {
      "domain": "portal.example.test",
      "includePackages": true,
      "maxComponents": 4096,
      "excludePaths": [".git/**", "var/**", "backups/**"]
    }
    
  50. 50

    Dekking van ieder softwarecomponent lezen

    Open Websites & diensten → een website → Software & versies. In de kolom Dekking staat afzonderlijk hoe de versie is gevonden en of er een actuele kwetsbaarheidscontrole voor de packagecoördinaat is bevestigd. Een lockfileversie bewijst de installatie niet. Ontbreekt een bruikbare pakketidentiteit, is de broncontrole verlopen, of wacht verwerking in de wachtrij, dan staat er Controle onvolledig met de reden. Beoordeeld betekent alleen dat de gevonden packageversie door de genoemde advisorybron is gecontroleerd; het is geen garantie dat er geen kwetsbaarheden of andere ontbrekende software zijn. Gebruik het filter Dekking voor bevestigde versies, onbevestigde installaties of ontbrekende pakketidentiteiten. De compacte bewijscodes blijven zichtbaar voor ondersteuning en troubleshooting.

  51. 51

    Fouten herstellen en een activatie terugdraaien

    Bij een afwijkend installatiepad: ontdek opnieuw, controleer de mapping en maak een nieuw voorstel. Bij ontbrekende Syft: installeer Syft volgens de aparte handleiding of zet de aanvullende package-scan uit. Bij een onleesbaar pad: controleer de origin en de agentaccount. De agent maakt bij activering naast agent.json een privébestand met de naam agent.json.before-websites-<tijdstip>. Herstel dat bestand naar de actieve configuratielocatie om de collectorwijziging terug te draaien. De volgende herlading gebruikt de herstelde collectors; reeds ontvangen inventarishistorie blijft bewaard. Controleer na iedere scan aflevering én dekkingsmeldingen; een geslaagde upload bewijst geen volledige catalogisering.

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