Intégrer à GitHub Enterprise Server

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 6 minutes de lecture

    • Vous pouvez intégrer votre ServiceNow instance à l’application GitHub Enterprise Server pour suivre vos abonnements logiciels et récupérer les licences inutilisées.

    Important :
    Minimisez les risques de sécurité et protégez les informations en n’accordant l’accès qu’aux utilisateurs ou aux autorisations d’API nécessaires.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application GitHub Enterprise Server Périmètres d’authentification
    Télécharger les abonnements Administrateur de site site_admin
    Récupérer l’abonnement Administrateur de site site_admin

    Générer un jeton d’accès API pour GitHub le serveur Enterprise

    Générez un jeton que vous pouvez utiliser pour accéder à l’API Enterprise GitHub Server.

    Avant de commencer

    GitHub Rôle requis : administrateur du site

    Pourquoi et quand exécuter cette tâche

    Le GitHub service d’hébergement du référentiel utilise des jetons d’accès personnels pour accorder aux utilisateurs l’accès à l’API GitHub . Les jetons d’accès personnels fonctionnent de la même manière que les jetons d’accès OAuth en autorisant les demandes d’API. En générant un jeton d’accès personnel pour autoriser vos GitHub demandes d’API Enterprise Server, vous pouvez accéder à l’API Enterprise GitHub Server.

    Procédure

    1. À partir d’un navigateur Web, ouvrez votre GitHub instance de serveur Enterprise.
    2. Connectez-vous à votre GitHub compte.
    3. Dans l’en-tête de la GitHub page, sélectionnez votre photo de profil, puis sélectionnez Paramètres.
      Les paramètres de votre profil s’ouvrent.
    4. Dans le volet de navigation de gauche, sélectionnez Paramètres du développeur.
      Vos paramètres de développeur s’ouvrent.
    5. Dans le volet de navigation de gauche, sélectionnez Jetons d’accès personnels.
    6. Sur la page Jetons d’accès personnels, sélectionnez Générer un nouveau jeton.
    7. Si vous êtes invité à confirmer votre mot de passe avant de continuer, saisissez-le GitHub , puis sélectionnez Confirmer le mot de passe.
    8. Sur le formulaire Nouveau jeton d’accès personnel, décrivez l’objectif du jeton dans le champ Remarque .
    9. Dans la section du formulaire Sélectionner les champs d’application, activez le champ d’application site_admin OAuth en cochant la case site_admin .
      Les champs d’application OAuth limitent le niveau d’accès de l’application à vos ressources protégées. Le champ d’application OAuth site_admin vous permet de gérer les utilisateurs, les organisations et les référentiels de votre entreprise.
    10. Sélectionnez Générer un jeton.
      Votre jeton d’accès personnel est généré.
    11. Copiez le jeton d’accès et enregistrez-le dans un emplacement sécurisé pour une utilisation ultérieure.

    Créer une connexion à un serveur d’entreprise GitHub

    Créez une connexion entre vos GitHub applications Enterprise Server et votre ServiceNow instance.

    Avant de commencer

    Si vous souhaitez utiliser un Serveur MID pour la communication entre votre instance et vos applications Serveur Entreprise, vous devez d’abord configurer un Serveur MID pour la communication entre votre ServiceNow instance et vos GitHub applications Serveur Entreprise. Voir Serveur MID pour obtenir des instructions détaillées.

    ServiceNow Rôle requis : admin

    Procédure

    1. À partir de votre ServiceNow instance, accédez à Automatisation des processus > Concepteur de flux.
      Flow Designer apparaît dans un nouvel onglet.
    2. Sélectionnez l’onglet Connexions .
    3. Sélectionnez Afficher les détails de votre GitHub connexion au serveur.
    4. Dans la liste des connexions disponibles, localisez GitHub Serveur, puis sélectionnez Configurer.
    5. Renseignez les champs de la boîte de dialogue Configurer la connexion.
      Tableau 2. Boîte de dialogue Configurer la connexion
      Champ Description
      Nom de la connexion Nom de la GitHub connexion au serveur.
      URL de connexion URL de votre GitHub instance.
      Utiliser Serveur MID Option qui permet à votre ServiceNow instance d’utiliser un Serveur MID pour la communication avec vos GitHub applications Serveur d’entreprise.
      • Si votre instance nécessite un Serveur MID, définissez ce champ sur vrai.
      • Si votre instance n’a pas besoin d’un Serveur MID, laissez ce champ vide.
      Important :
      Pour activer cette option, vous devez déjà avoir configuré Serveur MID votre instance. Voir Serveur MID pour obtenir des instructions détaillées.
      Clé API Jeton d’accès personnel qui vous permet d’accéder à l’API Enterprise GitHub Server. Saisissez <api-key>, où <api-key> est le jeton d’accès personnel que vous avez généré dans Générer un jeton d’accès API pour GitHub le serveur Enterprise.
    6. Sélectionnez Configurer la connexion.

    Créer un profil d’intégration GitHub Enterprise Server

    Créez un profil d’intégration GitHub Enterprise Server pour suivre les abonnements logiciels et optimiser la gestion des licences pour vos GitHub applications Enterprise Server.

    Avant de commencer

    Pour créer un profil d’intégration GitHub de serveur d’entreprise, demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (com.sn_sam_saas_int) auprès du ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator ou admin

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option permettant de créer le profil d’intégration du GitHub serveur dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tout > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Profil d’abonnement GitHub Server.
      Espace de travail des ressources logicielles
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Serveur GitHub dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 3. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, Intégration de GitHub Server.
      Connexion et information d'identification Alias de connexion et d’informations d’identification pour le GitHub spoke. Ce champ est automatiquement défini sur sn_github_spoke. GitHub_Server.
      Statut État du profil d'intégration.
      • Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon.
      • Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
      Type de profil Type de profil d'intégration. Ce champ est automatiquement défini sur github_server_subscription.
    3. Dans l’onglet Télécharger le flux secondaire d’abonnement , vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement GitHub Server.
      Vous pouvez afficher les événements effectués par des utilisateurs individuels jusqu’à un an avant la date actuelle. Pour plus d'informations, consultez Réviser une règle de réclamation de logiciel.
      Remarque :
      Gestion des actifs logiciels Extrait les événements à partir du moment où vous commencez à télécharger les abonnements utilisateur, quelle que soit la date de création du profil.
    4. Dans l’onglet Récupérer le flux secondaire de l’abonnement , vérifiez que le champ Flux secondaire est défini sur Abonnement de récupération GitHub Server.
    5. Sélectionnez Enregistrer.
      Votre ServiceNow instance crée une ébauche de profil d’intégration. Le profil d’intégration utilise les flux secondaires d’abonnements GitHub de téléchargement de serveur et GitHub d’abonnement de récupération de serveur pour récupérer des données de vos GitHub applications serveur d’entreprise.
    6. Une fois le formulaire rechargé, sélectionnez Publier.
    7. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.

    Que faire ensuite

    Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements utilisateur qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser une règle de réclamation de logiciel.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher les résultats de votre rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position de conformité de licence et pour remédier à toute non-conformité.