Configurer un webhook bidirectionnel pour le spoke Jira

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

    • Configurez un webhook auquel vous Jira abonner avec une ServiceNow URL de rappel.

    Avant de commencer

    • Demander un Hub d'intégration abonnement
    • Activer le spoke Jira
    • Rôle requis : administrateur

    Créer un jeton

    Créez un jeton à incorporer dans l’URL Webhook Jira .

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Dans le filtre ionique de navigation, saisissez token_verification.list.
      Le système affiche les enregistrements dans la table Vérifications des jetons.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 1. Formulaire de vérification de jeton
      Champ Description
      Nom Nom unique permettant d’identifier le jeton. Par exemple, jeton Jira.
      Description Description du jeton.
      Jeton Jeton d’authentification. Ce jeton est chiffré et intégré dans l’URL.

    Résultats

    Le jeton est créé pour être incorporé dans l’URL Webhook Jira .

    Enregistrer un Jira webhook dans ServiceNow

    Enregistrez un Jira webhook dans ServiceNow pour notifier l’application ServiceNow lorsque certains événements se produisent dans Jira.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > Jira Webhooks > Registres Webhook Jira.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs du formulaire.
      Tableau 2. Formulaire du registre Webhook Jira
      Champ Description
      Nom Nom unique permettant d’identifier l’enregistrement. Par exemple, le webhook Jira.
      Description Description de l’enregistrement.
      Jeton Jeton d’authentification. Ce jeton est chiffré et intégré dans l’URL. Par exemple, jeton Jira.
      Chemin d'accès Jira Chemin d’accès du webhook. Par défaut, ce chemin est défini sur api/sn_jira_spoke/jira_webhook_callbacks/wh_entry.
    4. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    5. Cliquez sur URL de rappel.
      Le système affiche l’URL de retour webhook c.
    6. Copiez et enregistrez l’URL du retour.

    Résultats

    Le Jira webhook est enregistré dans votre ServiceNow instance.

    Ajouter une URL de rappel dans Jira

    Fournissez une URL de rappel webhook dans votreJira compte Atlassian pour créer un webhook.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Connectez-vous à votre Jira compte Atlassian.
    2. Créez un webhook dans votre compte Atlassian.
    3. Saisissez l’URL de rappel webhook dans le champ d’URL .
      Consultez la documentation du portail Atlassian Developer pour obtenir des instructions sur la création d’un webhook.

    Résultats

    L’URL de rappel est ajoutée à votre Jira compte Atlassian. Vous pouvez créer des politiques d’acheminement et des flux secondaires selon vos besoins. Reportez-vous à la rubrique Personnaliser un webhook bidirectionnel pour en savoir plus sur la création de nouvelles politiques d’acheminement et de flux secondaires.

    Personnaliser un webhook bidirectionnel

    Créez une politique d’acheminement de webhook et un flux secondaire selon vos besoins.

    Avant de commencer

    Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    La politique de routage par défaut dans le module Politiques d’acheminement de Webhook Jira déclenche le flux secondaire Traiter les webhooks Jira et notifie l’application ServiceNow lorsque certains événements se produisent dans Jira. Pour plus d’informations sur les champs pris en charge par la politique d’acheminement et les flux secondaires par défaut, reportez-vous Jira Rayon à la section Pour utiliser d’autres champs dans votre flux secondaire personnalisé et personnaliser les conditions de la politique d’acheminement, effectuez les étapes suivantes.

    Procédure

    1. Accédez à la Tout > Concepteur de flux > Concepteur.
    2. Cliquez sur Flux secondaires.
    3. Créez une copie du flux secondaire par défaut, Traiter les webhooks Jira.
    4. Personnalisez le flux secondaire selon vos besoins et publiez-le. Pour plus d’informations sur la création et l’utilisation de flux secondaires, consultez Création de flux secondaires et Jira Rayon sur les champs pris en charge par la politique d’acheminement et les flux secondaires par défaut.
    5. Accédez à la Jira Webhooks > Politiques d’acheminement de WebHook Jira.
    6. Cliquez sur Nouveau.
    7. Renseignez les champs du formulaire.
      Tableau 3. Formulaire Décision
      Champ Description
      Étiquette Étiquette unique pour identifier la politique d’acheminement.
      Réponse par défaut Option permettant de spécifier s’il s’agit de la réponse par défaut. La réponse pardéfaut est applicable lorsque les conditions ne sont pas remplies.
      1. Cliquez sur l'icône de recherche ( icône de recherche).
      2. Sélectionnez le flux secondaire requis dans la liste Document .
        Remarque :
        Assurez-vous que le nom de la table est Flux [sys_hub_flow].
      Condition Conditions à remplir lorsque les événements requis se produisent dans Jira. Reportez-vous à Jira Webhooks pour plus d’informations sur les champs pris en charge.
      Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies.
    8. Cliquez sur Envoyer.
      Remarque :
      Ces politiques d’acheminement sont enregistrées dans les tables de décision. Les utilisateurs sont mis en garde contre la mise à jour ou la modification directe des données de ces tables.

    Résultats

    La politique de sortie et le flux secondaire sont créés.