GitHub Enterprise Server configureren voor eenmalige aanmelding met Microsoft Entra-id

In dit artikel leert u hoe u GitHub Enterprise Server integreert met Microsoft Entra ID. Wanneer u GitHub Enterprise Server integreert met Microsoft Entra ID, kunt u het volgende doen:

• In Microsoft Entra-id beheren wie toegang heeft tot GitHub Enterprise Server.
• Ervoor zorgen dat gebruikers automatisch met hun Microsoft Entra-account worden aangemeld bij GitHub Enterprise Server.
• Beheer uw accounts op één centrale locatie.

Vereiste voorwaarden

U hebt het volgende nodig om aan de slag te gaan:

• Een Microsoft Entra-abonnement. Als u geen abonnement hebt, kunt u een gratis account krijgen.
• GitHub Enterprise Server, klaar voor initialisatie.
• Naast cloudtoepassingsbeheerder kan toepassingsbeheerder ook toepassingen toevoegen of beheren in Microsoft Entra-id. Zie Ingebouwde rollen in Azure voor meer informatie.

Beschrijving van scenario

In dit artikel configureer en test je Microsoft Entra SSO in een testomgeving.

• GitHub Enterprise Server ondersteunt door SP en IDP geïnitieerde eenmalige aanmelding.
• GitHub Enterprise Server biedt ondersteuning voor Just-In-Time-inrichting van gebruikers.
• GitHub Enterprise Server biedt ondersteuning voor geautomatiseerde inrichting van gebruikers.

GitHub Enterprise Server toevoegen vanuit de galerie

Als u de integratie van GitHub Enterprise Server in Microsoft Entra ID wilt configureren, moet u GitHub Enterprise Server vanuit de galerie toevoegen aan uw lijst met beheerde SaaS-apps.

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.
2. Blader naar Entra ID>Enterprise-apps>Nieuwe toepassing.
3. Typ in de sectie Toevoegen uit de galerieGitHub Enterprise Server in het zoekvak.
4. Selecteer GitHub Enterprise Server in het resultatenvenster en voeg vervolgens de app toe. Wacht enkele seconden totdat de app aan uw huurdersaccount is toegevoegd.

U kunt ook de wizard Enterprise App Configuration gebruiken. In deze wizard kunt u een toepassing toevoegen aan uw tenant, gebruikers/groepen toevoegen aan de app, rollen toewijzen en de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Eenmalige aanmelding van Microsoft Entra voor GitHub Enterprise Server configureren en testen

Configureer en test eenmalige aanmelding van Microsoft Entra met GitHub Enterprise Server met behulp van een testgebruiker met de naam B.Simon. Eenmalige aanmelding werkt alleen als u een koppelingsrelatie tot stand brengt tussen een Microsoft Entra-gebruiker en de bijbehorende gebruiker in GitHub Enterprise Server.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra met GitHub Enterprise Server te configureren en te testen:

1. Configureer eenmalige aanmelding van Microsoft Entra - zodat uw gebruikers deze functie kunnen gebruiken.
   1. Een Microsoft Entra-testgebruiker maken : eenmalige aanmelding van Microsoft Entra testen met B.Simon.
   2. Wijs de Microsoft Entra-testgebruiker toe om B.Simon in staat te stellen eenmalige aanmelding van Microsoft Entra te gebruiken.
2. Eenmalige aanmelding voor GitHub Enterprise Server configureren : als u de instellingen voor eenmalige aanmelding aan de toepassingszijde wilt configureren.
   1. Testgebruiker voor GitHub Enterprise Server maken: als u een tegenhanger van B.Simon in GitHub Enterprise Server wilt hebben die is gekoppeld aan de Microsoft Entra-weergave van de gebruiker.
3. Eenmalige aanmelding testen : om te controleren of de configuratie werkt.

De SSO van Microsoft Entra configureren

Volg deze stappen om Microsoft Entra SSO te activeren.

1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.

2. Blader naar Entra ID>Enterprise-apps>gitHub Enterprise> aanmelding.

3. Selecteer SAML op de pagina Een methode voor eenmalige aanmelding selecteren.

4. Selecteer op de pagina Eenmalige aanmelding instellen met SAML het potloodpictogram voor Standaard SAML-configuratie om de instellingen te bewerken.

   

5. Voer in de sectie Standaard SAML-configuratie de volgende stappen uit als u de toepassing in de door IDP geïnitieerde modus wilt configureren:

   a. Typ in het tekstvak Id (Entiteits-id) een URL met het volgende patroon: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

   b. Typ in het tekstvak Antwoord-URL een URL met het volgende patroon: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

