Configurer Connecteur du graphe de services pour Jamf à l’aide de la configuration guidée

Configurez les informations d’identification d’authentification et les travaux planifiés pour importer Jamf des données dans votre Base de données de gestion des configurations (CMDB).

Avant de commencer

Important :

Sauf en cas de problèmes de configuration, utilisez la vue dans le SGC CentralEspace de travail du graphe de services ou Espace de travail CMDB pour configurer la connexion pour le connecteur, car la méthode de configuration guidée est planifiée pour être obsolète.

Pour utiliser cette optionConnecteur du graphe de services, vous devez être abonné à une unité d’abonnement basée sur l’application Gestion des opérations ITITOM() Visibility () Visibility ( Visibilité ou l’application ITOM Découverte). Comme défini dans la section intitulée « Types de ressources informatiques gérées » dans la vue d’ensemble de l’unité d’abonnement ServiceNow pour votre abonnement, pour les ressources informatiques gérées qui sont créées ou modifiées dans le CMDB cadre de cet Connecteur du graphe de services abonnement, mais qui ne sont pas encore gérées par Visibilité ITOM ou Découverte ITOM, ces ressources augmenteront la consommation d’unités d’abonnement à partir de cette application. Vérifiez votre consommation actuelle d’unités d’abonnement dans Visibilité ITOM ou Découverte ITOM pour vous assurer de la capacité disponible.

Dépendances et exigences :

• L’application du magasin Integration Commons for CMDB, qui est automatiquement installée.
• L’application de stockage des modèles de classe CI CMDB, qui est automatiquement installée. Consultez Application Modèles de classe CI CMDB.
• Module d’extension Gestion des licences ITOM (com.snc.itom.license). Module d’extension sans licence qui contient une logique de calcul pour la consommation de SU si nécessaire. Pour plus d’informations, consultez la section Demander la découverte.
• Jamf API classique version 10.x.

Lorsque vous utilisez les informations d’identification du client pour l’authentification, procurez-vous les informations d’identification OAuth auprès de votre Jamf administrateur. Notez les détails suivants :

• ID (client) de l'application
• Secret client

Si vous utilisez l’authentification par informations d’identification du client dans Jamf Pro, vous devez utiliser la fonctionnalité API Roles and Clients. Pour plus d’informations, reportez-vous à la section Rôles et clients API de la Jamf documentation. Lors de la création d’un nouveau client API dans l’environnement Jamf , le champ Durée de vie du jeton d’accès du formulaire de création d’un client permet de définir la durée de validité du jeton. La valeur par défaut est de 60 secondes, mais en raison de ServiceNow AI Platform limitations, la valeur doit être définie sur plus de 60 secondes. Définir la durée de vie du jeton sur 3 600 secondes (1 heure) permet d’éviter les problèmes potentiels.

Rôle requis : admin

Procédure

1. Accédez à la Tous > Connecteurs du graphe de services > Jamf > Configuration.
2. Sur la page Mise en route, sélectionnez Démarrer.
3. Définissez les propriétés de configuration.
   1. Sur la page Connecteur du graphe de services pour Jamf, dans la section Définir les propriétés de configuration, sélectionnez Configurer la limite de taille des données JSON.
   2. Pour la tâche Configurer la limite de taille des données JSON , sélectionnez Configurer.
   3. Sélectionnez le périmètre de l’application Global dans le sélecteur d’application.
   4. Définissez la valeur de la propriété système com.glide.transform.json.max-partial-length .
      • Pour créer une propriété système, sélectionnez Nouveau et entrez com.glide.transform.json.max-partial-length comme nom et 65536 comme valeur de la propriété.
      • Si la com.glide.transform.json.max-partial-length propriété existe déjà, vérifiez que sa valeur est définie sur 65536.
   5. Définissez la tâche Configurer la limite de taille des données JSON à terminer en sélectionnant Marquer comme terminé.
