Application cloud GitHub Enterprise

La norme SAML (Security Assertion Markup Language) 2.0 vous permet de configurer l'authentification unique (SSO) pour un certain nombre d'applications cloud. Une fois l'authentification unique configurée, vos utilisateurs peuvent se connecter à une application à l'aide de leurs identifiants Google Workspace.

Configurer le SSO pour GitHub Enterprise à l'aide de SAML

Tout développer  |  Tout réduire

Pour ce faire, vous devez être connecté en tant que super-administrateur.

Étape 1 : Définissez Google comme fournisseur d'identité SAML

1. Connectez-vous à votre Console d'administration Google.

   Connectez-vous avec un compte disposant de droits de super-administrateur (ne se terminant pas par @gmail.com).

2. Dans la console d'administration, accédez à Menu    Applications  Applications Web et mobiles.
3. Cliquez sur Ajouter une applicationRechercher des applications.
4. Dans le champ Saisissez le nom de l'application, saisissez GitHub Enterprise.
5. Dans les résultats de recherche, pointez sur GitHub Enterprise (SAML), puis cliquez sur Sélectionner. 
6. Dans la fenêtre Informations sur le fournisseur d'identité Google, pour Option 2 : Copier l'URL SSO, l'ID d'entité et le certificat :
   1. À côté du champ URL SSO, cliquez sur Copier  et enregistrez l'URL.
   2. À côté de ID d'entité, cliquez sur Copier  et enregistrez l'URL.
   3. À côté de Certificat, cliquez sur Télécharger  pour télécharger le certificat.
      Vous avez besoin de ces informations pour effectuer la configuration dans GitHub Enterprise.
7. Cliquez sur Continuer.
8. Sur la page Détails relatifs au fournisseur de services, dans les champs URL ACS et ID d'entité, remplacez {votre-organisation} par le nom de votre organisation GitHub Enterprise.
9. Cliquez sur Continuer.
10. Dans la fenêtre Mappage des attributs, cliquez sur Sélectionner un champ et mappez les attributs de l'annuaire Google suivants aux attributs GitHub Enterprise correspondants. Les attributs firstName et lastName sont obligatoires.

    Attributs d'annuaire Google	Attributs de l'application
    Informations générales > Prénom	firstName*
    Informations générales > Nom	lastName*

11. (Facultatif) Pour ajouter d'autres mappages, cliquez sur Ajouter un mappage, puis sélectionnez les champs à mapper.
12. (Facultatif) Pour saisir des noms de groupes pertinents pour cette application :

    1. Dans le champ Appartenance à un groupe (facultatif), cliquez sur Rechercher un groupe, saisissez une ou plusieurs lettres du nom du groupe, puis sélectionnez-en un.
    2. Ajoutez des groupes si nécessaire (75 groupes au maximum).
    3. Sous Attribut de l'application, saisissez le nom d'attribut correspondant des groupes du fournisseur de services.

    Quel que soit le nombre de noms de groupes saisis, la réponse SAML inclut uniquement les groupes dont un utilisateur est membre (directement ou indirectement). Pour en savoir plus, consultez À propos du mappage des informations d'appartenance à un groupe.

13. Cliquez sur Terminer.

Étape 2 : Définissez GitHub Enterprise comme fournisseur de services SAML 2.0

1. Ouvrez une fenêtre de navigation privée et accédez à la page de connexion à GitHub Enterprise, puis connectez-vous avec votre compte administrateur GitHub Enterprise.
2. Cliquez sur votre nom d'utilisateur Settings (Paramètres).
3. Cliquez sur le nom de votre organisation Security (Sécurité).
4. Pour l'authentification unique SAML :
   • Dans le champ Sign on URL (URL d'authentification), collez l'URL SSO que vous avez copiée précédemment.
   • Dans le champ Issuer (Émetteur), collez l'ID d'entité que vous avez copié précédemment.
   • Dans le champ Public certificate (Certificat public), copiez le certificat que vous avez téléchargé précédemment.
5. Cliquez sur Test SAML configuration (Tester la configuration SAML) pour vérifier vos paramètres.
6. Cochez l'option Enable SAML authentication (Activer l'authentification SAML).
7. Cliquez sur Enregistrer.

Étape 3 : Activez l'application pour les utilisateurs

1. Connectez-vous à votre Console d'administration Google.

   Connectez-vous avec un compte disposant de droits de super-administrateur (ne se terminant pas par @gmail.com).

2. Dans la console d'administration, accédez à Menu    Applications  Applications Web et mobiles.
3. Cliquez sur GitHub Enterprise.
4. Cliquez sur Accès utilisateur.

5. Pour activer ou désactiver un service pour tous les membres de votre organisation, cliquez sur Activé pour tous ou sur Désactivé pour tous, puis sur Enregistrer.

6. (Facultatif) Pour activer ou désactiver un service pour une unité organisationnelle :

   1. Sur la gauche, sélectionnez l'unité organisationnelle souhaitée.
   2. Pour modifier l'état du service, sélectionnez Activé ou Désactivé.
   3. Choisissez une option :
      • Si l'état du service est défini sur Hérité et que vous souhaitez conserver le paramètre mis à jour, même si le paramètre parent est modifié, cliquez sur Remplacer.
      • Si l'état du service est défini sur Remplacé, cliquez sur Hériter pour rétablir le paramètre parent, ou cliquez sur Enregistrer pour conserver le nouveau paramètre, même si le paramètre parent est modifié.
        Remarque : En savoir plus sur la structure organisationnelle
7. Pour activer un service pour un ensemble d'utilisateurs au sein d'une ou de plusieurs unités organisationnelles, sélectionnez un groupe d'accès. Pour plus d'informations, consultez la section Activer ou désactiver un service pour un groupe d'accès.
8. Vérifiez que les domaines de messagerie des comptes utilisateur GitHub Enterprise correspondent au domaine principal du compte Google géré de votre organisation.

Étape 4 : Vérifiez le bon fonctionnement de l'authentification unique

GitHub Enterprise est compatible à la fois avec l'authentification unique initiée par le fournisseur d'identité et celle initiée par le fournisseur de services.  

Vérifier l'authentification unique initiée par le fournisseur d'identité

1. Connectez-vous à votre Console d'administration Google.

   Connectez-vous avec un compte disposant de droits de super-administrateur (ne se terminant pas par @gmail.com).

2. Dans la console d'administration, accédez à Menu    Applications  Applications Web et mobiles.
3. Cliquez sur GitHub Enterprise.
4. Dans la section GitHub Enterprise, cliquez sur Tester la connexion SAML. 

   L'application s'ouvre dans un onglet distinct. Si ce n'est pas le cas, corrigez le message d'erreur, puis réessayez. Pour savoir comment résoudre les problèmes, consultez Messages d'erreur liés aux applications SAML.

Vérifier l'authentification unique initiée par le fournisseur de services

1. Fermez toutes les fenêtres du navigateur.
2. Ouvrez https://github.com/orgs/{votre-organisation}/sso et essayez de vous connecter. Vous devriez être automatiquement redirigé vers la page de connexion Google.
3. Saisissez vos identifiants.

   Une fois authentifié, vous êtes automatiquement redirigé vers GitHub Enterprise.

4. Connectez-vous avec vos identifiants GitHub personnels.

_{Google, Google Workspace et les marques et logos associés sont des marques de Google LLC. Tous les autres noms de sociétés et de produits sont des marques des sociétés auxquelles ils sont associés.}