Tutoriel : Intégration de l’authentification unique Microsoft Entra à GitHub Enterprise Server

Dans ce tutoriel, vous découvrez comment intégrer GitHub Enterprise Server à Microsoft Entra ID. Quand vous intégrez GitHub Enterprise Server à Microsoft Entra ID, vous pouvez :

• Contrôler dans Microsoft Entra ID qui a accès à GitHub Enterprise Server.
• Permettre à vos utilisateurs d’être connectés automatiquement à GitHub Enterprise Server avec leur compte Microsoft Entra.
• Gérer vos comptes à partir d’un emplacement central.

Prérequis

Pour commencer, vous devez disposer de ce qui suit :

• Un abonnement Microsoft Entra. Si vous ne disposez d’aucun abonnement, vous pouvez obtenir un compte gratuit.
• GitHub Enterprise Server, prêt pour l’initialisation.
• Outre l'administrateur d'applications cloud, l'administrateur d'applications 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 ce tutoriel, vous configurez et testez Microsoft Entra SSO 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 le provisionnement d’utilisateurs Juste-à-temps.
• GitHub Enterprise Server prend en charge le Provisionnement automatique d’utilisateurs.

Ajout de GitHub Enterprise Server à partir de la galerie

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

1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
2. Accédez à Identité>Applications>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 Entreprise App Configuration. Dans cet assistant, vous pouvez ajouter une application à votre locataire, ajouter des utilisateurs/groupes à l’application, attribuer des rôles, mais également parcourir 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 au moyen d’un utilisateur de test nommé B.Simon. Pour que l’authentification unique fonctionne, vous devez établir une relation entre un utilisateur Microsoft Entra et l’utilisateur associé dans GitHub Enterprise Server.

Pour configurer et tester l’authentification unique Microsoft Entra avec GitHub Enterprise Server, effectuez les étapes suivantes :

1. Configurez l’authentification unique Microsoft Entra pour permettre à vos utilisateurs d’utiliser cette fonctionnalité.
   1. Créez un utilisateur de test Microsoft Entra pour tester l’authentification unique Microsoft Entra avec B.Simon.
   2. Attribuer l’utilisateur test Microsoft Entra – pour permettre à B.Simon d’utiliser l’authentification unique Microsoft Entra.
2. Configurer l’authentification unique GitHub Enterprise Server pour configurer les paramètres d’authentification unique côté application.
   1. Créez 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. Tester l’authentification unique pour vérifier si la configuration fonctionne.

Configurer Microsoft Entra SSO

Effectuez 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 àIdentité>Applications>Applications d’entreprise>GitHub Enterprise Server>Authentification unique.

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, cliquez sur l’icône de crayon de Configuration SAML de base afin de modifier les paramètres.

   

5. Dans la section Configuration SAML de base, si vous souhaitez configurer l’application en mode lancé par le fournisseur d’identité, effectuez les étapes suivantes :

   a. Dans la zone de texte Identificateur (ID d’entité) , saisissez une URL au format suivant : https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

   b. Dans la zone de texte URL de réponse, tapez une URL au format suivant : https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

6. Si vous souhaitez configurer l’application en mode démarré par le fournisseur de services, cliquez sur Définir des URL supplémentaires, puis effectuez les étapes suivantes :

   Dans la zone de texte URL de connexion, saisissez une URL au format suivant : https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

   Remarque

   Il ne s’agit pas de valeurs réelles. Mettez à jour ces valeurs avec l’identificateur, l’URL d’authentification et l’URL de réponse réels. Pour obtenir ces valeurs, contactez l’équipe du support technique de GitHub Enterprise Server. Vous pouvez également consulter les modèles figurant à la section Configuration SAML de base.

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

   

8. Modifiez Attributs utilisateur et revendications.

9. Cliquez sur Ajouter une nouvelle revendication, puis entrez comme nom administrateur dans la zone de texte (la valeur administrateur respecte la casse).

10. Développez Conditions de revendication et sélectionnez Membres dans Type d’utilisateur.

11. Cliquez sur Sélectionnez des groupes et recherchez le Groupe pour lequel vous souhaitez inclure cette revendication, dont les membres doivent être administrateurs pour GHAE.

