GitHub Un spoke

Demander des applications dans l'App Store

Visitez le ServiceNow Store pour afficher toutes les applications disponibles et pour obtenir des informations sur la soumission de demandes à la boutique. Pour obtenir des informations sur les notes de publication cumulatives pour toutes les applications publiées, consultez les ServiceNow Store notes de publication relatives à l'historique des versions.

Abonnement à Centre d'intégration

Ce spoke requiert un abonnement au Centre d'intégration. Pour plus d'informations, consultez Calendriers juridiques - Vue d'ensemble du Centre d'intégration.

Version de spoke

GitHub Spoke v3.5.2 est la dernière version.

Versions prises en charge

Ce spoke a été conçu pour GitHub la version v3 de l’API, mais peut être compatible avec les versions ultérieures.

Exigences relatives au spoke

GitHub compte
Utilisateur avec les informations d’identification de l’administrateur
Jeton pour authentifier l’instance ServiceNow

Voir le GitHub documentation pour obtenir des instructions sur la création d’un GitHub compte et la génération d’un jeton.

GitHub Module de webhooks

Des webhooks bidirectionnels peuvent être configurés pour être avertis des événements requis. La politique d’acheminement définit les conditions qui doivent être remplies pour notifier l’application ServiceNow . Ces conditions sont basées sur les événements GitHub pour lesquels vous souhaitez être notifié. Lorsque les conditions sont remplies, la politique d’acheminement déclenche le flux secondaire associé, qui à son tour automatise les GitHub tâches.

Les webhooks bidirectionnels nécessitent une configuration séparée et peuvent être utilisés indépendamment sans utiliser les actions de spoke. Par défaut, l’application GitHub Webhooks est disponible dans le GitHub Spoke et comporte les modules suivants :

GitHub Registres Webhook
GitHub Politiques d’acheminement de WebHook

Utilisez le GitHub module Registres Webhook pour affecter un jeton et fournir le chemin d’accès de l’API. Vous devez générer une URL de rappel ici et fournir cette URL dans GitHub. Une politique d’acheminement par défaut est fournie dans le module Politiques d’acheminement GitHub WebHook. La politique d’acheminement par défaut prend en charge ces GitHub champs :


