macOS
Das macOS-Modul (ab v3.22.0) verwaltet Macs: MacBook, iMac, Mac mini, Mac Studio und Mac Pro, mit Intel oder Apple Silicon. Es zeigt Zustand, Sicherheit und Updates, verteilt macOS- und Homebrew-Updates über Jobs, führt Scripts und Checks aus und bietet Shell, Tunnel und RustDesk-Fernzugriff.
Die Modulfarbe ist Grau (Schiefer). Sie erscheint nur als Akzent (Icon, Punkt in der Seitenleiste).
Was wird erfasst
| Bereich | Inhalt | Aktualisierung |
|---|---|---|
| System | CPU, RAM, Platte, Last, Uptime, IP, angemeldete Benutzer | jeder Heartbeat |
| Gerät | Modell (z.B. "Mac mini", Mac14,3), Chip (Apple M2 / Intel), Architektur, Seriennummer, Geräteart | stündlich |
| macOS | Version (z.B. 15.1.1), Build (z.B. 24B91), Darwin-Kernel | jeder Heartbeat |
| Sicherheit | FileVault, Systemintegritätsschutz (SIP), Gatekeeper, Firewall + Tarnmodus, XProtect-Version, automatische Updates, MDM-Registrierung | stündlich |
| macOS-Updates | softwareupdate -l: Titel, Version, Größe, Art, Neustart nötig, Sicherheitsupdate | stündlich |
| Homebrew | veraltete Formulae und Casks (brew outdated) | alle 6 Stunden |
| Programme | Apps aus system_profiler (Name, Version, Quelle) | alle 6 Stunden |
| Dienste | launchd-Dienste von Drittanbietern (ohne com.apple.*): Label, PID, letzter Exit-Code | jeder Heartbeat |
| Platten, Netzwerk, Ports | Volumes, Interfaces, offene Ports | jeder Heartbeat |
| Akku (nur Laptops) | Ladung, Ladezyklen, maximale Kapazität, Zustand | stündlich |
Langsame Quellen laufen im Hintergrund-Cache des Agents. Der Heartbeat wartet nie auf sie. Rescan (Detail-Panel oder Kontextmenü) leert den Cache und liest sofort neu ein.
Geräteart
Der Agent leitet die Geräteart aus dem Modell ab:
| Geräteart | Modelle |
|---|---|
| Laptop | MacBook, MacBook Air, MacBook Pro |
| Desktop | iMac |
| Server | Mac mini, Mac Studio, Mac Pro, Xserve |
Ein Mac mini als Arbeitsplatz lässt sich im Detail-Panel unter Auf einen Blick > Geräteart von Hand umstellen. Die Geräteart steuert:
- Offline-Alarm nur für Server. Ausgeschaltete Laptops und iMacs sind kein Problem (wie Windows-Arbeitsplätze).
- den Gerätetyp-Filter in Jobs (Nur Server / Nur Arbeitsplätze) und in der Liste.
Installation
Per curl (einzelner Mac)
- Im Modul macOS auf Mac hinzufügen klicken, Name und Kunde eingeben.
- Den angezeigten Befehl im Terminal des Macs ausführen (Administrator-Passwort nötig):
curl -fsSL https://control.ihredomain.de/agent/macos-install.sh | sudo bash -s -- --token IHR_TOKENFür die Selbstregistrierung mit dem Master-Token steht der Befehl unter Einstellungen > Onboarding > macOS.
Der Installer lädt das passende Binary (datazone-agent-darwin-arm64 bzw. -amd64). Es ist von DATAZONE signiert und von Apple notarisiert, Gatekeeper blockiert es nicht.
Per Paket (.pkg)
Alternativ gibt es das signierte und notarisierte Paket datazone-agent-macos.pkg (Universal-Binary für Intel und Apple Silicon). Es installiert Agent und launchd-Dienst, enthält aber keine Kundendaten:
sudo installer -pkg datazone-agent-macos.pkg -target /Danach gilt:
- Liegt schon
/Library/Application Support/DATAZONE/agent.jsonvor (Update, Neuinstallation), startet der Agent neu mit dieser Konfiguration. - Massenverteilung: vorher
/Library/Application Support/DATAZONE/onboarding.confablegen mit den ZeilenCENTRAL_URL=...,MASTER_TOKEN=...und optionalCUSTOMER_NUMBER=.... Der Mac registriert sich selbst, die Datei wird danach gelöscht. - Sonst ist der Agent installiert, aber nicht gestartet. Registrieren mit dem curl-Installer aus Einstellungen > Onboarding.
Installationspfade
| Was | Pfad |
|---|---|
| Binary | /usr/local/datazone/datazone-agent |
| Konfiguration | /Library/Application Support/DATAZONE/agent.json (nur root lesbar) |
| Log | /Library/Logs/DATAZONE/agent.log |
| launchd-Dienst | /Library/LaunchDaemons/de.datazone.agent.plist (Label de.datazone.agent) |
| Hilfsprogramm Fernsteuerung | /Library/Application Support/DATAZONE/DATAZONE Fernwartung.app, LaunchAgent /Library/LaunchAgents/de.datazone.agent.remote.plist (lädt der Agent selbst) |
Liste
| Spalte | Beschreibung |
|---|---|
| Name, Kunde | wie in allen Modulen |
| Geräteart | Laptop / Desktop / Server |
| Modell | z.B. "MacBook Pro" |
| macOS | Version, Build im Tooltip |
| Update | bereit oder Benutzer muss bestätigen (siehe unten), Tooltip mit "was tun" |
| Updates | Anzahl offener macOS-Updates, Sicherheitsupdates als rotes "sec" |
| FileVault | an / aus / verschlüsselt gerade |
| Checks, Gruppen, Zuletzt gesehen | wie in allen Modulen |
Weitere Spalten (Chip, Benutzer, Seriennummer, CPU/RAM/Disk, Status als Wort, Fernzugriff) lassen sich über das Spalten-Menü einblenden. Filter Gerätetyp, Status-Filter (inkl. Wartung / Außer Betrieb), gespeicherte Ansichten und Sammelaktionen funktionieren wie in den anderen Modulen. Sammelaktionen: Update, Update + Neustart, Homebrew aktualisieren, Neustart, Agent-Update, Wartung / Außer Betrieb, Script, Check.
Detail-Panel
Auf einen Blick zeigt Auslastung, macOS-Version, Updates, Sicherheit und Geräteart als Kacheln, darunter Modell, Chip, macOS + Build, Seriennummer, Geräteart, angemeldeten Benutzer und Uptime. Unter-Reiter:
| Reiter | Inhalt |
|---|---|
| Sicherheit | Jedes Merkmal als Punkt + Wort mit einem Satz "was tun" (z.B. FileVault aus: in Systemeinstellungen einschalten und Wiederherstellungsschlüssel sicher ablegen). Darunter automatische Updates und Wazuh. |
| Updates | macOS-Updates mit Art, Neustart- und Sicherheits-Hinweis, Homebrew-Pakete, Aktionen |
| Programme, Dienste, Hardware | nur lesend |
| Akku | nur bei Laptops |
| Disks, Network, Ports | wie bei Linux |
Dazu die Reiter Updates, Checks, Jobs, Shell, Log, Gruppen und Agent wie in den anderen Modulen.
Updates
Apple Silicon: ehrliche Grenze ohne MDM
Auf Macs mit Apple Silicon kann ein Programm macOS-Updates nicht ohne Benutzer installieren: Apple verlangt dafür die Freigabe eines Benutzers mit sicherem Token (oder ein MDM). Control tut deshalb, was geht:
- Updates werden heruntergeladen (
softwareupdate -d). - Schnelle Sicherheitsmaßnahmen (RSR) und XProtect werden direkt versucht.
- Der angemeldete Benutzer bekommt eine Mitteilung "Bitte Updates installieren".
- Der Task endet als erledigt mit dem Ergebnis "heruntergeladen, Benutzer muss bestätigen", nicht als Fehler.
Die Spalte Update zeigt dann Benutzer muss bestätigen. Klartext: "Apple Silicon: macOS-Updates brauchen die Freigabe eines Benutzers am Mac. Control lädt sie herunter und zeigt dem Benutzer einen Hinweis." Mit Benutzer benachrichtigen lässt sich der Hinweis jederzeit erneut schicken.
Intel-Macs installieren ohne Benutzer (softwareupdate -i). Ein Neustart passiert nur, wenn Neustart erlauben gesetzt ist und ein Update ihn braucht.
Aktionen im Reiter Updates
| Knopf | Wirkung |
|---|---|
| Sicherheitsupdates installieren | nur Sicherheitsupdates, RSR und XProtect |
| Alle installieren | alle angebotenen macOS-Updates |
| Homebrew aktualisieren | brew upgrade inklusive Casks |
| Benutzer benachrichtigen | Mitteilung an den angemeldeten Benutzer |
| Neustart | shutdown -r +1 (Warnung, wenn ein Benutzer angemeldet ist) |
Jobs
Unter macOS > Jobs gibt es die Update-Typen Sicherheitsupdates, Alle macOS-Updates und Homebrew aktualisieren, dazu Script, Playbook und Check. Felder Gerätetyp (Alle / Nur Server / Nur Arbeitsplätze) und Neustart erlauben (nur Intel, nicht bei Homebrew). Hosts in Wartung oder außer Betrieb werden übersprungen. Siehe Zeitgesteuerte Jobs.
Homebrew
Homebrew darf nicht als root laufen. Control führt brew upgrade deshalb als Besitzer der Homebrew-Installation aus (/opt/homebrew bzw. /usr/local). Ohne Homebrew endet der Task mit "kein Homebrew", der Knopf ist dann ausgegraut.
Checks
Vorgefertigte Checks für macOS (zsh-Scripts mit Nagios-Exit-Codes, Verteilung über Check-Jobs):
| Check | Ergebnis |
|---|---|
| FileVault aus | kritisch |
| SIP aus | kritisch |
| Firewall aus | Warnung |
| Gatekeeper aus | Warnung |
| macOS-Sicherheitsupdate seit mehr als 14 Tagen offen | Warnung |
| Akku: Service empfohlen | Warnung |
Eigene Scripts für macOS: Sprache zsh, bash, sh oder python (python3), Modul macOS. Siehe Checks und Scripts.
Dateien (ab v3.30.0)
Reiter Dateien im Detail-Panel: Dateimanager im Browser wie bei Windows und Linux (Host online, Recht Dateien bzw. Dateien verwalten). Ordner durchsuchen, Dateien und Ordner (als ZIP) herunterladen, hochladen, umbenennen, löschen, Ordner anlegen.
- Der Agent läuft als root und kann alle Dateien lesen. Die Rechte sind deshalb nicht in der Rolle Viewer.
- Systemordner sind vor Löschen und Umbenennen geschützt, z. B.
/System,/Applications,/Library,/Users,/private,/usr/local, außerdem die Dateien von Agent und Hilfsprogramm (/usr/local/datazone,/Library/Application Support/DATAZONE, die LaunchDaemon/LaunchAgent-plists). Der Schutz für die Mac-Ordner wirkt ab Agent 3.30.0, ältere Agents schützen nur die allgemeinen Unix-Ordner. - Ordner unter
~/Desktop,~/Documentsund~/Downloadsdes Benutzers können wegen macOS-Datenschutz (TCC) leer erscheinen oder „Zugriff verweigert“ melden. Dann hat der Agent keinen Festplattenvollzugriff.
Fernzugriff
- Shell: Reiter Shell bzw. Kontextmenü (Recht
macos.shell). Der Agent startet eine zsh als root direkt auf dem Mac, ohne Anmeldung und ohne SSH („Entfernte Anmeldung“ muss nicht an sein). Wer die Shell öffnen darf, regelt allein das Rechtmacos.shellsamt Kundenbindung. Jede Sitzung steht im Audit-Log (Aktionshell_open). - Tunnel: Vorlagen SSH (22), Bildschirmfreigabe/VNC (5900), SMB, HTTP(S).
- RustDesk: wie bei Windows/Linux. macOS verlangt zwei Freigaben, die nur ein Benutzer am Mac erteilen kann: Systemeinstellungen > Datenschutz & Sicherheit > Bildschirmaufnahme und > Bedienungshilfen jeweils für RustDesk erlauben. Fehlt Bildschirmaufnahme, bleibt das Bild schwarz; fehlen Bedienungshilfen, reagieren Maus und Tastatur nicht.
Fernsteuerung (Take Control)
Ab Version 3.26.0 lässt sich der Bildschirm eines Macs wie bei Windows direkt im Browser fernsteuern (Knopf Fernsteuerung, Recht macos.takecontrol; das Recht ist sensibel und kommt nicht über „alle Unterreiter“). Allgemeines zu Ablauf, Zustimmung und Viewer: Fernsteuerung.
Hilfsprogramm: Bild und Eingaben übernimmt das signierte Programm DATAZONE Fernwartung (
/Library/Application Support/DATAZONE/DATAZONE Fernwartung.app), das als LaunchAgent (de.datazone.agent.remote) im angemeldeten Benutzer läuft. Der Agent lädt es selbst nach und hält es auf seiner eigenen Version (beim Start und vor jeder Fernsteuerung, prüft die Apple-Signatur der DATAZONE GmbH). Am Mac ist nichts zu installieren.Einmalige Freigaben: beim ersten Fernzugriff muss der Benutzer am Mac unter Systemeinstellungen > Datenschutz & Sicherheit zwei Einträge für DATAZONE Fernwartung einschalten:
- Bildschirm- & Systemaudioaufnahme – ohne diese Freigabe kein Bild. Control meldet dann „Freigabe 'Bildschirmaufnahme' fehlt …“.
- Bedienungshilfen – ohne diese Freigabe nur Zuschauen, Maus und Tastatur wirken nicht.
Ab 3.31.1 führt ein Fenster Freigaben für die Fernwartung (mit DATAZONE-Logo) den Benutzer durch beide Schritte: Es zeigt live, welche Freigabe fehlt, und öffnet mit Freigeben … direkt die richtige Seite der Systemeinstellungen. Dort schaltet der Benutzer DATAZONE Fernwartung ein und bestätigt bei der Bildschirmaufnahme „Beenden & erneut öffnen“. Das Hilfsprogramm startet dann von selbst neu, und das Fenster zeigt den nächsten Schritt bzw. „Alles erledigt“. Das Fenster erscheint einmal nach der Installation (wenn eine Freigabe fehlt) und bei jedem Fernzugriff, dem eine Freigabe fehlt. Fehlt die Bildschirmaufnahme, nach der Freigabe einfach erneut verbinden. Fehlen nur die Bedienungshilfen, wirken Maus und Tastatur sofort nach der Freigabe, ohne neu zu verbinden. Ganz ohne Benutzer am Mac geht das nicht, das lässt macOS nicht zu.
Danach funktioniert die Fernsteuerung unbeaufsichtigt (je nach Einstellung mit Hinweisleiste oder Nachfrage). Die Freigaben bleiben bei Updates des Hilfsprogramms erhalten.
MDM: Bedienungshilfen lassen sich per PPPC-Profil (Privacy Preferences Policy Control) vorab erlauben (Bundle-ID
de.datazone.agent.remote, Team-ID2Z7R8GDLT7). Bildschirmaufnahme kann Apple per MDM nicht still erteilen – höchstens so, dass ein normaler Benutzer sie selbst einschalten darf.Nur mit angemeldetem Benutzer: Das Anmeldefenster (kein Benutzer angemeldet, nach Neustart) wird in dieser Version nicht unterstützt. Control meldet dann „Kein Benutzer am Mac angemeldet oder Hilfsprogramm läuft nicht“. Bei schnellem Benutzerwechsel wird der Benutzer gesteuert, der gerade am Bildschirm ist.
Strg+Alt+Entf gibt es auf dem Mac nicht; die Windows-Taste entspricht Command, Alt entspricht Option.
Nachfragen (ab 3.48.1): Bis der Benutzer zugestimmt hat, leitet der Agent weder Maus, Tastatur noch Zwischenablage an den Mac weiter, und es verlässt kein Bild den Mac. Steuerbefehle aus dem Viewer an das Hilfsprogramm verwirft der Agent immer. Das gilt genauso für Linux-Desktops.
Fehlerbehebung
| Problem | Was tun |
|---|---|
| Mac erscheint nicht | Log prüfen: tail -50 /Library/Logs/DATAZONE/agent.log |
| Agent neu starten | sudo launchctl kickstart -k system/de.datazone.agent |
| Dienst-Status | sudo launchctl print system/de.datazone.agent |
| Token/URL ändern | /Library/Application Support/DATAZONE/agent.json bearbeiten, danach Agent neu starten |
| Update bleibt bei "Benutzer muss bestätigen" | Erwartet auf Apple Silicon ohne MDM: Benutzer muss in Systemeinstellungen > Softwareupdate bestätigen |
| RustDesk schwarz / keine Eingabe | Freigaben Bildschirmaufnahme und Bedienungshilfen prüfen (siehe oben) |
| Fernsteuerung: kein Bild | Freigabe Bildschirm- & Systemaudioaufnahme für „DATAZONE Fernwartung“ prüfen; Protokoll des Hilfsprogramms: ~/Library/Logs/DATAZONE/remote-helper.log |
| Fernsteuerung: Hilfsprogramm läuft nicht | Agent-Log nach remote helper durchsuchen; Status: launchctl print gui/$(id -u)/de.datazone.agent.remote (als angemeldeter Benutzer) |
| Sicherheitswerte "unbekannt" | Agent auf 3.22.0 oder neuer aktualisieren, Rescan starten |