Configurer un webhook bidirectionnel pour le spoke GitLab

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 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 concentrateur d’intégration
    • Activer le spoke GitLab
    • Rôle requis : admin

    Inscrire le webhook GitLab dans l’instance ServiceNow

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tout > GitLab Webhooks > Registres de 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 :
      Le secret est régénéré et mis à 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éé et GitLab son ID est renseigné dans ID de webhook.

    Que faire ensuite

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

    Personnaliser un webhook bidirectionnel dans le spoke GitLab

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

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    La politique d’acheminement par défaut dans les modules Politiques d’acheminement de webhook GitLab 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.
      Consultez Créer des flux secondaires pour plus d’informations sur la création et l’utilisation de flux secondaires et GitLab spoke pour plus d’informations sur les champs GitLab que la politique de routage par défaut prend en charge et les événements GitLab que les flux secondaires prennent en charge.
    5. Accédez à la Tout > GitLab Webhooks > Politiques d’acheminement de Webhook 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 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].
      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 dans ces tables.

    Résultats

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