Champs pris en charge GitHub
Action	Créateur de la carte de projet	Réf
Référence de base	Note sur la carte de projet	Type de référence
Corps du commentaire de validation	Précédente note sur la carte de projet	Actifs de mise en production
Heure de création du commentaire de validation	Heure de mise à jour de la carte de projet	Auteur de la mise en production
Chemin du commentaire de validation	Heure de création de la colonne de projet	Corps de la mise en production
Heure de mise à jour du commentaire de validation	Nom de la colonne de projet	Heure de création de la mise en production
Utilisateur du commentaire de validation	Précédent nom de la colonne de projet	Brouillon de la mise en production
Opération push forcée	Heure de mise à jour de la colonne de projet	Nom de mise en production
URL de l’instance GitHub	Heure de création du projet	Heure de publication de la mise en production
Problème affecté à	Nom du projet	Nom de la balise de mise en production
Délégataires du problème	Précédent corps du projet	Validations des cibles de mise en production
Corps du problème	Précédent nom du projet	Référentiel archivé
Heure de fermeture du problème	État du projet	Heure de création du référentiel
Commentaire sur le problème	Heure de mise à jour du projet	Description du référentiel
Nombre de commentaires sur le problème	Demande d’extraction affectée à	Référentiel inactif
Heure de création du commentaire sur le problème	Délégataires de la demande d’extraction	Nom complet du référentiel
Heure de mise à jour du commentaire sur le problème	Corps de la demande d’extraction	Le référentiel rencontre des problèmes
Heure de création du problème	Heure de fermeture de la demande d’extraction	Le référentiel contient des projets
Problème étiqueté à	Nombre de commentaires sur la demande d’extraction	État de l’importation du référentiel
Étiquettes des problèmes	Heure de création de la demande d’extraction	Licence du référentiel
Problème verrouillé	Brouillon de la demande d’extraction	Nombre de problèmes ouverts du référentiel
Jalon du problème	Demande d’extraction étiquetée à	Propriétaire du référentiel
Précédent corps du problème	Étiquettes de la demande d’extraction	Référentiel privé
Précédent commentaire sur le problème	Demande d’extraction verrouillée	Action push effectuée sur le référentiel à
Jalon précédent du problème	Demande d’extraction fusionnable	Référentiel marqué d’une étoile
Titre précédent du problème	Demande d’extraction fusionnée	Heure de mise à jour du référentiel
Problème précédemment affecté à	Demande d’extraction fusionnée à	Plage affectée par l’alerte de vulnérabilité du référentiel
Problème précédemment étiqueté à	Jalon de la demande d’extraction	Identificateur externe de l’alerte de vulnérabilité du référentiel
État du problème	Précédent corps de la demande d’extraction	Alerte de vulnérabilité du référentiel résolue
Titre du problème	Précédent titre de la demande d’extraction	Nom du package de l’alerte de vulnérabilité du référentiel
Heure de mise à jour du problème	Demande d’extraction précédemment affectée à	Description de l’avis de sécurité
Utilisateur du problème	Demande d’extraction précédemment étiquetée à	ID de l’avis de sécurité
Heure de fermeture du jalon	Demande d’extraction pouvant être rebasée	Heure de publication de l’avis de sécurité
Heure de création du jalon	Corps de la révision de demande d’extraction	Gravité de l’avis de sécurité
Créateur du jalon	Commentaire sur l’examen de la demande d’extraction	Résumé de l’avis de sécurité
Description du jalon	Nombre de commentaires sur la révision de demande d’extraction	Heure de mise à jour de l’avis de sécurité
Date d’échéance du jalon	Heure de création du commentaire sur la révision de demande d’extraction	Heure de retrait de l’avis de sécurité
État du jalon	Chemin d’accès du fichier du commentaire sur la révision de demande d’extraction	Connexion de l’expéditeur
Titre du jalon	Commentaire précédent sur la révision de demande d’extraction	Message de validation du statut
Heure de mise à jour du jalon	Heure de mise à jour du commentaire sur la révision de demande d’extraction	Contexte de l’état
Description de l'organisation	Corps de révision de demande d’extraction précédent	Heure de création du statut
Connexion de l’organisation	État de révision de la demande d’extraction	Description de l’état
Version préliminaire	État de la demande d’extraction	Nom du statut
Corps du projet	Titre de la demande d’extraction	État du statut
Carte de projet archivée	Heure de mise à jour de la demande d’extraction	Heure de mise à jour du statut
Heure de création de la carte de projet	Utilisateur de la demande d’extraction	Événement de webhook

Pour utiliser d’autres conditions dans la politique d’acheminement, créez une politique d’acheminement dans le module Politiques d’acheminement GitHub WebHook et spécifiez les conditions en fonction de vos besoins. Consultez la section Configurer un webhook bidirectionnel pour le spoke GitHub pour en savoir plus sur l’installation et la configuration des webhooks.

Déclencheurs de spokes

ServiceNow prend en charge des événements spécifiques sur GitHub lesquels créer des déclencheurs. Vous devez d’abord configurer un flux avec une définition de déclencheur prise en charge. Lorsqu’un événement, par exemple une demande push, se produit sur le GitHub, il envoie la charge utile via un webhook à l’instance ServiceNow . Ensuite, le flux que vous avez configuré est déclenché sur l’instance ServiceNow pour automatiser un workflow. Les événements pris en charge sont les suivants :


Catégorie	Déclencheur	Description
Gestion des branches	Branche créée	Le flux est déclenché lorsque vous créez une branche sur GitHub.
Gestion des référentiels	Demande d’extraction ouverte	Le flux est déclenché lorsque vous lancez une nouvelle demande de tirage sur GitHub.
	Demande d’extraction modifiée	Le flux est déclenché lorsque vous mettez à jour une demande de tirage sur GitHub.
	Demande d’extraction fermée	Le flux est déclenché lorsque vous fermez une demande de tirage sur GitHub.
	Demande d’extraction affectée	Le flux est déclenché lorsque vous affectez une demande de tirage à un utilisateur sur GitHub.
	Demande d’extraction rouverte	Le flux est déclenché lorsque vous rouvrez une demande de tirage sur GitHub.
	Fourchette du référentiel	Le flux est déclenché lorsque vous dupliquez un référentiel sur GitHub.
	Action push sur le référentiel	Le flux est déclenché lorsque vous effectuez une opération push vers un référentiel sur GitHub.