6. Selecteer Extra URL's instellen en voer de volgende stap uit als u de toepassing in de door SP geïnitieerde modus wilt configureren:

   Typ in het tekstvak Aanmeldings-URL een URL met het volgende patroon: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

   Opmerking

   Deze waarden zijn niet echt. Werk deze waarden bij met de werkelijke id, antwoord-URL en aanmeldings-URL. Neem contact op met het ondersteuningsteam van GitHub Enterprise Server om deze waarden te verkrijgen. U kunt ook verwijzen naar de patronen die worden weergegeven in de sectie Standaard SAML-configuratie .

7. In de GitHub Enterprise Server-toepassing worden de SAML-asserties in een specifieke indeling verwacht. Hiervoor moet u aangepaste kenmerktoewijzingen toevoegen aan de configuratie van uw SAML-tokenkenmerken. In de volgende schermopname ziet u de lijst met standaardkenmerken.

   

8. Gebruikerskenmerken en -claims bewerken.

9. Selecteer Nieuwe claim toevoegen en voer de naam in zoals administrator in het tekstvak (de administrator waarde is hoofdlettergevoelig).

10. Vouw Claimvoorwaarden uit en selecteer Leden van het gebruikerstype.

11. Selecteer Groepen selecteren en zoek naar de groep die u wilt opnemen met deze claim, waarbij de leden beheerders moeten zijn voor GHES.

12. Selecteer Kenmerk voor bron en voer true (zonder aanhalingstekens) voor de waarde in.

13. Selecteer Opslaan.

    

14. Zoek op de pagina Eenmalige aanmelding met SAML instellen in de sectie SAML-handtekeningcertificaathet certificaat (Base64) en selecteer Downloaden om het certificaat te downloaden en op uw computer op te slaan.

    

15. In de sectie GitHub Enterprise Server instellen kopieert u de juiste URL('s) op basis van uw behoeften.

    

Microsoft Entra-testgebruiker maken en toewijzen

Volg de richtlijnen in de quickstart voor het maken en toewijzen van een gebruikersaccount om een testgebruikersaccount met de naam B.Simon te maken.

Eenmalige aanmelding voor GitHub Enterprise Server configureren

Als u eenmalige aanmelding aan de zijde van GitHub Enterprise Server wilt configureren, moet u de instructies volgen die hier worden vermeld.

Testgebruiker voor GitHub Enterprise Server maken

In deze sectie wordt een gebruiker met de naam B.Simon gemaakt in GitHub Enterprise Server. GitHub Enterprise Server biedt ondersteuning voor Just-In-Time-inrichting van gebruikers. Deze functie is standaard ingeschakeld. Er is geen actie-item voor u in deze sectie. Als er nog geen gebruiker in GitHub Enterprise Server bestaat, wordt er een nieuwe gemaakt na verificatie.

GitHub Enterprise Server biedt ook ondersteuning voor automatische inrichting van gebruikers. Hier vindt u meer informatie over het configureren van automatische inrichting van gebruikers.

Testen van Single Sign-On (SSO)

In deze sectie test u de configuratie voor eenmalige aanmelding van Microsoft Entra met de volgende opties.

DOOR SP geïnitieerd:

• Selecteer Deze toepassing testen. Met deze optie wordt u omgeleid naar de aanmeldings-URL van GitHub Enterprise Server, waar u de aanmeldingsstroom kunt initiëren.

• Ga rechtstreeks naar de aanmeldings-URL van GitHub Enterprise Server en initieer de aanmeldingsstroom daar.

IDP geïnitieerd:

• Selecteer Deze toepassing testen en u wordt automatisch aangemeld bij de GitHub Enterprise Server waarvoor u eenmalige aanmelding hebt ingesteld.

U kunt Microsoft Mijn apps ook gebruiken om de toepassing in elke modus te testen. Wanneer u de tegel GitHub Enterprise Server selecteert in Mijn apps, als deze is geconfigureerd in de SP-modus, wordt u omgeleid naar de aanmeldingspagina van de toepassing voor het initiëren van de aanmeldingsstroom. Als deze is geconfigureerd in de IDP-modus, wordt u automatisch aangemeld bij de GitHub Enterprise Server waarvoor u eenmalige aanmelding hebt ingesteld. Zie Microsoft Entra My Apps voor meer informatie.

Verwante inhoud

• SCIM-inrichting configureren om gebruikers te beheren.

• Zodra u GitHub Enterprise Server hebt geconfigureerd, kunt u sessiebeheer afdwingen, waardoor exfiltratie en infiltratie van gevoelige gegevens van uw organisatie in realtime worden beschermd. Sessiebeheer is een uitbreiding van voorwaardelijke toegang. Meer informatie over het afdwingen van sessiebeheer met Microsoft Defender voor Cloud Apps.