Jamf Concepts
Anleitungen

Anleitungen

Jamf Device Checker

~15 min read
War das hilfreich?

Warum Jamf Device Checker verwenden?

Das Problem

Endbenutzer stoßen häufig auf Geräteprobleme, die ihre Produktivität beeinträchtigen, wissen aber nicht, wie sie diese erkennen oder beheben können:

  • Fehlende oder veraltete App-Versionen
  • Veraltete iOS-Versionen
  • Schlechter Batteriezustand, der zu unerwarteten Abschaltungen führt
  • Probleme mit der Speicherkapazität, die App-Installationen verhindern
  • Probleme mit der Netzwerkkonnektivität, die die Produktivität beeinträchtigen
  • Geräteüberhitzung, die zu Leistungsdrosselung führt
  • Hohe Speicher-/CPU-Auslastung, die die Arbeit verlangsamt

Diese Probleme führen typischerweise zu Helpdesk-Tickets, Produktivitätsverlust und frustrierten Benutzern.

Die Lösung

Jamf Device Checker befähigt Endbenutzer, Probleme mit der Gerätebereitschaft über eine einfache, farbcodierte Oberfläche selbst zu diagnostizieren und zu beheben:

  • Grün = Gerät ist einsatzbereit
  • ⚠️ Gelb = Warnungen, die bald behoben werden sollten
  • 🔴 Rot = Kritische Probleme, die die Produktivität verhindern

Wichtigste Vorteile

Für Endbenutzer: Self-Service-Bereitschaftsprüfungen des Geräts, klare umsetzbare Anleitungen zur Problembehebung, kürzere Wartezeiten für IT-Support und proaktive Benachrichtigungen vor Fristen.

Für IT-Teams: weniger Helpdesk-Tickets, Compliance-Durchsetzung von Unternehmensrichtlinien (OS-Versionen, erforderliche Apps), Echtzeit-Einblick in den Gerätezustand sowie konfigurierbare Schwellenwerte und Überwachungsregeln.

Für Organisationen: verbesserte Endbenutzerproduktivität, besseres Geräte-Lebenszyklusmanagement, reduzierte IT-Supportkosten sowie Compliance-Nachverfolgung und -Berichterstattung.

Anzeige des Gesamtstatus

Die App zeigt oben im Hauptbildschirm einen großen, farbcodierten Statusindikator an, der die Gesamtbereitschaft des Geräts zusammenfasst.

Status Farbe Symbol Beschreibung
Ready 🟢 Grün Häkchen Alle aktivierten Prüfungen bestanden. Gerät erfüllt alle Anforderungen.
Deadline Approaching 🟠 Orange Warndreieck Updates mit konfigurierten Fristen verfügbar. Zeigt „X update(s) available - Y day(s) remain" mit Countdown bis zur frühesten Frist an.
Action Needed 🟠 Orange Warndreieck Updates verfügbar, aber keine Fristen konfiguriert. Zeigt „X update(s) available" an.
Not Ready 🔴 Rot X-Markierung Ein oder mehrere Updates erforderlich, und Frist ist abgelaufen. Zeigt „X update(s) required" an.
Installing Updates 🔵 Blau Rotierende Pfeile MDM-Befehle laufen. Zeigt einen 2-Minuten-Countdown-Timer für die automatische Aktualisierung an.
Off Duty ⚪ Grau Mond mit Z's Gerät über Jamf Setup EA als außer Dienst markiert.
Unknown ⚪ Grau Fragezeichen Anfangszustand, bevor die erste Prüfung abgeschlossen ist.

Schnellstart

Voraussetzungen

  • Jamf Pro-Server (JPS)
  • Administratorzugriff auf Jamf Pro
  • Jamf Self Service-App (erforderlich für die App-Installationsfunktion)
  • Lokales Benutzerkonto mit Wizard-Berechtigungen (siehe unten)

Erforderliche API-Berechtigungen

Die App verwendet zwei unterschiedliche Berechtigungssätze:

Für die Wizard-Einrichtung (lokales Benutzerkonto – während der Erstkonfiguration verwendet):

Erstellen Sie einen lokalen Benutzer in Jamf Pro mit diesen 8 Berechtigungen:

API Integration Setup (einmalige Wizard-Konfiguration):

  • Read API Integrations
  • Create API Integrations
  • Update API Integrations
  • Read API Roles
  • Create API Roles
  • Update API Roles

App Config Management (Wizard + laufende Updates):

  • Read Mobile Device Applications
  • Update Mobile Device Applications

