Configurer un webhook bidirectionnel pour le spoke Jira

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 à intégrer dans l’URL Webhook Jira .

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 de vérification de jeton

   Champ	Description
   Nom	Nom unique permettant d’identifier le jeton. Par exemple, un jeton Jira.
   Description	Description du jeton.
   Jeton	Jeton d’authentification. Ce jeton est chiffré et incorporé à l’URL.

Résultats

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

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 Tout > Jira Webhooks > Registres de webhook Jira.
2. Cliquez sur Nouveau.
3. Renseignez les champs du formulaire.

   Tableau 2. Formulaire du registre de webhook Jira

   Champ	Description
   Nom	Nom unique permettant d’identifier l’enregistrement. Par exemple, webhook Jira.
   Description	Description de l’enregistrement.
   Jeton	Jeton d’authentification. Ce jeton est chiffré et incorporé à l’URL. Par exemple, un 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 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.

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. 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 selon vos besoins.

Avant de commencer

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

La règle d’acheminement par défaut du 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 rubrique Jira Rayon pour plus d’informations sur les champs pris en charge par la politique d’acheminement par défaut et les flux secondaires. Pour utiliser d’autres champs dans votre flux secondaire personnalisé et personnaliser les conditions dans la politique d’acheminement, procédez comme suit.

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. Consultez Création de flux secondaires pour plus d’informations sur la création et l’utilisation de flux secondaires et Jira Rayon pour plus d’informations 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. 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 par défaut est applicable lorsque les conditions ne sont pas remplies. Cliquez sur l'icône de recherche ( ). Sélectionnez le flux secondaire requis dans la liste 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épondre	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.