Einführung
Der Level-Agent ist ein schlanker Hintergrunddienst, der sich bei Ihrem Konto anmeldet und Fernsteuerung, Überwachung, Automatisierung sowie Patch-Management für ein Gerät bereitstellt. Die Installation unter macOS dauert ein paar Minuten, wobei nach der ersten Installation einige Berechtigungen erteilt werden müssen.
⚙️ VORAUSSETZUNGEN
Ein Level-Konto mit der Berechtigung, Geräte hinzuzufügen
Lokale Administratorrechte auf dem Ziel-macOS-Gerät
macOS 11 (Big Sur) oder höher
🎬 VIDEO
macOS-Installation
Das Installationsfenster öffnen
Klicken Sie auf Neues Gerät hinzufügen in der oberen rechten Ecke der Geräteliste Seite. Wählen Sie im Betriebssystem-Selektor macOS.
Eine Gerätegruppe auswählen (Optional)
Wählen Sie eine Gerätegruppe aus, bevor Sie Ihren Installationsbefehl kopieren. Der Installationsschlüssel wird aktualisiert und enthält die Gruppen-ID, sodass das Gerät beim ersten Check-in automatisch in der richtigen Gruppe landet. Bei der Installer-Methode wird der schlüsselbasierte Setup-Befehl aktualisiert, nicht der Inhalt der heruntergeladenen PKG-Datei.
Wenn Sie diesen Schritt überspringen, landet das Gerät in Ohne Gruppe — Sie können es danach verschieben.
💡 TIPP: Das Zuweisen einer Gruppe zum Installationszeitpunkt bedeutet, dass das Gerät sofort alle gruppenweiten Automatisierungen und Berechtigungen übernimmt.
Der Installationsschlüssel
Die Registrierung eines Mac verwendet einen Installationsschlüssel, ein kurzer Token, der im Fenster sichtbar ist und neue Geräte mit Ihrem Level-Konto verknüpft. Er ist bewusst eng begrenzt: Wenn er offengelegt wird, kann er nicht auf Ihr Konto, vorhandene Geräte oder die Level-API zugreifen. Das einzige Risiko besteht darin, dass jemand ihn verwenden könnte, um Geräte zu Ihrem Konto hinzuzufügen.
Wenn Sie glauben, dass Ihr Installationsschlüssel kompromittiert wurde, wenden Sie sich an den Level-Support, um ihn zu erneuern.
ℹ️ HINWEIS: Der Installationsschlüssel spiegelt Ihre Gruppenauswahl in Echtzeit wider. Ohne ausgewählte Gruppe enthält er nur Ihren Kontobezeichner. Wählen Sie eine Gruppe aus, wird die Gruppen-ID angehängt.
Installationsmethoden
Das Fenster hat zwei Registerkarten für macOS.
Einzeiliger Befehl
Ein einzeiliger curl-Befehl, der den Agenten herunterlädt und installiert. Dies ist die schnellste Methode und funktioniert auf jeder unterstützten Architektur, ohne eine manuell auswählen zu müssen.
Wählen Sie im Fenster die Einzeiliger Befehl Registerkarte.
Optional eine Gerätegruppe auswählen.
Den generierten Befehl kopieren.
Öffnen Sie auf dem Zielgerät Terminal.
Fügen Sie den Befehl ein und führen Sie ihn aus. Möglicherweise werden Sie nach Ihrem Administratorkennwort gefragt.
Das Gerät erscheint in Ihrer Geräteliste innerhalb von 5–10 Sekunden nach Abschluss der Installation.
Installer
Laden Sie eine architekturspezifische PKG-Datei herunter und führen Sie dann den vollständigen Befehl aus, der im Fenster angezeigt wird, um den Mac zu installieren und zu registrieren.
Wählen Sie im Fenster die Installer Registerkarte.
Wählen Sie Ihre Architektur aus dem Dropdown-Menü: x64 (Intel) oder ARM64 (Apple Silicon).
Optional eine Gerätegruppe auswählen.
Klicken Sie auf Installer herunterladen um die PKG-Datei herunterzuladen.
Öffnen Sie auf dem Ziel-Mac Terminal und wechseln Sie in den Ordner, der die heruntergeladene PKG-Datei enthält.
Kopieren Sie den vollständigen Befehl aus dem Fenster und führen Sie ihn aus. Vergewissern Sie sich, dass der PKG-Dateiname im Befehl mit der heruntergeladenen Datei übereinstimmt. Möglicherweise werden Sie nach Ihrem Administratorkennwort gefragt.
ℹ️ HINWEIS: Ein Doppelklick auf die Standard-PKG-Datei installiert die Anwendung und die CLI, aber der Assistent fragt nicht nach Ihrem Installationsschlüssel und registriert den Mac nicht. Der vollständige Befehl im Fenster installiert zuerst die PKG-Datei und führt dann einen separaten Level-Registrierungsbefehl mit Ihrem Installationsschlüssel aus. Führen Sie den vollständigen Befehl aus, um die Einrichtung abzuschließen, oder verwenden Sie die Einzeiliger Befehl Methode oben.
🖥️ PLATTFORMHINWEIS:
Intel (x64): Wählen Sie x64 im Architektur-Dropdown-Menü.
Apple Silicon (M1/M2/M3): Wählen Sie ARM64. Level verwendet auf Apple-Silicon-Geräten ein Dienstkonto zur Unterstützung des Patch-Managements – nach Abschluss der Installation werden Sie nach Administratoranmeldedaten gefragt. Dies ist das erwartete Verhalten.
Erzwungene Installation (Erweitert)
Wenn eine frühere Level-Installation veraltete Dateien hinterlassen hat, verwenden Sie den forceInstall URL-Parameter, um eine saubere Überschreibung zu erzwingen.
ℹ️ HINWEIS: forceInstall=true ist ein URL-Parameter für Support-Szenarien. Der Level-Support kann Sie bei der Fehlerbehebung direkt zu einer vorkonfigurierten Fenster-URL weiterleiten.
Navigieren Sie zu:
https://app.level.io/devices?forceInstall=true
Dies fügt LEVEL_FORCE_INSTALL=true zum generierten einzeiligen Befehl.
⚠️ WARNUNG: Die erzwungene Installation überschreibt jede vorhandene Level-Agentenkonfiguration auf dem Gerät. Verwenden Sie diese Option nur, wenn eine Standardinstallation fehlschlägt oder der Level-Support Sie dazu anweist.
Nach der Installation: Berechtigungen
macOS erfordert explizite Berechtigungserteilungen für Fernsteuerung, Bildschirmaufnahme und Dateizugriff. Nachdem der Agent installiert wurde, erteilen Sie Level den Zugriff an allen drei Stellen unter Systemeinstellungen → Datenschutz & Sicherheit:
Bildschirmaufnahme
Gerätesteuerung und Datenzugriff (macOS 27) oder Bedienungshilfen (ältere Versionen)
Voller Festplattenzugriff
macOS 27 (Golden Gate): Apple hat Bedienungshilfen zu Gerätesteuerung und Datenzugriff. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Gerätesteuerung und Datenzugriff und aktivieren Sie Level. Unter macOS 26 (Tahoe) heißt die Einstellung weiterhin Bedienungshilfen. Um Ihre macOS-Version zu überprüfen, wählen Sie Apple-Menü → Über diesen Mac.
Sie benötigen Administratoranmeldedaten, um diese Änderungen vorzunehmen.
ℹ️ HINWEIS: Das Installationsfenster listet diese drei Berechtigungen als Erinnerung am unteren Rand beider Installationsregisterkarten auf.
MDM-Bereitstellung: mobileconfig-Profil (Optional)
💡 TIPP: Wenn Sie auf vielen macOS-Geräten bereitstellen, verwenden Sie das unten beschriebene mobileconfig-Profil. Es erteilt Bedienungshilfen und vollen Festplattenzugriff automatisch per MDM und ermöglicht es Nicht-Administratoren, die Bildschirmaufnahme-Anfrage zu genehmigen, ohne Administratoranmeldedaten zu benötigen.
Für von MDM verwaltete Umgebungen können Sie ein PPPC-Profil (Privacy Preferences Policy Control) als mobileconfig-Profil bereitstellen, um die Berechtigungseinrichtung nach der Installation zu vereinfachen.
Das Profil erteilt Bedienungshilfen und vollen Festplattenzugriff automatisch per MDM-Richtlinie. Die Bildschirmaufnahme ist eine geschützte Datenschutzberechtigung, die Apple MDM nicht automatisch erteilen lässt – stattdessen ermöglicht das Profil Nicht-Admin-Benutzern, die Bildschirmaufnahme-Anfrage selbst zu genehmigen, ohne Administratoranmeldedaten zu benötigen.
⚠️ WARNUNG: Die von Level bereitgestellte mobileconfig-Datei ist nur ein Beispiel. Level bietet keinen Support für die Erstellung, Verwaltung oder Fehlerbehebung von MDM-Konfigurationen – das Verhalten variiert je nach MDM-Anbieter. Testen Sie in Ihrer eigenen Umgebung, bevor Sie breit bereitstellen.
So führen Sie die Bereitstellung durch:
Laden Sie das mobileconfig-Profil herunter: Level - PPPC.mobileconfig herunterladen
Übertragen Sie es über Ihr MDM-Tool oder stellen Sie es per Skript als Teil Ihres Installationsprozesses bereit.
Nach der Bereitstellung werden Bedienungshilfen und voller Festplattenzugriff automatisch erteilt. Endbenutzer können die Bildschirmaufnahme-Anfrage ohne Administratoranmeldedaten genehmigen.
AV/EDR-Ausschlüsse
Einige Antiviren- und EDR-Tools stufen Level als Bedrohung ein. Fügen Sie Level vor der Bereitstellung zu Ihren Ausschlüssen hinzu, um zu verhindern, dass die Installation blockiert oder der Agent nach der Installation unter Quarantäne gestellt wird.
Informationen zu Ausschlusspfaden, Zertifikatsdetails und toolspezifischen Anweisungen finden Sie unter AV/EDR-Fehlerkennungen. Level veröffentlicht außerdem eine Erläuterung, warum EDR-Tools RMM-Agenten markieren, unter level.io/blog/edrs-distrust-rmms-and-thats-ok.
Systemanforderungen
Anforderung | Details |
Betriebssystem | macOS 11 (Big Sur) oder höher |
Architektur | Intel (x64) und Apple Silicon (ARM64) |
⚠️ WARNUNG: macOS High Sierra, Mojave und Catalina werden nach dem 4. Mai 2026 nicht mehr unterstützt.
Speicherorte
Pfad | Zweck |
| Anwendungsbinärdatei |
| CLI-Binärdatei |
| Agentdaten |
| Start-Agent |
| Start-Daemon |
Nach der Installation
Nach Abschluss der Einrichtung und Registrierung erscheint das Gerät in Ihrer Geräteliste innerhalb von 5–10 Sekunden und beginnt innerhalb weniger Minuten mit der Erfassung des Hardware-Inventars.
Wenn das Gerät nicht erscheint oder kurz nach der Installation offline geht, siehe Offline-Fehlerbehebung.
Häufig gestellte Fragen
Ist der Installationsschlüssel dasselbe wie ein API-Schlüssel? Nein. Der Installationsschlüssel (aus Neues Gerät hinzufügen) registriert nur Geräte in Ihrem Konto. API-Schlüssel (aus Einstellungen → API-Schlüssel) externe Tools gegenüber der Level-API authentifizieren. Sie können den Agenten nicht mit einem API-Schlüssel installieren – verwenden Sie den Installationsschlüssel aus dem Installationsfenster. Siehe API-Schlüssel-Einstellungen.
Welche Berechtigungen benötigt Level unter macOS und warum? Level benötigt Bildschirmaufnahme (für Fernsteuerung), Gerätesteuerung und Datenzugriff unter macOS 27 oder Bedienungshilfen bei älteren Versionen (für Eingabeautomatisierung während Fernsitzungen) und vollen Festplattenzugriff (für Dateioperationen und Patch-Management). Ohne diese Berechtigungen funktionieren die Fernsteuerung und einige Verwaltungsfunktionen nicht.
Warum werde ich nach den Administratoranmeldedaten gefragt, nachdem die Installation auf meinem Apple-Silicon-Mac abgeschlossen ist? Level erstellt auf Apple-Silicon-Geräten ein Dienstkonto zur Unterstützung des Patch-Managements. Diese Anfrage ist zu erwarten – geben Sie die Administratoranmeldedaten ein, um die Einrichtung abzuschließen.
Welche Architektur soll ich auf der Installer-Registerkarte auswählen? Wählen Sie x64 für Intel-Macs und ARM64 für Apple Silicon (M1/M2/M3). Wenn Sie unsicher sind, überprüfen Sie Apple-Menü → Über diesen Mac. Die einzeilige Befehlsmethode erkennt die Architektur automatisch und erfordert keine manuelle Auswahl.
Was ist der Unterschied zwischen dem grafischen Installer und dem Terminal-Befehl? Ein Doppelklick auf die Standard-PKG-Datei installiert die Anwendung und die CLI, ohne einen Installationsschlüssel abzufragen oder den Mac zu registrieren. Der vollständige Befehl in der Installer Registerkarte installiert diese PKG-Datei und führt dann den Level-Registrierungsbefehl mit Ihrem Installationsschlüssel aus. Verwenden Sie den vollständigen generierten Befehl oder die Einzeiliger Befehl Methode, um die Einrichtung abzuschließen.
Kann ich die Berechtigungsanfragen bei der Bereitstellung auf vielen Macs unterdrücken? Teilweise. Stellen Sie das Level-PPPC-mobileconfig-Profil über MDM bereit – es erteilt Bedienungshilfen und vollen Festplattenzugriff automatisch. Die Bildschirmaufnahme ist eine geschützte Apple-Datenschutzberechtigung, die MDM nicht automatisch erteilen kann, aber das Profil ermöglicht es Nicht-Admin-Benutzern, diese Anfrage selbst zu genehmigen, ohne Administratoranmeldedaten zu benötigen.
Kann ich Endbenutzern einen E-Mail-Link schicken, damit sie den Agenten selbst installieren? Nein. Der Agent benötigt lokale Administratorrechte, die die meisten Endbenutzer nicht haben. Die Installation muss von jemandem mit lokalem Administratorzugriff durchgeführt werden, manuell oder über ein Bereitstellungstool.
Was ist, wenn mein Installationsschlüssel kompromittiert wurde? Der Installationsschlüssel kann nicht auf Ihr Konto, vorhandene Geräte oder die Level-API zugreifen. Das einzige Risiko besteht darin, dass jemand Geräte zu Ihrem Konto hinzufügt. Wenden Sie sich bei Bedarf an den Level-Support, um den Schlüssel zu erneuern.
Die PKG-Datei wurde installiert, aber der Mac erscheint nicht in Level. Was soll ich überprüfen? Bestätigen Sie, dass Sie den vollständigen Befehl von der Installer Registerkarte oder die Einzeiliger Befehl Methode. Der PKG-Assistent allein schließt die Registrierung nicht ab. Warten Sie nach Abschluss der Einrichtung und Registrierung 10–15 Sekunden und aktualisieren Sie die Seite. Wenn das Gerät immer noch nicht erscheint, prüfen Sie, ob alle drei macOS-Berechtigungen erteilt wurden und ob ein AV/EDR-Tool den Agenten nicht blockiert hat. Siehe AV/EDR-Fehlerkennungen und Offline-Fehlerbehebung.



