Skip to content

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 ​

BereichInhaltAktualisierung
SystemCPU, RAM, Platte, Last, Uptime, IP, angemeldete Benutzerjeder Heartbeat
GerätModell (z.B. "Mac mini", Mac14,3), Chip (Apple M2 / Intel), Architektur, Seriennummer, Geräteartstündlich
macOSVersion (z.B. 15.1.1), Build (z.B. 24B91), Darwin-Kerneljeder Heartbeat
SicherheitFileVault, Systemintegritätsschutz (SIP), Gatekeeper, Firewall + Tarnmodus, XProtect-Version, automatische Updates, MDM-Registrierungstündlich
macOS-Updatessoftwareupdate -l: Titel, Version, Größe, Art, Neustart nötig, Sicherheitsupdatestündlich
Homebrewveraltete Formulae und Casks (brew outdated)alle 6 Stunden
ProgrammeApps aus system_profiler (Name, Version, Quelle)alle 6 Stunden
Dienstelaunchd-Dienste von Drittanbietern (ohne com.apple.*): Label, PID, letzter Exit-Codejeder Heartbeat
Platten, Netzwerk, PortsVolumes, Interfaces, offene Portsjeder Heartbeat
Akku (nur Laptops)Ladung, Ladezyklen, maximale Kapazität, Zustandstü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äteartModelle
LaptopMacBook, MacBook Air, MacBook Pro
DesktopiMac
ServerMac 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) ​

  1. Im Modul macOS auf Mac hinzufügen klicken, Name und Kunde eingeben.
  2. Den angezeigten Befehl im Terminal des Macs ausführen (Administrator-Passwort nötig):
bash
curl -fsSL https://control.ihredomain.de/agent/macos-install.sh | sudo bash -s -- --token IHR_TOKEN

Fü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:

bash
sudo installer -pkg datazone-agent-macos.pkg -target /

Danach gilt:

  • Liegt schon /Library/Application Support/DATAZONE/agent.json vor (Update, Neuinstallation), startet der Agent neu mit dieser Konfiguration.
  • Massenverteilung: vorher /Library/Application Support/DATAZONE/onboarding.conf ablegen mit den Zeilen CENTRAL_URL=..., MASTER_TOKEN=... und optional CUSTOMER_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 ​

WasPfad
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 ​

SpalteBeschreibung
Name, Kundewie in allen Modulen
GeräteartLaptop / Desktop / Server
Modellz.B. "MacBook Pro"
macOSVersion, Build im Tooltip
Updatebereit oder Benutzer muss bestätigen (siehe unten), Tooltip mit "was tun"
UpdatesAnzahl offener macOS-Updates, Sicherheitsupdates als rotes "sec"
FileVaultan / aus / verschlüsselt gerade
Checks, Gruppen, Zuletzt gesehenwie 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:

ReiterInhalt
SicherheitJedes 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.
UpdatesmacOS-Updates mit Art, Neustart- und Sicherheits-Hinweis, Homebrew-Pakete, Aktionen
Programme, Dienste, Hardwarenur lesend
Akkunur bei Laptops
Disks, Network, Portswie 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:

  1. Updates werden heruntergeladen (softwareupdate -d).
  2. Schnelle Sicherheitsmaßnahmen (RSR) und XProtect werden direkt versucht.
  3. Der angemeldete Benutzer bekommt eine Mitteilung "Bitte Updates installieren".
  4. 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 ​

KnopfWirkung
Sicherheitsupdates installierennur Sicherheitsupdates, RSR und XProtect
Alle installierenalle angebotenen macOS-Updates
Homebrew aktualisierenbrew upgrade inklusive Casks
Benutzer benachrichtigenMitteilung an den angemeldeten Benutzer
Neustartshutdown -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):

CheckErgebnis
FileVault auskritisch
SIP auskritisch
Firewall ausWarnung
Gatekeeper ausWarnung
macOS-Sicherheitsupdate seit mehr als 14 Tagen offenWarnung
Akku: Service empfohlenWarnung

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, ~/Documents und ~/Downloads des 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 Recht macos.shell samt Kundenbindung. Jede Sitzung steht im Audit-Log (Aktion shell_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-ID 2Z7R8GDLT7). 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 ​

ProblemWas tun
Mac erscheint nichtLog prüfen: tail -50 /Library/Logs/DATAZONE/agent.log
Agent neu startensudo launchctl kickstart -k system/de.datazone.agent
Dienst-Statussudo 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 EingabeFreigaben Bildschirmaufnahme und Bedienungshilfen prüfen (siehe oben)
Fernsteuerung: kein BildFreigabe Bildschirm- & Systemaudioaufnahme für „DATAZONE Fernwartung“ prüfen; Protokoll des Hilfsprogramms: ~/Library/Logs/DATAZONE/remote-helper.log
Fernsteuerung: Hilfsprogramm läuft nichtAgent-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

DATAZONE Control Documentation