Documentatie / Agents en scanners

Linux-agent installeren

Dezelfde keuzes voor x86-64 en ARM64, met eenmalige run of systemd.

Wat je nodig hebt

  • Linux x86-64 of ARM64 met actieve beveiligingsupdates van de distributie
  • Leesrechten op de gekozen bronnen
  • Een agenttoken; voor mTLS ook een goedgekeurd clientcertificaat
  1. 1

    Uitvoering: kies eenmalige of automatische start

    Kies eerst: eenmalig uitvoeren met de losse binary, automatisch starten met de beheerde installatie, of zonder agent een eigen CycloneDX-SBOM naar de ingest-API sturen. Voor een beheerde installatie is een configuratiebestand nodig. Kies daarna tussen een statisch agenttoken en mTLS-bootstrap; beide routes zijn ondersteund. Voor host-, directory- en containerinventaris gebruikt de agent Syft; Jenkins-manifesten kunnen zonder Syft.

  2. 2

    Downloaden

    Kies x86-64 (amd64) of ARM64. Gebruik één van de drie routes hieronder. Controleer de gedownloade binary tegen de aparte SHA-256-checksum; de ondertekende releasecatalogus bevat dezelfde artifacthash.

    Via de browser

    Kies de binary en bijbehorende checksum voor jouw architectuur. Maak zo nodig in het Opslaan als-venster de map ~/.local/share/cve-watch/setup aan en bewaar beide bestanden daar met hun originele naam. Controleer de checksum en hernoem de binary daarna met het commando hieronder; vervang amd64 door arm64 op een ARM64-host. De binary bevat geen voorbeeldconfiguratie.

    cd "$HOME/.local/share/cve-watch/setup"
    sha256sum -c watchtower-agent-linux-amd64.sha256
    mv watchtower-agent-linux-amd64 watchtower-agent
    chmod 0755 watchtower-agent
    

    Via curl

    Vervang amd64 in beide download-URL's, de checksumnaam en de mv-regel door arm64 op een ARM64-host.

    mkdir -p "$HOME/.local/share/cve-watch/setup"
    cd "$HOME/.local/share/cve-watch/setup"
    curl -fSLO https://stackportrait.com/downloads/agent/current/watchtower-agent-linux-amd64
    curl -fSLO https://stackportrait.com/downloads/agent/current/watchtower-agent-linux-amd64.sha256
    sha256sum -c watchtower-agent-linux-amd64.sha256
    mv watchtower-agent-linux-amd64 watchtower-agent
    chmod 0755 watchtower-agent
    

    Via wget

    Vervang amd64 in beide download-URL's, de checksumnaam en de mv-regel door arm64 op een ARM64-host.

    mkdir -p "$HOME/.local/share/cve-watch/setup"
    cd "$HOME/.local/share/cve-watch/setup"
    wget https://stackportrait.com/downloads/agent/current/watchtower-agent-linux-amd64
    wget https://stackportrait.com/downloads/agent/current/watchtower-agent-linux-amd64.sha256
    sha256sum -c watchtower-agent-linux-amd64.sha256
    mv watchtower-agent-linux-amd64 watchtower-agent
    chmod 0755 watchtower-agent
    
  3. 3

    Authenticatie: kies je ingestmethode

    Kies één ingestmethode. Beide worden ondersteund: een statisch agenttoken voor inventaris en heartbeat, of mTLS met een goedgekeurd clientcertificaat en bootstrap-token voor certificaatgebonden sessies. De overige installatie-instructies zijn gelijk.

    Statisch agenttoken

    Maak onder Verzameling → Inrichting → Ingest-tokens het preset “Agent · bestaand statisch token” aan. Dit token mag inventaris en heartbeats publiceren totdat je het intrekt. Bewaar het alleen in een afgeschermd agent.json; de bron geldt niet als mTLS-geverifieerd. Gebruik voor releasebevestiging die mTLS vereist de andere route.

    mTLS met clientcertificaat

    Kies “Agent · mTLS bootstrap” als je clientcertificaat en kortlevende agentsessie wilt gebruiken. Maak op de agenthost een sleutel en CSR, upload alleen de CSR via Agentcertificaat aanvragen, wacht op goedkeuring en zet client-chain.crt naast de privésleutel. Het token alleen of het certificaat alleen volstaat niet. Beheer bij zelf geïnstalleerde agents ook de certificaatvernieuwing.

  4. 4

    Configureren: maak agent.json

    De losse binary bevat geen agent.json. Maak het bestand in de voorbereidingsmap met dit voorbeeld, vervang url, token, agentId, asset en environment, en sla het op. Voor mTLS voeg je clientCertificate en clientKey toe met absolute paden naar de uitgegeven keten en privésleutel. De host collector gebruikt Syft; installeer Syft eerst volgens de aparte gids.

    cd "$HOME/.local/share/cve-watch/setup"
    umask 077
    cat > agent.json <<'JSON'
    {
      "url": "https://stackportrait.com",
      "token": "<agenttoken>",
      "agentId": "linux-01",
      "asset": "linux-01-host",
      "environment": "acceptance",
      "collectors": [{"type":"host","name":"host-packages","asset":"linux-01-host","environment":"acceptance"}]
    }
    JSON
    ${EDITOR:-vi} agent.json
    chmod 600 agent.json
    
  5. 5

    Installeren: start eenmalig of via systemd

    Voor een proef draai je ./watchtower-agent -once -config agent.json. Op een host met systemd kan dezelfde gecontroleerde binary met -install-as-service een beheerde systemd-unit maken. Je kunt ook handmatig een systemd-user of systeemunit beheren; de agent plant scans zelf. Een cronjob die rechtstreeks een SBOM uploadt is de route zonder agent.

    cd "$HOME/.local/share/cve-watch/setup"
    ./watchtower-agent -config ./agent.json -check-config &&
      ./watchtower-agent -config ./agent.json -once
    
    Toon automatische installatie
    cd "$HOME/.local/share/cve-watch/setup"
    ./watchtower-agent -config ./agent.json -check-config &&
      ./watchtower-agent -config ./agent.json -install-as-service
    # systeemwijd: sudo ./watchtower-agent -config ./agent.json -install-as-service
    
  6. 6

    Controleren: service en ontvangst

    Controleer eerst de lokale configuratie, voer een enkele scan uit en kijk daarna in Verzameling → Agents naar heartbeat en collectorstatus. Controleer in Omgeving → Assets of de juiste asset en componenten zijn ontvangen. Een actieve taak of service bewijst op zichzelf geen serverontvangst. Bij agent.json heet de beheerde unit cve-watch-agent-managed-agent.service; controleer hem met systemctl status of, bij een gebruikersservice, systemctl --user status.

  7. 7

    Beheren: updates, herstel en grenzen

    Beheerde updates zijn opt-in via autoUpdate on met een vertrouwde releasekey, manifest-URL en profiel. De agent bevestigt een nieuwe versie pas na een heartbeat. Een handmatige installatie houd je zelf actueel. Hostinventaris toont alleen wat Syft op die host kan lezen; ontbrekende software is geen veiligverklaring.

Agent aantoonbaar aangesloten

Controleer de systemd-status, heartbeat en ontvangen software op de bedoelde asset.

Open Watchtower