Share via

Zelfstudie: Integratie van eenmalige aanmelding van Microsoft Entra met GitHub Enterprise Server

  • Artikel

In deze zelfstudie 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.

Vereisten

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 Cloud Application Beheer istrator kan Application Beheer istrator ook toepassingen toevoegen of beheren in Microsoft Entra-id. Zie Ingebouwde rollen in Azure voor meer informatie.

Beschrijving van scenario

In deze zelfstudie configureert en test u eenmalige aanmelding van Microsoft Entra in een testomgeving.

  • GitHub Enterprise Server biedt ondersteuning voor door SP en IDP geïnitieerde eenmalige aanmelding.
  • GitHub Enterprise Server biedt ondersteuning voor het Just In Time inrichten van gebruikers.
  • GitHub Enterprise Server biedt ondersteuning voor het geautomatiseerd inrichten 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 ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Nieuwe toepassing.
  3. Typ in de sectie Toevoegen uit de galerie in het zoekvak: GitHub Enterprise Server.
  4. Selecteer GitHub Enterprise Server in het resultatenvenster en voeg de app vervolgens toe. Wacht enkele seconden tot de app aan de tenant 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 ook 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.

Eenmalige aanmelding voor Microsoft Entra configureren

Volg deze stappen om eenmalige aanmelding van Microsoft Entra in te schakelen.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.

  2. Blader naar Identity>Applications Enterprise-toepassingen>>gitHub Enterprise Server-eenmalige> aanmelding.

  3. Selecteer SAML op de pagina Selecteer een methode voor eenmalige aanmelding.

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

    Screenshot shows to edit Basic S A M L Configuration.

  5. In het gedeelte Standaard SAML-configuratie voert u de volgende stappen uit als u de toepassing in de door IDP geïnitieerde modus wilt configureren:

    a. In het tekstvak Id (Entiteits-id) typt u een URL met de volgende notatie: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

    b. In het tekstvak Antwoord-URL typt u een URL met de volgende notatie: 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 de door SP geïnitieerde modus wilt configureren:

    In het tekstvak Aanmeldings-URL typt u een URL met de volgende notatie: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

    Notitie

    Dit zijn geen echte waarden. 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 op te vragen. 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 schermafbeelding wordt de lijst met standaardkenmerken weergegeven.

    Screenshot shows the image of Enterprise Server application.

  8. Gebruikerskenmerken en -claims bewerken.

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

  10. Vouw Claimvoorwaarden uit en selecteer Leden van gebruikerstype.

  11. Klik op 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) in voor de waarde.

  13. Klik op Opslaan.

    Screenshot shows to manage claim for attributes.

    Notitie

    Als u wilt weten hoe u een claim toevoegt, volgt u deze link.

  14. Op de pagina Eenmalige aanmelding met SAML instellen in de sectie SAML-handtekeningcertificaat gaat u naar Certificaat (Base64) en selecteert u Downloaden om het certificaat te downloaden en op te slaan op uw computer.

    Screenshot shows the Certificate download link.

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

    Screenshot shows to copy appropriate configuration U R L.

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 gebruiker Beheer istrator.
  2. Blader naar Identiteitsgebruikers>>Alle gebruikers.
  3. Selecteer Nieuwe gebruiker Nieuwe gebruiker> maken bovenaan het scherm.
  4. Voer in de gebruikerseigenschappen de volgende stappen uit:
    1. Voer in het veld Weergavenaam de tekst in B.Simon.
    2. Voer in het veld User Principal Name de username@companydomain.extensionnaam in. 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 Controleren + maken.
  5. Selecteer Maken.

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 ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Enterprise-toepassingen voor identiteitstoepassingen>>>GitHub Enterprise Server.
  3. Selecteer gebruikers en groepen op de overzichtspagina van de app.
  4. Selecteer Gebruiker/groep toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
    1. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
    2. Als u verwacht dat er een rol aan de gebruikers moet worden toegewezen, kunt u de rol selecteren in de vervolgkeuzelijst Selecteer een rol. 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.

Eenmalige aanmelding met GitHub Enterprise Server configureren

Als u eenmalige aanmelding wilt configureren in GitHub Enterprise Server, volg dan de instructies hier.

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 ondersteunt het Just-In-Time inrichten 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 ondersteunt ook automatische inrichting van gebruikers. Meer details over het configureren van automatische inrichting van gebruikers vindt u hier.

Eenmalige aanmelding testen

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

Met SP geïnitieerd:

  • Klik op Deze toepassing testen. U wordt 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.

Met IDP geïnitieerd:

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

U kunt ook Mijn apps van Microsoft gebruiken om de toepassing in een willekeurige modus te testen. Wanneer u in de 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 Mijn apps voor meer informatie.

Volgende stappen