Tutoriel : Intégration de Microsoft Entra SSO avec une organisation GitHub Enterprise Cloud

Dans ce didacticiel, vous apprendrez comment intégrer une organisation GitHub Enterprise Cloud avec Microsoft Entra ID. Lorsque vous intégrez une organisation GitHub Enterprise Cloud avec Microsoft Entra ID, vous pouvez :

• Contrôlez dans Microsoft Entra ID qui a accès à votre organisation GitHub Enterprise Cloud.
• Gérez l’accès à votre organisation GitHub Enterprise Cloud à 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.
• Une organisation GitHub créée dans GitHub Enterprise Cloud, ce qui nécessite le plan de facturation GitHub Enterprise.

Description du scénario

Dans ce didacticiel, vous configurez et testez l’authentification unique Microsoft Entra dans un environnement de test.

• GitHub prend en charge l’authentification unique lancée par le fournisseur de services.

• GitHub prend en charge l’attribution automatique d’utilisateurs (invitations d’organisation).

Ajout de GitHub à partir de la galerie

Pour configurer l'intégration de GitHub dans Microsoft Entra ID, vous devez ajouter GitHub depuis 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. Accédez à Identité>Applications>Applications d’entreprise>Nouvelle application.
3. Dans la section Ajouter à partir de la galerie, tapez GitHub dans la zone de recherche.
4. Sélectionnez GitHub Enterprise Cloud - Organization 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 Microsoft Entra SSO pour GitHub

Configurez et testez Microsoft Entra SSO avec GitHub à l'aide d'un utilisateur test appelé B.Simon. Pour que SSO fonctionne, vous devez établir une relation de lien entre un utilisateur Microsoft Entra et l'utilisateur associé dans GitHub.

Pour configurer et tester Microsoft Entra SSO avec GitHub, effectuez les étapes suivantes :

1. Configurer Microsoft Entra SSO – 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 pour configurer les paramètres de l’authentification unique côté application.
   1. Créer un utilisateur test GitHub – pour avoir un homologue de B.Simon dans GitHub qui est 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>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, entrez les valeurs pour les champs suivants :

   a. Dans la zone de texte Identificateur (ID d’entité) , saisissez une URL au format suivant : https://github.com/orgs/<Organization ID>

   b. Dans la zone de texte URL de réponse, tapez une URL au format suivant : https://github.com/orgs/<Organization ID>/saml/consume

   c. Dans la zone de texte URL de connexion, saisissez une URL au format suivant : https://github.com/orgs/<Organization ID>/sso

   Remarque

   Notez qu’il ne s’agit pas des valeurs réelles. Vous devez mettre à jour ces valeurs avec l’identificateur, l’URL de réponse et l’URL d’authentification réels. Nous vous suggérons d’utiliser ici la valeur de chaîne unique dans l’identificateur. Accédez à la section d’administration de GitHub pour extraire ces valeurs.

6. L’application GitHub s’attend à recevoir les assertions SAML dans un format spécifique, ce qui vous oblige à ajouter des mappages d’attributs personnalisés à votre configuration Attributs du jeton SAML. La capture d’écran suivante montre la liste des attributs par défaut, avec l’Identificateur d’utilisateur unique (ID de nom) mappé à user.userprincipalname. L’application GitHub s’attend à ce que Identificateur d’utilisateur unique (ID de nom) soit mappé avec user.mail. Vous devez donc modifier le mappage d’attributs. Pour cela, cliquez sur l’icône Modifier et changez le mappage d’attributs.

   

7. Dans la page Configurer l’authentification unique avec SAML, dans la section Certificat de signature SAML, cliquez sur Télécharger pour télécharger le Certificat (Base64) en fonction des options définies par rapport à vos besoins, puis enregistrez-le sur votre ordinateur.

   

8. Dans la section Configurer GitHub, 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 permettre à B.Simon d’utiliser l’authentification unique en lui accordant l’accès à GitHub.

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.

