Configurer un webhook bidirectionnel pour le spoke Jira

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 4 minutes de lecture
  • Configurez un webhook auquel Jira vous abonner avec une URL de ServiceNow rappel.

    Avant de commencer

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

    Créer un jeton

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Dans le filtre 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 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 utilisé pour authentifier les demandes de webhook entrantes.

    Résultats

    Le jeton créé est utilisé pour authentifier les demandes de webhook entrantes.

    Enregistrer un Jira webhook dans ServiceNow

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Jira Webhooks > Registres de webhooks Jira.
    2. Cliquez sur Nouveau.
    3. Remplissez les champs du formulaire.
      Tableau 2. Formulaire du registre de webhooks 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 utilisé pour authentifier les demandes de webhook entrantes.
      Chemin d'accès Jira Chemin d’accès au 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. Choisissez la façon dont vous souhaitez authentifier les demandes de rappel et sélectionnez l’une des options.
      Type d’URL de rappel Description
      URL de rappel basée sur un jeton Utilise un jeton statique dans l’URL pour une authentification simple.
      URL de rappel basée sur HMAC Utilise le code d’authentification de message basé sur le hachage (HMAC) pour une sécurité renforcée et une authentification inviolable.
      Le système affiche l’URL de rappel basée sur un jeton ou l’URL de rappel basée sur HMAC en fonction de votre sélection.
    6. Copiez et enregistrez l’URL w ebhook callback.

    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 : 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 obtenir des instructions sur la création d’un webhook.
      Remarque :
      Si vous sélectionnez une URL de rappel basée sur HMAC lors de l’enregistrement d’un webhook, saisissez le jeton secret créé à partir de votre ServiceNow instance dans le champ Secret du webhook.
      Création de webhook de spoke Jira dans le portail Jira.
    4. Sélectionnez les événements associés qui doivent déclencher le 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. Consultez la rubrique 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 selon vos besoins.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La politique d’acheminement par défaut dans le module Politiques d’acheminement des webhooks Jira déclenche le flux secondaire Traiter les webhooks Jira et avertit l’application ServiceNow lorsque certains événements se produisent dans Jira. Consultez la section Jira Un spoke pour plus d’informations sur les champs pris en charge par la politique d’acheminement et les flux secondaires par défaut. 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 Tous > 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 en fonction de vos besoins et publiez-le. Consultez Création de flux secondaires pour en savoir plus sur la création et l’utilisation de flux secondaires et Jira Un spoke 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 du webhook Jira.
    6. Cliquez sur Nouveau.
    7. Remplissez 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 par défaut s’applique 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 en savoir plus 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 avertis de ne pas mettre à jour ou modifier directement les données de ces tables.

    Résultats

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