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
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
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
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
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
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.