Dieses Benutzerkonto authentifiziert den Wizard über Basic Auth, um die API-Integration zu erstellen, Rollen zu konfigurieren, die native App zu verknüpfen und die App-Config-XML zu speichern. Nach der Ersteinrichtung wird dieser Benutzer nur für App-Config-Updates benötigt (erfordert lediglich die 2 Mobile Device Applications-Berechtigungen).

Für den Laufzeitbetrieb (OAuth-API-Client – automatisch vom Wizard konfiguriert):

Der Wizard erstellt automatisch eine „Jamf Device Checker"-API-Rolle mit diesen 4 Berechtigungen, die der verknüpften App-Integration zugewiesen werden:

  • Send Device Information Command
  • View MDM command information in Jamf Pro API
  • Read Mobile Devices
  • Send MDM command information in Jamf Pro API

Diese Berechtigungen ermöglichen es dem Device Checker, während des normalen Betriebs mittels OAuth-Authentifizierung Gerätedetails abzurufen und MDM-Befehle zu senden. Endbenutzer sehen oder verwenden diese Anmeldedaten niemals.

5-Minuten-Einrichtung

Schritt 1: App kaufen und zu Jamf Pro hinzufügen

  • „Jamf Device Checker" kaufen und der Jamf Pro-Instanz in AxM zuweisen
  • Navigieren Sie in Jamf Pro zu Mobile Device Apps
  • Fügen Sie „Jamf Device Checker" aus Apps Purchased in Volume hinzu

Schritt 2: Den Setup-Wizard ausführen

  • Installieren Sie die App auf Ihrem Admin-Gerät
  • Starten Sie die App und drücken Sie lange auf das kreisförmige Statusbild, um den Wizard-Modus zu aktivieren
  • Authentifizieren Sie sich mit dem lokalen Benutzer (erfordert 8 Wizard-Berechtigungen – siehe Erforderliche API-Berechtigungen oben)
  • Folgen Sie dem Wizard, um:
    • Die API-Rolle mit den erforderlichen Berechtigungen zu konfigurieren
    • Die API-Integration zu erstellen
    • Die native App zur Authentifizierung mit der API-Integration zu verknüpfen
    • Die Managed App Config zu generieren und im JPS zu speichern

Es gibt keinen Schritt 3 – legen Sie einfach den Geltungsbereich auf die Endbenutzergeräte fest.


Vollständige Einrichtungsanleitung

Schritt 1: Mobile Device App zu Jamf Pro hinzufügen

  • „Jamf Device Checker" kaufen und der Jamf Pro-Instanz in AxM zuweisen
  • Bei Jamf Pro anmelden
  • Navigieren Sie zu Devices > Mobile Device Apps
  • Klicken Sie auf + New
  • Suchen Sie nach „Jamf Device Checker" in Apps Purchased in Volume
  • Klicken Sie auf Add, um den App-Datensatz zu Ihrer Jamf Pro-Instanz hinzuzufügen

Schritt 2: Den Setup-Wizard ausführen

Der Wizard übernimmt automatisch die gesamte Authentifizierung und die Managed App Config.

App auf Admin-Gerät installieren

  • Weisen Sie die App einem iOS-Testgerät zu
  • Starten Sie Jamf Device Checker

Wizard-Modus aktivieren

  • Drücken Sie im Tab „More" 3 Sekunden lang auf das App-Symbol
  • Wählen Sie Wizard Setup
  • Authentifizieren Sie sich mit den in den Voraussetzungen erstellten lokalen Benutzeranmeldedaten (erfordert die 8 Wizard-Berechtigungen)

Wizard-Schritte abschließen

API Role

  • Der Wizard prüft auf eine vorhandene „Jamf Device Checker"-API-Rolle
  • Falls nicht gefunden, erstellt er die Rolle mit den erforderlichen Berechtigungen:
    • Send Device Information Command
    • View MDM command information in Jamf Pro API
    • Read Mobile Devices
    • Send MDM command information in Jamf Pro API
  • Verknüpft die Rolle mit der API-Integration

Native App Authentication

  • Der Wizard verknüpft den Mobile Device App-Datensatz mit der API-Integration
  • Aktiviert die OAuth-Authorization-Code-Übermittlung über Managed App Config

Generate App Config

  • Der Wizard generiert die vollständige Managed App Config
  • Sendet sie an Jamf Pro

Schritt 3: Geltungsbereich auf Geräte festlegen

  • Klicken Sie im selben App-Datensatz auf Scope
  • Fügen Sie Ziel-Gerätegruppen, Smart Groups oder einzelne Geräte hinzu
  • Klicken Sie auf Save

Konfigurationsreferenz