3. Dans la page de vue d’ensemble de l’application, recherchez la section Gérer et sélectionnez Utilisateurs et groupes.

4. Sélectionnez Ajouter un utilisateur, puis Utilisateurs et groupes dans la boîte de dialogue Ajouter une attribution.

5. 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.

6. 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é.

   

7. Dans la boîte de dialogue Ajouter une attribution, cliquez sur le bouton Attribuer.

Configurer l’authentification unique GitHub

1. Dans une autre fenêtre de navigateur web, connectez-vous à votre site d’entreprise GitHub en tant qu’administrateur.

2. Accédez aux Paramètres et cliquez sur Sécurité.

   

3. Cochez la case Activer l’authentification SAML, révélant ainsi les champs de configuration de l’authentification unique, puis effectuez les étapes suivantes :

   

   a. Copiez la valeur du champ URL d’authentification unique et collez-la dans la zone de texte URL de connexion de la section Configuration SAML de base.

   b. Copiez la valeur de l’URL Assertion Consumer Service (ACS), puis collez-la dans la zone de texte URL de réponse de la section Configuration SAML de base.

4. Configurez les champs suivants :

   

   a. Dans la zone de texte URL d’authentification, collez la valeur d’URL de connexion que vous avez copiée précédemment.

   b. Dans la zone de texte Émetteur, collez la valeur de l'identifiant Microsoft Entra que vous avez copiée précédemment.

   c. Ouvrez le certificat téléchargé à partir du portail Azure dans le bloc-notes et collez le contenu dans la zone de texte Certificat public.

   d. Cliquez sur l’icône Modifier pour changer la méthode de signature et la méthode Digest de RSA-SHA1 et SHA1 en RSA-SHA256 et SHA256 comme indiqué ci-dessous.

   e. Mettez à jour l’URL Assertion Consumer Service (URL de réponse) à partir de l’URL par défaut pour que l’URL dans GitHub corresponde à celle de l’inscription de l’application Azure.

   

5. Cliquez sur Tester la configuration SAML pour vérifier l’absence d’échecs ou d’erreurs de validation pendant l’authentification unique (SSO).

   

6. Cliquez sur Enregistrer.

Notes

L’authentification unique dans GitHub authentifie auprès d’une organisation dans GitHub, et ne remplace pas l’authentification GitHub. Par conséquent, si la session github.com de l’utilisateur a expiré, vous pouvez être invité à vous authentifier avec un ID ou un mot de passe GitHub pendant le processus d’authentification unique.

Créer un utilisateur de test GitHub

L’objectif de cette section est de créer un utilisateur appelé Britta Simon dans GitHub. GitHub prend en charge l’attribution automatique d’utilisateurs, qui est activée par défaut. Vous trouverez plus d’informations ici sur la façon de configurer l’attribution automatique d’utilisateurs.

Si vous avez besoin de créer un utilisateur manuellement, procédez comme suit :

1. Connectez-vous à votre site d’entreprise GitHub en tant qu’administrateur.

2. Cliquez sur People.

   

3. Cliquez sur Invite member.

   

4. Dans la boîte de dialogue Invite member, procédez comme suit :

   a. Dans la zone de texte E-mail , tapez l’adresse de messagerie du compte de Britta Simon.

   

   b. Cliquez sur Send Invitation.

   

   Remarque

   Le titulaire du compte Microsoft Entra reçoit alors un e-mail contenant un lien pour confirmer son compte avant qu’il ne soit activé.

Tester l’authentification unique (SSO)

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

• Cliquez sur Tester cette application. Vous êtes alors redirigé vers l’URL de connexion à GitHub, d’où vous pouvez lancer le flux de connexion.

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

• Vous pouvez utiliser Mes applications de Microsoft. Un clic sur la vignette GitHub dans Mes applications vous redirige vers l’URL de connexion GitHub. Pour plus d’informations sur Mes applications, consultez Présentation de Mes applications.

Étapes suivantes

Une fois que vous avez configuré GitHub, 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.