Configurer et tester les webhooks

Configurez manuellement les webhooks et Azure DevOps testez-les.

Configurer manuellement les webhooks Azure DevOps

Configurez des webhooks pour Azure DevOps envoyer des notifications de synchronisation à l’application Vélocité de changement DevOps .

Avant de commencer

Rôle requis : sn_devops.admin ou sn_devops.tool_owner dans Vélocité de changement DevOps, Azure DevOps admin

Pourquoi et quand exécuter cette tâche

Vous pouvez également accéder à la configuration manuelle à partir de l’enregistrement d’outil Azure DevOps dans Vélocité de changement DevOps.

Procédure

1. Dans Azure DevOps, ouvrez le projet pour lequel vous configurez des webhooks.
2. Accédez à la Paramètres > Crochets de service et créez un NOUVEL ABONNEMENT AUX CROCHETS DE SERVICE, dans Azure DevOps.
3. Dans Vélocité de changement DevOps, choisissez Configurer manuellement lors de la configuration de l’instance d’outil pour envoyer des données.
   
4. Dans Vélocité de changement DevOps, copiez le champ URL Webhook à partir des détails de connexion de l’instance ServiceNow pour Azure DevOps.
   Remarque :

   Sélectionnez Copier dans le champ approprié pour copier la valeur dans le presse-papiers. L’étiquette du champ bascule sur Copié, mais vous pouvez copier plusieurs fois.

   
5. Modifiez l’URL Webhook copiée pour refléter les détails de votre outil, puis collez l’URL dans Azure DevOps.

   Par exemple :

   https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/{code | plan | artefact | orchestration | test | softwarequality } ?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

   1. Sélectionnez l’une des options de l’outil {code | plan | artefact | orchestration | test | softwarequality } pour correspondre à votre outil.
      Par exemple :

      https://myinstance.service-now.com/api/sn_devops/v2/devops/tool/orchestration?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

   2. Remplacez <project_sys_id> par votre Azure DevOps ID de projet dans ServiceNow (native_id colonne de la table sn_devops_project).
   3. Copiez l’URL modifiée dans le champ URL du NOUVEL ABONNEMENT AUX HOOKS DE SERVICE dans Azure DevOps.
6. Dans Vélocité de changement DevOps, copiez le champ Jeton secret à partir des détails de connexion de l’instance ServiceNow pour Azure DevOps.
7. Dans Azure DevOps, dans le champ En-tête du NOUVEL ABONNEMENT AUX CROCHETS DE SERVICE, collez le jeton secret copié au bon format.
   1. Utilisez ce format pour le champ Azure DevOps En-têtes HTTP :
      « jeton : <tokenValue> »
   2. Remplacez <tokenValue> par le jeton secret copié à partir des détails de connexion de l’instance ServiceNow pour Azure DevOps.

   Tableau 1. Copier les valeurs de champ

   Champ De Vélocité de changement DevOps	Champ À Azure DevOps
   URL Webhook (modifiée)	URL
   Jeton secret	En-têtes HTTP Au format : jeton : <tokenValue>

   

Tester les webhooks dans Azure DevOps

Vous pouvez tester manuellement si les webhooks sont configurés correctement directement à partir de Azure DevOps chaque projet.

Avant de commencer

Rôle requis : Azure DevOps privilèges admin

Procédure

1. Accédez au Azure DevOps projet pour lequel vous souhaitez tester les webhooks et sélectionnez-le.
2. Accédez à la Paramètres du projet > Crochets de service.
   Pour chaque projet, Vélocité de changement DevOps des webhooks sont créés pour ces événements :

   • Création terminée
   • Code transmis par push
   • Mise en production créée
   • Déploiement de la version terminé
   • État de l’étape d’exécution changé
   • Élément de travail créé
   • Élément de travail supprimé
   • Élément de travail restauré
   • Élément de travail mis à jour
3. Sélectionnez un webhook, puis Modifier.
4. Sélectionnez Suivant pour afficher l’URL et les détails de l’authentification.

   

5. Pour tester le webhook, sélectionnez Test.

   • Si le webhook est configuré correctement, vous recevrez un message Réussite .

     

   • Si le webhook est mal configuré, vous recevez un message d’échec .

     

     Pour corriger un webhook, vous pouvez essayer les options suivantes :

     • Reconfigurez les webhooks en sélectionnant Configurer sur la page d’enregistrement de projet dans Vélocité de changement DevOps. Cette opération reconfigurera tous les webhooks existants pour le projet.

     • Vérifiez si les toolId et projectId sont corrects dans le champ URL . Vous pouvez trouver les valeurs correctes sur la page d’enregistrement de l’outil dans DevOps Change Velocity.

       

     • Si vous utilisez les informations d’identification de l’utilisateur d’intégration pour l’authentification, vérifiez si les informations d’identification sont correctes dans les champs Nom d’utilisateur et Mot de passe d’authentification de base .

       

     • Si vous utilisez le jeton secret pour l’authentification, la valeur du jeton est masquée dans le champ Mot de passe d’authentification de base . Vous pouvez remplacer le jeton dans ce champ.