Documentatie / Agents

Agentconfiguratie: alle JSON-keys

Betekenis, standaardwaarden en voorbeelden voor elke huidige agentinstelling.

Wat je nodig hebt

  • Een geïnstalleerde agent
  • Een afzonderlijk agenttoken
  1. 1

    Verplichte basisvelden

    url is de HTTP(S)-basis-URL zonder query, fragment of credentials. token is het geheim met inventory:write en agent:heartbeat. agentId is de stabiele agentidentiteit. asset is de standaard systeemnaam en environment de omgeving. collectors is de lijst van bronnen. hostname is optioneel en valt terug op de lokale hostnaam. Verander agentId of asset niet bij iedere run: dat breekt de continuïteit van het bewijs. De voorbeelden hieronder zijn losse configuratieblokken: algemene velden staan op het bovenste niveau; voorbeelden met type zijn afzonderlijke objecten in collectors. Voeg de velden op die plek toe aan je bestaande bestand.

    JSON-keyWanneer / standaardBetekenis
    urlverplichtHTTP(S)-basisadres van Watchtower, zonder query of gebruikersgegevens.
    tokenverplichtGeheim voor inventory:write en agent:heartbeat.
    agentIdverplichtStabiele identificatie van deze agentinstallatie.
    assetverplichtStandaard assetnaam voor collectors zonder eigen asset.
    environmentverplichtStandaard omgeving, bijvoorbeeld production.
    collectorslijstMaximaal 128 bronnen; iedere volledige bron heeft een eigen asset nodig.
    hostnameoptioneelWeergavenaam; standaard lokale hostnaam.
    {
      "url": "https://cve.example.nl",
      "token": "<agenttoken>",
      "agentId": "server-01",
      "hostname": "server-01.example.nl",
      "asset": "server-01-host",
      "environment": "production",
      "collectors": [
        {
          "type": "host",
          "name": "host-packages",
          "target": "dir:/"
        }
      ]
    }
    
  2. 2

    Automatische agentupdates

    autoUpdate is on of off en standaard off. Voor on zijn de vooraf vertrouwde publieke Ed25519-sleutels in updatePublicKeys en een beheerd installatieprofiel nodig. Een gemotiveerde platform-forceopdracht wijzigt autoUpdate niet. De agent haalt opdrachten uitgaand om de 30 seconden op; scaninterval en commandMaxAge regelen andere zaken. De gids Agentupdates en firewallregels toont alle bestemmingen.

    JSON-keyWanneer / standaardBetekenis
    autoUpdatestandaard offZet op on voor periodieke, ondertekende agentupdates.
    updatePublicKeysvereist voor updatesKey-ID naar base64-gecodeerde 32-byte Ed25519-publieke sleutel; maximaal vier tijdens rotatie.
  3. 3

    Planning en scanner

    interval is de tijd tussen scans (standaard 2h); jitter voegt willekeurige spreiding toe (standaard 15m). Gebruik waarden zoals 30s, 15m of 2h. syft is de binarynaam of het volledige pad (standaard syft via PATH). collectorTimeout is de maximale looptijd per collector (standaard 10m). concurrency is het aantal gelijktijdige collectors, 1 tot 8 (standaard 1). Verhoog dit pas na een belastingmeting.

    JSON-keyWanneer / standaardBetekenis
    intervalstandaard 2hTijd tussen volledige scanrondes.
    jitterstandaard 15mWillekeurige spreiding na de scaninterval.
    syftstandaard syftBinarynaam of volledig pad naar Syft.
    collectorTimeoutstandaard 10mMaximale tijd per collector; positieve duur.
    concurrencystandaard 1; bereik 1–8Aantal gelijktijdige collectors.
    compactSbomstandaard falseVerklein door Syft gemaakte CycloneDX-rapporten met behoud van correlatie- en dependencyvelden.
    incrementalInventoryoptioneel; standaard trueBij een ongewijzigde SBOM stuurt de agent alleen de SHA-256-identiteit. Watchtower hergebruikt uitsluitend exact bewijs van hetzelfde asset, dezelfde omgeving, host en containerimage. Ontbreekt de basis, dan volgt automatisch de volledige SBOM. false verstuurt altijd volledig.
    updateManifestUrlvereist voor updatesHTTPS-URL van de ondertekende catalogus; dezelfde vertrouwde origin serveert ook de artifactdownloads.
    updatePublicKeysoptioneel; 1–4 sleutelsMap van sleutel-ID naar base64-gecodeerde 32-byte Ed25519-publieke sleutel. Neem alleen sleutels op die releasebeheer expliciet heeft goedgekeurd. Meerdere sleutels ondersteunen rotatie; nooit privésleutels in agent.json.
    updateProfilevereist voor updates; native of containerBeheerd installatieprofiel. Containerprofielen gebruiken een persistent binvolume; onbekende profielen worden geweigerd.
    {
      "interval": "2h",
      "jitter": "15m",
      "syft": "/usr/local/bin/syft",
      "collectorTimeout": "10m",
      "concurrency": 1
    }
    
  4. 4

    Aflevering en wachtrij

    deliveryAttempts is 1–6 (standaard 3); deliveryRetryDelay is 100ms–1m (standaard 1s). spoolDirectory schakelt een versleutelde offline wachtrij in en moet absoluut zijn. spoolMaxBytes is standaard 268435456 bytes (256 MiB; toegestaan 1 MiB–10 GiB); spoolMaxEntries standaard 500 (1–10000). spoolReplayLimit is standaard 20 (1–100) en spoolReplayTimeout 30s (1s–5m). Zonder spoolDirectory is er geen duurzame wachtrij.

    JSON-keyWanneer / standaardBetekenis
    deliveryAttemptsstandaard 3; bereik 1–6Aantal uploadpogingen.
    deliveryRetryDelaystandaard 1s; 100ms–1mWachttijd tussen uploadpogingen.
    spoolDirectoryoptioneelAbsoluut pad; activeert de versleutelde offline wachtrij.
    spoolMaxBytesstandaard 256 MiB; 1 MiB–10 GiBMaximale opslag van de wachtrij, alleen met spoolDirectory.
    spoolMaxEntriesstandaard 500; 1–10000Maximaal aantal wachtrijitems.
    spoolReplayLimitstandaard 20; 1–100Maximaal aantal oude rapporten per herstelronde.
    spoolReplayTimeoutstandaard 30s; 1s–5mTijdslimiet voor herstel van oude rapporten.
    {
      "deliveryAttempts": 3,
      "deliveryRetryDelay": "1s",
      "spoolDirectory": "/var/lib/watchtower-agent/spool",
      "spoolMaxBytes": 268435456,
      "spoolMaxEntries": 500,
      "spoolReplayLimit": 20,
      "spoolReplayTimeout": "30s"
    }
    
  5. 5

    Certificaten en agentopdrachten

    clientCertificate wijst naar de door beheer uitgegeven client-chain.crt, nooit naar client.csr: een CSR is alleen een ondertekenverzoek. clientKey wijst naar de bijbehorende privésleutel. Beide moeten samen worden ingesteld. caCertificate is alleen nodig voor een extra te vertrouwen server-CA. commandMaxAge beperkt de leeftijd van een opdracht: standaard 10m, toegestaan 30s–1h. Zie Agent met mTLS aansluiten voor de volgorde en de aparte beheergids voor vernieuwing.

    JSON-keyWanneer / standaardBetekenis
    clientCertificateoptioneel, samen met clientKeyPad naar mTLS-clientcertificaat.
    clientKeyoptioneel, samen met clientCertificatePad naar de bijbehorende privésleutel.
    caCertificateoptioneelPad naar een extra vertrouwde CA.
    commandMaxAgestandaard 10m; 30s–1hMaximale leeftijd van een agentopdracht.
    {
      "clientCertificate": "/etc/cve-watch/mtls/jenkins-prod-01/client-chain.crt",
      "clientKey": "/etc/cve-watch/mtls/jenkins-prod-01/client.key",
      "commandMaxAge": "10m"
    }
    
  6. 6

    Gemeenschappelijke collectorvelden

    type kiest host, filesystem, docker, docker-container, website, jenkins, windows-host of macos-host. name geeft de collector een unieke herkenbare naam. target selecteert het scanobject. arguments is een lijst aanvullende Syft-argumenten. asset, environment en hostname kunnen de basiswaarden per collector overschrijven. Geef asset en environment altijd samen op; elke complete bron krijgt een eigen assetnaam. Maximaal 128 collectors zijn toegestaan.

    JSON-keyWanneer / standaardBetekenis
    typeverplichtCollectorsoort: host, filesystem, docker, docker-container, website, jenkins, windows-host of macos-host.
    nameaanbevolenUnieke naam voor status en gerichte controles; maximaal 120 bytes.
    assetoptioneel met environmentEigen assetnaam voor deze complete bron.
    environmentoptioneel met assetOmgeving voor de eigen asset.
    hostnameoptioneelWeergavenaam voor deze bron.
    targettype-afhankelijkHostpad, directory, image of containernaam.
    argumentsoptioneel voor SyftExtra Syft-argumenten als lijst van strings.
  7. 7

    Host en applicatiedirectory

    host scant met Syft standaard dir:/ als target ontbreekt. filesystem vereist een absoluut directorypad en is bedoeld voor een afzonderlijke applicatie of read-only volume. Beschikbare leesrechten en Syft-catalogers bepalen de dekking. Een gevonden pakket is geen bewijs dat het actief draait.

    JSON-keyWanneer / standaardBetekenis
    target (host)standaard dir:/Syft-target; op een Linux-host doorgaans dir:/.
    target (filesystem)verplichtAbsoluut pad naar de te scannen directory.
    "collectors": [
      {
        "type": "host",
        "name": "host-packages",
        "target": "dir:/",
        "asset": "server-01-host",
        "environment": "production"
      },
      {
        "type": "filesystem",
        "name": "web-files",
        "target": "/srv/web",
        "asset": "web-files",
        "environment": "production"
      }
    ]
    
  8. 8

    Docker-image en draaiende container

    docker vraagt Syft een expliciet image-target te scannen. docker-container zoekt target als containernaam via runtime (standaard docker; ook een geconfigureerde andere runtime) en scant het gekoppelde image-ID. Schrijfbare lagen en volumes zijn niet automatisch gedekt. applicationComponent kan een ontbrekende applicatie-identiteit toevoegen: name, een CPE 2.3-string en version of versionFromImageTag. Die laatste werkt alleen met een geldige versie-tag; latest is ongeschikt.

    JSON-keyWanneer / standaardBetekenis
    target (docker)verplichtExpliciet Syft-image-target.
    target (docker-container)verplichtNaam of ID van een draaiende container.
    runtimestandaard dockerUitvoerbare Docker- of compatibele runtime voor containerinspectie.
    applicationComponentoptioneel bij docker-containerExtra applicatie-identiteit als object met de velden hieronder.
    applicationComponent.nameverplicht indien ingesteldNaam van de extra applicatiecomponent.
    applicationComponent.cpeverplicht indien ingesteldCPE 2.3-identiteit van de applicatie.
    applicationComponent.versionversie of versionFromImageTagVaste applicatieversie.
    applicationComponent.versionFromImageTagoptioneel; standaard falseLees een geldige versie uit de image-tag.
    {
      "type": "docker-container",
      "name": "grafana-image",
      "target": "grafana",
      "runtime": "docker",
      "asset": "grafana-production",
      "environment": "production",
      "applicationComponent": {
        "name": "Grafana",
        "cpe": "cpe:2.3:a:grafana:grafana:*:*:*:*:*:*:*:*",
        "versionFromImageTag": true
      }
    }
    
  9. 9

    WordPress-site op een expliciete documentroot

    De website-collector leest WordPress coreversie, geïnstalleerde plugins en thema’s uit de opgegeven lokale documentroot. Hij voert geen PHP uit en leest wp-config.php niet. Plugin- en themaversies zijn geïnstalleerd bewijs. Met een expliciet, actueel activatie-exportbestand kan hij daarnaast actief, inactief of onbekend tonen. Zonder dat bestand blijft de activatiestatus onbekend. Zet settings.includePackages aan om daarnaast Syft package-manifests en libraries in dezelfde sitebron te scannen. -discover kan domein en documentroot uit ondersteunde Nginx-, Apache- en cPanel-configuraties voorstellen; controleer de mapping en laat hem in de websitecollector expliciet bevestigen. Elke site krijgt een eigen asset.

    JSON-keyWanneer / standaardBetekenis
    target (website)verplicht, absoluut padInstallatie- of projectroot met de softwaremanifests; voor WordPress de map met wp-includes.
    settings.packageModeoptioneel; standaard autoauto leest bij Composer-projecten uitsluitend composer.json, de geselecteerde vendor/composer/installed.json en zo nodig composer.lock. Zonder Composer-metadata gebruikt de aanvullende package-scan Syft. filesystem kiest expliciet een brede Syft-scan van de projectmap, ook als Composer aanwezig is. Alleen van toepassing bij includePackages: true.
    settings.composerVendorDiroptioneel; maximaal 512 tekensExpliciete vendormap voor deze website, relatief aan de projectroot of absoluut. Heeft voorrang op COMPOSER_VENDOR_DIR van het agentproces en op config.vendor-dir in composer.json; zonder instellingen is de Composer-standaard vendor. Geef een build-/globale override die de agent niet zelf kan zien expliciet op. De agent leest alleen composer/installed.json binnen de gekozen map, zonder die map recursief te scannen of Composer-code uit te voeren.
    settings.maxComponentsoptioneel; standaard 2048Maximaal 1–10000 unieke componenten per website-SBOM. De agent dedupliceert vóór deze controle; verschillende versies blijven apart. Verhoog alleen voor een bewust brede scan, bijvoorbeeld naar 4096 voor een grote plugin met dependencies. De uploadlimiet blijft 4 MiB. Er wordt niets stil afgekapt. Een bestaand expliciet budget blijft behouden bij het opnieuw toepassen van een activatieplan.
    settings.groupIdoptioneel; gegenereerd door activatieStabiele vhost-identiteit uit discovery. Scanvoorstellen vullen dit automatisch in; niet zelf raden. Verbindt software en runtimebewijs met de websitegroep.
    settings.domainverplichtWebsite-adres dat bij deze documentroot hoort.
    settings.cmsoptioneelKies wordpress, drupal, joomla, typo3, magento of shopware. Laat weg voor herkenning uit de exacte projectroot of een generieke packagebron. Ontbrekende manifests leveren geen geraden versie op.
    settings.excludePathsoptioneelRelatieve paden voor plugin-/themadetectie en de optionele Syft-scan uitsluiten.
    settings.includePackagesstandaard falseLees aanvullende packages en libraries: Composer-auto gebruikt projectmetadata; overige of brede scans gebruiken Syft.
    settings.wordpressActivationFileoptioneel; alleen cms wordpressAbsoluut pad naar een actueel (maximaal 24 uur oud), maximaal 256 KiB groot JSON-exportbestand met complete actieve plugin- en themaslugs. De agent leest dit bestand alleen; hij start WordPress of WP-CLI niet zelf en uploadt geen databasegegevens.
    settings.wordpressSitesoptioneel; maximaal 16 hostnamenVoor multisite: de exacte websites waarvan de activatie-export compleet moet zijn. Zonder lijst wordt alleen settings.domain vereist. Ontbreekt één opgegeven site, dan blijft activatie voor alle extensies onbekend.
    {
      "type": "website",
      "name": "site-components",
      "target": "/path/to/site",
      "asset": "site-example",
      "environment": "production",
      "settings": {
        "domain": "site.example",
        "cms": "wordpress",
        "includePackages": true,
        "excludePaths": ["wp-config.php", "wp-content/uploads/**"]
      }
    }
    
  10. 10

    Symfony-website en Composer-pakketten

    Richt target op de projectroot met composer.lock en eventueel vendor/, niet alleen op public/. Laat settings.cms weg; de agent leest de aanwezige Composer- en andere door Syft herkende pakketten. Een Symfony-identiteit volgt uit de gevonden Symfony-pakketten en hun versies. Controleer de domein→projectroot-koppeling zelf wanneer de webserver alleen public/ aanwijst. Deze collector voert geen applicatiecode uit.

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

    Jenkins, Windows en macOS

    jenkins leest de controller-WAR en pluginmanifesten; jenkinsHome is standaard /var/lib/jenkins en jenkinsWar /usr/share/java/jenkins.war. windows-host gebruikt de ingebouwde Windows-inventaris; de Windows-gids beschrijft installatie en dekking. Jenkins heeft geen Syft nodig.

    JSON-keyWanneer / standaardBetekenis
    jenkinsHomestandaard /var/lib/jenkinsJenkins-homedirectory met plugins/ voor .jpi en .hpi.
    jenkinsWarstandaard /usr/share/java/jenkins.warController-WAR met Jenkins-versie in het manifest.
    settings.homeoptioneel bij JenkinsNieuw gegroepeerd alternatief voor jenkinsHome; gebruik niet beide.
    settings.waroptioneel bij JenkinsNieuw gegroepeerd alternatief voor jenkinsWar; gebruik niet beide.
    settingsoptioneel bij Jenkins, website of native hostGroepeert opties die alleen bij dat collectortype horen.
    settings.applicationPathsalleen windows-host / macos-hostLijst van maximaal 16 absolute applicatiemappen. Standaard leeg; maximaal drie niveaus en 4096 entries; geen symlinks, reparsepoints of programma-uitvoering.
    windows-hostoptioneel settings.applicationPathsLeest Windows-registratiegegevens en .NET; expliciete applicatiemappen voegen PE-productversies toe zonder programma’s uit te voeren.
    macos-hostoptioneel settings.applicationPathsLeest pkgutil, Homebrew, /Applications en de Applications-map van de agentgebruiker; extra mappen alleen expliciet.
    {
      "type": "jenkins",
      "name": "jenkins-plugins",
      "jenkinsHome": "/var/lib/jenkins",
      "jenkinsWar": "/usr/share/java/jenkins.war",
      "asset": "jenkins-production",
      "environment": "production",
      "hostname": "jenkins.example.nl"
    }
    
  12. 12

    Extra applicatiemappen op Windows en macOS

    Alleen bij windows-host en macos-host kun je settings.applicationPaths instellen: maximaal 16 absolute applicatiemappen, zonder wildcard of variabele. De agent doorzoekt maximaal drie mapniveaus en 4096 entries; symlinks en Windows-reparsepoints worden overgeslagen. Op macOS leest hij .app-versies uit Info.plist en stopt hij bij de bundlegrens. Op Windows leest hij ProductVersion of FileVersion uit .exe-bestanden. Hij start die programma’s niet. Gebruik dit voor een portable-installatiemap of een expliciet toegestane gebruikersapplicatiemap. Onleesbare bronnen en limieten worden als gedeeltelijke dekking gerapporteerd. De agent laadt geen offline Windows-registerhives en krijgt hierdoor geen extra rechten.

    {
      "type": "windows-host",
      "name": "installed-software",
      "asset": "workstation-software",
      "environment": "production",
      "settings": {
        "applicationPaths": ["C:\\Tools", "C:\\Apps"]
      }
    }
    
  13. 13

    Podman gebruikt zijn eigen imagebron

    Zet runtime: podman bij een docker-container-collector om de huidige container met Podman inspect te lezen en het bevestigde imagedigest via Syft podman: te scannen. De agent kiest hierdoor geen Docker-image met dezelfde naam. De Podman-API/socket moet onder de agentgebruiker bereikbaar zijn. Zet discovery.containerRuntimes op ["docker", "podman"] als beide engines moeten worden ontdekt. Een ontbrekende engine of onvoldoende rechten geeft ontbrekende dekking; er wordt geen extra daemon of toegang automatisch aangezet.

  14. 14

    Kies de bron bij de vraag

    Een hostcollector inventariseert geïnstalleerde software; die hoeft niet als service te draaien. Op Linux kan Syft de dpkg-, RPM- of apk-database lezen. windows-host leest onder meer uninstall-registers, geladen gebruikershives en .NET-installaties. macos-host leest receipts, Homebrew en applicatiebundles. Discovery voegt luisterende poorten, diensten, containers, vhosts en routebewijs toe. Een websitecollector leest de betreffende applicatie en bijvoorbeeld WordPress-plugins. Combineer deze collectors in één agent.json met afzonderlijke assetnamen; een hostinventaris bewijst op zichzelf niet welke pakketten een website gebruikt.

  15. 15

    Lees versie- en kwetsbaarheidsaantallen goed

    Software & versies toont actuele componenten van de gekoppelde bronnen. De websitepagina telt actuele kwetsbaarheden per uniek advisory-ID, zodat één kwetsbaarheid in meerdere componenten geen dubbel totaalaantal krijgt. Een runtime of framework met een actuele match krijgt de kleur en het icoon van de hoogste ernst. Dezelfde runtime- en frameworkcomponenten worden onder Kwetsbaarheden & risico’s beoordeeld. Een match bevestigt pakket en getroffen versie; bereikbaarheid, geladen code en exploitatievoorwaarden vragen aanvullende beoordeling. Updateadvies verschijnt alleen wanneer de kwetsbaarheidsbron een herstelde versie opgeeft. Geen inventaris of geen betrouwbare identiteit betekent onbekende dekking, geen veilige uitslag.

  16. 16

    Controleer iedere wijziging

    Gebruik -check-config na het bewerken. Onbekende collectortypes en ontbrekende verplichte targets worden geweigerd. Een nieuwe agent kan met -discover lokaal services en containers tonen en met -proposal een bewerkbare configuratie voorstellen. discovery.enabled is optioneel en standaard uit. Als je het inschakelt, rapporteert de agent een aparte runtime-SBOM voor actieve services met een verifieerbare versie.

    watchtower-agent -check-config -config /etc/cve-watch/agent.json
  17. 17

    Controleer lokale voorwaarden met doctor

    Voer doctor uit als de agentgebruiker voordat je een volledige scan start. Het commando controleert de geldigheid van de JSON, of Syft uitvoerbaar is, leesbaarheid van certificaatbestanden en projectmappen, en of een Docker CLI beschikbaar is voor containercollectors. Het print een compact JSON-rapport en uploadt niets. Een fout geeft exitcode 1. Doctor start geen applicatiecode en test geen netwerk-, daemon- of registrytoegang; bevestig de echte levering daarna met -once en de collectorstatus in Watchtower. Installatiepaden en tokens komen niet in het rapport.

    watchtower-agent -doctor -config /etc/cve-watch/agent.json
  18. 18

    Begrijp welke scan welke software ziet

    Syft scant geïnstalleerde pakketten en manifests binnen target; het bepaalt niet welke software op dat moment draait. De Linux host-collector gebruikt package-databases en leesbare bestanden. De Windows- en macOS-hostcollectors lezen hun eigen platformbronnen. Docker-container scant het image, niet automatisch volumes of schrijfbare lagen. -discover leest daarnaast lokale services, sockets en containers; die preview wordt niet geüpload. discovery.enabled voegt alleen services met een onderbouwde versie als aparte runtime-asset toe. compactSbom verwijdert ongebruikte CycloneDX-velden, geen softwarecomponenten. incrementalInventory staat standaard aan: voor een identiek document verstuurt de agent een hash en de server reconstrueert de nieuwe inventaris uit het bestaande, geverifieerde SBOM-bewijs. Als de basis ontbreekt of onleesbaar is, valt de agent terug op volledige overdracht. Bij gewijzigde software wordt de volledige compacte SBOM verstuurd; opgeslagen bewijs kan daarna als delta worden bewaard. Watchtower normaliseert en dedupliceert componentidentiteiten en correleert kwetsbaarheden alleen wanneer een bruikbare versie en package-identiteit beschikbaar zijn.

  19. 19

    Optionele lokale serververkenning

    discovery.enabled is standaard false. excludeServices en excludeContainers accepteren globpatronen; maxServices is standaard 256 en maxContainers 128. De preview uploadt niets. Het voorstelbestand bevat je bestaande token, krijgt rechten 0600 en overschrijft geen bestaand bestand. Services zonder betrouwbare versie blijven in de lokale preview en worden niet als kwetsbare component gerapporteerd.

    JSON-keyWanneer / standaardBetekenis
    discoveryoptioneel objectInstellingen voor lokale service-, socket- en containerverkenning.
    discovery.enabledstandaard falsePubliceer een aparte runtime-inventaris bij reguliere agentruns.
    discovery.excludeServicesoptioneelGlobpatronen voor uit te sluiten systemd-services.
    discovery.excludeContainersoptioneelGlobpatronen voor uit te sluiten containers.
    discovery.maxServicesstandaard 256Maximaal aantal services in de lokale verkenning.
    discovery.maxContainersstandaard 128Maximaal aantal containers in de lokale verkenning.
    discovery.maxSocketsstandaard 512Maximaal aantal luisterende TCP- en UDP-sockets in de preview.
    discovery.containerRuntimesstandaard [docker]Lees Docker, Podman of beide; toegang tot de runtime blijft vereist.
    discovery.webConfigPathsoptioneelExpliciete configuratiebestanden of mappen voor Nginx, Apache of cPanel. Nginx begint standaard bij /etc/nginx/nginx.conf en volgt alleen de bereikbare includes. Een expliciete map scant ook beschikbare maar mogelijk niet geladen vhosts.
    discovery.webRootMappingsoptioneel; maximaal 32Object met absolute bronpad→werkelijk-pad-mappings voor verplaatste actuele installaties. Langste overeenkomende padprefix wint. Beide paden blijven zichtbaar; een mapping bewijst geen gebruikte runtime. Gebruik geen backup als actuele bron zonder die bevestiging.
    discovery.maxWebsitesstandaard 128Maximum aantal vhost-mappings in de lokale preview en het voorstel.
    discovery.websiteRegistrationstandaard offoff houdt de preview lokaal; candidates stuurt voorlopige websitekandidaten met dekkingsmelding naar Watchtower.
    discovery.autoRegisteroptioneel object; standaard uitOpt-in beleid voor begrensde automatische activering van bevestigde websitebronnen.
    discovery.autoRegister.modeoff, review of confirmed; standaard offconfirmed voegt alleen bronnen binnen de allowlists toe; review laat kandidaten ter handmatige beoordeling.
    discovery.autoRegister.allowedDomainsvereist bij confirmed; maximaal 32Exacte kleine domeinlijst of *.suffix voor toegestane websites.
    discovery.autoRegister.excludedDomainsoptioneel; maximaal 32Adressen die ondanks de allowlist niet automatisch geactiveerd worden.
    discovery.autoRegister.allowedRootsoptioneel; maximaal 16Absolute lokale mappen waarbinnen een leesbare installatie moet liggen.
    discovery.autoRegister.allowedContainersoptioneel; maximaal 16Exacte namen van bevestigde containers die automatisch mogen worden toegevoegd.
    discovery.autoRegister.maxNewstandaard 4; 1–16Maximaal aantal nieuwe collectors per activeringsronde.
    watchtower-agent -discover -config /etc/cve-watch/agent.json
    watchtower-agent -discover -config /etc/cve-watch/agent.json -proposal /etc/cve-watch/agent-voorstel.json
    

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