Les attributs d’extension vous permettent de collecter des données d’inventaire supplémentaires. Les valeurs des attributs d’extension sont remplies avec un type d’entrée parmi les suivants :

Champ texte
Menu contextuel
Script
Mappage d’attributs LDAP

Dans Jamf Pro, vous pouvez créer des attributs d’extension manuellement à partir d’un modèle disponible dans Jamf Pro, ou en téléchargeant un attribut d’extension depuis Jamf Nation.

Exemples :

Une entrée de champ texte permet de collecter la date de retrait d’un ordinateur.
Une entrée de script peut collecter des données concernant le logiciel antivirus de votre entreprise sur un ordinateur.

Les attributs d’extension peuvent être utilisés comme critères dans un groupe intelligent ou comme variable dans un profil de configuration, ce qui vous permet d’administrer les workflows et les tâches de gestion dynamique en fonction des données collectées avec les attributs d’extension.

Remarque : En fonction du type d’entrée et du type de données (chaîne, entier, date), les attributs d’extension peuvent ajouter du temps et du trafic réseau au processus de collecte de l’inventaire.

Types d’entrée des attributs d’extension

Les attributs d’extension permettent de collecter des données d’inventaire en utilisant un type d’entrée. Vous pouvez configurer les types d’entrée suivants :

Champs texte

Vous pouvez afficher un champ texte dans les données d’inventaire, ou utiliser Recon pour collecter des données d’inventaire. Vous pouvez saisir une valeur dans le champ lors de l’enrôlement avec Recon, ou à tout moment avec Jamf Pro.

Remarque : Seuls les attributs d’extension créés manuellement peuvent utiliser un champ texte.

Menus contextuels

Vous pouvez afficher un menu contextuel dans les données d’inventaire, ou utiliser Recon pour collecter des données d’inventaire. Vous pouvez choisir une valeur dans le menu contextuel lors de l’enrôlement d’un ordinateur avec Recon, ou à tout moment avec Jamf Pro.

Remarque : Les menus contextuels ne peuvent être configurés que par un attribut d’extension créé manuellement.

Scripts

Vous pouvez exécuter un script qui renvoie la valeur d’une donnée chaque fois qu’un ordinateur envoie un inventaire à Jamf Pro. Vous pouvez écrire votre propre script d’attribut d’extension, ou en créer un à partir d’un modèle dans Jamf Pro.

Lorsque vous écrivez des scripts d’attributs d’extension, tenez compte des éléments suivants :

Les scripts peuvent être écrits dans n’importe quelle langue pour laquelle un interpréteur est installé. Les interpréteurs les plus courants sont Bash, Pearl et Python.
Lorsqu'un attribut d'extension est alimenté par un script, le texte entre la balise <result></result> est stocké dans Jamf Pro.
Vous pouvez désactiver temporairement les attributs d’extension lors du dépannage des processus.

L’exemple de script suivant collecte le nom d’hôte des ordinateurs Mac :

#!/bin/bash

echo "<result>`hostname 2>&1`</result>"

Pour plus d’exemples et de modèles, consultez la page web Attributs d’extension sur Jamf Nation.

Mappage d’attributs LDAP

Pour alimenter un attribut d’extension, vous pouvez utiliser un mappage d’attributs LDAP. Les attributs d’extension peuvent être alimentés par des attributs à valeurs multiples d’un serveur LDAP, par exemple « memberOf ». Ces valeurs multiples peuvent ensuite être utilisées lors de la création de groupes intelligents et de recherches avancées avec les critères d’attributs d’extension et les opérateurs « has » ou « does not have ».

Tenez compte des limitations suivantes lors de l’utilisation d’attributs d’extension LDAP à valeurs multiples :

Lors de la création de groupes intelligents et de recherches avancées, la valeur du critère doit refléter avec précision la valeur renvoyée dans l’inventaire de l’ordinateur. Pour vous assurer d’utiliser la bonne valeur, copiez la valeur d’inventaire de l’attribut d’extension et collez-la dans le champ de valeur du critère.
Le mappage d’attributs à valeurs multiples ne fonctionne pas avec les groupes imbriqués. Seuls les groupes directement répertoriés dans l’enregistrement Utilisateur apparaîtront dans l’attribut d’extension LDAP mappé.
Pour que les attributs d’extension fonctionnent correctement, les valeurs retournées par le serveur LDAP ne peuvent pas contenir la séquence de répétition de caractères barre verticale (code ASCII 124, entité HTML = |).

Identifiants des attributs d’extension et variables

La création d'un attribut d'extension d’ordinateur génère une variable qui peut être utilisée pour remplir les réglages du profil de configuration. La variable est $EXTENSIONATTRIBUTE_#, où # est l’ID d'attribut d'extension.

Pour plus d'informations sur l’utilisation des variables d’entités des profils de configuration, consultez la section Profils de configuration d’ordinateur.

Pour les attributs d’extension qui utilisent un champ texte, un menu contextuel ou un type d’entrée de script, le numéro d’identification se trouve dans l’URL de l’attribut d’extension. Dans l’exemple d’URL ci-dessous, « id=2 » indique le numéro d’identification de l’attribut d’extension :

Exemple : https://instancename.jamfcloud.com/computerExtensionAttributes.html?id=2&o=r

