Configurer et tester les webhooks

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • Configurez manuellement les webhooks dans Azure DevOps et testez-les.

    Configurer manuellement des webhooks dans Azure DevOps

    Configurez des webhooks dans Azure DevOps pour 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, administrateur Azure DevOps

    Pourquoi et quand exécuter cette tâche

    Vous pouvez également accéder à la configuration manuelle à partir de l'enregistrement de l'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 > Service Hooks et créez un NOUVEL ABONNEMENT AUX HOOKS DE SERVICE, dans Azure DevOps.
    3. Dans Vélocité de changement DevOps, sélectionnez Configurer manuellement lors de la configuration de l'instance de l'outil pour envoyer des données.
      Outil de configuration Azure DevOps
    4. Dans Vélocité de changement DevOps, copiez la valeur du 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 devient Copié, mais vous pouvez copier plusieurs fois.
      Configurer les webhooks manuellement dans Azure DevOps
    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 | artifact | orchestration | test | softwarequality }?toolId=23410545938c71d0db5bfe686cba1036&projectId=<project_sys_id>

      1. Sélectionnez l'une des options de l'outil {code | plan | artifact | 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 l'ID de votre projet Azure DevOps dans ServiceNow (colonne native_id 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 la valeur du 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 hooks de service, collez la valeur copiée du champ Jeton secret dans le format approprié.
      1. Utilisez ce format pour le champ Azure DevOps En-têtes HTTP :
        « jeton : <tokenValue> »
      2. Remplacez <tokenValue> par la valeur copiée du champ Jeton secret à partir des détails de connexion de l'instance ServiceNow pour Azure DevOps.
      Tableau 1. Copier les valeurs de champ
      Du champ Vélocité de changement DevOps Vers le champ Azure DevOps
      URL Webhook (modifiée) URL
      Jeton secret

      En-têtes HTTP

      Au format :

      jeton : <tokenValue>
      Configurer les webhooks manuellement dans Azure DevOps

    Tester les webhooks dans Azure DevOps

    Vous pouvez tester manuellement si les webhooks sont correctement configurés directement depuis Azure DevOps pour chaque projet.

    Avant de commencer

    Rôle requis : privilèges d'administrateur Azure DevOps

    Procédure

    1. Accéder à Azure DevOps et sélectionner le projet pour lequel vous souhaitez tester les webhooks.
    2. Accédez à la Paramètres du projet > Crochets de service.
      Pour chaque projet, Vélocité de changement DevOps crée des webhooks pour les événements suivants :
      • Version terminée
      • Code transmis par push
      • Mise en production créée
      • Déploiement de la mise en production terminé
      • État d'étape d'exécution modifié
      • É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 les détails de l'URL et de l'authentification.

      Détails du webhook configuré.

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

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

        Message de réussite lorsque le webhook est configuré correctement.

      • Si le webhook n'est pas configuré correctement, vous recevez un message Échec

        Message d'échec lorsque le webhook n'est pas configuré correctement.

        Pour corriger un webhook, vous pouvez essayer les options suivantes :
        • Reconfigurez les webhooks en sélectionnant Configurer dans la page d'enregistrement de projet dans Vélocité de changement DevOps. Cela reconfigurera tous les webhooks existants pour le projet.

        • Vérifiez si projectId et toolId sont corrects dans le champ URL. Vous trouverez les valeurs correctes dans la page d'enregistrement de l'outil dans Vélocité de changement DevOps.

          toolId et projectId dans l'URL.

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

          Champs d'authentification de base dans le webhook.

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

          Jeton dans le webhook.