Die App wird vollständig über die Managed App Config von Jamf Pro konfiguriert. Nachfolgend finden Sie eine vollständige Referenz aller verfügbaren Schlüssel.

Erforderliche Schlüssel

Diese Schlüssel werden automatisch von Jamf Pro befüllt – ändern oder entfernen Sie sie nicht.

Schlüssel Beschreibung
JPS_URL Jamf Pro-Server-URL (automatisch befüllt: $JPS_URL)
JSSID Geräte-JSS-ID (automatisch befüllt: $JSSID)
MANAGEMENTID Geräteverwaltungs-ID (automatisch befüllt: $MANAGEMENTID)
OAUTH_AUTH_CODE OAuth-Authorization-Code (automatisch befüllt: $OAUTH_AUTH_CODE)
APP_CONFIG_REINSTALL_CODE Neuinstallations-Triggercode (automatisch befüllt: $APP_CONFIG_REINSTALL_CODE)
APPJSSID Jamf Device Checker-App-Datensatz-ID (automatisch befüllt: $APPJSSID)

Branding & Alerts-URL

Schlüssel Typ Standard Beschreibung
device-checker-branding-image-url String (leer) URL zum Firmenlogo-Bild (PNG/JPG). Leer lassen für kein Branding.
device-checker-branding-image-height Integer 80 Logohöhe in Punkten.
device-checker-alerts-url String (leer) Optionale URL für Alerts-/Statusseite. Zeigt Link im Alerts-Tab an.

Beispiel:

<key>device-checker-branding-image-url</key>
<string>https://yourcompany.com/logo.png</string>
<key>device-checker-branding-image-height</key>
<string>60</string>

Share-Buttons

Steuern Sie die Sichtbarkeit der Funktionen zum Teilen des Status und zum Exportieren von Protokollen im More-Tab.

Schlüssel Typ Standard Beschreibung
device-checker-send-status-enabled String YES Zeigt den Button „Send Status" an (teilt die Zusammenfassung der Gerätebereitschaft per E-Mail/Nachricht)
device-checker-send-logs-enabled String YES Zeigt den Button „Send Logs" an (exportiert App-Protokolle zur Fehlerbehebung)

Beispiel:

<key>device-checker-send-status-enabled</key>
<string>YES</string>
<key>device-checker-send-logs-enabled</key>
<string>NO</string>

UI-Verhalten

Steuern Sie das Scroll-Verhalten des Status-Tabs.

Schlüssel Typ Standard Beschreibung
device-checker-status-tab-scrollable String NO Bei YES wird der gesamte Status-Tab scrollbar (Kopfzeile + Gesamtstatus + Kacheln). Bei NO (Standard) bleiben Kopfzeile und Gesamtstatus fixiert und nur die Kacheln darunter scrollen.

Beispiel:

<key>device-checker-status-tab-scrollable</key>
<string>NO</string>

Wann aktivieren: Der Standard (NO) ist für die meisten Bereitstellungen am besten – Kopfzeile und Gesamtbereitschaftsstatus bleiben beim Scrollen durch die Kacheln sichtbar. Setzen Sie auf YES, wenn die gesamte Ansicht zusammen scrollen soll oder um längere Branding-Kopfzeilen auf kleineren Geräten zu berücksichtigen.


Bereitschaft des Betriebssystems

Überwachen Sie die OS-Versionsanforderung mit konfigurierbarer Mindestversion und Frist.

Schlüssel Typ Standard Beschreibung
device-checker-os-enabled String YES OS-Versionsüberwachungskachel aktivieren
device-checker-os-min-version String (keine) Mindestens erforderliche OS-Version (z. B. 26.2)
device-checker-os-deadline String (keine) Anforderungsfrist im Format YYYY-MM-DD

Beispiel:

<key>device-checker-os-enabled</key>
<string>YES</string>
<key>device-checker-os-min-version</key>
<string>26.2</string>
<key>device-checker-os-deadline</key>
<string>2026-06-30</string>

Statuslogik:

Grün (Ready) – Aktuelle OS-Version erfüllt die Mindestanforderung

⚠️ Gelb (Warning) – Aktuelle OS-Version unter Minimum, aber Frist ist NICHT abgelaufen (oder keine Frist konfiguriert)

🔴 Rot (Not Ready) – Aktuelle OS-Version unter Minimum UND Frist ist abgelaufen


App-Bereitschaft

Überwachen Sie den Installationsstatus und die Versionsanforderungen für erforderliche verwaltete Apps.

Schlüssel Typ Standard Beschreibung
device-checker-apps-enabled String NO App-Überwachungskachel aktivieren
device-checker-apps-list String (leer) Durch Pipe getrennte Liste von Apps (siehe Format unten)

