Configurer GitHub Enterprise Cloud comme fournisseur de services SAML

Découvrez comment configurer Auth0 comme fournisseur d’identité à l’aide du module complémentaire SAML2 Web App pour une organisation GitHub Enterprise Cloud (github.com).

Vous pouvez configurer Auth0 pour qu’il agisse comme fournisseur d’identité pour GitHub Enterprise Cloud (github.com). GitHub exige un abonnement de niveau entreprise pour permettre l’utilisation d’un IdP SAML externe.

• Pour en savoir plus sur le SSO sur GitHub, consultez About authentication with SAML single sign-on sur https://docs.github.com.
• Pour savoir comment configurer Auth0 comme fournisseur d’identité pour GitHub Enterprise Server (instance privée), consultez Configure Auth0 as Identity Provider for GitHub Enterprise Server.

​

Configurer SAML SSO dans Auth0

1. Accédez à Dashboard > Applications > Applications et créez une nouvelle application. Donnez-lui un nom explicite, comme GitHub. Vous pouvez choisir n’importe quel type d’application, mais le type Regular Web App est recommandé.

2. Accédez à l’onglet Addons et activez la bascule SAML2 Web App.

3. Dans l’onglet Settings, définissez Application Callback URL sur : https://github.com/orgs/{YOUR_GITHUB_ORG_NAME}/saml/consume.

   

4. Collez le code suivant dans la zone de texte Settings, puis cliquez sur Debug.

   {
         "audience": "https://github.com/orgs/{yourGitHubOrgName}",
         "mappings": {
       "user_id": "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
       "email": "emails",
       "name": "full_name"
         },
         "passthroughClaimsWithNoMapping": false,
         "mapIdentities": false,
         "signatureAlgorithm": "rsa-sha256",
         "digestAlgorithm": "sha256",
         "nameIdentifierProbes": [
       "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier"
         ]
       }
   
   1. Remplacez {YOUR_GITHUB_ORG_NAME} par le nom de l’organisation GitHub correspondant à votre abonnement. Le mappage enverra le user_id à GitHub comme Name Identifier. C’est une bonne option si vous activez plus d’une connexion pour l’application GitHub, car cela garantit l’unicité (chaque utilisateur aura un ID différent).
   2. Si vous utilisez une seule connexion, vous pouvez utiliser nickname ou un autre identificateur unique comme Name Identifier plus convivial (mais assurez-vous que la propriété choisie est unique). Par exemple, si vous voulez utiliser nickname comme Name Identifier, la section mappings ci-dessus ressemblera à ceci :

5. Faites défiler jusqu’au bas de l’onglet et cliquez sur Enable.

6. Dans l’onglet Usage, repérez Identity Provider Metadata et cliquez sur Download pour télécharger le fichier de métadonnées. Vous en aurez besoin lorsque vous configurerez Auth0 comme fournisseur d’identité.

   

​

Configurer SAML SSO sur GitHub

1. Suivez les instructions dans GitHub pour activer et tester l’authentification unique SAML (SSO) pour votre organisation afin de terminer la configuration dans GitHub Enterprise Cloud.
2. Vous aurez besoin des renseignements suivants :

Champ	Valeur
URL de connexion	https://{yourDomain}/samlp/{CLIENT_ID} {'{CLIENT_ID}'} correspondra au client_id de l’application GitHub que vous venez de créer dans Auth0.
Émetteur	urn:auth0:{yourTenant}
Certificat public	Téléchargez-le depuis https://{yourDomain}/pem. Ouvrez le fichier téléchargé dans un éditeur de texte, copiez-en le contenu et collez-le dans la zone de texte sur GitHub.
Méthode de signature	RSA256-SHA256
Méthode de hachage	SHA256

3. Comme le recommande la documentation de GitHub, avant d’activer SAML SSO pour votre organisation, cliquez sur Test SAML configuration pour vous assurer que les renseignements saisis sont exacts.

Lors de la configuration de l’authentification unique SAML (SSO) pour votre organisation, vous pouvez tester votre mise en œuvre sans affecter les membres de votre organisation en laissant la case Require SAML SSO authentication for all members of the organization décochée.