macOS-agent installeren
Dezelfde keuzes voor Apple Silicon en Intel, met eenmalige run of launchd.
Wat je nodig hebt
- macOS op Apple Silicon of Intel met recente Apple-beveiligingsupdates
- Leesrechten op de gekozen bronnen
- Een agenttoken; voor mTLS ook een goedgekeurd clientcertificaat
-
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. Kies voor een persoonlijke Mac een LaunchAgent en voor een beheerde machine een LaunchDaemon; de collectors zien alleen bronnen waarvoor die account leesrechten heeft. Syft is nodig voor host-, directory- en containerscans.
-
2
Downloaden
Kies Apple Silicon (arm64) of Intel (amd64). Gebruik één van de drie routes hieronder. Controleer de gedownloade binary tegen de aparte SHA-256-checksum; de ondertekende releasecatalogus bevat dezelfde artifacthash. Er is geen officiële Homebrew-formule voor de WatchTower-agent.
Via de browser
Kies de binary en bijbehorende checksum voor de architectuur van je Mac. Maak zo nodig in het Opslaan als-venster de map ~/Library/Application Support/WatchTower/setup aan en bewaar beide bestanden daar met hun originele naam. Controleer de checksum en hernoem de binary daarna met het commando hieronder; vervang arm64 door amd64 op een Intel-Mac. De download bevat geen voorbeeldconfiguratie. Als macOS de browserdownload wegens ontbrekende Apple-notarisatie blokkeert, vraag dan de beheerder om een goedgekeurde distributieroute; zet Gatekeeper niet algemeen uit.
cd "$HOME/Library/Application Support/WatchTower/setup" shasum -a 256 -c watchtower-agent-darwin-arm64.sha256 mv watchtower-agent-darwin-arm64 watchtower-agent chmod 0755 watchtower-agentVia curl
Vervang arm64 in beide download-URL's, de checksumnaam en de mv-regel door amd64 op een Intel-Mac.
mkdir -p "$HOME/Library/Application Support/WatchTower/setup" cd "$HOME/Library/Application Support/WatchTower/setup" curl -fSLO https://stackportrait.com/downloads/agent/current/watchtower-agent-darwin-arm64 curl -fSLO https://stackportrait.com/downloads/agent/current/watchtower-agent-darwin-arm64.sha256 shasum -a 256 -c watchtower-agent-darwin-arm64.sha256 mv watchtower-agent-darwin-arm64 watchtower-agent chmod 0755 watchtower-agentVia interne softwaredistributie
Een beheerder kan dezelfde geverifieerde artifactbytes intern verspreiden. Controleer op de doelhost opnieuw de hash en bewaar de vaste releaseversie bij het wijzigingsrecord.
-
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 Mac een P-256-sleutel en CSR, upload alleen de CSR via Agentcertificaat aanvragen en zet na goedkeuring client-chain.crt bij de privésleutel. Voor een LaunchAgent kan de sleutel in de beschermde gebruikersmap hieronder staan; voor een LaunchDaemon moet de systeemaccount de sleutel kunnen lezen. Het token alleen of het certificaat alleen volstaat niet. Beheer bij zelf geïnstalleerde agents ook de certificaatvernieuwing.
Toon macOS-opdrachten voor sleutel en CSR
AGENT_ID=mac-01 # gebruik dezelfde waarde in agent.json CERT_DIR="$HOME/Library/Application Support/WatchTower/mtls/$AGENT_ID" mkdir -p "$CERT_DIR" && chmod 700 "$CERT_DIR" umask 077 openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out "$CERT_DIR/client.key" 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" # Upload uitsluitend client.csr en plaats client-chain.crt na goedkeuring in CERT_DIR. -
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. Voor deze macos-host collector is Syft niet nodig; voor host-, directory- en containercollectors wel.
cd "$HOME/Library/Application Support/WatchTower/setup" umask 077 cat > agent.json <<'JSON' { "url": "https://stackportrait.com", "token": "<agenttoken>", "agentId": "mac-01", "asset": "mac-01-host", "environment": "acceptance", "collectors": [{"type":"macos-host","name":"host-packages","asset":"mac-01-host","environment":"acceptance"}] } JSON open -e agent.json -
5
Installeren: start eenmalig of via launchd
Voor een proef draai je de binary met -once. Met -install-as-service maakt de agent als gewone gebruiker een LaunchAgent; met sudo een LaunchDaemon. Je kunt een plist ook handmatig beheren. Gebruik een vaste configlocatie, want de installer kopieert configuratie en binary naar een beschermde agentmap.
cd "$HOME/Library/Application Support/WatchTower/setup" ./watchtower-agent -config ./agent.json -check-config && ./watchtower-agent -config ./agent.json -onceToon automatische installatie
cd "$HOME/Library/Application Support/WatchTower/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
Controleren: launchd 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. Controleer de launchd-label nl.revolted.watchtower.agent.<config-naam> in de juiste gebruikers- of systeemscope.
-
7
Beheren: updates, herstel en grenzen
Beheerde updates zijn opt-in via autoUpdate on en een vertrouwde releasekey. LaunchAgent draait alleen binnen de gekozen gebruikerscontext; niet-leesbare directories en containers ontbreken. Een handmatige plist en een zelf beheerd mTLS-certificaat vereisen eigen onderhoud.
Agent aantoonbaar aangesloten
Controleer de launchd-status, heartbeat en ontvangen software op de bedoelde asset.