Pour les attributs d’extension avec le type d’entrée de mappage des attributs LDAP, le numéro d’identification s’affiche dans le champ Variable d’attribut LDAP après l’enregistrement de l’attribut d’extension.

Création manuelle d'un attribut d'extension d'ordinateur

Exigences

Si vous créez un attribut d’extension d’ordinateur avec le type d’entrée « Mappage d’attributs LDAP », vous avez besoin des éléments suivants :

Un serveur LDAP configuré dans Jamf Pro
Pour plus d’informations, consultez la section Intégration aux services d’annuaire LDAP.
Les réglages Collecte d’inventaire d’ordinateurs configurés pour collecter des informations sur l’utilisateur et l’emplacement depuis LDAP.
Pour plus d’informations, voir Réglages Collecte d’inventaire d’ordinateurs.

Procédure

Connectez-vous à Jamf Pro.
Dans l’angle supérieur droit de la page, cliquez sur Réglages .
Cliquez sur Gestion des ordinateurs.
Dans la section « Gestion des ordinateurs – Structure de gestion », cliquez sur Attributs d’extension .
Cliquez sur Nouveau .
Configurez les réglages suivants :
1. Donnez un nom à votre attribut d’extension.
2. (Optionnel) Saisissez une description.
3. Choisissez le type de données collectées dans le menu contextuel Type de données.
4. Choisissez une catégorie dans laquelle afficher l’attribut d’extension dans Jamf Pro dans le menu contextuel Affichage de l’inventaire.
5. Choisissez un type d’entrée pour alimenter l’attribut d’extension dans le menu contextuel Type d’entrée.
Cliquez sur Enregistrer .

Création d'un attribut d'extension d'ordinateur à partir d'un modèle

Jamf Pro possède des modèles intégrés pour de nombreux attributs d'extension couramment utilisés.

Connectez-vous à Jamf Pro.
Dans l’angle supérieur droit de la page, cliquez sur Réglages .
Cliquez sur Gestion des ordinateurs.
Dans la section « Gestion des ordinateurs – Structure de gestion », cliquez sur Attributs d’extension .
Cliquez sur Nouveau à partir du modèle.
Cliquez sur le modèle d'attribut d'extension que vous souhaitez utiliser.
(Optionnel) Modifiez les réglages si nécessaire.
Cliquez sur Enregistrer .

Upload d'un modèle pour un attribut d'extension d'ordinateur

Vous pouvez créer un attribut d'extension en uploadant un modèle d'attribut d'extension obtenu auprès de Jamf Nation. Les modèles d'attributs d'extension sont disponibles dans Jamf Nation à l'adresse :
https://www.jamf.com/jamf-nation/third-party-products/files/extension-attributes

Connectez-vous à Jamf Pro.
Dans l’angle supérieur droit de la page, cliquez sur Réglages .
Cliquez sur Gestion des ordinateurs.
Dans la section « Gestion des ordinateurs – Structure de gestion », cliquez sur Attributs d’extension .
Cliquez sur Uploader et uploadez le modèle d'attribut d'extension.
(Optionnel) Modifiez les réglages si nécessaire.
Cliquez sur Enregistrer .

Désactivation d'un attribut d'extension d'ordinateur

Pour dépanner les workflows, vous pouvez désactiver temporairement les attributs d’extension avec le type d’entrée script. Vous pouvez également choisir de conserver ou de supprimer les données collectées par cet attribut d'extension.

Connectez-vous à Jamf Pro.
Dans l’angle supérieur droit de la page, cliquez sur Réglages .
Cliquez sur Gestion des ordinateurs.
Dans la section « Gestion des ordinateurs – Structure de gestion », cliquez sur Attributs d’extension .
Sélectionnez l'attribut d'extension que vous souhaitez désactiver.

Remarque : Seuls les attributs d'extension avec le type d'entrée script peuvent être désactivés.
Cliquez sur Modifier .
Désactivez la case Activé (type d’entrée de script uniquement).
Cliquez sur Enregistrer .
Utilisez la boîte de dialogue contextuelle pour choisir l'une des options suivantes :
- Pour conserver les données collectées par l'attribut d'extension, sélectionnez Conserver les données existantes, puis cliquez sur Enregistrer.
  
  Remarque : Tous les réglages et ordinateurs qui utilisent des données collectées par des attributs d’extension désactivés afficheront ou utiliseront la dernière valeur collectée par l’attribut d’extension avant sa désactivation.
- Pour supprimer les données collectées par l'attribut d'extension, sélectionnez Supprimer les données existantes, puis cliquez sur Enregistrer.
  
  Remarque : Si des groupes intelligents d’ordinateurs ou d’autres éléments utilisent les données d’attribut d’extension, la suppression de données existantes peut empêcher ces éléments de fonctionner correctement.

Informations connexes

Pour des informations connexes, consultez les sections suivantes de ce guide :

Réglages d'affichage de l'inventaire de l'ordinateur
Vous pouvez afficher les attributs d'extension dans les résultats d'une recherche simple d’ordinateurs.
Données d’inventaire d’ordinateurs
Vous pouvez afficher les attributs d'extension collectés depuis un ordinateur et modifier les valeurs d'attributs d'extension non script pour cet ordinateur.
Groupes intelligents
Vous pouvez créer des groupes intelligents d'ordinateurs en fonction de certains attributs d'extension.

Attributs d’extension d’ordinateur