Configurer un webhook pour le spoke Jenkins

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

    • Configurez une application Webhook pour recevoir les mises à jour requises de Jenkins sur votre ServiceNow instance.

    Avant de commencer

    Rôle requis : admin

    Créer une clé d’autorisation pour le Spoke Jenkins v2

    Créez une clé d’autorisation pour autoriser les demandes provenant de Jenkins.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tous > Définition du système > Scripts - Arrière-plan.
    2. Entrez cette commande dans le champ de texte Exécuter le script (JavaScript exécuté sur le serveur) :
      gs.info(GlideSecureRandomUtil.getSecureRandomString(32));
    3. Cliquez sur Exécuter le script.
    4. Copiez et enregistrez la valeur générée pour une utilisation ultérieure.
      Secret client ou clé d’autorisation

    Fournir une clé d’autorisation pour le webhook

    Autorisez les demandes de Jenkins en fournissant une clé d’autorisation pour le webhook dans votre ServiceNow instance.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Jenkins v2 > Détails du client de webhook.
    2. Cliquez sur Nouveau.
    3. Renseignez les valeurs suivantes sur le formulaire :
      Tableau 1. Formulaire Détails du client de webhook Jenkins
      Champ Description
      Clé d'autorisation Clé d’autorisation que vous avez générée. Consultez la section Créer une clé d’autorisation pour le Spoke Jenkins v2 pour plus d’informations.
      Nom Nom permettant d’identifier l’enregistrement client webhook.
    4. Cliquez sur Envoyer.

    Fournir une clé d’autorisation dans Jenkins

    Recevez des mises à jour de Jenkins en fournissant la clé d’autorisation dans Jenkins.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Connectez-vous à votre compte Jenkins.
    2. Cliquez sur la tâche pour laquelle vous souhaitez configurer votre webhook et ouvrez-la.
    3. Cliquez sur Configurer.
    4. Dans l’onglet Liaisons , cliquez sur Ajouter et sélectionnez Jenkins.

      Pour plus d’informations sur l’utilisation du module d’extension, consultez Liaison d’informations d’identification.

      Fournisseur d’informations d’identification Jenkins
    5. Remplissez les champs du formulaire.
      Tableau 2. Formulaire de fournisseur d’informations d’identification Jenkins
      Champ Description
      Genre Sélectionnez Texte secret.
      Clé secrète Saisissez la clé d’autorisation. Consultez la section Créer une clé d’autorisation pour le Spoke Jenkins v2 pour plus d’informations.
      ID Indiquez un identificateur unique pour identifier l’enregistrement.
    6. Cliquez sur Ajouter.
    7. Dans l’onglet Actions post-version , configurez la tâche et spécifiez le script pour recevoir les mises à jour sur votre ServiceNow instance.
      • Exemple de Windows script : curl « https://<nom-instance>.service-now.com/api/sn_jenkinsv2_spoke/jenkins_v2_webhook/build_status » -X POST -H « type-contenu :application/json » -H « jenkinsKey : %<ID> % » -d « {\"Job_Name\ » :\" %JOB_NAME %\ »,\"Job_Path » :\" %JOB_URL %\ »,\"Build_Number\ » :\" %BUILD_NUMBER %\"} »
      • Exemple de script Shell : curl « https://<nom-instance>.service-now.com/api/sn_jenkinsv2_spoke/jenkins_v2_webhook/build_status » -X POST -H « type-contenu :application/json » -H « jenkinsKey : ${<ID>} » -d « {\"Job_Name\ » :\"${JOB_NAME}\ »,\"Job_Path\ » :\"${JOB_URL}\ »,\"Build_Number\ » :\"${BUILD_NUMBER}\"} »
      Remarque :
      L’ID dans le script est l’ID que vous aviez fourni dans le formulaire Fournisseur d’informations d’identification Jenkins.
      Pour plus d’informations sur l’utilisation du module d’extension, consultez Tâche de post-version.
    8. Cliquez sur Appliquer.

    Fournir une description au flux secondaire

    Fournissez des descriptions conviviales aux flux secondaires dans le Spoke Jenkins v2.

    Avant de commencer

    Rôle requis : admin.

    Procédure

    1. Accédez à la Tous > Jenkins v2 > Flux secondaires de réponse au webhook.
    2. Cliquez sur Nouveau.
    3. Renseignez les valeurs suivantes sur le formulaire :
      Champ Description
      Description Description du flux secondaire.
      Flux secondaire Flux secondaire requis dans le Spoke Jenkins v2.
    4. Cliquez sur Envoyer.

    Fournir des réponses à la table de décision

    Fournissez des flux secondaires en réponse aux conditions mentionnées dans la table de décision. Lorsque les conditions spécifiées sont remplies, le flux secondaire associé est déclenché.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Définition du système > Tables de décision.
    2. Ouvrez l’enregistrement du spoke Jenkins v2.
    3. Dans l’onglet Décisions , cliquez sur Nouveau.
    4. Renseignez les valeurs suivantes sur le formulaire :
      Tableau 3. 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 Jenkins. Consultez la section Jenkins v2 Spoke pour plus d’informations sur les champs pris en charge.
      Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies
      1. Cliquez sur l’icône de recherche (icône de recherche).
      2. Sélectionnez le flux secondaire requis dans la liste Documents .
        Remarque :
        Assurez-vous que le nom de la table est Flux secondaire de réponse au webhook Jenkins v2 [sn_jenkinsv2_spoke_webhook_answer_subflow].
    5. Cliquez sur Envoyer.

    Personnaliser un webhook

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > Concepteur de flux > Concepteur.
    2. Cliquez sur Flux secondaires.
    3. Créez une copie du flux secondaire par défaut requis.
    4. Personnalisez le flux secondaire de réponse au webhook Jenkins : traitez le flux secondaire d’informations de version 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 Jenkins v2 Spoke pour plus d’informations sur les champs pris en charge par les politiques d’acheminement et les flux secondaires.
    5. Accédez à la Jenkins v2 > Flux secondaires de réponse au webhook.
    6. Cliquez sur Nouveau.
    7. Remplissez les champs du formulaire.
      Champ Description
      Description Description du flux secondaire.
      Flux secondaire Flux secondaire requis dans le Spoke Jenkins v2.
    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.
    9. Accédez à la Définition du système > Tables de décision.
    10. Ouvrez l’enregistrement du spoke Jenkins v2 .
    11. Dans l’onglet Décisions , cliquez sur Nouveau.
    12. Renseignez les champs suivants sur le formulaire :
      Tableau 4. 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 Jenkins. Consultez la section Jenkins v2 Spoke pour plus d’informations sur les champs pris en charge.
      Réponse Flux secondaire qui doit être déclenché lorsque les conditions spécifiées sont remplies
      1. Cliquez sur l’icône de recherche (icône de recherche).
      2. Sélectionnez le flux secondaire requis dans la liste Documents .
        Remarque :
        Assurez-vous que le nom de la table est Flux secondaire de réponse au webhook Jenkins v2 [sn_jenkinsv2_spoke_webhook_answer_subflow].
    13. Cliquez sur Envoyer.