Jamf Concepts
Handleidingen

Handleidingen

Jamf Device Checker

~16 min read
Was dit nuttig?

Waarom Jamf Device Checker gebruiken?

Het probleem

Eindgebruikers ondervinden vaak apparaatproblemen die hun productiviteit beïnvloeden, maar weten niet hoe ze deze moeten identificeren of oplossen:

  • Ontbrekende of verouderde app-versies
  • Verouderde iOS-versies
  • Slechte batterijconditie die onverwachte uitschakelingen veroorzaakt
  • Problemen met opslagcapaciteit die app-installaties verhinderen
  • Problemen met netwerkconnectiviteit die de productiviteit beïnvloeden
  • Oververhitting van het apparaat die prestatieafknijping veroorzaakt
  • Hoog geheugen-/CPU-gebruik dat het werk vertraagt

Deze problemen resulteren doorgaans in helpdesktickets, productiviteitsverlies en gefrustreerde gebruikers.

De oplossing

Jamf Device Checker stelt eindgebruikers in staat om problemen met apparaatgereedheid zelf te diagnosticeren en op te lossen via een eenvoudige, kleurgecodeerde interface:

  • Groen = Apparaat is klaar voor werk
  • ⚠️ Geel = Waarschuwingen die binnenkort moeten worden aangepakt
  • 🔴 Rood = Kritieke problemen die de productiviteit verhinderen

Belangrijkste voordelen

Voor eindgebruikers: selfservicecontroles van apparaatgereedheid, duidelijke, uitvoerbare begeleiding voor het oplossen van problemen, kortere wachttijd voor IT-ondersteuning en proactieve meldingen vóór deadlines.

Voor IT-teams: minder helpdesktickets, handhaving van compliance met bedrijfsbeleid (OS-versies, vereiste apps), realtime inzicht in apparaatconditie en configureerbare drempelwaarden en monitoringregels.

Voor organisaties: verbeterde productiviteit van eindgebruikers, beter beheer van de apparaatlevenscyclus, lagere kosten voor IT-ondersteuning en compliance-tracking en -rapportage.

Weergave van de algehele status

De app toont een grote, kleurgecodeerde statusindicator bovenaan het hoofdscherm die de algehele gereedheid van het apparaat samenvat.

Status Kleur Icoon Beschrijving
Ready 🟢 Groen Vinkje Alle ingeschakelde controles slagen. Apparaat voldoet aan alle vereisten.
Deadline Approaching 🟠 Oranje Waarschuwingsdriehoek Updates beschikbaar met geconfigureerde deadlines. Toont "X update(s) available - Y day(s) remain" met aftelling tot de vroegste deadline.
Action Needed 🟠 Oranje Waarschuwingsdriehoek Updates beschikbaar, maar geen deadlines geconfigureerd. Toont "X update(s) available".
Not Ready 🔴 Rood X-markering Een of meer updates vereist en de deadline is verstreken. Toont "X update(s) required".
Installing Updates 🔵 Blauw Draaiende pijlen MDM-opdrachten in uitvoering. Toont een aftelklok van 2 minuten voor automatisch vernieuwen.
Off Duty ⚪ Grijs Maan met Z's Apparaat gemarkeerd als niet-actief via Jamf Setup EA.
Unknown ⚪ Grijs Vraagteken Beginstatus voordat de eerste controle is voltooid.

Snel aan de slag

Vereisten

  • Jamf Pro-server (JPS)
  • Beheerderstoegang tot Jamf Pro
  • Jamf Self Service-app (vereist voor de app-installatiefunctie)
  • Lokaal gebruikersaccount met wizard-privileges (zie hieronder)

Vereiste API-privileges

De app gebruikt twee afzonderlijke sets privileges:

Voor Wizard-installatie (lokaal gebruikersaccount — gebruikt tijdens de eerste configuratie):

Maak een lokale gebruiker in Jamf Pro aan met deze 8 privileges:

API Integration Setup (eenmalige wizardconfiguratie):

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

App Config Management (wizard + doorlopende updates):

  • Read Mobile Device Applications
  • Update Mobile Device Applications

Dit gebruikersaccount authenticeert de wizard via Basic Auth om de API-integratie te maken, rollen te configureren, de native app te koppelen en app config-XML op te slaan. Na de eerste installatie is deze gebruiker alleen nodig voor app config-updates (vereist alleen de 2 Mobile Device Applications-privileges).

Voor runtimewerking (OAuth API-client — automatisch geconfigureerd door de wizard):