Gestion des mises en production	Mise en production créée	Le flux est déclenché lorsque les détails d’une mise en production sont créés le GitHub.
	Mise en production modifiée	Le flux est déclenché lorsque les détails d’une mise en production sont mis à jour le GitHub.
	Mise en production supprimée	Le flux est déclenché lorsqu’une mise en production est supprimée sur GitHub.
	Mise en production mise en production	Le flux est déclenché lorsqu’une mise en production est publiée le GitHub.

Pour en savoir plus sur la configuration des déclencheurs du spoke, reportez-vous à la GitHub section Activer la définition de déclencheur sur ServiceNow l’instance. Pour en savoir plus sur l’intégration entrante, reportez-vous à la section Intégration entrante conditionnelle et pilotée par événement.

Flux secondaires du spoke

fournit GitHub Spoke un exemple de flux secondaire pour gérer divers GitHub événements de webhook. Exemples de flux secondaires disponibles :

Tableau 1. Flux secondaires du spoke
Flux secondaire	Description	Événement pris en charge GitHub
Traiter les événements de webhook de branche et de balise GitHub	Gère les événements webhook de branche et de balise.	Branche et balise
Traiter les événements de webhook de validation GitHub	Gère les événements de webhook de validation.	Valider
Traiter les événements de webhook du problème GitHub	Gère les événements de webhook de problème.	Problème
Traiter les événements de webhook de jalon GitHub	Gère les événements webhook du jalon.	Jalon
Traiter les événements de webhook du projet GitHub	Gère les événements webhook du projet.	Projet
Traiter les événements de webhook de demande d’extraction GitHub	Gère les événements de webhook de demande d’extraction.	Demande d'extraction
Traiter les événements de webhook push GitHub	Gère les événements de webhook de demande de transmission.	Demande de transmission
Traiter les événements de webhook de version GitHub	Gère les événements de webhook de mise en production.	Mise en production
Traiter les événements de webhook du référentiel GitHub	Gère les événements de webhook du référentiel.	Référentiel
Traiter les événements de webhook de sécurité GitHub	Gère les événements de webhook de sécurité.	Sécurité
Traiter les événements de webhook GitHub	Gère tous les GitHub événements de webhook.	Remarque : Ce flux secondaire gère tous les GitHub événements. Vous pouvez personnaliser ce flux secondaire pour gérer d’autres GitHub événements de webhook qui ne sont pas pris en charge par défaut.

Pour créer des flux secondaires afin de gérer d’autres événements de GitHub webhook ou de gérer différemment les événements de webhook pris en charge GitHub , personnalisez le flux secondaire Traiter les événements de webhook GitHub. Pour cela, vous devez créer une copie du flux secondaire, analyser la charge utile et personnaliser le flux secondaire en fonction de vos besoins. La charge utile est l’une des entrées du flux secondaire.

Lors de la personnalisation des flux secondaires, vous devez confirmer que les flux secondaires sont configurés pour éviter les boucles infinies.

Remarque :

Vous devez configurer des webhooks pour utiliser le flux secondaire de spoke. Consultez la section Configurer un webhook bidirectionnel pour le spoke GitHub pour en savoir plus sur l’installation et la configuration du webhook.
Les exemples de flux secondaires s’exécutent en tant qu’utilisateur par défaut. Il peut être configuré pour s’exécuter en tant que système.
GitHub Spoke prend en charge la charge utile application/JSON. Configurez le GitHub webhook en conséquence. Voir le GitHub Développeur Documentation pour obtenir des instructions sur la création et la configuration d’un webhook.

Actions du spoke

Les GitHub Spoke actions fournies permettent de gérer les branches, les problèmes, les référentiels et le code source lorsque des événements se produisent dans ServiceNow. Les actions disponibles sont les suivantes :


Catégorie	Action	Description
Gestion des branches	Créer une branche	Crée une branche en fonction d’un GitHub SHA de commit spécifique.
	Supprimer la branche	Supprime une branche du GitHub référentiel.
	Rechercher une branche	Récupère les détails d’une branche dans le GitHub référentiel.
	Rechercher une protection de branche	Récupère les détails de restriction de la branche requise.
	Rechercher des branches	Récupère la liste de toutes les branches d’un référentiel.
	Supprimer la protection de la branche	Supprime la protection sur la branche requise.
	Mettre à jour la protection de la branche	Met à jour la protection sur la branche requise.
