--- sourceDocument: Gestion des services IT Australie sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/it-service-management Release : - australia ft:locale : - fr-FR ft:publication_title : - Gestion des services IT Australie ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Intégrer GitHub à l'aide de Espace de travail # Intégrer GitHub à Vélocité de changement DevOps - Espace de travail {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 10 minutes de lecture Connectez-vous à votre instance GitHub à l'aide du playbook Espace de travail de changement DevOps pour détecter, configurer et importer les plans, les référentiels et les pipelines. ## Avant de commencer Effectuez les tâches spécifiées dans la rubrique [Premiers pas avec Vélocité de changement DevOps](https://servicenow-prod.fluidtopics.net/k9FqLJfUV8UBs~Bhtg1EOg "Découvrez le processus de configuration de Vélocité de changement DevOps que vous devez suivre avant de configurer les intégrations avec votre chaîne d'outils."). Rôle requis : sn_devops.admin ou sn_devops.tool_owner ## Procédure 1. Accédez à la Espaces de travailEspace de travail de changement DevOps et utilisez l'une des options suivantes pour ouvrir le playbook à intégrer GitHub. | Option | Étapes | | Page d'accueil | 1. Sélectionnez Connecter un outil. 2. Dans le modal Se connecter à un outil, sélectionnez l'outil dans la catégorie appropriée (Orchestration, Plan, Code ou Qualité logicielle). Par exemple, si vous souhaitez vous connecter à GitHub en tant qu'outil de codage, sélectionnez la catégorie Outils de codage. {#playbook-enter-github-instance-details__ol_e5j_4y1_fwb} | | Module Applications | 1. Sélectionnez Applications ( ![icône Applications.]()) dans la barre de navigation principale. 2. Sélectionnez une application existante ou créez-en une. Pour créer une application, consultez [Créer une application - Espace de travail](https://servicenow-prod.fluidtopics.net/EXtUjiCcmxeWWmZ8yvePUg "Créez des applications à l'aide de l'espace de travail Changement DevOps et associez-lui des pipelines, des plans et des référentiels."). 3. Dans le volet Actions recommandées, sélectionnez la carte Connecter un outil. 4. Dans le modal Se connecter à un outil, sélectionnez l'outil dans la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitHub en tant qu'outil de codage, sélectionnez GitHub dans la catégorie Code. {#playbook-enter-github-instance-details__ol_u24_mz1_fwb} | | Module Outils | 1. Sélectionnez Outils ( ![icône Outils.]()) dans la barre de navigation principale. 2. Dans la liste Aptitude, sélectionnez la catégorie appropriée. Par exemple, si vous souhaitez vous connecter à GitHub en tant qu'outil de codage, sélectionnez la catégorie Codage. 3. Sélectionnez Connecter un outil. 4. Dans le modal Se connecter à un outil, sélectionnez GitHub. {#playbook-enter-github-instance-details__ol_fjs_k1b_fwb} | |-|-| {#playbook-enter-github-instance-details__choicetable_m3t_ky1_fwb} Important : si vous souhaitez détecter et suivre des objets d'outil tels que des pipelines, des plans ou des référentiels lors de la connexion à l'outil, vous devez connecter votre outil à partir du module Application. 2. Dans le champ Nom de l'outil, saisissez un nom pour l'outil. 3. Sélectionnez Suivant. Le playbook DevOps s'ouvre pour vous aider à accomplir les tâches d'intégration. 4. Terminez la connexion et la configuration à l'aide du playbook. 1. Dans le champ Type d'informations d'identification, sélectionnez l'un des types d'informations d'identification suivants. * Authentification de base * OAuth 2.0 avec code d'autorisation * OAuth 2.0 avec jeton Web JSON (JWT) {#playbook-enter-github-instance-details__ul_uvd_2dg_fwb} 2. Saisissez les informations d'identification. {#playbook-enter-github-instance-details__table_uxp_shk_ybc__entry__1}{#playbook-enter-github-instance-details__table_uxp_shk_ybc__entry__3}{#playbook-enter-github-instance-details__table_uxp_shk_ybc__entry__5} | Authentification de base | Saisissez le nom d'utilisateur et le mot de passe/jeton d'accès de votre instance GitHub. | | OAuth 2.0 avec code d'autorisation | Sélectionnez un enregistrement d'informations d'identification existant OAuth 2.0 avec code d'autorisation ou créez-en un. Pour plus d'informations, consultez [Créer un enregistrement d'informations d'identification pour le fournisseur d'applications GitHub (code d'autorisation)](https://servicenow-prod.fluidtopics.net/5Puf2pALqMa0ZrX~GDGzCw#dev-ops-create-cred-github-auth "Créez un enregistrement d'informations d'identification auprès du fournisseur d'applications GitHub précédemment créé pour autoriser les actions."). | | OAuth 2.0 avec jeton Web JSON (JWT) | Pour vous connecter à l'aide d'OAuth 2.0 avec un jeton JWT, vous devez d'abord effectuer les opérations suivantes : * [Créer et configurer une application GitHub](https://servicenow-prod.fluidtopics.net/lOI5jdRgbdZ1TX40indt7g#dev-ops-config-github-acct-jwt "Créez une application GitHub personnalisée à partir de votre compte GitHub pour activer l'authentification OAuth 2.0 avec votre instance ServiceNow.") * [Générer le certificat Java KeyStore pour GitHub](https://servicenow-prod.fluidtopics.net/lOI5jdRgbdZ1TX40indt7g#dev-ops-generate-jks-cert-github "Générez un certificat Java KeyStore (JKS) pour l'authentification JWT.") * [Joindre le certificat GitHub Java KeyStore à votre instance](https://servicenow-prod.fluidtopics.net/lOI5jdRgbdZ1TX40indt7g#dev-ops-attach-jks-cert-github "Activez l'authentification du jeton Attribution titulaire JWT en joignant le certificat GitHub Java KeyStore (JKS) valide à votre instance ServiceNow.") {#playbook-enter-github-instance-details__ul_irn_hlk_ybc} Une fois les conditions préalables remplies, vous pouvez continuer avec l'activité du playbook Connexion de Vélocité de changement DevOps : 1. Sélectionnez l'option Utiliser un enregistrement d'informations d'identification JWT existant si vous souhaitez utiliser un enregistrement d'informations d'identification JWT déjà existant. Si cette option n'est pas sélectionnée, les champs permettant de créer un enregistrement d'informations d'identification JWT s'affichent. Passez à l'étape suivante. 2. Dans le champ Certificat JKS, sélectionnez un certificat JKS existant. Il s'agit du nom que vous avez saisi pour identifier de façon unique le fournisseur JWT. Les certificats JKS sont créés à l'aide de commandes shell pour créer un enregistrement sys_certificate. Pour plus d'informations, consultez [Créer une clé de signature JWT pour le certificat GitHub JKS](https://servicenow-prod.fluidtopics.net/lOI5jdRgbdZ1TX40indt7g#dev-ops-create-jwt-key-github "Créez une clé de signature JSON Web Token (JWT) à affecter à votre certificat GitHub Java KeyStore."). 3. Dans le champ Clé de signature, saisissez la clé de signature à affecter à votre certificat JKS. Il s'agit du mot de passe d'exportation saisi lors de la [génération du certificat JKS](https://servicenow-prod.fluidtopics.net/lOI5jdRgbdZ1TX40indt7g#dev-ops-generate-jks-cert-github "Générez un certificat Java KeyStore (JKS) pour l'authentification JWT."). 4. Dans le champ ID de l'application GitHub, sélectionnez l'ID votre application GitHub (disponible dans la section À propos de votre configuration d'application GitHub dans GitHub). L'image suivante présente un exemple de la section À propos d'une configuration d'application GitHub à partir de laquelle vous pouvez accéder à l'ID de l'application GitHub, l'ID client et le secret client. 5. Dans le champ ID client, sélectionnez l'ID client de votre application GitHub (disponible dans la section À propos de votre configuration d'application GitHub dans GitHub). 6. Dans le champ Secret client, sélectionnez le secret client de votre application GitHub (disponible dans la section À propos de votre configuration d'application GitHub dans GitHub). 7. Dans le champ URL de jeton, sélectionnez l'emplacement du point de terminaison du jeton que l'instance utilise pour récupérer et actualiser les jetons. Pour la version dans le cloud, saisissez : https://api.github.com/app/installations/<installation_id>/access_tokens. Pour la version d'entreprise, saisissez : https://<HOST_URL>/api/v3/app/installations/<installation_id>/access_tokens. Pour l'ID d'installation, accédez à la section d'installation de l'application dans votre configuration d'application GitHub dans GitHub et sélectionnez l'icône d'engrenage pour configurer votre application. L'ID d'installation se trouve dans l'URL de la page Web. Par exemple, https://github.com/settings/installations/\. {#playbook-enter-github-instance-details__ol_fpn_kkt_vyb} Si les informations d'identification OAuth sont créées en utilisant Applications GitHub - JWT, l'option Configure with GitHub App (Configurer avec l'application GitHub) est disponible sur la page d'enregistrement de l'outil. | |-|-| [ ] {#playbook-enter-github-instance-details__table_uxp_shk_ybc} Pour plus d'informations sur les informations d'identification OAuth 2.0, consultez [Configurer les informations d'identification OAuth 2.0 GitHub pour Vélocité de changement DevOps](https://servicenow-prod.fluidtopics.net/3cIjqMBxRiMatlC5P1CFLQ "Créez des informations d'identification OAuth 2.0 pour les applications GitHub ou les applications OAuth et utilisez-les pour connecter votre instance GitHub."). 3. **Facultatif :** Saisissez une valeur dans le champ Nom de la slug de l'application GitHub pour vérifier les besoins d'autorisation de l'outil avant de le connecter si vous avez créé vos informations d'identification OAuth 2.0 à l'aide des applications GitHub. Vous trouverez le nom de la slug de l'application sur la page des paramètres de votre application. 4. **Facultatif :** Si votre instance GitHub est liée à un Serveur MID, sélectionnez l'option Serveur MID et saisissez les détails correspondants. Pour plus d'informations sur le serveur MID, consultez [Sélection de Serveur MID](https://www.servicenow.com/docs/access?context=c_MIDServerSelector&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). Remarque : Le code d'autorisation OAuth et les types d'accord JWT sont pris en charge pour GitHub et GitHub Enterprise avec serveur MID. 5. Sélectionnez Connexion. 6. Des vérifications d'autorisation sont exécutées sur les informations d'identification que vous avez saisies. Les autorisations requises et les autorisations disponibles s'affichent. Si vous souhaitez saisir des informations d'identification disposant de meilleures autorisations, sélectionnez Saisir à nouveau les informations d'identification. Pour obtenir des informations détaillées sur toutes les autorisations requises, consultez la section relative aux autorisations GitHub dans [Autorisations requises pour les outils DevOps](https://servicenow-prod.fluidtopics.net/5dRJvaimwaDmpLNmhDgStA "Autorisations requises dans votre outil tiers pour vous connecter à Vélocité de changement DevOps."). Pour OAuth 2.0, si vous n'avez pas saisi le nom de la slug de l'application GitHub, l'outil est connecté sans vérification des besoins d'autorisation. 7. Sélectionnez Suivant. {#playbook-enter-github-instance-details__substeps_wdp_x1b_fwb} 5. Spécifiez l'accès à l'outil. 1. Si vous souhaitez contrôler l'accès à l'outil, ajoutez les groupes qui doivent y avoir accès dans le champ Maintenu par. Les tâches que ces utilisateurs des groupes peuvent effectuer dépendent du rôle qui leur est affecté. * Rôle Propriétaire de l'outil DevOps : peut afficher et modifier l'outil. * Rôle Propriétaire de l'application DevOps : peut afficher l'outil, associer, détecter et importer des données historiques et modifier les étapes du pipeline (le cas échéant) des objets de l'outil (tels que les plans, les référentiels et les pipelines). * Rôle Administrateur DevOps : peut modifier tous les outils. * Autres rôles DevOps : peuvent afficher l'outil. {#playbook-enter-github-instance-details__ul_csp_h5c_xwb} Remarque : Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs disposant du rôle Propriétaire de l'outil DevOps seront en mesure de modifier l'outil. 2. Si vous choisissez de contrôler l'accès à l'outil, l'option Tous les propriétaires d'applications peuvent visualiser et associer des objets d'outil aux applications peut être sélectionnée. Cette option permet à tous les utilisateurs disposant du rôle Propriétaire de l'application DevOps d'accéder à l'outil. Si cette option est sélectionnée, ils seront en mesure d'afficher, d'associer, de détecter et d'importer des données historiques et pourront également modifier les étapes du pipeline (le cas échéant) des objets de l'outil. 3. Sélectionnez Affecter. {#playbook-enter-github-instance-details__ol_slg_2tz_cxb} 6. Configurez automatiquement les webhooks dans votre instance GitHub pour envoyer des données à Vélocité de changement DevOps. Cette action configure les webhooks suivants : * push : pour collecter des validations, des branches et des balises de référentiel * workflow_job : pour collecter des données de pipeline * issues : pour collecter des données (élément de travail) sur les problèmes {#playbook-enter-github-instance-details__ul_k4d_sbb_fwb} Remarque : il est recommandé d'effectuer la configuration dans le cadre de cette tâche, car les notifications en temps réel sont idéales pour maintenir les informations à jour, notamment pour automatiser les demandes de changement. Sinon, vous pouvez configurer manuellement le webhook ultérieurement en activant l'interrogation nocturne pour extraire le système de données pour tous les référentiels ou pipelines suivis en définissant la propriété Enable Polling sur Oui. Sélectionnez les référentiels pour lesquels vous souhaitez configurer des webhooks, puis sélectionnez Configurer. Pour configurer manuellement des webhooks, sélectionnez Configurer manuellement. Consultez [Configurer manuellement des webhooks dans GitHub](https://servicenow-prod.fluidtopics.net/9Pqjw7eqxO95TfkY_cGGXQ "Configurez des webhooks dans GitHub pour envoyer des notifications de synchronisation à l'application Vélocité de changement DevOps.") pour plus d'informations. Important : * Si vous vous connectez à partir de la page d'accueil ou du module Outils, la connexion est terminée et vous êtes redirigé vers la page Résumé. * Si vous vous connectez à partir du module Applications, les référentiels et les pipelines disponibles sont détectés. Vous pouvez en suivre et en importer des données historiques. {#playbook-enter-github-instance-details__ul_yfy_zz1_bzb} 7. Sélectionnez les plans à suivre. 1. Sélectionnez les plans dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application. Une fois l'intégration de l'outil terminée, seuls les éléments de travail de ces plans sélectionnés sont importés automatiquement. 2. Sélectionnez Suivant. {#playbook-enter-github-instance-details__ol_zlk_1jc_bzb} 8. Sélectionnez les référentiels à suivre. 1. Sélectionnez les référentiels dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application. 2. Sélectionnez Suivant. 3. Si vous souhaitez importer des données de référentiel, sélectionnez la plage de dates, puis Soumettre. Vous pouvez importer jusqu'à 90 jours de données. Les workflows associés aux référentiels sont également importés. {#playbook-enter-github-instance-details__ol_r1g_3jc_bzb} 9. Sélectionnez les pipelines à suivre. 1. Sélectionnez les pipelines dont vous souhaitez suivre les mises à jour et que vous voulez associer à l'application. 2. Sélectionnez Suivant. 3. Pour chaque pipeline sélectionné, toutes les étapes sont importées pour la dernière exécution réussie. Dans l'activité Assign services to pipeline steps (Affecter des services aux étapes du pipeline), vous pouvez sélectionner les éléments suivants pour chaque étape du pipeline : 1. Type d'étape du pipeline : sélectionnez un type d'étape auquel vous souhaitez affecter un service. Conseil : indiquez au moins le type d'étape Prod deploy pour les étapes qui représentent le déploiement de production afin de permettre à DevOps d'identifier les exécutions de pipeline correctes en tant que déploiements de production. 2. Service : sélectionnez le service d'application CMDB auquel l'étape de pipeline est mappée. Le service d'application est mappé approximativement à l'environnement. Si vous utilisez la même étape de pipeline pour procéder au déploiement dans différents environnements, laissez le champ vide. Les informations sur le service permettent à DevOps d'identifier et de signaler des mesures opérationnelles telles que les incidents, les pannes, etc. {#playbook-enter-github-instance-details__ol_aty_ftk_zxb} 4. Sélectionnez Suivant. {#playbook-enter-github-instance-details__ol_sgy_rjc_bzb} 10. Dans la page Résumé, sélectionnez Afficher l'enregistrement de l'outil pour examiner les détails de l'outil GitHub connecté. Pour les pipelines GitHub Actions, vous devez effectuer des étapes supplémentaires telles que la création de secrets, la définition de la configuration de workflow dans GitHub, etc. Pour plus d'informations, consultez [Configurations de GitHub Actions](https://servicenow-prod.fluidtopics.net/a_kxYy1O63AL2_3feq19ng#github-actions-integration-with-devops "Informations de configuration sur GitHub Actions, notamment les clés secrètes, les workflows et les limitations."). ## Résultats Vous avez intégré avec succès votre outil GitHub à Vélocité de changement DevOps. ## Que faire ensuite Vous pouvez également détecter manuellement les plans une fois que votre outil GitHub est intégré. Comme il n'existe aucune entité de plan dans GitHub, les référentiels sont pris en compte pour détecter les enregistrements de plan correspondants dans ServiceNow. 1. Sur la page d'enregistrement de l'outil, sélectionnez Détecter pour détecter les plans. 2. Sélectionnez Configurer. Les plans sont suivis, et un webhook appelé issues est créé pour envoyer des notifications en temps réel pour les éléments de travail. {#playbook-enter-github-instance-details__ol_vkw_znt_qzb} Les informations suivantes sont mises à jour pour un élément de travail dans ServiceNow lorsque le problème correspondant est mis à jour dans GitHub. * Changement de l'intitulé du problème * Mise à jour des délégataires * Transfert d'un problème Remarque : lorsqu'un problème est transféré, il est marqué comme transféré dans le référentiel à partir duquel il est transféré et ouvert dans le référentiel vers lequel il est transféré. * Suppression d'un problème Remarque : lorsqu'un problème est supprimé dans GitHub, l'élément de travail correspondant n'est pas supprimé dans ServiceNow, mais l'état de l'élément de travail est marqué comme supprimé. {#playbook-enter-github-instance-details__ul_zcb_ptt_qzb} Si vous effectuez une mise à niveau, les plans de vos référentiels sont détectés via la tâche planifiée de découverte périodique ou via la découverte manuelle. Une fois vos plans détectés, vous pouvez activer la propriété sn_devops.track.github.issues pour reconfigurer en une seule fois tous les référentiels précédemment configurés afin que tous les plans soient suivis et que le webhook des problèmes soit créé pour les éléments de travail. Remarque : l'importation de l'historique des plans n'est pas prise en charge. **Tâches associées** * [Configurer des webhooks à partir de l'enregistrement d'outil](https://servicenow-prod.fluidtopics.net/9wo0xbW3PH8KdeZw68qvoQ "Configurez des webhooks à partir de l'enregistrement d'outil afin d'envoyer des données à Vélocité de changement DevOps une fois que l'outil est connecté.")