12. Sélectionnez Attribut pour Source et entrez true (sans guillemets) pour Valeur.

13. Cliquez sur Enregistrer.

    

    Remarque

    Pour savoir comment ajouter une revendication, suivez ce lien.

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

    

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

    

Créer un utilisateur de test Microsoft Entra

Dans cette section, vous allez créer un utilisateur de test appelé B.Simon.

1. Connectez-vous au Centre d’administration de Microsoft Entra en tant qu’Administrateur de l’utilisateur.
2. Accédez à Identité>Utilisateurs>Tous les utilisateurs.
3. Sélectionnez Nouvel utilisateur>Créer un utilisateur dans la partie supérieure de l’écran.
4. Dans les propriétés Utilisateur, effectuez les étapes suivantes :
   1. Dans le champ Nom d’affichage, entrez B.Simon.
   2. Dans le champ Nom d’utilisateur principal, entrez username@companydomain.extension. Par exemple : B.Simon@contoso.com.
   3. Cochez la case Afficher le mot de passe, puis notez la valeur affichée dans le champ Mot de passe.
   4. Sélectionnez Revoir + créer.
5. Sélectionnez Create (Créer).

Attribuer l’utilisateur test Microsoft Entra

Dans cette section, vous allez autoriser B.Simon à utiliser l’authentification unique en lui accordant l’accès à GitHub Enterprise Server.

1. Connectez-vous au Centre d’administration de Microsoft Entra au minimum en tant qu’Administrateur d’application cloud.
2. Accédez àIdentité>Applications>Applications d’entreprise>GitHub Enterprise Server.
3. Dans la page de présentation de l’application, sélectionnez Utilisateurs et groupes.
4. Sélectionnez Ajouter un utilisateur/groupe, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.
   1. Dans la boîte de dialogue Utilisateurs et groupes, sélectionnez B. Simon dans la liste Utilisateurs, puis cliquez sur le bouton Sélectionner au bas de l’écran.
   2. Si vous attendez qu’un rôle soit attribué aux utilisateurs, vous pouvez le sélectionner dans la liste déroulante Sélectionner un rôle . Si aucun rôle n’a été configuré pour cette application, vous voyez le rôle « Accès par défaut » sélectionné.
   3. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

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 nommé B.Simon est créé dans GitHub Enterprise Server. GitHub Enterprise Server prend en charge le provisionnement d’utilisateurs juste-à-temps, option activée par défaut. Vous n’avez aucune opération à effectuer dans cette section. S’il n’existe pas encore d’utilisateur dans GitHub Enterprise Server, il en est créé un après l’authentification.

GitHub Enterprise Server prend également en charge le provisionnement automatique d’utilisateurs. Vous trouverez plus d’informations ici sur la façon de configurer le provisionnement 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ée par le fournisseur de services :

• Cliquez sur Tester cette application : vous serez alors redirigé vers l’URL d’authentification de GitHub Enterprise Server où vous pouvez lancer le flux de connexion.

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

Lancée par le fournisseur d’identité :

• Cliquez sur Tester cette application : vous devez alors être connecté automatiquement à l’instance GitHub Enterprise Server pour laquelle vous avez configuré l’authentification unique.

Vous pouvez aussi utiliser Mes applications de Microsoft pour tester l’application dans n’importe quel mode. Si, quand vous cliquez sur la vignette GitHub Enterprise Server dans Mes applications, le mode Fournisseur de services est configuré, vous êtes redirigé vers la page de connexion de l’application pour lancer le flux de connexion ; s’il s’agit du mode Fournisseur d’identité, vous êtes automatiquement connecté à l’instance de GitHub Enterprise Server pour laquelle vous avez configuré l’authentification unique. Pour plus d’informations, consultez Mes applications Microsoft Entra.

Étapes suivantes

• Configuration de l’attribution d’utilisateurs pour votre entreprise.

• Une fois que vous avez configuré GitHub Enterprise Server, vous pouvez appliquer le contrôle de session, qui protège contre l’exfiltration et l’infiltration des données sensibles de votre organisation en temps réel. Le contrôle de session est étendu à partir de l’accès conditionnel. Découvrez comment appliquer un contrôle de session avec Microsoft Defender for Cloud Apps.