De wizard maakt automatisch een "Jamf Device Checker" API-rol aan met deze 4 privileges die aan de gekoppelde app-integratie worden toegewezen:

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

Met deze privileges kan de device checker apparaatgegevens ophalen en MDM-opdrachten verzenden tijdens de normale werking met behulp van OAuth-authenticatie. Eindgebruikers zien of gebruiken deze inloggegevens nooit.

Installatie in 5 minuten

Stap 1: Koop de app en voeg deze toe aan Jamf Pro

  • Koop "Jamf Device Checker" en wijs deze toe aan de Jamf Pro-instance in AxM
  • Navigeer naar Mobile Device Apps in Jamf Pro
  • Voeg "Jamf Device Checker" toe vanuit Apps Purchased in Volume

Stap 2: Voer de installatiewizard uit

  • Installeer de app op je beheerdersapparaat
  • Start de app en houd de ronde statusafbeelding lang ingedrukt om de wizardmodus in te schakelen
  • Authenticeer met de lokale gebruiker (vereist 8 wizard-privileges — zie Vereiste API-privileges hierboven)
  • Volg de wizard om:
    • De API-rol met de vereiste privileges te configureren
    • Een API-integratie te maken
    • De native app te koppelen aan de API-integratie voor authenticatie
    • De managed app config te genereren en op te slaan in JPS

Er is geen stap 3 — beperk het bereik gewoon tot de apparaten van eindgebruikers.


Volledige installatie-instructies

Stap 1: Voeg de mobiele apparaat-app toe aan Jamf Pro

  • Koop "Jamf Device Checker" en wijs deze toe aan de Jamf Pro-instance in AxM
  • Log in op Jamf Pro
  • Navigeer naar Devices > Mobile Device Apps
  • Klik op + New
  • Zoek naar "Jamf Device Checker" in Apps Purchased in Volume
  • Klik op Add om het app-record aan je Jamf Pro-instance toe te voegen

Stap 2: Voer de installatiewizard uit

De wizard verzorgt automatisch alle authenticatie en de managed app-configuratie.

Installeer de app op het beheerdersapparaat

  • Wijs de app toe aan een test-iOS-apparaat
  • Start Jamf Device Checker

Schakel de wizardmodus in

  • Houd op het tabblad Meer het app-icoon 3 seconden lang ingedrukt
  • Selecteer Wizard Setup
  • Authenticeer met de lokale gebruikersgegevens die in Vereisten zijn aangemaakt (vereist de 8 wizard-privileges)

Voltooi de wizardstappen

API-rol

  • De wizard controleert op een bestaande "Jamf Device Checker" API-rol
  • Als deze niet wordt gevonden, wordt de rol aangemaakt met de vereiste privileges:
    • Send Device Information Command
    • View MDM command information in Jamf Pro API
    • Read Mobile Devices
    • Send MDM command information in Jamf Pro API
  • Koppelt de rol aan de API-integratie

Native app-authenticatie

  • De wizard koppelt het mobiele apparaat-app-record aan de API-integratie
  • Schakelt aflevering van de OAuth-autorisatiecode in via Managed App Config

Genereer app config

  • De wizard genereert een complete Managed App Config
  • Verzendt deze naar Jamf Pro

Stap 3: Beperk het bereik tot apparaten

  • Klik in hetzelfde app-record op Scope
  • Voeg doelapparaatgroepen, smart groups of individuele apparaten toe
  • Klik op Save

Configuratiereferentie

De app wordt volledig geconfigureerd via de Managed App Config van Jamf Pro. Hieronder staat een complete referentie van alle beschikbare sleutels.

Vereiste sleutels

Deze sleutels worden automatisch ingevuld door Jamf Pro — wijzig of verwijder ze niet.

Sleutel Beschrijving
JPS_URL Jamf Pro-server-URL (automatisch ingevuld: $JPS_URL)
JSSID JSS-ID van het apparaat (automatisch ingevuld: $JSSID)
MANAGEMENTID Management-ID van het apparaat (automatisch ingevuld: $MANAGEMENTID)
OAUTH_AUTH_CODE OAuth-autorisatiecode (automatisch ingevuld: $OAUTH_AUTH_CODE)
APP_CONFIG_REINSTALL_CODE Herinstallatietriggercode (automatisch ingevuld: $APP_CONFIG_REINSTALL_CODE)
APPJSSID Jamf Device Checker app-record-ID (automatisch ingevuld: $APPJSSID)

