---
sourceDocument: Xanadu : créer des intégrations avec des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Xanadu : créer des intégrations avec des applications

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Configurer un webhook

# Configurer un webhook {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

Configurez l'application Webhook pour recevoir les mises à jour requises de Jenkins à votre ServiceNow instance.

## Avant de commencer

Rôle requis : admin

## Créer une clé d'autorisation pour le Spoke Jenkins v2 {#ariaid-title2}

Créez une clé d'autorisation pour autoriser les demandes à partir de Jenkins.

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutDéfinition du systèmeScripts - 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.  
{#create-secret__steps_p3c_zbc_hlb}

## Fournir une clé d'autorisation pour le webhook {#ariaid-title3}

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

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Accédez à la ToutJenkins v2Détails du client de webhook.
2. Cliquez sur Nouveau.
3. Renseignez les valeurs suivantes sur le formulaire :  
   {#provide-authkey__table_ddb_ndc_hlb__entry__2}{#provide-authkey__sec-info}

   | Champ | Description |
   |-|-|
   | Clé d'autorisation | Clé d'autorisation que vous avez générée. Voir [Créer une clé d'autorisation pour le Spoke Jenkins v2](https://servicenow-prod.fluidtopics.net/OAq67Lse7WYaXKwP0QbjrQ#create-secret "Créez une clé d’autorisation pour autoriser les demandes à partir de Jenkins.") pour plus d'informations. |
   | Nom | Nom permettant d'identifier l'enregistrement client webhook. |
   [Tableau 1. Formulaire des détails du client de webhook Jenkins]

   {#provide-authkey__table_ddb_ndc_hlb}
4. Cliquez sur Envoyer.

## Fournir une clé d'autorisation dans Jenkins {#ariaid-title4}

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](https://plugins.jenkins.io/credentials-binding/).
5. Renseignez les champs du formulaire.  
   {#authkey-jenkins__table_rzp_ygc_hlb__entry__2}

   | Champ | Description |
   |-|-|
   | Genre | Sélectionnez Texte secret. |
   | Clé secrète | Saisissez la clé d'autorisation. Voir [Créer une clé d'autorisation pour le Spoke Jenkins v2](https://servicenow-prod.fluidtopics.net/OAq67Lse7WYaXKwP0QbjrQ#create-secret "Créez une clé d’autorisation pour autoriser les demandes à partir de Jenkins.") pour plus d'informations. |
   | ID | Fournir un identificateur unique pour identifier l'enregistrement. |
   [Tableau 2. Formulaire Fournisseur d'informations d'identification Jenkins]

   {#authkey-jenkins__table_rzp_ygc_hlb}
6. Cliquez sur Ajouter.
7. Dans l'onglet Actions post-génération , 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 << content-type :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 << content-type :application/json >> -H << jenkinsKey : ${<ID>} >> -d << {\"Job_Name\ >> :\"${JOB_NAME}\ >>,\"Job_Path\ >> :\"${JOB_URL}\ >>,\"Build_Number\ >> :\"${BUILD_NUMBER}\"} >>`

   {#authkey-jenkins__ul_prg_wmc_hlb}  
   Remarque :  
   L'ID dans le script est l'ID que vous avez fourni dans le formulaire Fournisseur d'informations d'identification Jenkins.
   Pour plus d'informations sur l'utilisation du module d'extension, consultez [Tâche post-génération](https://plugins.jenkins.io/postbuild-task/).
8. Cliquez sur Appliquer.

## Fournir une description au flux secondaire {#ariaid-title5}

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

### Avant de commencer

Rôle requis : admin.

### Procédure

1. Accédez à la ToutJenkins v2Flux secondaires de réponse au webhook.
2. Cliquez sur Nouveau.
3. Renseignez les valeurs suivantes sur le formulaire :  
   {#ans-subflow__table_jg5_3rc_hlb__entry__2}

   | Champ | Description |
   |-|-|
   | Description | Description du flux secondaire. |
   | Flux secondaire | Flux secondaire requis dans le Spoke Jenkins v2. |
   [ ]

   {#ans-subflow__table_jg5_3rc_hlb}
4. Cliquez sur Envoyer.

## Fournir des réponses à la table de décision {#ariaid-title6}

Fournissez des flux secondaires en tant que réponses 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 : administrateur

### Procédure

1. Accédez à la ToutDéfinition du systèmeTables 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 :  
   {#dec-table-ans__table_awj_xgv_z3b__entry__2}

   | 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 rubrique [Jenkins v2 Spoke](https://servicenow-prod.fluidtopics.net/EA1b3i5ylqS64h4FISyxvA "Gérez les versions, les utilisateurs, les paramètres et les tâches sur le serveur Jenkins. Récupérez les données Jenkins à utiliser dans un flux.") pour en savoir plus 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 Document. Remarque : Assurez-vous que le nom de la table est <kbd class="ph userinput">Flux secondaire de réponse au webhook Jenkins v2 [sn_jenkinsv2_spoke_webhook_answer_subflow].</kbd> {#dec-table-ans__ol_sdf_ftb_1jb} |
   [Tableau 3. Formulaire Décision]

   {#dec-table-ans__table_awj_xgv_z3b}
5. Cliquez sur Envoyer.

## Personnaliser un webhook {#ariaid-title7}

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

### Avant de commencer

Rôle requis : administrateur

### Procédure

1. Accédez à la ToutConcepteur de fluxConcepteur.
2. Cliquez sur Flux secondaires.
3. Créez une copie du flux secondaire par défaut requis.
4. Personnaliser le flux secondaire de réponse au webhook Jenkins : traitez le flux secondaire d'informations de version selon vos besoins et publiez-le.  
   Pour plus d'informations sur la création et l'utilisation de flux secondaires et [Jenkins v2 Spoke](https://servicenow-prod.fluidtopics.net/EA1b3i5ylqS64h4FISyxvA "Gérez les versions, les utilisateurs, les paramètres et les tâches sur le serveur Jenkins. Récupérez les données Jenkins à utiliser dans un flux.") sur les champs pris en charge par les politiques d'acheminement et les flux secondaires, consultez [Création de flux secondaires](https://www.servicenow.com/docs/access?context=subflows&version=xanadu&pubname=xanadu-build-workflows&ft:locale=en-US).
5. Accédez à la Jenkins v2Flux secondaires de réponse au webhook.
6. Cliquez sur Nouveau.
7. Renseignez les champs du formulaire.  
   {#cust-subflow-jenkins__table_m34_52d_hlb__entry__2}

   | Champ | Description |
   |-|-|
   | Description | Description du flux secondaire. |
   | Flux secondaire | Flux secondaire requis dans le Spoke Jenkins v2. |
   [ ]

   {#cust-subflow-jenkins__table_m34_52d_hlb}
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.
9. Accédez à la Définition du systèmeTables 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 du formulaire :  
    {#cust-subflow-jenkins__table_zhp_k2d_hlb__entry__2}

    | 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 rubrique [Jenkins v2 Spoke](https://servicenow-prod.fluidtopics.net/EA1b3i5ylqS64h4FISyxvA "Gérez les versions, les utilisateurs, les paramètres et les tâches sur le serveur Jenkins. Récupérez les données Jenkins à utiliser dans un flux.") pour en savoir plus 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 Document. Remarque : Assurez-vous que le nom de la table est <kbd class="ph userinput">Flux secondaire de réponse au webhook Jenkins v2 [sn_jenkinsv2_spoke_webhook_answer_subflow].</kbd> {#cust-subflow-jenkins__ol_sdf_ftb_1jb} |
    [Tableau 4. Formulaire Décision]

    {#cust-subflow-jenkins__table_zhp_k2d_hlb}
13. Cliquez sur Envoyer.