Gestion des problèmes	Créer un commentaire sur un problème	Crée un commentaire sur un problème requis.
	Créer un problème	Crée un problème pour le référentiel requis.
	Supprimer un commentaire sur le problème	Supprime le commentaire sur un problème requis.
	Verrouiller un problème	Verrouille le problème requis. Cela limite la conversation aux collaborateurs uniquement.
	Rechercher des commentaire sur un flux de problème	Récupère la liste des commentaires sur un problème.
	Rechercher le flux de problèmes	Récupère la liste des problèmes pour un référentiel.
	Déverrouiller le problème	Déverrouille le problème requis. Cela ouvre la conversation à tous les utilisateurs.
	Mettre à jour un commentaire sur le problème	Met à jour un commentaire sur un problème.
	Mettre à jour le problème	Met à jour les détails du problème requis.
Récupération des métadonnées	Rechercher des champs par action	Récupère la liste des champs pour un filtre d’action dans la GitHub table Champs.
	Rechercher les métadonnées des branches	Récupère les métadonnées des branches.
	Rechercher les métadonnées des problèmes	Récupère les métadonnées des problèmes.
	Rechercher les métadonnées des jalons	Récupère les métadonnées des jalons.
	Rechercher des métadonnées de demandes de tirage	Récupère les métadonnées des demandes de tirage.
Gestion des organisations	Rechercher le plan de l’organisation	Récupère le nom du plan d’une organisation.
	Rechercher le flux des membres de l’organisation	Récupère la liste de tous les membres au sein d’une organisation.
	Rechercher un flux de dépôts d’organisation	Récupère la liste de tous les dépôts au sein d’une organisation.
	Supprimer un membre de l’organisation	Supprime un utilisateur d’une organisation.
	Rechercher un flux d’événements d’organisation	Récupère la liste des événements dans une organisation en fonction de la date de référence fournie.
	Rechercher un flux de collaborateurs externes à l’organisation	Récupère la liste de tous les collaborateurs externes au sein d’une organisation.
	Supprimer un collaborateur externe de l’organisation	Supprime un collaborateur externe d’une organisation.
	Rechercher un flux de collaborateurs externes en attente d’une organisation	Récupère une liste de collaborateurs en attente dans un référentiel.
	Rechercher un flux d’invitations d’organisations	Récupère une liste d’invitations au sein d’une organisation.
	Rechercher le flux de journal d’audit de l’organisation	Récupère une liste des événements du journal d’audit de l’organisation pour une date de référence spécifiée.
Gestion des référentiels	Ajouter un collaborateur	Ajoute un collaborateur au référentiel requis.
	Supprimer le référentiel	Supprime un référentiel à partir de GitHub.
	Créer un commentaire sur une demande de tirage	Créer des commentaires d’examen sur une demande de tirage.
	Créer un jalon	Crée un jalon pour le référentiel requis.
	Créer une demande de tirage	Crée une demande de tirage pour un référentiel.
	Créer une réponse sur un commentaire d’examen de demande de tirage	Crée une réponse à un commentaire d’examen pour une demande de tirage.
	Créer un référentiel	Crée un référentiel dans GitHub.
	Supprimer un commentaire sur une demande de tirage	Supprime un commentaire d’examen sur une demande de tirage.
	Supprimer le jalon	Supprime le jalon du référentiel requis.
	Rechercher des commentaires sur un flux de demande de tirage	Récupère la liste de tous les commentaires de révision sur une demande de tirage.
	Rechercher un flux de jalons	Récupère la liste de tous les jalons dans un référentiel.
	Rechercher un flux d’événements de référentiel	Récupère la liste des événements dans un référentiel.
	Rechercher un flux de demandes de tirage	Récupère les détails des demandes de tirage pour un référentiel.
	Rechercher un flux de dépôts	Récupère les détails des référentiels en fonction d’un utilisateur ou d’une organisation spécifique.
	Rechercher les détails d’un référentiel	Récupère les détails du référentiel spécifié.
	Fusionner un demande de tirage	Fusionne la demande de tirage avec un référentiel.
	Retirer un collaborateur	Supprime un collaborateur d’un référentiel.
	Mettre à jour le commentaire sur la demande de tirage	Met à jour les commentaires d’examen fournis pour une demande de tirage.
	Mettre à jour le jalon	Met à jour les détails d’un jalon dans un référentiel.
	Mettre à jour la demande de tirage	Met à jour les détails d’une demande de tirage dans un référentiel.
	Mettre à jour le référentiel	Met à jour les détails d’un référentiel dans GitHub.