App-Listenformat:

AppName,bundleID,minVersion,deadline|AppName2,bundleID2,minVersion2,deadline2|...

Beispiel:

<key>device-checker-apps-enabled</key>
<string>YES</string>
<key>device-checker-apps-list</key>
<string>Slack,com.tinyspeck.chatlyio,24.0.0,2026-03-01|Microsoft Teams,com.microsoft.skype.teams,5.0.0,2026-06-01</string>

Statuslogik:

Grün (Ready) – Alle Apps installiert und erfüllen die Mindestversionen

⚠️ Gelb (Warning) – Eine oder mehrere Apps müssen aktualisiert werden, aber Frist ist NICHT abgelaufen

🔴 Rot (Not Ready) – Eine oder mehrere Apps müssen aktualisiert werden UND Frist ist abgelaufen

Pending – App-Installation läuft (siehe Self Service-Integration unten)

Self Service-Integration:

Wenn Apps fehlen oder veraltet sind, können Benutzer auf den Button „Update Apps" auf der Apps-Kachel tippen, um erforderliche Apps automatisch zu installieren oder zu aktualisieren. Der Arbeitsablauf ist:

  1. Benutzer tippt auf den Button „Update Apps" auf der Apps-Kachel
  2. Die Jamf Self Service-App öffnet sich automatisch mit den fehlenden/veralteten Apps in der Warteschlange
  3. Device Checker wechselt in den Status „Pending" und startet einen 2-minütigen automatischen Aktualisierungstimer
  4. Die App aktualisiert sich automatisch alle 2 Minuten, um zu prüfen, ob die Installationen abgeschlossen sind
  5. Sobald alle Apps die Anforderungen erfüllen, kehrt der Status zu Grün zurück

Anforderungen: Jamf Self Service muss auf dem Gerät installiert sein, Apps müssen in Self Service verfügbar und dem Gerät zugewiesen sein, und bei den Apps muss „Display app in Self Service after it is installed" in Jamf Pro aktiviert sein.

Hinweise:

  • Die Bundle-ID muss exakt übereinstimmen (Groß-/Kleinschreibung beachten)
  • Der Versionsvergleich verwendet semantische Versionierung (z. B. 2.5.0 > 2.4.9)
  • Die Frist ist optional (leer lassen, falls nicht benötigt: AppName,bundleID,minVersion,)

Power Source (Batteriestand)

Überwachen Sie den Batterieladestand mit konfigurierbaren Warn- und kritischen Schwellenwerten.

Schlüssel Typ Standard Beschreibung
device-checker-power-source-enabled String YES Batteriestandüberwachungskachel aktivieren
device-checker-power-source-warning Integer 25 Warnschwellenwert (Prozent)
device-checker-power-source-critical Integer 10 Kritischer Schwellenwert (Prozent)

Beispiel:

<key>device-checker-power-source-enabled</key>
<string>YES</string>
<key>device-checker-power-source-warning</key>
<string>25</string>
<key>device-checker-power-source-critical</key>
<string>10</string>

Statuslogik:

🔴 Rot (Critical) – Batterie ≤ kritischer Schwellenwert

⚠️ Gelb (Warning) – Batterie ≤ Warnschwellenwert (aber > kritisch)

Grün (Ready) – Batterie > Warnschwellenwert

Charging – Gerät ist angeschlossen (beim Laden immer grün)


Speicherkapazität

Überwachen Sie den verfügbaren Speicher mit konfigurierbaren Warn- und kritischen Schwellenwerten (basierend auf verwendetem Prozentsatz).

Schlüssel Typ Standard Beschreibung
device-checker-storage-enabled String YES Speicherüberwachungskachel aktivieren
device-checker-storage-warning Integer 75 Warnschwellenwert (% verwendet)
device-checker-storage-critical Integer 90 Kritischer Schwellenwert (% verwendet)

Beispiel:

<key>device-checker-storage-enabled</key>
<string>YES</string>
<key>device-checker-storage-warning</key>
<string>75</string>
<key>device-checker-storage-critical</key>
<string>90</string>

Statuslogik:

🔴 Rot (Critical) – Verwendeter Speicher ≥ kritischer Schwellenwert

⚠️ Gelb (Warning) – Verwendeter Speicher ≥ Warnschwellenwert (aber < kritisch)

Grün (Ready) – Verwendeter Speicher < Warnschwellenwert


Batteriezustand

Überwachen Sie den Batteriezustand, um Geräte zu identifizieren, die möglicherweise einen Batterieaustausch benötigen. Diese Kachel zeigt den Batteriezustand und den aktuellen Ladeprozentsatz an.

