Jamf Concepts
Guides

Guides

Jamf Device Checker

~19 min read
Cela vous a-t-il été utile ?

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 :

  1. L'utilisateur appuie sur le bouton « Update Apps » sur la tuile Apps
  2. L'app Jamf Self Service s'ouvre automatiquement avec les apps manquantes/obsolètes en file d'attente
  3. Device Checker passe à l'état « En attente » et démarre un minuteur d'actualisation automatique de 2 minutes
  4. L'app s'actualise automatiquement toutes les 2 minutes pour vérifier si les installations sont terminées
  5. 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 0 pour 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

Cela vous a-t-il été utile ?