Configurer Connecteur du graphe de services pour Jamf

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 9 minutes de lecture

    • Configurez les informations d’identification d’authentification et les travaux planifiés pour importer Jamf des données dans votre CMDBfichier .

    Avant de commencer

    Pour l’utiliser Connecteur du graphe de services, vous avez besoin d’un abonnement à une unité d’abonnement basée sur l’application Gestion des opérations informatiques Visibilité (ITOM) ou sur 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 des unités d’abonnement ServiceNow pour votre abonnement, pour les ressources informatiques gérées qui sont créées ou modifiées dans le CMDB , Connecteur du graphe de servicesmais qui ne sont pas encore gérées par Visibilité ITOM ou Détection ITOM, ces ressources augmenteront la consommation d’unités d’abonnement de cette application. Passez en revue votre consommation actuelle d’unités d’abonnement dans Visibilité ITOM ou Détection ITOM pour vous assurer de la capacité disponible.

    Dépendances et besoins :
    • L’application Integration Commons for CMDB Store, qui est automatiquement installée.
    • L’application de stockage Modèles de classe CI CMDB, qui est automatiquement installée. Consultez Application de stockage CMDB CI Class Models.
    • Module d’extension Gestion des licences ITOM (com.snc.itom.license). Un module d’extension sans licence qui contient la logique de calcul pour la consommation de SU si nécessaire. Pour plus d’informations, consultez Demander la détection.
    • Jamf Version 10.x de l’API classique.

    Rôles requis : admin

    Procédure

    1. Accédez à la Tout > Connecteurs du graphe de services > Jamf > Configuration.
    2. Sur la page Mise en route, sélectionnez Démarrer.
    3. Configurez les propriétés.
      1. Sur la page Connecteur du graphe de services pour Jamf, dans la section Configurer les propriétés, sélectionnez la tâche Configurer la longueur partielle maximale JSON de transformation.
      2. Pour la tâche Configurer la longueur partielle maximale JSON de transformation, sélectionnez Configurer.
      3. Sélectionnez le périmètre de l’application dans le sélecteur d’application.
      4. Sélectionnez Nouveau pour créer une propriété système.
      5. Dans le champ Nom , saisissez com.glide.transform.json.max-partial-length.
      6. Dans le champ Valeur , saisissez 65536.
        Remarque :
        Le champ Valeur est requis pour que la transformation fonctionne.
      7. Définissez la longueur partielle maximale du JSON de transformation de configuration sur terminé en sélectionnant Marquer comme terminé.
      8. Filtrez les applications personnelles.
        Remarque :
        Par défaut, SG-Jamf importe tous les enregistrements d’application. Pour importer uniquement des enregistrements d’applications gérés, définissez la valeur de la sn_jamf_integrate.import_managed_apps_only propriété sur vrai. En outre, l’utilisateur doit disposer de privilèges de lecture pour la catégorie Applications pour appareils mobiles dans Jamf.
        1. Pour la tâche Filtrer les applications personnelles, sélectionnez Configurer.
        2. Sélectionnez le nom de la propriété.
        3. Dans le champ Valeur , mettez à jour la valeur de faux à vrai.
        4. Définissez la tâche Filtrer les applications personnelles sur Terminée en sélectionnant Marquer comme terminée.
      9. Lors de l’utilisation de Jamf l’API Pro, de la Jamf version Pro 10.35 ou supérieure, ou des 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. Lors de l’utilisation de Jamf l’API Pro au lieu de l’API classique, sur la page Connexions JAMF, cochez la case Utiliser l’API Jamf Pro .
        3. Lorsque vous utilisez la Jamf version Pro 10.35 ou supérieure, cochez la case Jamf Pro 10.35 ou supérieure .
          Remarque :
          Si vous utilisez Jamf Pro 10.35 ou une version supérieure, cochez la case Jamf Pro 10.35 ou supérieure pour éviter de générer des erreurs. Lorsque la case Jamf Pro 10.35 ou supérieure est cochée, l’authentification par jeton de porteur est utilisée pour authentifier l’API Jamf . Sinon, l’authentification de base est utilisée.
        4. Sélectionnez Mettre à jour.
        5. Définissez la tâche Sélectionner la version JAMF Pro et l’API pour qu’elle soit terminée en sélectionnant Marquer comme terminé.
      10. Configurez les informations d’identification d’authentification Jamf .
        1. Pour la tâche Configurer les informations d’identification Jamf, sélectionnez Configurer.
        2. Renseignez 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 :
          L’utilisateur doit disposer de 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 les informations d’identification Jamf sur terminée en sélectionnant Marquer comme terminé.
      11. Configurez la Jamf connexion HTTP.
        1. Pour la tâche Configurer la connexion HTTP JAMF, sélectionnez Configurer.
        2. Renseignez 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.
          Actif Option permettant d’activer la connexion HTTP.
          Domaine Domaine qui contient la connexion.
          Générateur d'URL Option permettant au système de générer 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 MID Server 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 de l'hôte réussie. Si la connexion ne se produit pas pendant cette période, 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 de base ou votre Jamf adresse IP. 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 Pro, le champ Chemin d’accès Jamfde base doit être vide. Par conséquent, effacez n’importe quelle valeur dans le champ Chemin d’accès de base .
        3. Sélectionnez Mettre à jour.
        4. Définissez la tâche Configurer la connexion HTTP Jamf sur Terminée en sélectionnant Marquer comme terminé.
      12. Testez la connexion.
        1. Pour la tâche Tester la connexion , sélectionnez Configurer.
        2. 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.
        3. Définissez la tâche Tester la connexion pour qu’elle soit terminée en sélectionnant Marquer comme terminé.
    4. 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. Créez des sources de données pour la nouvelle Jamf connexion.
        1. Assurez-vous que vous disposez 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 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 comme terminée en sélectionnant Marquer comme terminé
      3. Créez une tâche d’importation planifiée pour la nouvelle Jamf connexion.
        1. Assurez-vous que vous disposez 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 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 d’accès à l’importation de données planifiée comme terminée en sélectionnant Marquer comme terminé.
      4. Ajoutez une autre 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 Ajouter une autre connexion, sélectionnez Configurer.
        2. Dans le Studio de workflow, sélectionnez Ajouter une connexion.
        3. Renseignez les champs du formulaire.
          Tableau 3. Formulaire Connexion
          Champ Description
          Nom de la connexion Nom d’affichage de la connexion.
          URL de connexion URL de connexion pour la nouvelle connexion.
          Nom d'utilisateur Nom d’utilisateur, informations d’identification pour la nouvelle connexion.
          Mot de passe Informations d’identification du mot de passe pour la nouvelle connexion.
        4. Sélectionnez Créer une connexion.
        5. Revenez à la configuration guidée et sélectionnez Marquer comme terminé.
      5. Facultatif : Configurez le Serveur MID pour la connexion que vous avez créée.
        1. Pour la tâche Configurer les Mid Servers, sélectionnez Configurer.
        2. Sélectionnez le nom de la connexion que vous avez créée.
        3. Cochez la case Utiliser un MID Server .
        4. Sélectionnez Mettre à jour.
        5. Définissez la tâche Configurer les Mid Servers comme terminée en sélectionnant Marquer comme terminé.
      6. Lors de l’utilisation de Jamf l’API Pro, de la Jamf version Pro 10.35 ou supérieure, ou des 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 true lors de l’utilisation de la Jamf version Pro 10.35 ou supérieure.
          Remarque :
          Lorsque la valeur de colonne Jamf Pro 10.35 ou supérieure est 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 pour qu’elle soit terminée 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 présente 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ée.
    5. Configurer les tâches d’importation planifiées.
      1. Pour la tâche Configurer les travaux planifiés dans la section Configurer les travaux d’importation planifiée , 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 comme Active et exécute la tâche planifiée Ordinateur SG-Jamf en tant que parent.
      3. Sur le formulaire Importation de données planifiée, vérifiez les valeurs de champ de 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 5.b pour chaque tâche planifiée pour l’importation 5.d de données.
      6. Définissez la tâche Configurer les travaux planifiés pour qu’elle soit terminée en sélectionnant Marquer comme terminé dans la configuration guidée.