Schlüssel Typ Standard Beschreibung
device-checker-battery-enabled String YES Batteriezustandsüberwachungskachel aktivieren

Beispiel:

<key>device-checker-battery-enabled</key>
<string>YES</string>

Statuslogik:

Grün (Ready) – Batteriezustand ist „Normal" oder „Unsupported"

🔴 Rot (Not Ready) – Batteriezustand ist „Service-Recommended" oder „Non-Genuine"

Grau (Unknown) – Batteriezustand ist „Unknown" oder Batteriedaten können nicht abgerufen werden

Werte für den Zustandsstatus:

  • Normal – Batterie funktioniert einwandfrei (Grün)
  • Service-Recommended – Batteriekapazität hat sich verschlechtert, Austausch empfohlen (Rot)
  • Non-Genuine – Nicht von Apple stammende Batterie erkannt, Austausch empfohlen (Rot)
  • Unsupported – Batteriezustandsüberwachung auf diesem Gerätemodell nicht verfügbar (Grün, zeigt nur Ladeprozent an)
  • Unknown – Zustandsdaten noch nicht von iOS verfügbar (Grau, zeigt nur Ladeprozent an)

Kachelanzeige: Statusfarbe und Symbol basieren auf dem Batteriezustand. Der Untertitel zeigt das Batteriezustandsproblem an, falls vorhanden, andernfalls den aktuellen Ladeprozentsatz. Die Detailansicht zeigt Ladestand, Ladezustand, Low Power Mode, Batteriezustandsstatus und Empfehlungen.

Hinweise:

  • Batteriezustandsdaten stammen aus Declarative Device Management (DDM)
  • Neue Geräte zeigen möglicherweise „Unknown" an, bis iOS die Zustandsmetriken berechnet (typischerweise nach einigen Ladezyklen)
  • Der Ladeprozentsatz wird immer im Untertitel oder in der Detailansicht angezeigt
  • Diese Kachel konzentriert sich auf den Batteriezustand; verwenden Sie die Power Source-Kachel für die Überwachung des Ladestands mit Schwellenwerten

Thermischer Zustand

Überwachen Sie die Gerätetemperatur in Echtzeit über lokale iOS-APIs (keine MDM-Aufrufe erforderlich).

Schlüssel Typ Standard Beschreibung
device-checker-thermal-enabled String YES Kachel zur Überwachung des thermischen Zustands aktivieren

Beispiel:

<key>device-checker-thermal-enabled</key>
<string>YES</string>

Statuslogik:

Grün (Nominal) – Normale Betriebstemperatur, alle Funktionen arbeiten normal

⚠️ Gelb (Fair) – Leicht erhöht, System verschiebt Hintergrundarbeiten wie Prefetching/Indizierung

🔴 Rot (Serious) – Hohe Temperatur, CPU/GPU-Drosselung aktiv, Bildraten können auf 30 FPS sinken

🔴 Rot (Critical) – Gerät kritisch heiß, erhebliche Drosselung, Kamera/Blitz/Lautsprecher können deaktiviert werden, Risiko einer Abschaltung

Anwendungsfälle: Feldgeräte in heißen Umgebungen (Fahrzeuge, Außenarbeit), Benutzer, die intensive Apps ausführen (Videoaufnahme, AR), proaktive Warnungen vor thermischen Abschaltungen und das Verständnis der Leistungsdrosselung.

Hinweise: Echtzeitüberwachung über die iOS ProcessInfo-API. Keine API-Aufrufe oder Batterieentladung. Wird sofort aktualisiert, wenn sich der thermische Zustand ändert.


Leistung (Speicher & CPU)

Überwachen Sie den Speicherdruck und die CPU-Auslastung des Geräts über lokale iOS-APIs mit konfigurierbaren Schwellenwerten.

Schlüssel Typ Standard Beschreibung
device-checker-performance-enabled String YES Leistungsüberwachungskachel aktivieren
device-checker-memory-warning Integer 70 Speicher-Warnschwellenwert (% verwendet)
device-checker-memory-critical Integer 85 Kritischer Speicherschwellenwert (% verwendet)
device-checker-cpu-warning Integer 60 CPU-Warnschwellenwert (% Auslastung)
device-checker-cpu-critical Integer 80 Kritischer CPU-Schwellenwert (% Auslastung)

Beispiel:

<key>device-checker-performance-enabled</key>
<string>YES</string>
<key>device-checker-memory-warning</key>
<string>70</string>
<key>device-checker-memory-critical</key>
<string>85</string>
<key>device-checker-cpu-warning</key>
<string>60</string>
<key>device-checker-cpu-critical</key>
<string>80</string>