Branding en waarschuwingen-URL

Sleutel Type Standaard Beschrijving
device-checker-branding-image-url String (leeg) URL naar bedrijfslogo-afbeelding (PNG/JPG). Laat leeg voor geen branding.
device-checker-branding-image-height Integer 80 Loghoogte in punten.
device-checker-alerts-url String (leeg) Optionele URL voor waarschuwingen-/statuspagina. Toont een link op het tabblad Alerts.

Voorbeeld:

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

Deelknoppen

Beheer de zichtbaarheid van de functies voor het delen van status en het exporteren van logboeken op het tabblad Meer.

Sleutel Type Standaard Beschrijving
device-checker-send-status-enabled String YES Toon de knop "Send Status" (deelt een samenvatting van de apparaatgereedheid via e-mail/berichten)
device-checker-send-logs-enabled String YES Toon de knop "Send Logs" (exporteert app-logboeken voor probleemoplossing)

Voorbeeld:

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

UI-gedrag

Beheer het scrollgedrag van het tabblad Status.

Sleutel Type Standaard Beschrijving
device-checker-status-tab-scrollable String NO Wanneer ingesteld op YES, maakt dit het hele tabblad Status scrollbaar (koptekst + algehele status + tegels). Bij NO (standaard) blijven de koptekst en algehele status vast, waarbij alleen de tegels eronder scrollen.

Voorbeeld:

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

Wanneer inschakelen: De standaardinstelling (NO) is het beste voor de meeste implementaties — de koptekst en algehele gereedheidsstatus blijven zichtbaar tijdens het scrollen door de tegels. Stel in op YES wanneer je wilt dat de hele weergave samen scrollt, of om langere brandingkopteksten op kleinere apparaten te accommoderen.


Gereedheid van het besturingssysteem

Bewaak de OS-versievereiste met een configureerbare minimumversie en deadline.

Sleutel Type Standaard Beschrijving
device-checker-os-enabled String YES Schakel de tegel voor OS-versiemonitoring in
device-checker-os-min-version String (geen) Minimaal vereiste OS-versie (bijv. 26.2)
device-checker-os-deadline String (geen) Vereistedeadline in YYYY-MM-DD-formaat

Voorbeeld:

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

Statuslogica:

Groen (Ready) — Huidige OS-versie voldoet aan de minimumvereiste

⚠️ Geel (Warning) — Huidige OS-versie ligt onder het minimum, maar de deadline is NIET verstreken (of er is geen deadline geconfigureerd)

🔴 Rood (Not Ready) — Huidige OS-versie ligt onder het minimum EN de deadline is verstreken


App-gereedheid

Bewaak de installatiestatus en versievereisten voor vereiste managed apps.

Sleutel Type Standaard Beschrijving
device-checker-apps-enabled String NO Schakel de tegel voor app-monitoring in
device-checker-apps-list String (leeg) Pipe-gescheiden lijst van apps (zie formaat hieronder)

Formaat app-lijst:

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

Voorbeeld:

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

Statuslogica:

Groen (Ready) — Alle apps zijn geïnstalleerd en voldoen aan de minimumversies

⚠️ Geel (Warning) — Een of meer apps moeten worden bijgewerkt, maar de deadline is NIET verstreken

🔴 Rood (Not Ready) — Een of meer apps moeten worden bijgewerkt EN de deadline is verstreken

Pending — App-installatie in uitvoering (zie Self Service-integratie hieronder)

Self Service-integratie:

Wanneer apps ontbreken of verouderd zijn, kunnen gebruikers op de knop "Update Apps" op de app-tegel tikken om vereiste apps automatisch te installeren of bij te werken. De werkstroom is:

  1. Gebruiker tikt op de knop "Update Apps" op de app-tegel
  2. De Jamf Self Service-app opent automatisch met ontbrekende/verouderde apps in de wachtrij
  3. Device Checker gaat naar de status "Pending" en start een automatische vernieuwingstimer van 2 minuten
  4. De app vernieuwt automatisch elke 2 minuten om te controleren of de installaties zijn voltooid
  5. Zodra alle apps aan de vereisten voldoen, keert de status terug naar groen

Vereisten: Jamf Self Service moet op het apparaat zijn geïnstalleerd, apps moeten beschikbaar zijn in Self Service en binnen het bereik van het apparaat vallen, en bij apps moet "Display app in Self Service after it is installed" zijn aangevinkt in Jamf Pro.