Gestion du code source	Crée un commentaire sur un commit	Crée un commentaire pour le commit requis à l’aide de son SHA.
	Créer ou mettre à jour un fichier	Crée un fichier ou met à jour un fichier existant dans un référentiel.
	Rechercher des commentaires par flux d’ID de commit	Récupère les commentaires fournis pour un commit unique.
	Rechercher des informations de commit par ID	Récupère le contenu de la référence de commit requise.
	Rechercher le contenu du fichier	Récupère le contenu d’un fichier dans un référentiel. Remarque : Cette action prend en charge les fichiers d’une taille maximale de 1 Mo.
	Rechercher des commits sur un référentiel	Récupère les détails de toutes les validations effectuées sur un référentiel.
Gestion des utilisateurs	Rechercher tous les utilisateurs pour le serveur d’entreprise	Récupère la liste de tous les GitHub utilisateurs du serveur d’entreprise.
	Rechercher des organisations pour le flux d’utilisateurs authentifiés	Récupère la liste des organisations dont l’utilisateur connecté est membre.
	Suspendre un utilisateur	Suspend un GitHub compte d’utilisateur.
	Rechercher un utilisateur authentifié	Récupère des informations sur l’utilisateur authentifié.

Agents IA disponibles

Installez Now AssistCentre d'intégration et commencez à utiliser les agents IA disponibles. Pour plus d'informations, consultez Now Assist pour Centre d'intégration.

Ce spoke fournit des agents IA autonomes qui imitent une intelligence de type humain pour effectuer des tâches dans votre ServiceNow instance.

Dans le ServiceNow système agentique, vous pouvez créer un workflow agentique qui comprend un ensemble d’instructions de grand modèle de langage (LLM) ainsi qu’un ou plusieurs agents IA autonomes pour exécuter un objectif. Consultez Create an agentic workflow pour plus d’informations sur l’ajout d’agents IA pour créer des workflows agentiques selon vos besoins et fournir le déclencheur requis.
Vous pouvez également rechercher d’autres agents IA disponibles et les ajouter à votre workflow agentique. Consultez Find AI agents pour plus d'informations.
Vous pouvez créer un clone de l’agent IA de spoke requis et le personnaliser selon vos besoins. Consultez Duplicate an AI agent pour plus d’informations sur la création d’un clone.
Consultez la rubrique Now Assist AI agents pour plus d’informations sur les agents IA.

Les agents IA disponibles sont les suivants :


Agent IA	Description
Agent IA de gestion des branches GitHub	Gère et entretient les GitHub succursales. Récupère également des informations sur les GitHub branches.
Agent IA de gestion des problèmes GitHub	Gère et automatise les tâches liées à GitHub dans le concentrateur d’intégration.
Agent IA de gestion des référentiels GitHub	Gère les dépôts GitHub en gérant les opérations de dépôt, les demandes d’extraction, les commentaires sur les demandes d’extraction et les jalons.
Agent IA de gestion du code source GitHub	Gère le code source et gère les fichiers, les validations et les commentaires du référentiel.
Agent IA d’automatisation du code GitHub	Gère les changements de code et les opérations GitHub à partir de votre instance ServiceNow. Cet agent interprète vos demandes, pose des questions de clarification et analyse le contexte pour fournir des mises à jour de code bien intégrées. Il effectue également des tâches GitHub telles que la création de branches, la validation de modifications et l’ouverture de demandes de tirage.

Il peut y avoir des agents IA installés avec l’application qui ne sont pas utilisés dans les Now Assist workflows agentiques. Pour savoir comment afficher tous les agents à votre disposition, consultez Trouver des agents IA.

Remarque :

Assurez-vous que l’utilisateur exécutant un agent IA dispose des rôles et autorisations requis pour accéder aux données ou effectuer des opérations sur les données de la table associée à l’agent IA.

Modules de spoke

Le GitHub spoke ajoute ces modules à votre ServiceNow instance.


Module	Description
GitHub Propriétaire	Affiche les enregistrements de GitHub propriétaire que vous avez créés.
GitHub Référentiels	Affiche les détails des GitHub référentiels associés aux GitHub propriétaires.

Exigences en matière d'alias de connexion et d'informations d'identification

Centre d'intégration utilise des alias pour gérer les informations de connexion et d’identification, ainsi que les informations d’identification OAuth. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'environnements multiples. Si les informations de connexion ou d'identification changent, il n'est pas nécessaire de mettre à jour les actions qui utilisent la connexion.

Pour en savoir plus sur la configuration du spoke, consultez Configurer le GitHub spoke.