Statuslogik:

🔴 Rot (Critical) – Speicher ODER CPU ≥ kritischer Schwellenwert

⚠️ Gelb (Warning) – Speicher ODER CPU ≥ Warnschwellenwert (aber < kritisch)

Grün (Ready) – Sowohl Speicher ALS AUCH CPU < Warnschwellenwerte

Hinweise: Wird alle 5 Sekunden aktualisiert, wenn die Kachel sichtbar ist. Die Überwachung pausiert, wenn die App im Hintergrund ist (um Batterie zu sparen). Keine Remote-API-Aufrufe erforderlich – vollständig lokale Überwachung über os_proc_available_memory() für Speicher und host_statistics() für CPU.


Netzwerkstatus

Überwachen Sie den Verbindungsstatus von WLAN, Ethernet und Mobilfunk.

Schlüssel Typ Standard Beschreibung
device-checker-wifi-enabled String YES WLAN/Ethernet-Überwachungskachel aktivieren (Ethernet wird automatisch erkannt, wenn verbunden)
device-checker-cellular-enabled String NO Mobilfunküberwachungskachel aktivieren
device-checker-network-speed-enabled String NO Netzwerkgeschwindigkeitstest-Button in Netzwerkdetailansichten aktivieren

Beispiel:

<key>device-checker-wifi-enabled</key>
<string>YES</string>
<key>device-checker-cellular-enabled</key>
<string>YES</string>
<key>device-checker-network-speed-enabled</key>
<string>YES</string>

Details zum Netzwerkgeschwindigkeitstest:

Der Geschwindigkeitstest ist ein bedarfsgesteuertes Diagnosetool (~10–15 MB pro Test, ~15–20 Sekunden Dauer), das Download-/Upload-Geschwindigkeiten und Latenz misst. Vor jedem Test über Mobilfunk wird eine Warnung angezeigt, um auf den Datenverbrauch hinzuweisen. Die Ergebnisse dienen nur zur Information und wirken sich nicht auf den Bereitschaftsstatus des Geräts aus. Anwendungsfälle umfassen Außendienstmitarbeiter, die die Konnektivität überprüfen, die Fehlerbehebung bei langsamer Leistung und die Validierung von Bandbreitenanforderungen.

Internet-Konnektivitätstest (WLAN, Ethernet und Mobilfunk)

Leichtgewichtiger Test zur Überprüfung der tatsächlichen Interneterreichbarkeit im Gegensatz zur reinen Schnittstellenkonnektivität.

Schlüssel Typ Standard Beschreibung
device-checker-internet-connectivity-test-enabled String NO Internet-Konnektivitätstest für alle Schnittstellen aktivieren
device-checker-internet-connectivity-test-endpoint String http://captive.apple.com/hotspot-detect.html Test-Endpunkt-URL (Apple Captive Portal-Standard)
device-checker-internet-connectivity-test-timeout String 3 Anforderungs-Timeout in Sekunden (Bereich 1–10)
device-checker-internet-connectivity-test-cache-ttl String 30 Gültigkeit des zwischengespeicherten Ergebnisses in Sekunden (Bereich 10–300; Mobilfunk verwendet mindestens 60 s)

Beispiel:

<key>device-checker-internet-connectivity-test-enabled</key>
<string>YES</string>
<key>device-checker-internet-connectivity-test-timeout</key>
<string>5</string>
<key>device-checker-internet-connectivity-test-cache-ttl</key>
<string>60</string>

So funktioniert es: Sendet eine leichtgewichtige HEAD-Anfrage (~200–500 Byte) an den Captive-Portal-Endpunkt von Apple. Tests werden automatisch ausgeführt, wenn eine Schnittstelle eine Verbindung herstellt oder wenn Netzwerkdetailansichten geöffnet werden (falls der Cache abgelaufen ist). Die Ergebnisse werden bei WLAN/Ethernet 30 Sekunden lang und bei Mobilfunk mindestens 60 Sekunden lang zwischengespeichert, um den Datenverbrauch zu minimieren. Netzwerkkacheln zeigen den Status Gelb/Warnung an, wenn verbunden, aber kein Internet erkannt wird.

Statusverhalten nach Schnittstelle:

WLAN – Grün: verbunden mit verifiziertem Internet. Gelb: verbunden, aber kein Internet (Captive Portal, Routing-Problem). Rot: nicht verbunden.

Ethernet – Grün: verbunden mit verifiziertem Internet. Gelb: verbunden, aber kein Internet (Routing-/Firewall-Problem). Rot: nicht verbunden.