4. Configurez les informations d’identification de l’authentification et la connexion HTTP utilisées pour envoyer des demandes à l’API Jamf .
   1. Saisissez les détails d’authentification de base ou par jeton de porteur.
      Important :

      Ignorez cette étape si vous utilisez les informations d’identification du client pour l’authentification et passez plutôt à l’étape 4.c.

      1. Pour la tâche Configurer l’authentification Jamf : authentification de base ou par jeton de porteur , sélectionnez Configurer.
      2. Remplissez les champs du formulaire.

         Tableau 1. Formulaire Informations d'identification pour l'authentification de base

         Champ	Description
         Nom	Nom descriptif de cette configuration d’authentification.
         Nom d'utilisateur	Nom d’utilisateur utilisé pour authentifier la demande HTTP ou HTTPS lorsque ce profil d’authentification de base est activé. Remarque : Vérifiez que l’utilisateur Jamf dispose des privilèges de lecture pour les catégories Ordinateurs et Équipements mobiles dans Jamf.
         Mot de passe	Mot de passe utilisé pour authentifier la demande HTTP ou HTTPS lorsque ce profil d’authentification de base est activé.

      3. Sélectionnez Mettre à jour.
      4. Définissez la tâche Configurer l’authentification Jamf : authentification de base ou par jeton de porteur à terminer en sélectionnant Marquer comme terminé.
   2. Configurez la Jamf connexion HTTP.
      Important :

      Ignorez cette étape si vous utilisez les informations d’identification du client pour l’authentification et passez plutôt à l’étape 4.c.

      1. Pour la tâche Configurer la connexion HTTP Jamf , sélectionnez Configurer.
      2. Remplissez les champs du formulaire.

         Tableau 2. Formulaire Connexion HTTP(s)

         Champ	Description
         Nom	Nom de la connexion.
         Informations d'identification	Valeur d’informations d’identification utilisée par cette connexion.
         Alias de connexion	Valeur de connexion utilisée pour faire référence à la connexion.
         Actives	Option permettant d’activer la connexion HTTP.
         Domaine	Domaine qui contient la connexion.
         Générateur d'URL	Option permettant au système de créer l’URL de connexion.
         URL de connexion	URL de connexion pour la connexion. Vous pouvez entrer manuellement une URL ou utiliser le générateur d’URL pour créer la chaîne de connexion. Remarque : Vous ne pouvez pas modifier le champ URL de connexion si vous cochez la case Générateur d’URL .
         Authentification réciproque	Option permettant de définir la connexion avec authentification réciproque. Ce champ s’affiche uniquement lorsque la case Générateur d’URL est cochée.
         Protocole	Protocole sous-jacent utilisé par la connexion. Ce champ s’affiche uniquement lorsque la case Générateur d’URL est cochée. Remarque : Mettez à jour le champ Protocole si vous utilisez autre chose que https.
         Utiliser un serveur MID	Option permettant de sélectionner un serveur MID qui envoie cette connexion HTTP. L’utilisation d’un serveur MID n’est pas compatible avec l’authentification réciproque.
         Délai de connexion	Nombre de millisecondes pendant lesquelles le système attend une connexion réussie de l’hôte. Si aucune connexion ne se produit pendant ce temps, la demande de connexion expire. Laissez ce champ vide pour utiliser la valeur de délai de connexion par défaut du système.
         Hôte	Valeur d’hôte cible utilisée par la connexion. Ce champ s’affiche uniquement lorsque la case Générateur d’URL est cochée. Remarque : Mettez à jour le champ Hôte avec votre URL ou adresse Jamf IP de base. Par exemple, demojamfhost.com ou 127.0.0.1.
         Remplacer le port par défaut	Port de valeur cible utilisé par la connexion. Ce champ s’affiche uniquement lorsque la case Générateur d’URL est cochée.
         Chemin d'accès de base	Chemin d’accès de base pour la connexion HTTPS. Ce champ s’affiche uniquement lorsque la case Générateur d’URL est cochée. Remarque : Pour utiliser l’API Jamf Pro, le champ Chemin d’accès de base doit être vide. Par conséquent, effacez toutes les valeurs du champ Chemin d’accès de base .

      3. Sélectionnez Mettre à jour.
      4. Définissez la tâche Configurer la connexion HTTP Jamf comme terminée en sélectionnant Marquer comme terminé.
   3. Configurez les informations d’identification d’authentification du client.
      Important :

      Ignorez cette étape si vous utilisez un jeton de base pour l’authentification et passez plutôt à l’étape 4.a.

      1. Pour la tâche Configurer l’authentification Jamf : informations d’identification du client , sélectionnez Configurer.
      2. Sélectionnez Modifier pour la connexion OAuth SG-Jamf, la connexion par défaut.
      3. Dans la section Informations de connexion de la fenêtre Modifier la connexion, renseignez les champs.

         Tableau 3. Information de connexion

         Champ	Description
         Nom de la connexion	Nom permettant d’identifier l’enregistrement de Jamf connexion. Connexion OAuth SG-Jamf est le nom de l’alias d’informations d’identification par défaut et est en lecture seule.
         URL de connexion	URL de base pour se connecter à l’API Jamf . Remarque : Ce champ est automatiquement défini sur l’URL de connexion à l’application. Laissez la valeur du champ telle quelle.

      4. (Facultatif) Si un Serveur MID est requis pour la connexion au serveur, cochez la case Utiliser Serveur JamfMID . Ensuite, sélectionnez les champs associés au serveur MID en conséquence.
      5. Renseignez les champs de la section Informations d’identification de la fenêtre Edit Connection (Modifier la connexion).

         Tableau 4. Informations d'identification

         Champ	Description
         ID client OAuth	ID (client) de votre Jamf application cliente, comme indiqué dans la section Avant de commencer . Remarque : Vérifiez que le Jamf client dispose des privilèges de lecture pour les catégories Ordinateurs et Appareils mobiles dans Jamf.
         Secret client OAuth	Secret client de votre Jamf application cliente, comme indiqué dans la section Avant de commencer .

   4. Testez la connexion.
      1. Pour la tâche Test de la connexion , sélectionnez Configurer.
      2. Passez en revue les propriétés dans la liste connexe Propriétés de connexion du graphe de services.
         Remarque :

         Les propriétés de la liste connexe Propriétés de connexion du graphe de services de l’enregistrement de connexion sont modifiables. Assurez-vous d’effectuer la configuration guidée, d’examiner les descriptions des propriétés et de suivre attentivement les instructions avant d’y apporter des changements.

         • Pour l’authentification de base, définissez la valeur de la auth_type propriété sur basique (applicable uniquement aux Jamf versions antérieures à 10.35. Notez qu’elle Jamf ne prend plus en charge l’authentification de base et qu’elle sera désactivée pour toutes les instances à partir de la Jamf version 11.5).
         • Pour l’authentification par jeton de porteur, définissez la valeur de la propriété sur porteur (disponible dans Jamf la auth_type version 10.35 ou les versions ultérieures).
         • Pour l’authentification par informations d’identification du client (OAuth 2.0), définissez la valeur de la propriété sur OAuth (disponible dans Jamf la auth_type version 10.49 ou les versions ultérieures).
         • Si aucun type d'authentification n'est sélectionné, le connecteur utilise par défaut l'authentification par jeton de porteur.
      3. Testez la connexion en sélectionnant le lien connexe Tester le chargement de 20 enregistrements .

         Le test de la connexion peut prendre quelques instants. La page est actualisée pour afficher les résultats du test.

         Remarque :

         La connexion aboutit si l’état HTTP est égal à 200. Si quelque chose s’affiche dans les champs Code d’erreur et Message d’erreur , la connexion a échoué et un dépannage supplémentaire est requis. Ne sélectionnez pas Charger tous les enregistrements pendant cette configuration.
      4. Définissez la tâche Test de la connexion à terminer en sélectionnant Marquer comme terminé.
