Documentatie / Beveiliging

Agent met mTLS aansluiten

Maak een sleutel en CSR, laat het clientcertificaat uitgeven en start daarna de agent.

Wat je nodig hebt

  • Een agent-ID dat ook in agent.json wordt gebruikt
  • Een Agent · mTLS bootstrap-token
  • Toegang tot de agenthost met OpenSSL en sudo
  1. 1

    Maak op de agenthost de privésleutel en CSR

    Voer deze stap op de agenthost uit. Vul exact dezelfde agent-ID in als bij agentId in de configuratie. De privésleutel blijft op deze host. Heb je al client.key en client.csr, sla deze stap over en maak geen nieuwe sleutel.

    printf 'Agent-ID (gelijk aan agentId in agent.json): '; read -r AGENT_ID
    CERT_DIR="/etc/cve-watch/mtls/$AGENT_ID"
    sudo install -d -m 0700 "$CERT_DIR"
    sudo sh -c 'umask 077; openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -pkeyopt ec_param_enc:named_curve -out "$1/client.key"' sh "$CERT_DIR"
    sudo openssl req -new -sha256 -key "$CERT_DIR/client.key" -out "$CERT_DIR/client.csr" -subj "/C=NL/O=Revolted/OU=CVE Watchtower Agent/CN=$AGENT_ID"
    sudo chmod 0400 "$CERT_DIR/client.key"
  2. 2

    Laat het verzoek ondertekenen

    client.csr is een certificate signing request en bevat nog geen clientcertificaat. Open Verzameling → Inrichting → Agentcertificaat aanvragen. Dien daar uitsluitend de CSR in, met dezelfde agent-ID als in agent.json. De privésleutel en het bootstrap-token blijven op de agenthost. Een platformbeheerder controleert en keurt de aanvraag goed; de geïsoleerde CA-host tekent daarna. Een zelfondertekend certificaat wordt niet door de WatchTower-proxy vertrouwd.

  3. 3

    Installeer het ontvangen client-chain.crt

    Download client-chain.crt vanuit Mijn aanvragen in WatchTower en plaats het in de huidige werkmap van de agenthost. Vul opnieuw dezelfde agent-ID in. Pas na deze stap bestaat het bestand dat clientCertificate in de configuratie aanwijst. Een CSR hernoemen naar .crt maakt er geen certificaat van.

    printf 'Agent-ID (dezelfde als bij stap 1): '; read -r AGENT_ID
    CERT_DIR="/etc/cve-watch/mtls/$AGENT_ID"
    sudo install -m 0444 ./client-chain.crt "$CERT_DIR/client-chain.crt"
    sudo openssl x509 -in "$CERT_DIR/client-chain.crt" -noout -subject -dates
  4. 4

    Verwijs naar het certificaat, niet naar de CSR

    Vervang <agent-id> in beide paden door je eigen agent-ID. Het bootstrap-token staat apart in token. caCertificate is alleen nodig als de WatchTower-server een extra, niet door het systeem vertrouwde server-CA gebruikt.

    {
      "clientCertificate": "/etc/cve-watch/mtls/<agent-id>/client-chain.crt",
      "clientKey": "/etc/cve-watch/mtls/<agent-id>/client.key"
    }
  5. 5

    Controleer lokaal en start pas daarna

    Gebruik -doctor nadat client-chain.crt aanwezig is. De lokale controle verifieert dat er een echt clientcertificaat is, dat de sleutel erbij hoort en dat het certificaat momenteel geldig is. Of de WatchTower-proxy de CA vertrouwt, blijkt pas bij de verbinding met -once. Een melding over CSR betekent dat clientCertificate nog naar het ondertekenverzoek wijst.

    sudo watchtower-agent -config /etc/cve-watch/agent.json -check-config
    sudo watchtower-agent -config /etc/cve-watch/agent.json -doctor
    sudo watchtower-agent -config /etc/cve-watch/agent.json -once

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