Mobilfunk – Grün: aktiviert mit verifiziertem Internet. Gelb: aktiviert, aber kein Internet (Anbieterproblem, Kontoproblem). Rot: nicht verfügbar oder deaktiviert.

Datenverbrauch: ~200–500 Byte pro Test (im Vergleich zu ~10–15 MB beim Geschwindigkeitstest). WLAN/Ethernet mit 30-Sekunden-Cache: typischerweise weniger als 100 KB/Tag. Mobilfunk mit 60-Sekunden-Cache: typischerweise weniger als 50 KB/Tag.

Statuslogik ohne Internet-Konnektivitätstest:

WLAN: ✅ Grün (Connected) – Mit WLAN verbunden. 🔴 Rot (Not Connected) – Nicht mit WLAN verbunden.

Mobilfunk: ✅ Grün (Ready) – Mobilfunkdaten verfügbar. ⚠️ Gelb (Warning) – Mobilfunkzugriff eingeschränkt. 🔴 Rot (Error) – Mobilfunk nicht verfügbar.


Jamf Setup-Erweiterungsattribut

Zeigt den Im-Dienst-/Außer-Dienst-Status aus einem Jamf Pro-Erweiterungsattribut an.

Schlüssel Typ Standard Beschreibung
device-checker-jamf-setup-ea-enabled String NO Jamf Setup EA-Kachel aktivieren
device-checker-jamf-setup-ea-name String (leer) Name des Erweiterungsattributs in Jamf Pro
device-checker-jamf-setup-ea-on-duty-value String (leer) Wert, der „im Dienst" anzeigt
device-checker-jamf-setup-ea-off-duty-value String (leer) Wert, der „außer Dienst" anzeigt

Beispiel:

<key>device-checker-jamf-setup-ea-enabled</key>
<string>YES</string>
<key>device-checker-jamf-setup-ea-name</key>
<string>Jamf Setup</string>
<key>device-checker-jamf-setup-ea-on-duty-value</key>
<string>On-duty</string>
<key>device-checker-jamf-setup-ea-off-duty-value</key>
<string>Off-duty</string>

Statuslogik:

Grün (Ready) – EA-Wert stimmt mit dem Im-Dienst-Wert überein

⚠️ Gelb (Warning) – EA-Wert stimmt mit dem Außer-Dienst-Wert überein

Grau (Unknown) – EA nicht gefunden oder Wert stimmt mit keinem der konfigurierten Werte überein

Hinweise: Erfordert ein benutzerdefiniertes Erweiterungsattribut in Jamf Pro. Das Erweiterungsattribut muss von Jamf Setup oder einer anderen Methode befüllt werden.


Drosselung der automatischen Aktualisierung

Steuern Sie, wie oft die App sich beim Rückkehren aus dem Hintergrund automatisch aktualisiert.

Schlüssel Typ Standard Beschreibung
device-checker-auto-refresh-threshold Integer 300 Mindestanzahl an Sekunden zwischen automatischen Aktualisierungen (Bereich: 60–3600, oder 0 zum Deaktivieren)

Beispiel:

<key>device-checker-auto-refresh-threshold</key>
<string>300</string>

Verhalten:

  • Standard (300 Sekunden / 5 Minuten): Wenn der Benutzer die App wechselt und innerhalb von 5 Minuten zurückkehrt, erfolgt keine automatische Aktualisierung
  • Benutzerdefinierter Schwellenwert: Auf gewünschte Sekunden setzen (60–3600)
  • Drosselung deaktivieren: Auf 0 setzen, um immer zu aktualisieren, wenn die App aktiv wird

Aktualisiert immer (Drosselung umgangen): erste Aktivierung nach App-Start, im Pending-Zustand (aktualisiert automatisch alle 2 Minuten), manuelle Tippgesten auf den Aktualisierungsbutton und Timer-Ablauf während des Pending-Zustands.

Verhalten im Pending-Zustand: Wenn die Apps-Kachel in den Zustand „Pending" wechselt (nachdem der Benutzer auf „Update Apps" getippt hat), prüft die App automatisch alle 2 Minuten den Gerätestatus, bis alle erforderlichen Apps installiert sind, unabhängig von der Einstellung des Schwellenwerts für die automatische Aktualisierung.


Konfigurationsbeispiele

Minimalkonfiguration (Standardeinstellungen)

Perfekt für schnelle Tests oder grundlegende Bereitstellungen.