5. Facultatif : Ajoutez plusieurs instances.
   Remarque :

   Si vous n’avez pas besoin d’ajouter plusieurs instances, vous pouvez ignorer cette étape.
   1. Dans la section Ajouter plusieurs instances de la page Connecteur du graphe de services pour Jamf , sélectionnez Démarrer.
   2. Activez la création de sources de données pour la nouvelle Jamf connexion.
      1. Assurez-vous de disposer des autorisations de modification pour la table Source de données [sys_data_source].
      2. Pour la tâche Mettre à jour l’accès à la source de données, sélectionnez Configurer.
      3. Pour modifier l’enregistrement, sélectionnez le périmètre de l’application Global dans le sélecteur d’application.
      4. Dans la liste connexe Accès à l’application du formulaire Source de données qui s’ouvre dans un nouvel onglet, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
      5. Sélectionnez Mettre à jour.
      6. Sélectionnez l’icône de retour (<) pour revenir à la page de Configuration guidée.
      7. Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services pour Jamf .
      8. Définissez la tâche Mettre à jour l’accès à la source de données à terminer en sélectionnant Marquer comme terminé
   3. Activez la création d’une tâche d’importation de données planifiée pour la nouvelle Jamf connexion.
      1. Assurez-vous de disposer des autorisations de modification pour la table Importation de données planifiée [scheduled_import_set].
      2. Pour la tâche Mettre à jour l’accès à l’importation de données planifiée , sélectionnez Configurer.
      3. Pour modifier l’enregistrement, sélectionnez le périmètre de l’application Global dans le sélecteur d’application.
      4. Dans la liste connexe Accès à l’application du formulaire Importation de données planifiée qui s’ouvre dans un nouvel onglet, cochez les cases Peut créer, Peut mettre à jour et Peut supprimer .
      5. Sélectionnez Mettre à jour.
      6. Sélectionnez l’icône de retour (<) pour revenir à la page de Configuration guidée.
      7. Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services pour Jamf .
      8. Définissez la tâche Mettre à jour l’accès à l’importation de données planifiée comme terminée en sélectionnant Marquer comme terminé.
   4. Sélectionnez le type d’authentification pour la nouvelle connexion.
      Remarque :

      Dans le sélecteur d’application, sélectionnez le périmètre de l’application Connecteur du graphe de services pour Jamf .

      1. Pour la tâche Sélectionner le type d’authentification pour une nouvelle connexion , sélectionnez Configurer.
      2. Sélectionnez sn_jamf_integrate.auth_type dans la colonne Nom .
      3. Définissez la sn_jamf_integrate.auth_type propriété sur l’une des valeurs suivantes :
         • de base : authentification de base qui utilise un nom d’utilisateur et un mot de passe.
         • porteur : authentification de jeton de porteur qui utilise un nom d’utilisateur et un mot de passe pour récupérer un jeton de porteur.
         • OAuth : authentification par informations d’identification du client qui utilise un ID client et un secret client pour s’authentifier via OAuth 2.0.
      4. Revenez à la configuration guidée.
      5. Définissez le type d’authentification pour la tâche de nouvelle connexion à terminer en sélectionnant Marquer comme terminé.
   5. Ajoutez une autre connexion.
      Remarque :

      Vérifiez que le périmètre de l’application Connecteur du graphe de services pour Jamf est sélectionné dans le sélecteur d’application.

      1. Pour la tâche Ajouter une autre connexion , sélectionnez Configurer.
      2. Dans le , sélectionnez Ajouter uneStudio de workflow connexion.
      3. Sur le formulaire, en fonction du type d’authentification, renseignez les champs.
         Remarque :

         • Pour une connexion basée sur l’authentification de base ou par jeton de porteur, n’incluez pas https:// dans le champ Hôte de connexion . Exemple de valeur d’hôte de connexion : test.jamfcloud.com.
         • Pour la connexion basée sur l’authentification par informations d’identification du client, incluez https:// dans le champ URL de connexion . Exemple de valeur de l’URL de connexion : https://test.jamfcloud.com.
      4. Selon le type d’authentification, sélectionnez le bouton pour créer la connexion.
      5. Revenez à la configuration guidée.
      6. Définissez la tâche Ajouter une autre connexion à terminer en sélectionnant Marquer comme terminé.
   6. Lorsque vous utilisez Jamf l’API Pro, la Jamf version Pro 10.35 ou supérieure, ou les deux, spécifiez la version Pro et l’API Jamf .
      1. Pour la tâche Sélectionner la version JAMF Pro et l’API , sélectionnez Configurer.
      2. Dans la colonne Utiliser l’API JAMF Pro , pour la connexion que vous avez créée, modifiez la valeur de faux à vrai pour utiliser Jamf l’API Pro au lieu de l’API classique.
      3. Mettez à jour la valeur de colonne Jamf Pro 10.35 ou supérieure sur vrai lors de l’utilisation de la Jamf version Pro 10.35 ou supérieure.
         Remarque :

         Avec la valeur de colonne Jamf Pro 10.35 ou supérieure définie sur vrai, l’authentification par jeton de porteur est utilisée pour authentifier l’API Jamf . Sinon, l’authentification de base est utilisée.
      4. Définissez la tâche Sélectionner la version JAMF Pro et l’API à terminer en sélectionnant Marquer comme terminé.
   7. Testez les nouvelles connexions.
      1. Pour la tâche Tester les nouvelles connexions , sélectionnez Configurer.
      2. Sélectionnez le nom de la connexion que vous souhaitez tester.
      3. Pour valider la configuration de la source de données, sélectionnez Tester le chargement de 20 enregistrements.
         Remarque :

         Si l’un des tests comporte un code d’erreur, un message ou un signe d’erreur, la connexion a échoué et un dépannage supplémentaire est requis.
      4. Définissez la tâche Tester les nouvelles connexions comme terminée en sélectionnant Marquer comme terminé.
6. Configurer les tâches d’importation planifiées.
   1. Pour la tâche Configurer les travaux planifiés dans la section Configurer des tâches d’importation planifiées , sélectionnez Configurer.
   2. Sélectionnez la tâche planifiée que vous souhaitez activer.
      Remarque :

      Par défaut, la tâche planifiée Équipements mobiles SG-Jamf est automatiquement définie sur Actif et exécute la tâche planifiée SG-Jamf Computer en tant que parent.
   3. Dans le formulaire Importation de données planifiée, vérifiez les valeurs de champ de la tâche planifiée et cochez la case Actif pour activer la tâche planifiée.

      Pour plus d'informations, consultez Schedule a data import.

   4. Sélectionnez Mettre à jour.
   5. Répétez les étapes 6.b pour chaque tâche planifiée d’importation 6.d de données.
   6. Définissez la tâche Configurer les travaux planifiés comme terminée en sélectionnant Marquer comme terminé dans la configuration guidée.