Gestion des sources d’événement externes

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 6 minutes de lecture

    • Créez et gérez des sources d’événements externes pour un spoke ou une application incluse dans le périmètre qui écoutent les événements se produisant dans une application en dehors ServiceNow de . Ensuite, vous pouvez créer des définitions de déclencheurs externes et les associer aux sources d’événements externes. Lorsque l’événement que vous spécifiez dans la définition du déclencheur externe se produit, il démarre un ou plusieurs flux sur votre ServiceNow instance.

    Avant de commencer

    Rôle requis : trigger_designer (peut créer, lire, mettre à jour ou supprimer des sources d’événements externes) et trigger_designer_read (peut effectuer des opérations en lecture seule sur les sources d’événements externes créées par le rôle trigger_designer).

    Confirmez que vous avez installé le module d’extension Générateur de déclencheur externe sur votre instance. Générateur de déclencheurs externes v1.0.3 est la dernière version disponible.

    Pourquoi et quand exécuter cette tâche

    Une source d’événement externe est un point de terminaison sur votre ServiceNow instance qui écoute un système ou une application en dehors de ServiceNow. Une fois que l’application externe ServiceNow a envoyé un événement à la source d’événement externe, elle active une définition de déclencheur pour démarrer un ou plusieurs flux. Par exemple, vous définissez une source d’événement externe pour un logiciel de suivi des problèmes qui communique avec une définition de déclencheur externe que vous avez définie. La définition de déclencheur externe écoute la source de l’événement et lance un flux lorsqu’un nouveau problème est créé dans le logiciel de suivi des problèmes. Les définitions de la source d’événement externe et du déclencheur sont définies sur votre ServiceNow instance. Une définition de déclencheur externe donne un ensemble de conditions qui indiquent à votre instance ServiceNow quand démarrer un flux.

    Créer une source d’événement externe

    Créez une source d’événement externe pour un spoke ou une application incluse dans le périmètre qui écoute les événements se produisant dans une application ou un système en dehors ServiceNow de . En fonction de la source d’événement externe, vous pouvez créer une définition de déclencheur externe qui reçoit une communication de la source d’événement externe et démarre un flux sur votre ServiceNow instance.

    Avant de commencer

    Rôle requis : trigger_designer (peut créer, lire, mettre à jour ou supprimer des sources d’événements externes) et trigger_designer_read (peut effectuer des opérations en lecture seule sur les sources d’événements externes créées par le rôle trigger_designer).

    Confirmez que vous avez installé le module d’extension Générateur de déclencheur externe sur votre instance.

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Studio de workflow.
    2. Cliquez sur l'onglet Intégrations.
    3. Cliquez sur le spoke.
      L’onglet Spokes est sélectionné par défaut. S’il n’est pas déjà sélectionné, confirmez que vous l’avez sélectionné.

      Sélection de spokes pour la création de sources d’événements externes.

    4. Sur le panneau de gauche, cliquez sur Sources de l’événement.
      Menu Sources de l’événement.
    5. Cliquez sur Créer une source d’événement.
    6. Dans le champ Nom de la source d’événement, attribuez un nom unique à la source d’événement externe.
    7. Facultatif : Dans le champ Description, entrez une description de la source d’événement externe.
      Écran Créer la source d’événement externe.
    8. Cliquez sur Créer une source d’événement.
      La source d’événement externe est créée à l’état de brouillon.
    9. Facultatif : Affichez la source d’événement externe à l’état de brouillon.
      1. Sélectionnez l’onglet de spoke.
        L’onglet Spoke est sélectionné.
      2. Sélectionnez l’onglet Brouillons .
        La source d’événement externe que vous avez créée s’affiche.
        Conseil :
        Si la source d’événement externe n’apparaît pas, actualisez la page, puis sélectionnez l’onglet Brouillons .
    10. Sous l’en-tête Authentification, sélectionnez la méthode d’authentification du webhook que l’application externe envoie à votre ServiceNow instance.
      Les méthodes d’authentification suivantes sont disponibles.
      • Élémentaire
      • OAuth
      • Hachage
      • Jeton
      Si vous choisissez la méthode d’authentification par hachage ou jeton, vous devez spécifier les informations fournies dans la table.
      Tableau 1. Spécifications d’authentification
      Méthode d'authentification Champ Description
      Élémentaire Option permettant de spécifier que les noms d’utilisateur et mots de passe envoyés par l’application externe seront authentifiés.
      OAuth Option permettant de spécifier le mécanisme OAuth qui sera utilisé pour authentifier les webhooks à partir de l’application externe.
      Hachage Emplacement d'authentification Option permettant de spécifier l’emplacement où l’application ou le système externe inclut le hachage lors de l’envoi du message. Les emplacements disponibles sont les suivants :
      • Paramètres de requête
      • En-tête
      Nom de paramètre Option permettant de spécifier le nom du champ dans lequel vous pouvez trouver le hachage.
      Algorithme de hachage Option permettant de spécifier l’algorithme à l’aide duquel le hachage est calculé. Les algorithmes disponibles sont les suivants :
      • HmacSHA256
      • HmacSHA384
      • HmacSHA512
      Préfixe Option permettant de spécifier une valeur qui peut être placée avant le hachage.
      Script d’utilitaire HMAC Option permettant de spécifier le script qui génère ou valide le hachage.

      Pour en savoir plus sur HMAC, reportez-vous à la section Configure HMAC - Token-based authentication.
      Jeton Emplacement d'authentification Option permettant de spécifier l’emplacement où le système externe inclut le jeton lors de l’envoi du message. Les emplacements disponibles sont les suivants :
      • Paramètres de requête
      • En-tête
      Nom de paramètre Option permettant de spécifier le nom du champ dans lequel vous pouvez trouver le jeton.
      Préfixe Option permettant de spécifier une valeur qui peut être antérieure au jeton.
    11. Cliquez sur Publier.
      Vous pouvez associer la source d’événement externe à une définition de déclencheur externe.

      Source d’événement externe publiée.

    12. Facultatif : Affichez la source d’événement externe publiée.
      1. Sélectionnez l’onglet de spoke.
        Onglet Spoke sélectionné.
      2. Sélectionnez l’onglet Publié .
      La source d’événement externe que vous avez publiée s’affiche.
      Conseil :
      Si la source d’événement externe n’apparaît pas, actualisez la page et sélectionnez l’onglet Brouillons .

    Que faire ensuite

    Créer un déclencheur externe enregistré et associez-le à la source d’événement externe que vous avez créée.

    Mettre à jour une source d’événement externe

    Mettez à jour une source d’événement externe qui est à l’état Brouillon ou Publié.

    Avant de commencer

    Rôle requis : trigger_designer (peut créer, lire, mettre à jour ou supprimer des sources d’événements externes) et trigger_designer_read (peut effectuer des opérations en lecture seule sur les sources d’événements externes créées par le rôle trigger_designer).

    Confirmez que vous avez installé le module d’extension Générateur de déclencheur externe sur votre instance.

    Pourquoi et quand exécuter cette tâche

    Vous pouvez mettre à jour toutes les informations d’une source d’événement externe à l’état brouillon, mais uniquement son nom et sa description à l’état Publié.

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Studio de workflow.
    2. Cliquez sur l'onglet Intégrations.
    3. Cliquez sur le spoke pour lequel la source d’événement externe est définie.
      L’onglet Spokes est sélectionné par défaut. Si elle n’est pas sélectionnée, confirmez que vous l’avez sélectionnée.

      Sélection de spokes pour la création de sources d’événements externes.

    4. Sur le panneau de gauche, cliquez sur Sources de l’événement.
      Menu Sources de l’événement.
    5. Pour mettre à jour une source d’événement à l’état brouillon, procédez comme suit.
      1. Cliquez sur l’onglet Brouillons .
      2. Cliquez sur la source d’événement externe que vous souhaitez mettre à jour.
      3. Cliquez sur le bouton avec des points de suspension ( icône avec des points de suspension pour mettre à jour la source d’événement externe.), puis cliquez sur Propriétés.
      4. Dans le formulaire Propriétés de la source de l’événement, mettez à jour les informations.
      5. Cliquez sur Mettre à jour.
        La source d’événement externe est mise à jour.
    6. Pour mettre à jour une source d’événement à l’état Publié, procédez comme suit.
      1. Cliquez sur l’onglet Publié .
      2. Cliquez sur la source d’événement externe que vous souhaitez mettre à jour.
      3. Cliquez sur le bouton avec des points de suspension ( icône avec des points de suspension pour mettre à jour la source d’événement externe.), puis cliquez sur Propriétés.
      4. Dans le formulaire Propriétés de la source de l’événement, mettez à jour les informations des champs suivants.
        • Nom de la source de l'événement
        • Description
      5. Cliquez sur Mettre à jour.
        La source d’événement externe est mise à jour.

    Supprimer une source d’événement externe

    Supprimez une source d’événement externe à l’état Brouillon ou Publié qui n’est pas associée à une définition de déclencheur externe.

    Avant de commencer

    Rôle requis : trigger_designer (peut créer, lire, mettre à jour ou supprimer des sources d’événements externes) et trigger_designer_read (peut effectuer des opérations en lecture seule sur les sources d’événements externes créées par le rôle trigger_designer).

    Confirmez que vous avez installé le module d’extension Générateur de déclencheur externe sur votre instance.

    Procédure

    1. Accédez à la Tous > Automatisation des processus > Studio de workflow.
    2. Cliquez sur l'onglet Intégrations.
    3. Cliquez sur le spoke pour lequel la source d’événement externe est définie.
      L’onglet Spokes est sélectionné par défaut. Si elle n’est pas sélectionnée, confirmez que vous l’avez sélectionnée.

      Sélection de spokes pour la création de sources d’événements externes.

    4. Sur le panneau de gauche, cliquez sur Sources de l’événement.
      Menu Sources de l’événement.
    5. Cliquez sur l’onglet Publié ou Brouillons .
    6. Cliquez sur la source d’événement externe que vous souhaitez supprimer.
    7. Cliquez sur le bouton avec des points de suspension ( Icône avec des points de suspension pour mettre à jour la source d’événement externe.), puis sélectionnez Propriétés.
    8. Cliquez sur Supprimer.
    9. Dans la boîte de dialogue Supprimer la source de l’événement, cliquez sur Supprimer.
      La source d’événement externe est supprimée.
      Remarque :
      Vous ne pouvez pas supprimer une source d’événement externe à laquelle un ou plusieurs déclencheurs externes sont associés.