Configurer GitHub Enterprise le cloud pour l’indexation de contenu externe

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

    • Créez et autorisez une GitHub application pour permettre au connecteur de contenu externe dans le cloud d’accéder à votre GitHub Enterprise contenu dans le GitHub Enterprise cloud.

    Avant de commencer

    Vous avez besoin de tous les éléments suivants :

    Rôle requis : aucun

    Pourquoi et quand exécuter cette tâche

    Le GitHub Enterprise connecteur de contenu externe dans le cloud récupère le contenu et les métadonnées pouvant faire l’objet d’une recherche à partir des validations, des problèmes et des demandes d’extraction trouvés dans les référentiels publics et internes de votre GitHub Enterprise système source dans le cloud à l’aide de l’API GitHub REST.

    Pour permettre au connecteur d’accéder à votre GitHub Enterprise système source dans le cloud via l’API REST, vous devez configurer et autoriser une GitHub application pour votre organisation dans GitHub Enterprise le cloud. Votre administrateur de connecteur peut utiliser les paramètres copiés à partir de l’application pour configurer le connecteur externe dans le GitHub Enterprise cloud afin qu’il GitHub se connecte correctement à votre système source.

    Procédure

    1. Créez une application GitHub pour le connecteur de contenu externe dans le GitHub Enterprise cloud.
      1. Accédez et https://github.com/ connectez-vous avec vos GitHub Enterprise informations d’identification dans le cloud.
      2. Sélectionnez votre photo de profil, puis sélectionnez Votre entreprise dans le menu contextuel.
        Si vous n’utilisez pas Enterprise Managed Users, sélectionnez Vos entreprises, puis Paramètres.
      3. Dans le menu, accédez à Paramètres > Paramètres du développeur > GitHub Applications.
      4. Sélectionnez Nouvelle GitHub application.
      5. Sur la page Enregistrer une nouvelle GitHub application, saisissez un nom pour votre nouvelle GitHub application.
        Par exemple, vous pouvez saisir Connecteur de contenu externe.
        Remarque :
        Le nom de l’application ne peut pas dépasser 34 caractères.
      6. Dans le champ URL de la page d’accueil , saisissez l’URL du compte de GitHub votre organisation.
        Par exemple, vous pouvez saisir https://github.com/example.
      7. Dans la section Webhook, désactivez l’option Actif .
      8. Dans la section Autorisations, développez la liste des autorisations de référentiel et sélectionnez Accès en lecture seule pour chacune de ces autorisations.
        • États des validations
        • Contenu
        • Discussions
        • les problèmes
        • Fusionner les files d’attente
        • Demandes d'extraction
      9. Dans la section Autorisations, développez la liste des autorisations d’organisation et sélectionnez Accès en lecture seule pour l’autorisation Membres .
      10. Dans le champ Où cette GitHub application peut-elle être installée ? , sélectionnez l’option Uniquement sur ce compte .
      11. Sélectionnez Create AppGitHub.
      Un message indique que votre nouvelle GitHub application a été enregistrée avec succès et vous êtes redirigé vers sa page Paramètres généraux.
    2. Obtenez l’ID client et la clé privée de votre nouvelle GitHub application à partir de sa page Paramètres généraux.
      1. Dans la section À propos, copiez l’ID client de votre nouvelle GitHub application et stockez-le dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de cet ID client lors de la configuration du connecteur de contenu externe dans le GitHub Enterprise cloud.
      2. Dans la section Clés privées, sélectionnez Générer une clé privée.
      3. Lorsque vous y êtes invité, téléchargez le fichier de certificat de clé privée au format PEM dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de ce fichier de certificat de clé privée au format PEM lors de la configuration du connecteur de contenu externe dans le GitHub Enterprise cloud.
    3. Installez votre nouvelle GitHub application.
      1. Dans le menu de votre nouvelle GitHub application, sélectionnez Installer l’application.
      2. Dans l’entrée de votre GitHub compte d’organisation, sélectionnez Installer.
      3. Sur la page d’installation de votre nouvelle GitHub application, choisissez les référentiels auxquels vous souhaitez que le connecteur de contenu externe ait accès.
        • Pour accorder au connecteur de contenu externe l’accès à tous les référentiels appartenant à votre organisation, sélectionnez Tous les référentiels.
        • Pour accorder au connecteur de contenu externe l’accès à un ensemble spécifié de référentiels appartenant à votre organisation, sélectionnez Sélectionner uniquement les référentiels, puis utilisez la liste déroulante Sélectionner des référentiels pour rechercher et sélectionner les référentiels auxquels vous souhaitez accorder l’accès au connecteur.
      4. Sélectionnez Installer.
    4. Obtenez l’ID d’installation de l’application pour votre nouvelle GitHub application.
      1. Obtenez l’identificateur de votre GitHub organisation à partir de l’URL de la page de votre GitHub organisation.
        L’identificateur de votre organisation est l’élément URL suivant la troisième barre oblique dans l’URL de la page de votre GitHub organisation. Par exemple, si l’URL de la page de votre GitHub organisation est https://github.com/example, l’identificateur de votre organisation est un exemple.
      2. Générez un jeton Web JSON (JWT) pour votre nouvelle GitHub application.
        Pour plus d’informations sur la génération d’un JWT pour une GitHub application à l’aide de Ruby, Python, bash ou PowerShell, consultez la ressource de https://docs.github.com/en/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-json-web-token-jwt-for-a-github-app GitHub documentation.

        Pour générer un JWT, vous avez besoin de l’ID client que vous avez copié à l’étape 2.a et du fichier de certificat de secret client au format PEM que vous avez téléchargé à l’étape 2.c.

        Important :
        Votre JWT expire 10 minutes après sa création. S’il expire avant de pouvoir effectuer l’étape suivante, répétez cette étape pour générer un nouveau JWT.
      3. Exécutez la commande curl suivante, en remplaçant <org> par l’identificateur de votre GitHub organisation et <json-web-token> par le JWT que vous avez généré. 
        curl --request GET \
  --url "https://api.github.com/orgs/<org>/installation" \
  --header "Accept: application/vnd.github+json" \
  --header "Authorization: Bearer <json-web-token>" \
  --header "X-GitHub-Api-Version: 2022-11-28"
      4. Dans l’objet de réponse JSON, recherchez la paire clé-valeur d’ID de l’installation de l’application, copiez sa valeur et stockez-la dans un emplacement sécurisé.
        Important :
        Votre administrateur du connecteur de contenu externe a besoin de cet ID d’installation de l’application lors de la configuration du connecteur de contenu externe dans le GitHub Enterprise cloud.

    Que faire ensuite

    Fournissez les éléments suivants à votre administrateur de connecteur :
    • L’ID client que vous avez copié à l’étape 2.a.
    • Le fichier de certificat de clé privée au format PEM que vous avez téléchargé à l’étape 2.c.
    • L’ID d’installation de l’application que vous avez copié à l’étape 4.d.

    Votre administrateur de connecteur a besoin de ces éléments pour configurer un GitHub Enterprise connecteur de contenu externe dans le cloud afin de récupérer des éléments et des principaux de sécurité à partir de votre GitHub Enterprise système source dans le cloud.

    Pour en savoir plus sur la création et la configuration d’un connecteur de GitHub Enterprise contenu externe dans le cloud, reportez-vous à la section Créer un connecteur de contenu externe dans le GitHub Enterprise cloud.