Activer l’intégration avec un connecteur personnalisé

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 6 minutes de lecture

    • Intégrez le connecteur personnalisé en Gestion des événements ajoutant un webhook standard dans la console du connecteur personnalisé. Configurez le connecteur personnalisé en copiant la valeur d’URL affichée dans le presse-papiers et en l’utilisant pour configurer le webhook sur la console du connecteur personnalisé.

    Avant de commencer

    Assurez-vous que le module d’extension Gestion des événements Connecteurs (sn_em_connector) est installé sur l’instance Now Platform .

    Assurez-vous que des éléments de configuration pour les hôtes gérés par votre connecteur personnalisé existent dans l’instance Now Platform . Ces CI peuvent être physiques ou virtuels, et peuvent être créés manuellement ou détectés via la détection d'adresses IP ou Détection dans le cloud.

    Rôle requis : evt_mgmt_admin

    Pourquoi et quand exécuter cette tâche

    Configurez l’environnement Gestion des événements pour la collecte d’événements à partir de votre connecteur personnalisé en authentifiant le connecteur personnalisé en tant que source de données. Dans votre console de connecteur personnalisée, définissez votre Now Platform instance en tant que point de terminaison REST à l’aide d’un webhook standard.

    Procédure

    1. Dans l’onglet Parcourir les intégrations , sélectionnez la liste déroulante Toutes les intégrations , puis sélectionnez Personnalisée.
    2. Sélectionnez une vignette de connecteur personnalisée.
    3. Sur la page Fournir des détails , fournissez les détails du connecteur.
      1. Dans le champ Nom du connecteur , saisissez un nom d’intégration unique et significatif pour le type de connecteur.
      2. Facultatif : Dans le champ Description , entrez des informations pour vous aider à identifier ce type de connecteur.
      3. Facultatif : Dans la liste déroulante Groupe d’affectation , sélectionnez l’enregistrement de la table des groupes d’affectation contenant le groupe d’affectation du connecteur.
      4. Dans le champ Source , entrez le fournisseur et le protocole utilisés pour collecter des événements à partir de la source d’événement externe.

        Ces informations sont utilisées comme identificateur pour reconnaître les événements et vous permettre de reconnaître facilement la source des événements et des alertes après l’activation du connecteur.

    4. Facultatif : Définissez des balises à ajouter aux événements pour marquer et identifier les connecteurs de ce type et surveiller leurs alertes dans le Liste express.
      1. En regard du champ Balises , sélectionnez le signe plus.
      2. Dans le menu contextuel, saisissez une clé et une valeur de balise.
      3. Sélectionnez Ajouter.
    5. Facultatif : Faites glisser ou chargez un logo à partir de votre système pour l’afficher dans la vignette de votre connecteur.
      • Faites glisser une image dans la zone.
      • Sélectionnez Charger l’image , puis sélectionnez l’image dans votre système de fichiers.
      La taille maximale du fichier téléchargé est de 1 Mo.
    6. Déterminez si vous souhaitez connecter les événements directement à l’instance ITOM ou via un MID Server.
      • Pour terminer lesévénements de l’instanceITOM, sélectionnez Directement à l’instance ITOM.
      • Pour envoyer des événements via un MID Server, qui traite le message d’événement, puis transmet l’événement à l’instance, utilisezla commande Via le MID Server.

        Si le MID Server existe, sélectionnez-le parmi les MID Servers disponibles connectés à un écouteur d’événements. Si vous devez créer un MID Server, configurez l’extension MID Web Server ou le contexte du collecteur d’événements de service Web MID. Pour plus d'informations, consultez Configurer l'extension Serveur Web MID et Configurer le contexte du collecteur d'événements MID WebService.

    7. Sélectionnez Suivant.
    8. Sélectionnez une méthode pour collecter des données d’événement .
      Si vous disposez d’un système en direct pour diffuser des événements, sélectionnez Collecter des événements sources réels pour définir des champs. Si vous disposez d’un exemple JSON, sélectionnez Utiliser un exemple JSON pour mapper les champs.
      MéthodeDescription
      Collecter des événements sources réels pour définir des champs
      1. Sélectionnez Collecter des événements sources réels pour définir des champs afin d’augmenter la précision des événements et des alertes en utilisant plusieurs événements comme référence.
      2. Sélectionnez Copier dans le presse-papiers et copiez l’URL.
      3. Collez l’URL dans la configuration de votre webhook pour créer un webhook qui permet à votre connecteur tiers d’envoyer des événements à l’instance ServiceNow . En collectant des événements sources réels à partir de votre connecteur tiers, vous augmentez la précision des événements et des alertes en utilisant plusieurs événements comme référence pour définir les champs.
      4. Sélectionnez Rechercher des événements. Des fichiers JSON sont créés.
      Utiliser un exemple JSON pour mapper les champs
      1. Sélectionnez Utiliser un exemple JSON pour mapper les champs.
      2. Dans la boîte de dialogue Entrer la charge utile , copiez et collez un exemple de charge utile JSON pour créer et afficher le mappage pour mapper les champs.
      3. Sélectionnez Charger JSON.
      4. Sélectionnez Modifier ou coller un nouveau fichier JSON pour modifier le fichier JSON que vous avez chargé ou collez-en un nouveau.
    9. Sélectionnez Suivant.
    10. Sur la page Mapper les champs , permettez au système de créer correctement des événements sur les données entrantes en mappant les champs de votre exemple de code JSON aux ServiceNow champs.
      1. Copiez et collez l’exemple de code JSON extrait de votre charge utile JSON de connecteur personnalisé dans l’exemple de code JSON de custom_test colonne.
        Les informations de gravité et de clé de message sont automatiquement remplies pour vous faire gagner du temps et de l’énergie. La clé Message fournit l’identificateur correct des événements afin que la déduplication fonctionne correctement et qu’aucune alerte redondante ne soit générée, par exemple.
      2. Dans la colonne Noms des champs de connecteur, saisissez au moins une valeur qui correspond aux valeurs de gravité répertoriées dans la ServiceNow colonne du champ Gravité .

        Vous pouvez entrer la valeur de gravité à partir de l’exemple de code JSON. Pour définir une valeur de gravité, vous devez connaître la charge utile de votre connecteur tiers et les types de gravité pris en charge par le connecteur. Les valeurs de gravité des événements reçus doivent correspondre aux événements générés dans votre système.

    11. Sélectionnez Suivant et enregistrez.
    12. Dans l’écran Configurer le connecteur push , copiez la valeur du paramètre d’URL générée automatiquement dans le presse-papiers en sélectionnant Copier dans le presse-papiers.
    13. Facultatif : Dans la section Autres champs , dans la colonne de votre connecteur, fournissez des paramètres d’événement tiers qui ne sont pas requis, mais fournissent des informations supplémentaires sur l’événement.
      Si vous choisissez de ne pas fournir les informations facultatives, laissez le champ vide.
      1. Dans le champ Description , saisissez une description significative de l’alerte.
      2. Dans le champ Nom de la mesure , saisissez le nom d’une mesure qui vous permetd’associer des événements aux mesures de performances ou aux KPI qui ont déclenché l’alerte.
      3. Dans le champ Nœud , entrez une valeur de nœud à utiliser pour la liaison de CI.
      4. Dans le champ Heure de l’événement , saisissez l’heure de création de l’événement tiers.
        Si l’heure de l’événement n’est pas mappée, le système utilise l’heure de l’événement par défaut.
      5. Dans le champ Paramètres de l’heure de l’événement , sélectionnez le format d’heure et le fuseau horaire de l’événement.
        • Format d’heure : champ GlideDateTime au format UTC ou GMT avec une longueur maximale de 40 caractères.
        • Fuseau horaire : les heures sont stockées en heure universelle coordonnée (UTC) et s’affichent globalement en fonction du fuseau horaire du système.
    14. Sélectionnez Suivant.
    15. Dans l’écran Configurer le connecteur , dans le champ de valeur du paramètre d’URL , sélectionnez Copier dans le presse-papiers pour copier la valeur du paramètre d’URL générée automatiquement dans le presse-papiers.
    16. Collez l’URL dans la configuration de votre webhook et saisissez vos informations d’identification d’authentification de base dans la configuration du webhook du système de surveillance (telles que le nom d’utilisateur et le mot de passe).

      Le webhook permet à votre connecteur tiers d’envoyer des événements à l’instance ServiceNow .

    17. Activez et enregistrez le connecteur en sélectionnant Activer , puis OK dans la fenêtre contextuelle de confirmation.
      Vous pouvez afficher les détails du connecteur dans l’onglet Détails et vos mappages de champs dans l’onglet Mappage des champs .
    18. Facultatif : Vérifiez que le processus a été mené à bien et que les événements affluent dans le système en sélectionnant l’onglet Événements associés et en consultant les événements connexes.

    Résultats

    Une fois le connecteur activé, les événements commencent à circuler de votre console de connecteur personnalisée vers l’instance ServiceNow . Le module d’extension extrait les informations du message d’événement du connecteur personnalisé d’origine pour renseigner les champs d’événement requis et insère l’événement dans la base de données. Pour afficher les événements dans votre Now Platform instance, accédez à Tous les événements. Pour plus d'informations, consultez Afficher les événements.

    Que faire ensuite

    Pour créer une automatisation d’alerte, sélectionnez Ajouter une automatisation. Pour plus d'informations, consultez . La source et le groupe d’affectation sont renseignés automatiquement dans l’automatisation des alertes.