Pourquoi utiliser Jamf Device Checker ?
Le problème
Les utilisateurs finaux rencontrent souvent des problèmes d'appareil qui affectent leur productivité, mais ne savent pas comment les identifier ou les résoudre :
- Versions d'apps manquantes ou obsolètes
- Versions d'iOS obsolètes
- Faible santé de la batterie provoquant des arrêts inattendus
- Problèmes de capacité de stockage empêchant l'installation d'apps
- Problèmes de connectivité réseau affectant la productivité
- Surchauffe de l'appareil provoquant une limitation des performances
- Utilisation élevée de la mémoire/du processeur ralentissant le travail
Ces problèmes se traduisent généralement par des tickets d'assistance, une perte de productivité et des utilisateurs frustrés.
La solution
Jamf Device Checker permet aux utilisateurs finaux d'auto-diagnostiquer et de résoudre les problèmes de préparation des appareils grâce à une interface simple à code couleur :
- ✅ Vert = L'appareil est prêt à travailler
- ⚠️ Jaune = Avertissements à traiter prochainement
- 🔴 Rouge = Problèmes critiques empêchant la productivité
Avantages clés
Pour les utilisateurs finaux : contrôles de préparation des appareils en libre-service, conseils clairs et exploitables pour résoudre les problèmes, temps d'attente réduit pour l'assistance informatique et notifications proactives avant les échéances.
Pour les équipes informatiques : réduction des tickets d'assistance, application de la conformité aux politiques d'entreprise (versions de l'OS, apps requises), visibilité en temps réel sur la santé des appareils et seuils et règles de surveillance configurables.
Pour les organisations : amélioration de la productivité des utilisateurs finaux, meilleure gestion du cycle de vie des appareils, réduction des coûts d'assistance informatique, et suivi et reporting de la conformité.
Affichage de l'état global
L'app affiche un grand indicateur d'état à code couleur en haut de l'écran principal, qui résume la préparation globale de l'appareil.
| État | Couleur | Icône | Description |
|---|---|---|---|
| Prêt | 🟢 Vert | Coche | Tous les contrôles activés réussissent. L'appareil répond à toutes les exigences. |
| Échéance approchant | 🟠 Orange | Triangle d'avertissement | Mises à jour disponibles avec des échéances configurées. Affiche « X mise(s) à jour disponible(s) - Y jour(s) restant(s) » avec un compte à rebours jusqu'à l'échéance la plus proche. |
| Action nécessaire | 🟠 Orange | Triangle d'avertissement | Mises à jour disponibles, mais aucune échéance configurée. Affiche « X mise(s) à jour disponible(s) ». |
| Non prêt | 🔴 Rouge | Croix | Une ou plusieurs mises à jour requises, et l'échéance est dépassée. Affiche « X mise(s) à jour requise(s) ». |
| Installation des mises à jour | 🔵 Bleu | Flèches tournantes | Commandes MDM en cours. Affiche un compte à rebours de 2 minutes pour l'actualisation automatique. |
| Hors service | ⚪ Gris | Lune avec des Z | Appareil marqué comme hors service via l'EA Jamf Setup. |
| Inconnu | ⚪ Gris | Point d'interrogation | État initial avant la fin du premier contrôle. |
Prise en main rapide
Prérequis
- Serveur Jamf Pro (JPS)
- Accès administrateur à Jamf Pro
- App Jamf Self Service (requise pour la fonction d'installation d'apps)
- Compte d'utilisateur local avec privilèges d'assistant (voir ci-dessous)
Privilèges d'API requis
L'app utilise deux ensembles de privilèges distincts :
Pour la configuration de l'assistant (compte d'utilisateur local — utilisé lors de la configuration initiale) :
Créez un utilisateur local dans Jamf Pro avec ces 8 privilèges :
Configuration de l'intégration d'API (configuration unique de l'assistant) :
- Read API Integrations
- Create API Integrations
- Update API Integrations
- Read API Roles
- Create API Roles
- Update API Roles
Gestion de l'App Config (assistant + mises à jour continues) :
- Read Mobile Device Applications
- Update Mobile Device Applications
Ce compte d'utilisateur authentifie l'assistant via Basic Auth pour créer l'intégration d'API, configurer les rôles, lier l'app native et enregistrer l'app config XML. Après la configuration initiale, cet utilisateur n'est nécessaire que pour les mises à jour de l'app config (ne nécessite que les 2 privilèges Mobile Device Applications).
Pour le fonctionnement à l'exécution (client d'API OAuth — configuré automatiquement par l'assistant) :
L'assistant crée automatiquement un rôle d'API « Jamf Device Checker » avec ces 4 privilèges attribués à l'intégration d'app liée :
- Send Device Information Command
- View MDM command information in Jamf Pro API
- Read Mobile Devices
- Send MDM command information in Jamf Pro API
Ces privilèges permettent au device checker de récupérer les détails de l'appareil et d'envoyer des commandes MDM lors du fonctionnement normal à l'aide de l'authentification OAuth. Les utilisateurs finaux ne voient ni n'utilisent jamais ces identifiants.
Configuration en 5 minutes
Étape 1 : Achetez et ajoutez l'app à Jamf Pro
- Achetez « Jamf Device Checker » et attribuez-le à l'instance Jamf Pro dans AxM
- Accédez à Mobile Device Apps dans Jamf Pro
- Ajoutez « Jamf Device Checker » depuis Apps Purchased in Volume
Étape 2 : Exécutez l'assistant de configuration
- Installez l'app sur votre appareil d'administration
- Lancez l'app et appuyez longuement sur l'image d'état circulaire pour activer le mode Assistant
- Authentifiez-vous avec l'utilisateur local (nécessite les 8 privilèges d'assistant — voir Privilèges d'API requis ci-dessus)
- Suivez l'assistant pour :
- Configurer le rôle d'API avec les privilèges requis
- Créer l'intégration d'API
- Lier l'app native à l'intégration d'API pour l'authentification
- Générer l'app config gérée et l'enregistrer sur le JPS
Il n'y a pas d'étape 3 — il suffit de cibler les appareils des utilisateurs finaux.
Instructions de configuration complètes
Étape 1 : Ajoutez l'app pour appareils mobiles à Jamf Pro
- Achetez « Jamf Device Checker » et attribuez-le à l'instance Jamf Pro dans AxM
- Connectez-vous à Jamf Pro
- Accédez à Devices > Mobile Device Apps
- Cliquez sur + New
- Recherchez « Jamf Device Checker » dans Apps Purchased in Volume
- Cliquez sur Add pour ajouter l'enregistrement de l'app à votre instance Jamf Pro
Étape 2 : Exécutez l'assistant de configuration
L'assistant gère automatiquement toute l'authentification et l'app config gérée.
Installez l'app sur l'appareil d'administration
- Attribuez l'app à un appareil iOS de test
- Lancez Jamf Device Checker
Activez le mode Assistant
- Sur l'onglet more, appuyez longuement sur l'icône de l'app pendant 3 secondes
- Sélectionnez Wizard Setup
- Authentifiez-vous avec les identifiants d'utilisateur local créés dans les Prérequis (nécessite les 8 privilèges d'assistant)
Terminez les étapes de l'assistant
Rôle d'API
- L'assistant recherche un rôle d'API « Jamf Device Checker » existant
- S'il n'est pas trouvé, il crée le rôle avec les privilèges requis :
- Send Device Information Command
- View MDM command information in Jamf Pro API
- Read Mobile Devices
- Send MDM command information in Jamf Pro API
- Lie le rôle à l'intégration d'API
Authentification de l'app native
- L'assistant lie l'enregistrement de l'app pour appareils mobiles à l'intégration d'API
- Active la remise du code d'autorisation OAuth via l'app config gérée
Générer l'App Config
- L'assistant génère l'app config gérée complète
- L'envoie à Jamf Pro
Étape 3 : Ciblez les appareils
- Dans le même enregistrement d'app, cliquez sur Scope
- Ajoutez des groupes d'appareils cibles, des groupes intelligents ou des appareils individuels
- Cliquez sur Save
Référence de configuration
L'app est entièrement configurée via l'app config gérée de Jamf Pro. Vous trouverez ci-dessous une référence complète de toutes les clés disponibles.
Clés requises
Ces clés sont automatiquement renseignées par Jamf Pro — ne les modifiez pas et ne les supprimez pas.
| Clé | Description |
|---|---|
JPS_URL |
URL du serveur Jamf Pro (renseignée automatiquement : $JPS_URL) |
JSSID |
JSS ID de l'appareil (renseigné automatiquement : $JSSID) |
MANAGEMENTID |
Management ID de l'appareil (renseigné automatiquement : $MANAGEMENTID) |
OAUTH_AUTH_CODE |
Code d'autorisation OAuth (renseigné automatiquement : $OAUTH_AUTH_CODE) |
APP_CONFIG_REINSTALL_CODE |
Code de déclenchement de réinstallation (renseigné automatiquement : $APP_CONFIG_REINSTALL_CODE) |
APPJSSID |
ID de l'enregistrement de l'app Jamf Device Checker (renseigné automatiquement : $APPJSSID) |
URL de branding et d'alertes
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-branding-image-url |
String | (vide) | URL de l'image du logo de l'entreprise (PNG/JPG). Laissez vide pour aucun branding. |
device-checker-branding-image-height |
Integer | 80 |
Hauteur du logo en points. |
device-checker-alerts-url |
String | (vide) | URL facultative pour une page d'alertes/d'état. Affiche un lien dans l'onglet Alertes. |
Exemple :
<key>device-checker-branding-image-url</key>
<string>https://yourcompany.com/logo.png</string>
<key>device-checker-branding-image-height</key>
<string>60</string>
Boutons de partage
Contrôlez la visibilité des fonctions de partage d'état et d'export des journaux dans l'onglet More.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-send-status-enabled |
String | YES |
Afficher le bouton « Send Status » (partage le résumé de préparation de l'appareil par e-mail/messages) |
device-checker-send-logs-enabled |
String | YES |
Afficher le bouton « Send Logs » (exporte les journaux de l'app pour le dépannage) |
Exemple :
<key>device-checker-send-status-enabled</key>
<string>YES</string>
<key>device-checker-send-logs-enabled</key>
<string>NO</string>
Comportement de l'interface
Contrôlez le comportement de défilement de l'onglet Status.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-status-tab-scrollable |
String | NO |
Lorsque YES, rend l'ensemble de l'onglet Status défilable (en-tête + état global + tuiles). Lorsque NO (défaut), l'en-tête et l'état global restent fixes, seules les tuiles défilant en dessous. |
Exemple :
<key>device-checker-status-tab-scrollable</key>
<string>NO</string>
Quand l'activer : La valeur par défaut (NO) convient à la plupart des déploiements — l'en-tête et l'état de préparation global restent visibles pendant le défilement des tuiles. Réglez sur YES lorsque vous avez besoin que toute la vue défile ensemble, ou pour accommoder des en-têtes de branding plus longs sur des appareils plus petits.
Préparation du système d'exploitation
Surveillez l'exigence de version de l'OS avec une version minimale et une échéance configurables.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-os-enabled |
String | YES |
Activer la tuile de surveillance de version de l'OS |
device-checker-os-min-version |
String | (aucune) | Version minimale requise de l'OS (par ex. 26.2) |
device-checker-os-deadline |
String | (aucune) | Échéance de l'exigence au format YYYY-MM-DD |
Exemple :
<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>
Logique d'état :
✅ Vert (Prêt) — La version actuelle de l'OS répond à l'exigence minimale
⚠️ Jaune (Avertissement) — La version actuelle de l'OS est inférieure au minimum, mais l'échéance n'est PAS dépassée (ou aucune échéance configurée)
🔴 Rouge (Non prêt) — La version actuelle de l'OS est inférieure au minimum ET l'échéance est dépassée
Préparation des apps
Surveillez l'état d'installation et les exigences de version des apps gérées requises.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-apps-enabled |
String | NO |
Activer la tuile de surveillance des apps |
device-checker-apps-list |
String | (vide) | Liste d'apps séparées par des barres verticales (voir le format ci-dessous) |
Format de la liste d'apps :
AppName,bundleID,minVersion,deadline|AppName2,bundleID2,minVersion2,deadline2|...
Exemple :
<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>
Logique d'état :
✅ Vert (Prêt) — Toutes les apps sont installées et répondent aux versions minimales
⚠️ Jaune (Avertissement) — Une ou plusieurs apps nécessitent une mise à jour, mais l'échéance n'est PAS dépassée
🔴 Rouge (Non prêt) — Une ou plusieurs apps nécessitent une mise à jour ET l'échéance est dépassée
⏳ En attente — Installation d'app en cours (voir l'intégration Self Service ci-dessous)
Intégration Self Service :
Lorsque des apps sont manquantes ou obsolètes, les utilisateurs peuvent appuyer sur le bouton « Update Apps » sur la tuile Apps pour installer ou mettre à jour automatiquement les apps requises. Le flux de travail est le suivant :
- L'utilisateur appuie sur le bouton « Update Apps » sur la tuile Apps
- L'app Jamf Self Service s'ouvre automatiquement avec les apps manquantes/obsolètes en file d'attente
- Device Checker passe à l'état « En attente » et démarre un minuteur d'actualisation automatique de 2 minutes
- L'app s'actualise automatiquement toutes les 2 minutes pour vérifier si les installations sont terminées
- Une fois que toutes les apps répondent aux exigences, l'état revient au vert
Exigences : Jamf Self Service doit être installé sur l'appareil, les apps doivent être disponibles dans Self Service et ciblées sur l'appareil, et les apps doivent avoir l'option « Display app in Self Service after it is installed » cochée dans Jamf Pro.
Remarques :
- Le bundle ID doit correspondre exactement (sensible à la casse)
- La comparaison de version utilise le versionnage sémantique (par ex.
2.5.0>2.4.9) - L'échéance est facultative (laissez vide si non nécessaire :
AppName,bundleID,minVersion,)
Source d'alimentation (niveau de batterie)
Surveillez le niveau de charge de la batterie avec des seuils d'avertissement et critiques configurables.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-power-source-enabled |
String | YES |
Activer la tuile de surveillance du niveau de batterie |
device-checker-power-source-warning |
Integer | 25 |
Seuil d'avertissement (pourcentage) |
device-checker-power-source-critical |
Integer | 10 |
Seuil critique (pourcentage) |
Exemple :
<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>
Logique d'état :
🔴 Rouge (Critique) — Batterie ≤ seuil critique
⚠️ Jaune (Avertissement) — Batterie ≤ seuil d'avertissement (mais > critique)
✅ Vert (Prêt) — Batterie > seuil d'avertissement
⚡ En charge — L'appareil est branché (toujours vert en charge)
Capacité de stockage
Surveillez le stockage disponible avec des seuils d'avertissement et critiques configurables (basés sur le pourcentage utilisé).
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-storage-enabled |
String | YES |
Activer la tuile de surveillance du stockage |
device-checker-storage-warning |
Integer | 75 |
Seuil d'avertissement (% utilisé) |
device-checker-storage-critical |
Integer | 90 |
Seuil critique (% utilisé) |
Exemple :
<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>
Logique d'état :
🔴 Rouge (Critique) — Stockage utilisé ≥ seuil critique
⚠️ Jaune (Avertissement) — Stockage utilisé ≥ seuil d'avertissement (mais < critique)
✅ Vert (Prêt) — Stockage utilisé < seuil d'avertissement
Santé de la batterie
Surveillez l'état de santé de la batterie pour identifier les appareils qui pourraient nécessiter un remplacement de batterie. Cette tuile affiche l'état de santé de la batterie et le pourcentage de charge actuel.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-battery-enabled |
String | YES |
Activer la tuile de surveillance de la santé de la batterie |
Exemple :
<key>device-checker-battery-enabled</key>
<string>YES</string>
Logique d'état :
✅ Vert (Prêt) — La santé de la batterie est « Normal » ou « Unsupported »
🔴 Rouge (Non prêt) — La santé de la batterie est « Service-Recommended » ou « Non-Genuine »
⚪ Gris (Inconnu) — La santé de la batterie est « Unknown » ou les données de batterie ne peuvent être récupérées
Valeurs d'état de santé :
- Normal — La batterie fonctionne correctement (Vert)
- Service-Recommended — La capacité de la batterie s'est dégradée, remplacement recommandé (Rouge)
- Non-Genuine — Batterie non Apple détectée, remplacement recommandé (Rouge)
- Unsupported — Surveillance de la santé de la batterie non disponible sur ce modèle d'appareil (Vert, affiche uniquement le % de charge)
- Unknown — Données de santé pas encore disponibles depuis iOS (Gris, affiche uniquement le % de charge)
Affichage de la tuile : La couleur et l'icône d'état sont basées sur la santé de la batterie. Le sous-titre affiche le problème de santé de la batterie s'il est présent, sinon affiche le pourcentage de charge actuel. La vue détaillée affiche le niveau de charge, l'état de charge, le mode économie d'énergie, l'état de santé de la batterie et les recommandations.
Remarques :
- Les données de santé de la batterie proviennent de la Declarative Device Management (DDM)
- Les nouveaux appareils peuvent afficher « Unknown » jusqu'à ce qu'iOS calcule les métriques de santé (généralement après quelques cycles de charge)
- Le pourcentage de charge est toujours affiché dans le sous-titre ou la vue détaillée
- Cette tuile se concentre sur la santé de la batterie ; utilisez la tuile Source d'alimentation pour la surveillance du niveau de charge avec des seuils
État thermique
Surveillez la température de l'appareil en temps réel à l'aide des API iOS locales (aucun appel MDM requis).
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-thermal-enabled |
String | YES |
Activer la tuile de surveillance de l'état thermique |
Exemple :
<key>device-checker-thermal-enabled</key>
<string>YES</string>
Logique d'état :
✅ Vert (Nominal) — Température de fonctionnement normale, toutes les fonctions fonctionnent normalement
⚠️ Jaune (Correct) — Légèrement élevée, le système reporte le travail en arrière-plan comme le préchargement/l'indexation
🔴 Rouge (Sérieux) — Température élevée, limitation CPU/GPU active, les fréquences d'images peuvent chuter à 30 FPS
🔴 Rouge (Critique) — Appareil dangereusement chaud, limitation importante, caméra/flash/haut-parleur peuvent se désactiver, risque d'arrêt
Cas d'usage : appareils de terrain dans des environnements chauds (véhicules, travail en extérieur), utilisateurs exécutant des apps intensives (enregistrement vidéo, AR), avertissements proactifs avant les arrêts thermiques et compréhension de la limitation des performances.
Remarques : Surveillance en temps réel via l'API iOS ProcessInfo. Aucun appel d'API ni décharge de batterie. Se met à jour instantanément lorsque l'état thermique change.
Performances (mémoire et processeur)
Surveillez la pression sur la mémoire et l'utilisation du processeur de l'appareil à l'aide des API iOS locales avec des seuils configurables.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-performance-enabled |
String | YES |
Activer la tuile de surveillance des performances |
device-checker-memory-warning |
Integer | 70 |
Seuil d'avertissement de la mémoire (% utilisé) |
device-checker-memory-critical |
Integer | 85 |
Seuil critique de la mémoire (% utilisé) |
device-checker-cpu-warning |
Integer | 60 |
Seuil d'avertissement du processeur (% d'utilisation) |
device-checker-cpu-critical |
Integer | 80 |
Seuil critique du processeur (% d'utilisation) |
Exemple :
<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>
Logique d'état :
🔴 Rouge (Critique) — Mémoire OU processeur ≥ seuil critique
⚠️ Jaune (Avertissement) — Mémoire OU processeur ≥ seuil d'avertissement (mais < critique)
✅ Vert (Prêt) — Mémoire ET processeur < seuils d'avertissement
Remarques : Se met à jour toutes les 5 secondes lorsque la tuile est visible. La surveillance se met en pause lorsque l'app est en arrière-plan (pour économiser la batterie). Aucun appel d'API distant requis — surveillance entièrement locale via os_proc_available_memory() pour la mémoire et host_statistics() pour le processeur.
État du réseau
Surveillez l'état de connectivité WiFi, Ethernet et cellulaire.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-wifi-enabled |
String | YES |
Activer la tuile de surveillance WiFi/Ethernet (Ethernet est détecté automatiquement lorsqu'il est connecté) |
device-checker-cellular-enabled |
String | NO |
Activer la tuile de surveillance cellulaire |
device-checker-network-speed-enabled |
String | NO |
Activer le bouton de test de vitesse réseau dans les vues détaillées du réseau |
Exemple :
<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>
Détails du test de vitesse réseau :
Le test de vitesse est un outil de diagnostic à la demande (~10–15 Mo par test, ~15–20 secondes de durée) qui mesure les vitesses de téléchargement/téléversement et la latence. Un avertissement est affiché avant chaque test sur le réseau cellulaire pour signaler la consommation de données. Les résultats sont fournis à titre informatif uniquement et n'affectent pas l'état de préparation de l'appareil. Les cas d'usage incluent les travailleurs de terrain vérifiant la connectivité, le dépannage des performances lentes et la validation des exigences de bande passante.
Test de connectivité Internet (WiFi, Ethernet et cellulaire)
Test léger pour vérifier l'accessibilité réelle d'Internet par rapport à la simple connectivité de l'interface.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-internet-connectivity-test-enabled |
String | NO |
Activer le test de connectivité Internet pour toutes les interfaces |
device-checker-internet-connectivity-test-endpoint |
String | http://captive.apple.com/hotspot-detect.html |
URL du point de terminaison de test (portail captif Apple par défaut) |
device-checker-internet-connectivity-test-timeout |
String | 3 |
Délai d'expiration de la requête en secondes (plage 1–10) |
device-checker-internet-connectivity-test-cache-ttl |
String | 30 |
Validité du résultat mis en cache en secondes (plage 10–300 ; le cellulaire utilise un minimum de 60 s) |
Exemple :
<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>
Comment ça marche : Envoie une requête HEAD légère (~200–500 octets) au point de terminaison du portail captif d'Apple. Les tests s'exécutent automatiquement lorsqu'une interface se connecte ou lorsque les vues détaillées du réseau sont ouvertes (si le cache a expiré). Les résultats sont mis en cache pendant 30 secondes sur WiFi/Ethernet et un minimum de 60 secondes sur cellulaire pour minimiser la consommation de données. Les tuiles réseau affichent un état jaune/avertissement si elles sont connectées mais qu'aucun accès Internet n'est détecté.
Comportement de l'état par interface :
WiFi — Vert : connecté avec Internet vérifié. Jaune : connecté mais pas d'Internet (portail captif, problème de routage). Rouge : non connecté.
Ethernet — Vert : connecté avec Internet vérifié. Jaune : connecté mais pas d'Internet (problème de routage/pare-feu). Rouge : non connecté.
Cellulaire — Vert : activé avec Internet vérifié. Jaune : activé mais pas d'Internet (problème d'opérateur, problème de compte). Rouge : non disponible ou désactivé.
Consommation de données : ~200–500 octets par test (contre ~10–15 Mo pour le test de vitesse). WiFi/Ethernet avec cache de 30 secondes : moins de 100 Ko/jour d'utilisation typique. Cellulaire avec cache de 60 secondes : moins de 50 Ko/jour d'utilisation typique.
Logique d'état sans test de connectivité Internet :
WiFi : ✅ Vert (Connecté) — Connecté au WiFi. 🔴 Rouge (Non connecté) — Non connecté au WiFi.
Cellulaire : ✅ Vert (Prêt) — Données cellulaires disponibles. ⚠️ Jaune (Avertissement) — Accès cellulaire restreint. 🔴 Rouge (Erreur) — Cellulaire non disponible.
Extension Attribute Jamf Setup
Affichez l'état on-duty/off-duty depuis un extension attribute de Jamf Pro.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-jamf-setup-ea-enabled |
String | NO |
Activer la tuile EA Jamf Setup |
device-checker-jamf-setup-ea-name |
String | (vide) | Nom de l'extension attribute dans Jamf Pro |
device-checker-jamf-setup-ea-on-duty-value |
String | (vide) | Valeur qui indique « on-duty » |
device-checker-jamf-setup-ea-off-duty-value |
String | (vide) | Valeur qui indique « off-duty » |
Exemple :
<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>
Logique d'état :
✅ Vert (Prêt) — La valeur de l'EA correspond à la valeur on-duty
⚠️ Jaune (Avertissement) — La valeur de l'EA correspond à la valeur off-duty
⚪ Gris (Inconnu) — EA introuvable ou la valeur ne correspond à aucune des valeurs configurées
Remarques : Nécessite un extension attribute personnalisé dans Jamf Pro. L'extension attribute doit être renseigné par Jamf Setup ou une autre méthode.
Limitation de l'actualisation automatique
Contrôlez la fréquence à laquelle l'app s'actualise automatiquement au retour depuis l'arrière-plan.
| Clé | Type | Défaut | Description |
|---|---|---|---|
device-checker-auto-refresh-threshold |
Integer | 300 |
Nombre minimal de secondes entre les actualisations automatiques (plage : 60–3600, ou 0 pour désactiver) |
Exemple :
<key>device-checker-auto-refresh-threshold</key>
<string>300</string>
Comportement :
- Défaut (300 secondes / 5 minutes) : Si l'utilisateur change d'app et revient dans les 5 minutes, aucune actualisation automatique n'a lieu
- Seuil personnalisé : Réglez sur le nombre de secondes souhaité (60–3600)
- Désactiver la limitation : Réglez sur
0pour toujours actualiser lorsque l'app devient active
S'actualise toujours (limitation contournée) : première activation après le lancement de l'app, en état d'attente (s'actualise automatiquement toutes les 2 minutes), appuis sur le bouton d'actualisation manuelle et expiration du minuteur pendant l'état d'attente.
Comportement de l'état d'attente : Lorsque la tuile Apps entre en état « En attente » (après que l'utilisateur a appuyé sur « Update Apps »), l'app vérifie automatiquement l'état de l'appareil toutes les 2 minutes jusqu'à ce que toutes les apps requises soient installées, quel que soit le réglage du seuil d'actualisation automatique.
Exemples de configuration
Configuration minimale (réglages par défaut)
Parfaite pour un test rapide ou des déploiements de base.
<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>
Configuration complète
Configuration complète avec branding, plusieurs contrôles d'état de l'appareil et seuils personnalisés.
<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>
Mentions légales
- Contrat d'utilisation : Application End User License Agreement
- Politique de confidentialité : Jamf Privacy Policy