Configurer un webhook bidirectionnel pour le spoke GitHub

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • Configurez le webhook auquel GitHub vous devez vous abonner avec une ServiceNow URL de rappel.

    Avant de commencer

    • Demander un Centre d'intégration abonnement
    • Activez le GitHubSpoke
    • Rôle requis : admin

    Enregistrer GitHub un webhook dans ServiceNow

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Webhooks GitHub > Registres de webhooks GitHub.
    2. Cliquez sur Nouveau.
    3. Remplissez les champs du formulaire.
      Tableau 1. Formulaire du registre Webhook GitHub
      Champ Description
      Nom Nom unique permettant d’identifier l’enregistrement. Par exemple, webhook GitHub.
      Description Description de l’enregistrement.
    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 de rappel Webhook et le secret Webhook.

      Valeurs de l’URL de rappel Webhook et du secret Webhook générés.

    6. Copiez et enregistrez les valeurs de l’URL de rappel Webhook et du Secret Webhook.

    Résultats

    Le GitHub webhook est enregistré dans votre ServiceNow instance.

    Ajouter une URL de rappel dans GitHub

    Fournissez une URL de rappel Webhook dans le GitHub compte pour créer un Webhook.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Connectez-vous à votre compte GitHub.
    2. Accédez au référentiel requis.
    3. Sélectionnez Paramètres.
    4. Sur le panneau de gauche, sélectionnez Webhooks.
    5. Sélectionnez Ajouter un webhook.
    6. Saisissez l’URL de rappel Webhook dans l’URL de la charge utile et le secret dans le secret.

      Voir le GitHub Développeur Documentation pour obtenir des instructions sur la création et la configuration d’un webhook.

      Remarque :
      GitHubSpoke Prend en charge la charge utile application/JSON . Configurez le GitHub webhook en conséquence. Voir le GitHub Développeur Documentation pour obtenir des instructions sur la création et la configuration d’un webhook.

    Résultats

    L’URL de rappel est ajoutée au GitHub compte. Vous pouvez créer des politiques d’acheminement et des flux secondaires selon vos besoins. Reportez-vous à la section Personnaliser un webhook bidirectionnel pour plus d’informations sur la création de nouvelles politiques d’acheminement et de flux secondaires.

    Personnaliser le webhook bidirectionnel dans le GitHubSpoke

    Créez une politique d’acheminement et un flux secondaire de webhook selon vos besoins dans le GitHubSpoke .

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La stratégie d’acheminement par défaut dans les modules GitHub WebHook Routing Policies déclenche le flux secondaire pertinent GitHub et avertit l’application ServiceNow lorsque certains événements se produisent dans GitHub. Consultez la rubrique GitHub Rayon pour plus d’informations sur les GitHub champs pris en charge par la politique d’acheminement par défaut et les GitHub événements pris en charge par 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 Tous > Automatisation des processus > Studio de workflow.
    2. Cliquez sur Flux secondaires.
    3. Créez une copie du flux secondaire requis.
    4. Personnalisez le flux secondaire requis selon vos besoins et publiez-le.
      Voir Création de flux secondaires pour plus d’informations sur la création et l’utilisation de flux secondaires, et GitHub Rayon pour plus d’informations sur les GitHub champs pris en charge par la politique d’acheminement par défaut et les GitHub événements pris en charge par les flux secondaires.
    5. Accédez à la Webhooks GitHub > Politiques d’acheminement du webhook GitHub.
    6. Cliquez sur Nouveau.
    7. Remplissez les champs du formulaire.
      Tableau 2. 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.
      Condition Conditions à remplir lorsque les événements requis se produisent dans GitHub. Consultez la rubrique GitHub Rayon 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
      1. Cliquez sur l’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].
    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 d’acheminement et le flux secondaire sont créés.