Configurer un webhook bidirectionnel pour le spoke GitLab

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Configurez un webhook pour vous abonner à GitLab avec une URL de rappel ServiceNow.

    Avant de commencer

    • Demander un abonnement au Centre d’intégration
    • Activer le spoke GitLab
    • Rôle requis : administrateur

    Enregistrer le webhook GitLab dans l’instance ServiceNow

    Enregistrez GitLab dans ServiceNow pour notifier l’application ServiceNow lorsque certains événements se produisent dans GitLab.

    Avant de commencer

    Rôle requis : administrateur

    Procédure

    1. Accédez à la Tout > GitLab Webhooks > Registres Webhook GitLab.
    2. Pour récupérer le compte de webhooks GitLab existant, cliquez sur Obtenir tous les webhooks.
    3. Pour créer un webhook, cliquez sur Nouveau.
    4. Renseignez les champs suivants du formulaire :
      Champs Description
      Nom Nom du Webhook. Par exemple, Webhook de la tâche.
      Description Description de l’enregistrement.
      ID de projet Identificateur unique du projet pour lequel le webhook doit être créé.
      Déclencheur et SSL Événements des projets auxquels vous souhaitez vous abonner. Lorsque l’un de ces événements se produit, le webhook est déclenché.
    5. Cliquez sur le lien connexe Générer un jeton secret .
      Le jeton secret est généré et affiché. En outre, la date d’expiration du secret est renseignée dans Expiration du secret.
      Remarque :
      La clé secrète est régénérée et mise à jour tous les 30 jours. Ce secret est également mis à jour dans GitLab.
    6. Cliquez avec le bouton droit sur l'en-tête du formulaire, puis cliquez sur Enregistrer.
    7. Cliquez sur Créer un webhook.
      Le webhook est créé dans GitLab et son ID est renseigné dans l’ID du Webhook

    Que faire ensuite

    Pour mettre à jour les détails des webhooks ou modifier les événements abonnés, cliquez sur Mettre à jour le webhook.

    Personnaliser un webhook bidirectionnel dans le spoke GitLab

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

    Avant de commencer

    Rôle requis : administrateur

    Pourquoi et quand exécuter cette tâche

    La politique de routage par défaut dans les modules GitLab WebHook Routing Policies déclenche le flux secondaire GitLab pertinent et notifie l’application ServiceNow lorsque certains événements se produisent dans GitLab. 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 Tout > Concepteur de flux > Concepteur.
    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.
      Pour plus d’informations sur la création et l’utilisation de flux secondaires, consultez Création de flux secondaires et GitLab spoke pour plus d’informations sur les champs GitLab pris en charge par la politique de routage par défaut et les événements GitLab pris en charge par les flux secondaires.
    5. Accédez à la Tout > GitLab Webhooks > Politiques d’acheminement des webhooks GitLab.
      Cinq politiques d’acheminement sont disponibles avec le spoke. Vous pouvez les configurer selon vos besoins ou créer une politique d’acheminement.
    6. Pour créer une politique d’acheminement, cliquez sur Nouveau.
    7. Renseignez les champs du formulaire.
      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 Rechercher.
      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 GitLab.
      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 mis en garde contre la mise à jour ou la modification directe des données de ces tables.

    Résultats

    La politique d’acheminement et le flux secondaire sont créés.