Opmerkingen:

  • De bundle-ID moet exact overeenkomen (hoofdlettergevoelig)
  • Versievergelijking gebruikt semantic versioning (bijv. 2.5.0 > 2.4.9)
  • De deadline is optioneel (laat leeg indien niet nodig: AppName,bundleID,minVersion,)

Voedingsbron (batterijniveau)

Bewaak het batterijladingsniveau met configureerbare waarschuwings- en kritieke drempelwaarden.

Sleutel Type Standaard Beschrijving
device-checker-power-source-enabled String YES Schakel de tegel voor batterijniveaumonitoring in
device-checker-power-source-warning Integer 25 Waarschuwingsdrempel (percentage)
device-checker-power-source-critical Integer 10 Kritieke drempel (percentage)

Voorbeeld:

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

Statuslogica:

🔴 Rood (Critical) — Batterij ≤ kritieke drempel

⚠️ Geel (Warning) — Batterij ≤ waarschuwingsdrempel (maar > kritiek)

Groen (Ready) — Batterij > waarschuwingsdrempel

Charging — Apparaat is aangesloten (altijd groen tijdens opladen)


Opslagcapaciteit

Bewaak de beschikbare opslag met configureerbare waarschuwings- en kritieke drempelwaarden (gebaseerd op gebruikt percentage).

Sleutel Type Standaard Beschrijving
device-checker-storage-enabled String YES Schakel de tegel voor opslagmonitoring in
device-checker-storage-warning Integer 75 Waarschuwingsdrempel (% gebruikt)
device-checker-storage-critical Integer 90 Kritieke drempel (% gebruikt)

Voorbeeld:

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

Statuslogica:

🔴 Rood (Critical) — Gebruikte opslag ≥ kritieke drempel

⚠️ Geel (Warning) — Gebruikte opslag ≥ waarschuwingsdrempel (maar < kritiek)

Groen (Ready) — Gebruikte opslag < waarschuwingsdrempel


Batterijconditie

Bewaak de batterijconditiestatus om apparaten te identificeren die mogelijk batterijvervanging nodig hebben. Deze tegel toont de batterijconditiestatus en het huidige ladingspercentage.

Sleutel Type Standaard Beschrijving
device-checker-battery-enabled String YES Schakel de tegel voor batterijconditiemonitoring in

Voorbeeld:

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

Statuslogica:

Groen (Ready) — Batterijconditie is "Normal" of "Unsupported"

🔴 Rood (Not Ready) — Batterijconditie is "Service-Recommended" of "Non-Genuine"

Grijs (Unknown) — Batterijconditie is "Unknown" of batterijgegevens kunnen niet worden opgehaald

Waarden batterijconditiestatus:

  • Normal — Batterij functioneert correct (Groen)
  • Service-Recommended — Batterijcapaciteit is verslechterd, vervanging aanbevolen (Rood)
  • Non-Genuine — Niet-Apple-batterij gedetecteerd, vervanging aanbevolen (Rood)
  • Unsupported — Batterijconditiemonitoring niet beschikbaar op dit apparaatmodel (Groen, toont alleen laadpercentage)
  • Unknown — Conditiegegevens nog niet beschikbaar van iOS (Grijs, toont alleen laadpercentage)

Tegelweergave: De statuskleur en het icoon zijn gebaseerd op de batterijconditie. De ondertitel toont het batterijconditieprobleem indien aanwezig, anders het huidige laadpercentage. De detailweergave toont het laadniveau, de laadstatus, de energiebesparingsmodus, de batterijconditiestatus en aanbevelingen.

Opmerkingen:

  • Batterijconditiegegevens komen van Declarative Device Management (DDM)
  • Nieuwe apparaten kunnen "Unknown" tonen totdat iOS conditiemetrieken berekent (doorgaans na een paar laadcycli)
  • Het laadpercentage wordt altijd weergegeven in de ondertitel of detailweergave
  • Deze tegel richt zich op de conditie van de batterij; gebruik de tegel Voedingsbron voor monitoring van het laadniveau met drempelwaarden

Thermische status

Bewaak de apparaattemperatuur in realtime met behulp van lokale iOS-API's (geen MDM-oproepen vereist).

Sleutel Type Standaard Beschrijving
device-checker-thermal-enabled String YES Schakel de tegel voor thermische-statusmonitoring in

Voorbeeld:

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

Statuslogica:

Groen (Nominal) — Normale bedrijfstemperatuur, alle functies werken normaal

