Configurer un webhook bidirectionnel

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

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

    Avant de commencer

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

    Créer un jeton

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Dans le filtre ionique de navigation, entrez 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 Vérification des jetons
      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 incorporé 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 : admin

    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 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 incorporé dans l’URL. Par exemple, jeton Jira.
      Chemin d'accès Jira Chemin d’accès du webhook. Par défaut, ce chemin d’accès 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 webhook callback.
    6. Copiez et enregistrez l’URL webhook callback.

    Résultats

    Le Jira webhook est inscrit 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 : admin

    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 URL.
      Consultez la documentation du portail Atlassian Developer pour savoir comment créer un webhook.

    Résultats

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

    Personnaliser un webhook bidirectionnel

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

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La politique de routage par défaut dans le module Politiques de routage 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. Consultez Jira Parlé pour plus d’informations sur les champs que la politique d’acheminement par défaut et les flux secondaires prennent en charge. 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. Sélectionnez des flux secondaires.
    3. Créer une copie du flux secondaire par défaut, Traiter les webhooks Jira.
    4. Personnalisez le flux secondaire en fonction de vos besoins et publiez-le.
      Reportez-vous à la section Création de flux secondaires pour en savoir plus sur la création et l’utilisation de flux secondaires et Jira Parlé pour obtenir des informations sur les champs pris en charge par la politique d’acheminement par défaut et les flux secondaires.
    5. Accédez à la Jira Webhooks > Politiques d’acheminement de WebHook Jira.
    6. Sélectionnez 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 s’applique lorsque les conditions ne sont pas remplies.
      1. Sélectionnez l’icône de recherche ( icône de recherche).
      2. Sélectionnez le flux secondaire requis dans la liste des documents .
        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. Sélectionnez Soumettre.
      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 dans ces tables.

    Résultats

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