Partager via

Configurer GitHub Enterprise Server pour l’authentification unique avec l’ID Microsoft Entra

Dans cet article, vous allez apprendre à intégrer GitHub Enterprise Server à Microsoft Entra ID. Lorsque vous intégrez GitHub Enterprise Server à l’ID Microsoft Entra, vous pouvez :

  • Contrôler dans Microsoft Entra ID qui a accès à GitHub Enterprise Server.
  • Permettre à vos utilisateurs de se connecter automatiquement à GitHub Enterprise Server avec leur compte Microsoft Entra.
  • Gérez vos comptes dans un emplacement central.

Prerequisites

Pour commencer, vous avez besoin des éléments suivants :

  • Un abonnement Microsoft Entra. Si vous n’avez pas d’abonnement, vous pouvez obtenir un compte gratuit .
  • GitHub Enterprise Server, prêt pour l’initialisation.
  • En plus de l’administrateur d’applications cloud, l’administrateur d’application peut également ajouter ou gérer des applications dans Microsoft Entra ID. Pour plus d’informations, voir Rôles intégrés Azure.

Description du scénario

Dans cet article, vous allez configurer et tester l’authentification unique Microsoft Entra dans un environnement de test.

  • GitHub Enterprise Server prend en charge l’authentification unique lancée par le fournisseur de services et le fournisseur d’identité .
  • GitHub Enterprise Server prend en charge l’approvisionnement d’utilisateurs juste-à-temps .
  • GitHub Enterprise Server prend en charge l’approvisionnement automatique d’utilisateurs.

Pour configurer l’intégration de GitHub Enterprise Server à Microsoft Entra ID, vous devez ajouter GitHub Enterprise Server à partir de la galerie à votre liste d’applications SaaS gérées.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
  2. Naviguez vers Entra ID>Applications d'entreprise>Nouvelle application.
  3. Dans la section Ajouter à partir de la galerie , tapez GitHub Enterprise Server dans la zone de recherche.
  4. Sélectionnez GitHub Enterprise Server dans le volet de résultats, puis ajoutez l’application. Patientez quelques secondes pendant que l’application est ajoutée à votre locataire.

Vous pouvez également utiliser l’Assistant Enterprise App Configuration. Dans cet Assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application, attribuer des rôles et parcourir également la configuration de l’authentification unique. En savoir plus sur les Assistants Microsoft 365.

Configurer et tester l’authentification unique Microsoft Entra pour GitHub Enterprise Server

Configurez et testez l’authentification unique Microsoft Entra avec GitHub Enterprise Server à l’aide d’un utilisateur de test appelé B.Simon. Pour que l’authentification unique fonctionne, vous devez établir un lien entre un utilisateur Microsoft Entra et l’utilisateur GitHub Enterprise Server associé.

Pour configurer et tester l’authentification unique Microsoft Entra avec GitHub Enterprise Server, procédez comme suit :

  1. Configurer Microsoft Entra SSO – pour permettre à vos utilisateurs d'utiliser cette fonctionnalité.
    1. Créer un utilisateur de test Microsoft Entra pour tester l’authentification unique Microsoft Entra avec B.Simon.
    2. Affectez l’utilisateur de test Microsoft Entra pour permettre à B.Simon d’utiliser l’authentification unique Microsoft Entra.
  2. Configurez l’authentification unique GitHub Enterprise Server pour configurer les paramètres de l’authentification unique côté application.
    1. Créer un utilisateur de test GitHub Enterprise Server pour avoir un équivalent de B.Simon dans GitHub Enterprise Server lié à la représentation Microsoft Entra de l’utilisateur.
  3. Effectuer un test SSO pour vérifier si la configuration fonctionne.

Configurer l’authentification unique Microsoft Entra