⚠️ Geel (Fair) — Licht verhoogd, systeem stelt achtergrondwerk zoals prefetching/indexering uit

🔴 Rood (Serious) — Hoge temperatuur, CPU/GPU-afknijping actief, framesnelheden kunnen dalen tot 30 FPS

🔴 Rood (Critical) — Apparaat kritiek heet, aanzienlijke afknijping, camera/flitser/luidspreker kunnen worden uitgeschakeld, risico op uitschakeling

Gebruiksscenario's: apparaten in het veld in warme omgevingen (voertuigen, buitenwerk), gebruikers die intensieve apps uitvoeren (video-opname, AR), proactieve waarschuwingen vóór thermische uitschakelingen en inzicht in prestatieafknijping.

Opmerkingen: Realtime monitoring via de iOS ProcessInfo-API. Geen API-oproepen of batterijverbruik. Werkt direct bij bij wijziging van de thermische status.


Prestaties (geheugen en CPU)

Bewaak de geheugendruk en het CPU-gebruik van het apparaat met behulp van lokale iOS-API's met configureerbare drempelwaarden.

Sleutel Type Standaard Beschrijving
device-checker-performance-enabled String YES Schakel de tegel voor prestatiemonitoring in
device-checker-memory-warning Integer 70 Waarschuwingsdrempel geheugen (% gebruikt)
device-checker-memory-critical Integer 85 Kritieke drempel geheugen (% gebruikt)
device-checker-cpu-warning Integer 60 Waarschuwingsdrempel CPU (% gebruik)
device-checker-cpu-critical Integer 80 Kritieke drempel CPU (% gebruik)

Voorbeeld:

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

Statuslogica:

🔴 Rood (Critical) — Geheugen OF CPU ≥ kritieke drempel

⚠️ Geel (Warning) — Geheugen OF CPU ≥ waarschuwingsdrempel (maar < kritiek)

Groen (Ready) — Zowel geheugen ALS CPU < waarschuwingsdrempels

Opmerkingen: Werkt elke 5 seconden bij wanneer de tegel zichtbaar is. Monitoring pauzeert wanneer de app op de achtergrond staat (om de batterij te sparen). Geen externe API-oproepen vereist — volledig lokale monitoring via os_proc_available_memory() voor geheugen en host_statistics() voor CPU.


Netwerkstatus

Bewaak de connectiviteitsstatus van wifi, ethernet en mobiel netwerk.

Sleutel Type Standaard Beschrijving
device-checker-wifi-enabled String YES Schakel de tegel voor wifi-/ethernetmonitoring in (ethernet wordt automatisch gedetecteerd wanneer verbonden)
device-checker-cellular-enabled String NO Schakel de tegel voor mobiele-netwerkmonitoring in
device-checker-network-speed-enabled String NO Schakel de knop voor netwerksnelheidstest in de netwerkdetailweergaven in

Voorbeeld:

<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 netwerksnelheidstest:

De snelheidstest is een on-demand diagnostisch hulpmiddel (~10–15 MB per test, ~15–20 seconden duur) dat download-/uploadsnelheden en latentie meet. Vóór elke test op het mobiele netwerk wordt een waarschuwing getoond om te wijzen op het dataverbruik. Resultaten zijn alleen informatief en beïnvloeden de apparaatgereedheidsstatus niet. Gebruiksscenario's zijn onder meer veldwerkers die de connectiviteit verifiëren, het oplossen van trage prestaties en het valideren van bandbreedtevereisten.

Internetconnectiviteitstest (wifi, ethernet en mobiel netwerk)

Lichtgewicht test om de daadwerkelijke internetbereikbaarheid te verifiëren, en niet alleen de interfaceconnectiviteit.

Sleutel Type Standaard Beschrijving
device-checker-internet-connectivity-test-enabled String NO Schakel de internetconnectiviteitstest voor alle interfaces in
device-checker-internet-connectivity-test-endpoint String http://captive.apple.com/hotspot-detect.html URL van het test-eindpunt (standaard Apple captive portal)
device-checker-internet-connectivity-test-timeout String 3 Time-out van verzoek in seconden (bereik 1–10)
device-checker-internet-connectivity-test-cache-ttl String 30 Geldigheid van gecacht resultaat in seconden (bereik 10–300; mobiel netwerk gebruikt minimaal 60s)

Voorbeeld:

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

