Share via

Microsoft Entra SSO-integratie met GitHub Enterprise Server

  • Artikel

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.

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, gereed voor initialisatie.
  • Naast cloudtoepassingsbeheerder kan toepassingsbeheerder ook toepassingen toevoegen of beheren in Microsoft Entra-id. Zie ingebouwde Azure-rollenvoor meer informatie.

Beschrijving van scenario

In dit artikel configureert en test u Microsoft Entra Single Sign-On (SSO) in een testomgeving.

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

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 minimaal cloudtoepassingsbeheerder.
  2. Blader naar Identity>Applications>Enterprise-toepassingen>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 terwijl de app aan uw tenant wordt toegevoegd.

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

Configureer en test Microsoft Entra SSO voor GitHub Enterprise Server

Configureer en test Microsoft Entra SSO met GitHub Enterprise Server door een testgebruiker genaamd B.Simon. SSO 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 Microsoft Entra SSO met GitHub Enterprise Server te kunnen configureren en testen:

  1. Single Sign-On van Microsoft Entra configureren - om uw gebruikers deze functie te laten gebruiken.
    1. Een Microsoft Entra-testgebruiker maken : als u eenmalige aanmelding van Microsoft Entra wilt testen met B.Simon.
    2. Wijs de Microsoft Entra-testgebruiker toe : om B.Simon in staat te stellen gebruik te maken van eenmalige aanmelding van Microsoft Entra.
  2. Eenmalige aanmelding bij 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. Test SSO (Single Sign-On) - om te controleren of de configuratie werkt.

De Microsoft Entra SSO configureren

Volg deze stappen om Microsoft Entra SSO in te schakelen.

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

  2. Blader naar Identity>Applications>Enterprise-toepassingen>GitHub Enterprise Server>Eenmalige aanmelding.

  3. Op de pagina Een methode voor eenmalige aanmelding selecteren, selecteer SAML.

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

    Schermopname van het bewerken van basic SAML-configuratie.

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

    een. 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. Klik op Extra URL's instellen en voer de volgende stap uit als u de toepassing in 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

    Notitie

    Deze waarden zijn niet echt. Werk deze waarden bij met de werkelijke id, antwoord-URL en aanmeldings-URL. Neem contact op met klantondersteuningsteam 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.

    Schermopname toont de afbeelding van de Enterprise Server-toepassing.

  8. Bewerk gebruikerskenmerken & aanspraken.

  9. Klik op Nieuwe claim toevoegen en voer de naam in als beheerder in het tekstvak (de beheerder waarde is hoofdlettergevoelig).

  10. Vergroot claimvoorwaarden en selecteer leden van gebruikerstype.

  11. Klik op Groepen selecteren en zoek naar de Groep waarin u deze claim wilt opnemen, waarbij de leden beheerders van GHES moeten zijn.

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

  13. Klik op Opslaan.

    Schermopname toont het beheren van claims voor attributen.

    Notitie

    Als u de instructies voor het toevoegen van een claim wilt weten, volgt u de koppeling.

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

    Schermopname toont de downloadkoppeling voor het certificaat.

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

    Schermopname toont het kopiëren van de juiste configuratie-URL.

Een Microsoft Entra-testgebruiker maken

In deze sectie maakt u een testgebruiker met de naam B.Simon.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een gebruikersbeheerder.
  2. Blader naar Identity>Gebruikers>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker>Maak nieuwe gebruikerbovenaan het scherm.
  4. Voer in de eigenschappen User de volgende stappen uit:
    1. Voer in het veld weergavenaamB.Simonin.
    2. Voer in het veld User Principal Name de username@companydomain.extensionin. Bijvoorbeeld B.Simon@contoso.com.
    3. Schakel het selectievakje Wachtwoord weergeven in en noteer de waarde die wordt weergegeven in het vak Wachtwoord.
    4. Selecteer Beoordelen enmaken.
  5. Selecteer Maak.

De Microsoft Entra-testgebruiker toewijzen

In deze sectie geeft u B.Simon toestemming om eenmalige aanmelding te gebruiken door toegang te verlenen tot GitHub Enterprise Server.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als minimaal een cloud-toepassingsbeheerder.
  2. Blader naar Identiteit>Toepassingen>Enterprise-toepassingen>GitHub Enterprise Server.
  3. Op de overzichtspagina van de app, selecteer Gebruikers en groepen.
  4. Selecteer Gebruiker/groep toevoegenen selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de gebruiker B.Simon in de lijst Gebruikers en klik op de knop Selecteer onderaan het scherm.
    2. Als u verwacht dat een rol wordt toegewezen aan de gebruikers, kunt u deze selecteren in de Selecteer een rol vervolgkeuzelijst. Als er geen rol is ingesteld voor deze app, wordt de rol Standaardtoegang geselecteerd.
    3. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

GitHub Enterprise Server SSO configureren

Om Single Sign-On (SSO) voor GitHub Enterprise Server te configureren, moet u de instructies volgen die hierworden 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.

Test SSO

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

Door SP geïnitieerd:

  • Klik op Test deze applicatie, dan wordt u doorgestuurd naar de aanmeld-URL van GitHub Enterprise Server waar u de aanmeldingsprocedure kunt starten.

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

De IDP is gestart.

  • Klik op Test deze toepassingen u wordt automatisch aangemeld bij de GitHub Enterprise Server waarvoor u de SSO hebt ingesteld.

U kunt Microsoft Mijn apps ook gebruiken om de toepassing in elke modus te testen. Wanneer u in Mijn apps op de tegel GitHub Enterprise Server klikt en 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 Appsvoor meer informatie.

Verwante inhoud