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:
- Benutzer tippt auf den Button „Update Apps" auf der Apps-Kachel
- Die Jamf Self Service-App öffnet sich automatisch mit den fehlenden/veralteten Apps in der Warteschlange
- Device Checker wechselt in den Status „Pending" und startet einen 2-minütigen automatischen Aktualisierungstimer
- Die App aktualisiert sich automatisch alle 2 Minuten, um zu prüfen, ob die Installationen abgeschlossen sind
- 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
0setzen, 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
- Nutzungsvereinbarung: Application End User License Agreement
- Datenschutzrichtlinie: Jamf Privacy Policy