Hoe het werkt: Stuurt een lichtgewicht HEAD-verzoek (~200–500 bytes) naar Apple's captive portal-eindpunt. Tests worden automatisch uitgevoerd wanneer een interface verbinding maakt of wanneer netwerkdetailweergaven worden geopend (als de cache is verlopen). Resultaten worden 30 seconden gecacht op wifi/ethernet en minimaal 60 seconden op het mobiele netwerk om het dataverbruik te minimaliseren. Netwerktegels tonen een gele/waarschuwingsstatus als er wel verbinding is, maar geen internet wordt gedetecteerd.

Statusgedrag per interface:

Wifi — Groen: verbonden met geverifieerd internet. Geel: verbonden maar geen internet (captive portal, routeringsprobleem). Rood: niet verbonden.

Ethernet — Groen: verbonden met geverifieerd internet. Geel: verbonden maar geen internet (routerings-/firewallprobleem). Rood: niet verbonden.

Mobiel netwerk — Groen: ingeschakeld met geverifieerd internet. Geel: ingeschakeld maar geen internet (providerprobleem, accountprobleem). Rood: niet beschikbaar of uitgeschakeld.

Dataverbruik: ~200–500 bytes per test (versus ~10–15 MB voor de snelheidstest). Wifi/ethernet met 30 seconden cache: doorgaans minder dan 100 KB/dag verbruik. Mobiel netwerk met 60 seconden cache: doorgaans minder dan 50 KB/dag verbruik.

Statuslogica zonder internetconnectiviteitstest:

Wifi: ✅ Groen (Connected) — Verbonden met wifi. 🔴 Rood (Not Connected) — Niet verbonden met wifi.

Mobiel netwerk: ✅ Groen (Ready) — Mobiele data beschikbaar. ⚠️ Geel (Warning) — Mobiele toegang beperkt. 🔴 Rood (Error) — Mobiel netwerk niet beschikbaar.


Jamf Setup-extensieattribuut

Toon de status actief/niet-actief van een Jamf Pro-extensieattribuut.

Sleutel Type Standaard Beschrijving
device-checker-jamf-setup-ea-enabled String NO Schakel de Jamf Setup EA-tegel in
device-checker-jamf-setup-ea-name String (leeg) Naam van het extensieattribuut in Jamf Pro
device-checker-jamf-setup-ea-on-duty-value String (leeg) Waarde die "actief" aangeeft
device-checker-jamf-setup-ea-off-duty-value String (leeg) Waarde die "niet-actief" aangeeft

Voorbeeld:

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

Statuslogica:

Groen (Ready) — EA-waarde komt overeen met de actief-waarde

⚠️ Geel (Warning) — EA-waarde komt overeen met de niet-actief-waarde

Grijs (Unknown) — EA niet gevonden of waarde komt met geen van beide geconfigureerde waarden overeen

Opmerkingen: Vereist een aangepast extensieattribuut in Jamf Pro. Het extensieattribuut moet worden ingevuld door Jamf Setup of een andere methode.


Automatische vernieuwing beperken

Beheer hoe vaak de app automatisch vernieuwt bij terugkeer van de achtergrond.

Sleutel Type Standaard Beschrijving
device-checker-auto-refresh-threshold Integer 300 Minimum aantal seconden tussen automatische vernieuwingen (bereik: 60–3600, of 0 om uit te schakelen)

Voorbeeld:

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

Gedrag:

  • Standaard (300 seconden / 5 minuten): Als de gebruiker van app wisselt en binnen 5 minuten terugkeert, vindt er geen automatische vernieuwing plaats
  • Aangepaste drempel: Stel in op het gewenste aantal seconden (60–3600)
  • Beperking uitschakelen: Stel in op 0 om altijd te vernieuwen wanneer de app actief wordt

Vernieuwt altijd (beperking omzeild): eerste activering na het starten van de app, in de pending-status (vernieuwt automatisch elke 2 minuten), handmatige tikken op de vernieuwknop en het verlopen van de timer tijdens de pending-status.

Gedrag pending-status: Wanneer de app-tegel de status "Pending" ingaat (nadat de gebruiker op "Update Apps" tikt), controleert de app automatisch elke 2 minuten de apparaatstatus totdat alle vereiste apps zijn geïnstalleerd, ongeacht de instelling voor de drempel voor automatische vernieuwing.


Configuratievoorbeelden

Minimale configuratie (standaardinstellingen)

Ideaal voor snel testen of basisimplementaties.

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

Volledige configuratie

Uitgebreide installatie met branding, meerdere apparaatstatuscontroles en aangepaste drempelwaarden.

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

Juridisch

Was dit nuttig?