Suivez ces étapes pour activer l’authentification unique Microsoft Entra.

  1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.

  2. Accédez àl’authentification unique GitHub Enterprise >>>.

  3. Dans la page Sélectionner une méthode d’authentification unique, sélectionnez SAML.

  4. Dans la page Configurer l’authentification unique avec SAML , sélectionnez l’icône crayon de configuration SAML de base pour modifier les paramètres.

    Capture d’écran montrant comment modifier la configuration S A M L de base.

  5. Dans la section Configuration SAML de base , si vous souhaitez configurer l’application en mode initié par le fournisseur d’identité, procédez comme suit :

    a. Dans la zone de texte Identificateur (ID d’entité), tapez une URL à l’aide du modèle suivant : https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

    b. Dans la zone de texte URL de réponse , tapez une URL à l’aide du modèle suivant : https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

  6. Sélectionnez Définir des URL supplémentaires et effectuez l’étape suivante si vous souhaitez configurer l’application en mode initié par le fournisseur de services :

    Dans la zone de texte URL de connexion , tapez une URL à l’aide du modèle suivant : https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

    Note

    Ces valeurs ne sont pas réelles. Mettez à jour ces valeurs avec l’IDENTIFICATEUR, l’URL de réponse et l’URL de connexion réels. Pour obtenir ces valeurs , contactez l’équipe du support technique GitHub Enterprise Server . Vous pouvez également faire référence aux modèles indiqués dans la section Configuration SAML de base .

  7. L’application GitHub Enterprise Server attend les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à votre configuration d’attributs de jeton SAML. La capture d’écran suivante montre la liste des attributs par défaut.

    Capture d’écran montrant l’image de l’application Enterprise Server.

  8. Modifier les attributs utilisateur et les revendications.

  9. Sélectionnez Ajouter une nouvelle revendication et entrez le nom comme administrator dans la zone de texte (la valeur respecte la administrator casse).

  10. Développez les conditions de revendication et sélectionnez Membres à partir du type d’utilisateur.

  11. Sélectionnez Sélectionner des groupes et recherchez le groupe que vous souhaitez inclure cette revendication, où ses membres doivent être administrateurs pour GHES.

  12. Sélectionnez Attribut pour source et entrez true (sans guillemets) pour la valeur.

  13. Cliquez sur Enregistrer.

    Capture d’écran montrant comment gérer la revendication pour les attributs.

  14. Dans la page Configurer l’authentification unique avec SAML , dans la section Certificat de signature SAML , recherchez le certificat (Base64) et sélectionnez Télécharger pour télécharger le certificat et l’enregistrer sur votre ordinateur.

    Capture d’écran montrant le lien de téléchargement du certificat.

  15. Dans la section Configurer GitHub Enterprise Server , copiez la ou les URL appropriées en fonction de vos besoins.

    Capture d’écran montrant comment copier la configuration appropriée U R L.

Créer et affecter un utilisateur de test Microsoft Entra

Suivez les instructions du guide de démarrage rapide pour créer et attribuer un compte utilisateur afin de créer un compte utilisateur de test appelé B.Simon.

Configurer l’authentification unique GitHub Enterprise Server

Pour configurer l’authentification unique côté GitHub Enterprise Server, vous devez suivre les instructions mentionnées ici.

Créer un utilisateur de test GitHub Enterprise Server

Dans cette section, un utilisateur appelé B.Simon est créé dans GitHub Enterprise Server. GitHub Enterprise Server prend en charge l’approvisionnement d’utilisateurs juste-à-temps, qui est activé par défaut. Il n’existe aucun élément d’action pour vous dans cette section. S’il n’existe pas encore d’utilisateur dans GitHub Enterprise Server, un nouvel utilisateur est créé après l’authentification.

GitHub Enterprise Server prend également en charge l’approvisionnement automatique d’utilisateurs. Vous trouverez plus d’informations ici sur la configuration de l’approvisionnement automatique d’utilisateurs.

Tester l’authentification unique (SSO)

Dans cette section, vous testez votre configuration d’authentification unique Microsoft Entra avec les options suivantes.

Lancé par le fournisseur de services :

  • Sélectionnez Tester cette application, cette option redirige vers l’URL de connexion à GitHub Enterprise Server où vous pouvez lancer le flux de connexion.

  • Accédez directement à l’URL de connexion à GitHub Enterprise Server pour lancer le flux de connexion.

Initié par le fournisseur d’identité :

  • Sélectionnez Tester cette application et vous devez être connecté automatiquement à GitHub Enterprise Server pour lequel vous avez configuré l’authentification unique.

Vous pouvez également utiliser Microsoft My Apps pour tester l’application en tout mode. Lorsque vous sélectionnez la vignette GitHub Enterprise Server dans Mes applications, si le mode Fournisseur de services est configuré, vous êtes redirigé vers la page de connexion de l’application pour lancer le flux de connexion et s’il est configuré en mode Fournisseur d’identité, vous êtes automatiquement connecté à GitHub Enterprise Server pour lequel vous avez configuré l’authentification unique. Pour plus d’informations, consultez Microsoft Entra My Apps.

Contenu connexe

  • Last updated on