Configurer Connecteur du graphe de services pour ExtraHop

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture
  • Configurez un message REST et des travaux planifiés pour importer des données ExtraHop dans votre CMDB.

    Avant de commencer

    Important :
    ServiceNowhébergé Connecteur du graphe de services pour ExtraHop est désormais obsolète et n’est plus pris en charge ni disponible pour une nouvelle activation. Connecteur du graphe de services hébergé ExtraHop pour ExtraHop fournit la dernière expérience pour cette fonctionnalité. Pour en savoir plus, consultez l'article Processus de retrait [KB0867184] dans la base de connaissances Now Support.

    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). Pour plus d’informations, consultez Demander la détection.
    • Module d’extension ITOM Discovery License (com.snc.itom.discovery.license). Vous devez activer ce module d’extension.
    • Serveur MID installé sur Linux ou Windows, sauf si l’appliance ExtraHop est publiquement accessible.
    • Dispositif ExtraHop Discover avec la version 7.2 ou ultérieure du micrologiciel, avec un compte utilisateur disposant de privilèges illimités.
    • Pour vous connecter à l’application ExtraHop, configurez une clé API. Pour plus d’informations, consultez le Guide de l’API REST ExtraHop, plus précisément, consultez la section « Configuration requise pour l’API ExtraHop ».

    Rôles requis : admin

    Procédure

    1. Accédez à la Tout > Connecteur du graphe de services pour ExtraHop > Configuration.
    2. Sur la page Mise en route, cliquez sur Démarrer.
    3. Sur la page Connecteur du graphe de services pour ExtraHop, dans la section Configurer le message REST, sélectionnez la tâche Configurer le message REST ExtraHop.
    4. Configurez un message REST à utiliser lors de l’envoi de demandes à l’API ExtraHop.
      1. Sur la page suivante, dans la section Configurer le message REST ExtraHop, cliquez sur Configurer.
      2. Renseignez les champs du formulaire.
        Tableau 1. Formulaire Message REST
        Champ Description
        Nom Nom descriptif de ce message REST. Ce champ est automatiquement défini.
        Point de terminaison URL du point de terminaison de l’API du service web. Définissez le champ sur une URL de base. Par exemple, https://myextrahop.com.
        Remarque :
        La mise à jour de l’URL de base du point de terminaison met également à jour les URL de base pour toutes les méthodes HTTP associées au message REST ExtraHop. Dans l’onglet de demande HTTP , mettez à jour l’en-tête d’autorisation pour utiliser votre clé API dans le champ Valeur .
        Description Description de ce message REST. Ce champ est automatiquement défini.
        Application Application contenant ce message. Ce champ est automatiquement défini.
        Type d'authentification Type d’authentification à appliquer aux requêtes HTTP. Ce champ est automatiquement défini.
        Activer l'authentification réciproque Option permettant d’utiliser l’authentification multiple en authentifiant les requêtes HTTP. L’authentification réciproque ne peut pas être utilisée avec un Serveur MID.
      3. Cliquez sur Mettre à jour si nécessaire.
      4. Dans la section Configurer la tâche de message REST ExtraHop, cliquez sur Marquer comme terminé.
    5. Testez la connexion à l’API ExtraHop Computer.
      1. Dans la section de la tâche Tester la connexion de l’ordinateur, cliquez sur Configurer.
      2. Renseignez les champs du formulaire.
        Tableau 2. Formulaire Méthode HTTP
        Champ Description
        Nom Identificateur unique pour cette méthode HTTP. Ce champ est automatiquement défini.
        Point de terminaison URL vers le point de terminaison de l’API de service Web
        Utiliser un serveur MID Serveur MID qui envoie cette demande HTTP. L’utilisation d’un serveur MID n’est pas compatible avec l’authentification réciproque.
        Message REST Enregistrement de message REST sur lequel cette méthode est basée. Ce champ est automatiquement défini.
        Méthode HTTP Méthode HTTP implémentée par cette méthode. Ce champ est automatiquement défini.
        Application Application contenant cette méthode. Ce champ est automatiquement défini.
        Type d'authentification Type d’authentification à appliquer aux requêtes HTTP.
        Activer l'authentification réciproque Option permettant d’utiliser l’authentification multiple en authentifiant les requêtes HTTP. L’authentification réciproque ne peut pas être utilisée avec un Serveur MID.
      3. Sélectionnez l’onglet de demande HTTP et renseignez le champ Utiliser un serveur MID .
      4. Cliquez sur l’onglet Authentification, puis sur le lien connexe Tester .
        Le test de la connexion prend quelques instants. Lorsque le test est terminé, la page est actualisée et affiche les résultats du test.
      5. Sélectionnez Marquer comme terminé.
        Remarque :
        La connexion aboutit si le champ État HTTP est défini sur 200. En cas d’erreur dans le champ Message d’erreur , la connexion a échoué et un dépannage supplémentaire est requis.
      6. Cliquez sur Mettre à jour si nécessaire.
      7. Dans la section de la tâche Tester la connexion de l’ordinateur, cliquez sur Marquer comme terminé.
    6. Testez la connexion à l’API Création d’activité du réseau ExtraHop.
      1. Dans la section Tester l’activité du réseau Créer une tâche de connexion, cliquez sur Configurer.
      2. Renseignez les champs du formulaire.
        Tableau 3. Formulaire Méthode HTTP
        Champ Description
        Nom Identificateur unique pour cette méthode HTTP.
        Point de terminaison URL vers le point de terminaison de l’API de service Web
        Utiliser un serveur MID Serveur MID qui envoie cette demande HTTP. L’utilisation d’un serveur MID n’est pas compatible avec l’authentification réciproque.
        Message REST Message REST sur lequel cette méthode est basée. Ce champ est automatiquement défini.
        Méthode HTTP Méthode HTTP implémentée par cette méthode. Ce champ est automatiquement défini.
        Application Application contenant cet enregistrement. Ce champ est automatiquement défini.
        Type d'authentification Type d’authentification à appliquer aux requêtes HTTP. Ce champ est automatiquement défini.
        Activer l'authentification réciproque Option permettant d’utiliser l’authentification multiple en authentifiant les requêtes HTTP. L’authentification réciproque ne peut pas être utilisée avec un Serveur MID.
      3. Cliquez sur l’onglet Authentification, puis sur le lien connexe Tester .
        Le test de la connexion prend quelques instants. Lorsque le test est terminé, la page est actualisée et affiche les résultats du test.
      4. Sélectionnez Marquer comme terminé.
        Remarque :
        La connexion aboutit si le champ État HTTP est défini sur 200. En cas d’erreur dans le champ Message d’erreur , la connexion a échoué et un dépannage supplémentaire est requis.
      5. Cliquez sur Mettre à jour si nécessaire.
      6. Dans la section Tester l’activité du réseau Créer une tâche de connexion, cliquez sur Marquer comme terminé.
    7. Configurer les tâches d’importation planifiées.
      1. Sur la page Connecteur du graphe de services pour ExtraHop, dans la section Configurer des tâches d’importation planifiées, sélectionnez la tâche Configurer la tâche planifiée par ordinateur.
      2. Dans la section Configurer l’ordinateur, cliquez sur Configurer.
      3. Renseignez les champs du formulaire.
        Tableau 4. Formulaire d’importation de données planifiée
        Champ Description
        Nom Nom de la tâche planifiée.
        Source de données Enregistrement de la source de données qui définit les données à importer.
        Exécuter en tant que Option permettant d’exécuter la tâche planifiée avec les informations d’identification de l’utilisateur spécifié.
        Actif Option permettant d’activer la tâche planifiée. Sélectionnez cette option.
        Importation simultanée Fonction qui charge les données à partir de plusieurs jeux d’importation. La fonction traite et transforme ensuite les données simultanément.
        Méthode de partition Méthode de partition du jeu d’importations simultanées.
        Taille de la partition Importez la taille définie pour une planification anticipée.
        Exécuter le script avant importation Option permettant de spécifier un script à exécuter avant l’exécution de l’importation.
        Exécuter le script après importation Option permettant de spécifier un script à exécuter après l’importation.
        Application Application contenant cette tâche planifiée.
        Exécuter Fréquence d’exécution de l’importation.
        Conditionnel Conditions dans lesquelles cette tâche est exécutée.
      4. Cliquez sur Mettre à jour si nécessaire.
      5. Dans la section Configurer l’ordinateur, cliquez sur Marquer comme terminé.
    8. Configurez la tâche planifiée Activité du réseau.
      1. Sur la page Connecteur du graphe de services pour ExtraHop, dans la section Configurer des tâches d’importation planifiée, sélectionnez la tâche planifiée Configurer l’activité du réseau.
      2. Dans la section de tâche de tâche planifiée Configurer l’activité du réseau, cliquez sur Configurer.
      3. Renseignez les champs du formulaire.
        Tableau 5. Formulaire d’importation de données planifiée
        Champ Description
        Nom Nom de la tâche planifiée.
        Source de données Enregistrement de la source de données qui définit les données à importer.
        Exécuter en tant que Option permettant d’exécuter la tâche planifiée avec les informations d’identification de l’utilisateur spécifié.
        Actif Option permettant d’activer la tâche planifiée. Sélectionnez cette option.
        Importation simultanée Fonction qui charge les données à partir de plusieurs jeux d’importation. La fonction traite et transforme ensuite les données simultanément.
        Méthode de partition Méthode de partition du jeu d’importations simultanées.
        Taille de la partition Importez la taille définie pour une planification anticipée.
        Exécuter le script avant importation Option permettant de spécifier un script à exécuter avant l’exécution de l’importation.
        Exécuter le script après importation Option permettant de spécifier un script à exécuter après l’importation.
        Application Application contenant cette tâche planifiée.
        Exécuter Fréquence d’exécution de l’importation.
        Conditionnel Conditions dans lesquelles cette tâche est exécutée.
      4. Cliquez sur Mettre à jour si nécessaire, puis sur Marquer comme terminé.