<dict>
  <!-- Required keys (auto-populated) -->
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>MANAGEMENTID</key>
  <string>$MANAGEMENTID</string>
  <key>OAUTH_AUTH_CODE</key>
  <string>$OAUTH_AUTH_CODE</string>
  <key>APP_CONFIG_REINSTALL_CODE</key>
  <string>$APP_CONFIG_REINSTALL_CODE</string>
  <key>APPJSSID</key>
  <string>$APPJSSID</string>

  <!-- Enable OS monitoring only -->
  <key>device-checker-os-enabled</key>
  <string>YES</string>
  <key>device-checker-os-min-version</key>
  <string>18.0</string>
</dict>

Vollständige Konfiguration

Umfassende Einrichtung mit Branding, mehreren Gerätestatusprüfungen und benutzerdefinierten Schwellenwerten.

<dict>
  <!-- Required keys (auto-populated) -->
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>MANAGEMENTID</key>
  <string>$MANAGEMENTID</string>
  <key>OAUTH_AUTH_CODE</key>
  <string>$OAUTH_AUTH_CODE</string>
  <key>APP_CONFIG_REINSTALL_CODE</key>
  <string>$APP_CONFIG_REINSTALL_CODE</string>
  <key>APPJSSID</key>
  <string>$APPJSSID</string>

  <!-- Branding -->
  <key>device-checker-branding-image-url</key>
  <string>https://yourcompany.com/logo.png</string>
  <key>device-checker-branding-image-height</key>
  <string>60</string>

  <!-- OS Readiness -->
  <key>device-checker-os-enabled</key>
  <string>YES</string>
  <key>device-checker-os-min-version</key>
  <string>18.0</string>
  <key>device-checker-os-deadline</key>
  <string>2026-12-31</string>

  <!-- App Readiness -->
  <key>device-checker-apps-enabled</key>
  <string>YES</string>
  <key>device-checker-apps-list</key>
  <string>Slack,com.tinyspeck.chatlyio,24.0.0,2026-06-01|Microsoft Teams,com.microsoft.skype.teams,5.0.0,2026-09-01</string>

  <!-- Device Health Tiles -->
  <key>device-checker-power-source-enabled</key>
  <string>YES</string>
  <key>device-checker-power-source-warning</key>
  <string>30</string>
  <key>device-checker-power-source-critical</key>
  <string>15</string>

  <key>device-checker-storage-enabled</key>
  <string>YES</string>
  <key>device-checker-storage-warning</key>
  <string>70</string>
  <key>device-checker-storage-critical</key>
  <string>85</string>

  <key>device-checker-battery-enabled</key>
  <string>YES</string>

  <key>device-checker-thermal-enabled</key>
  <string>YES</string>

  <key>device-checker-performance-enabled</key>
  <string>YES</string>
  <key>device-checker-memory-warning</key>
  <string>75</string>
  <key>device-checker-memory-critical</key>
  <string>90</string>
  <key>device-checker-cpu-warning</key>
  <string>70</string>
  <key>device-checker-cpu-critical</key>
  <string>85</string>

  <key>device-checker-wifi-enabled</key>
  <string>YES</string>
  <key>device-checker-cellular-enabled</key>
  <string>NO</string>

  <!-- Network Speed Test (optional - disabled by default) -->
  <key>device-checker-network-speed-enabled</key>
  <string>NO</string>

  <!-- Internet Connectivity Test (optional - disabled by default) -->
  <key>device-checker-internet-connectivity-test-enabled</key>
  <string>NO</string>
  <key>device-checker-internet-connectivity-test-endpoint</key>
  <string>http://captive.apple.com/hotspot-detect.html</string>
  <key>device-checker-internet-connectivity-test-timeout</key>
  <string>3</string>
  <key>device-checker-internet-connectivity-test-cache-ttl</key>
  <string>30</string>

  <!-- Jamf Setup EA -->
  <key>device-checker-jamf-setup-ea-enabled</key>
  <string>YES</string>
  <key>device-checker-jamf-setup-ea-name</key>
  <string>Device Status</string>
  <key>device-checker-jamf-setup-ea-on-duty-value</key>
  <string>Active</string>
  <key>device-checker-jamf-setup-ea-off-duty-value</key>
  <string>Spare Pool</string>

  <!-- UI Options -->
  <key>device-checker-alerts-url</key>
  <string>https://status.yourcompany.com</string>
  <key>device-checker-send-status-enabled</key>
  <string>YES</string>
  <key>device-checker-send-logs-enabled</key>
  <string>NO</string>
  <key>device-checker-status-tab-scrollable</key>
  <string>NO</string>

  <!-- Auto-Refresh (10 minutes) -->
  <key>device-checker-auto-refresh-threshold</key>
  <string>600</string>
</dict>

Rechtliches

War das hilfreich?