Delen via

Zelfstudie: Integratie van eenmalige aanmelding van Microsoft Entra met GitHub Enterprise Cloud - Enterprise Account

  • Artikel

In deze zelfstudie leert u hoe u een Microsoft Entra SAML-integratie instelt met een GitHub Enterprise Cloud - Enterprise-account. Wanneer u GitHub Enterprise Cloud - Enterprise Account integreert met Microsoft Entra ID, kunt u het volgende doen:

  • In Microsoft Entra-id beheren wie toegang heeft tot een GitHub Enterprise-account en alle organisaties binnen het Enterprise-account.

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.
  • Een GitHub Enterprise Account.
  • Een GitHub-gebruikersaccount dat eigenaar is van een Enterprise-account.

Beschrijving van scenario

In deze zelfstudie configureert u een SAML-integratie voor een GitHub Enterprise-account en test u enterprise-accounteigenaar en verificatie en toegang van leden van een onderneming/organisatie.

Notitie

De GitHub-toepassing Enterprise Cloud - Enterprise Account biedt geen ondersteuning voor het inschakelen van automatische SCIM-inrichting. Als u inrichting moet instellen voor uw GitHub Enterprise Cloud-omgeving, moet SAML worden geconfigureerd op organisatieniveau en moet de GitHub Enterprise Cloud - Organization Microsoft Entra-toepassing worden gebruikt. Als u een SAML- en SCIM-inrichtingsintegratie instelt voor een onderneming die is ingeschakeld voor enterprise managed users (EMU's), moet u de GitHub Enterprise Managed User Microsoft Entra-toepassing gebruiken voor SAML/Provisioning-integraties of de GitHub Enterprise Managed User (OIDC) Microsoft Entra-toepassing voor OIDC/Provisioning-integraties.

  • GitHub Enterprise Cloud - Enterprise Account biedt ondersteuning voor door SP en IDP geïnitieerde eenmalige aanmelding.

GitHub Enterprise Cloud - Enterprise Account toevoegen vanuit de galerie

Als u de integratie van GitHub Enterprise Cloud - Enterprise Account in Microsoft Entra ID wilt configureren, moet u GitHub Enterprise Cloud - Enterprise Account 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 GitHub Enterprise Cloud - Enterprise Account in het zoekvak in de sectie Toevoegen uit galerie.
  4. Selecteer GitHub Enterprise Cloud - Enterprise Account in het resultatenvenster en voeg de app 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 de configuratie van eenmalige aanmelding doorlopen. Meer informatie over Microsoft 365-wizards.

Eenmalige aanmelding van Microsoft Entra configureren en testen voor GitHub Enterprise Cloud - Enterprise Account

Configureer en test eenmalige aanmelding van Microsoft Entra met GitHub Enterprise Cloud - Enterprise Account 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 Cloud - Enterprise Account.

Voer de volgende stappen uit om eenmalige aanmelding van Microsoft Entra met GitHub Enterprise Cloud - Enterprise Account 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 uw Microsoft Entra-gebruiker en het testgebruikersaccount toe aan de GitHub-app , zodat uw gebruikersaccount en testgebruiker B.Simon eenmalige aanmelding van Microsoft Entra kunnen gebruiken.
  2. SAML inschakelen en testen voor het Enterprise-account en de bijbehorende organisaties - voor het configureren van de instellingen voor eenmalige aanmelding aan de kant van de toepassing.
    1. Eenmalige aanmelding testen met een andere accounteigenaar of account van een ander lid van de organisatie - 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 Cloud - Enterprise Account>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.

    Edit Basic SAML Configuration

  5. In de sectie Standaard SAML-configuratie voert u de volgende stappen uit:

    a. In het tekstvak Id (Entiteits-id) typt u een URL met de volgende notatie: https://github.com/enterprises/<ENTERPRISE-SLUG>

    b. In het tekstvak Antwoord-URL typt u een URL met de volgende notatie: https://github.com/enterprises/<ENTERPRISE-SLUG>/saml/consume

  6. 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://github.com/enterprises/<ENTERPRISE-SLUG>/sso

    Notitie

    Vervang <ENTERPRISE-SLUG> door de werkelijke naam van uw GitHub Enterprise-account.

  7. 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.

    The Certificate download link

  8. Kopieer in de sectie GitHub Enterprise Cloud-Enterprise Account instellen de juiste URL('s) op basis van uw behoeften.

    Copy configuration URLs

Een Microsoft Entra-testgebruiker maken

In deze sectie gaat u in Azure Portal een testgebruiker maken 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.

Uw Microsoft Entra-gebruiker en het testgebruikersaccount toewijzen aan de GitHub-app

In deze sectie geeft u B.Simon en uw gebruikersaccount toestemming om eenmalige aanmelding van Azure te gebruiken door toegang te verlenen tot GitHub Enterprise Cloud - Enterprise Account.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassing Beheer istrator.
  2. Blader naar Bedrijfstoepassingen voor Identiteitstoepassingen>>>GitHub Enterprise Cloud - Enterprise Account.
  3. Zoek op de overzichtspagina van de app de sectie Beheren en selecteer Gebruikers en groepen.
  4. Selecteer Gebruiker toevoegen en selecteer vervolgens Gebruikers en groepen in het dialoogvenster Toewijzing toevoegen.
  5. Selecteer in het dialoogvenster Gebruikers en groepen de optie B.Simon en uw gebruikersaccount in de lijst Gebruikers. Klik vervolgens op de knop Selecteren onderaan het scherm.
  6. 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.
  7. Klik in het dialoogvenster Toewijzing toevoegen op de knop Toewijzen.

SAML inschakelen en testen voor de Enterprise-account en de bijbehorende organisaties

Volg de stappen in deze GitHub-documentatieals u eenmalige aanmelding wilt configureren op de GitHub Enterprise Cloud - Enterprise-accountzijde.

  1. Meld u aan bij GitHub.com met een gebruikersaccount die een eigenaar van het enterprise-account is.
  2. Kopieer de waarde uit het Login URL veld in de app en plak deze in het Sign on URL veld in de SAML-instellingen van het GitHub Enterprise-account.
  3. Kopieer de waarde uit het Azure AD Identifier veld in de app en plak deze in het Issuer veld in de SAML-instellingen van het GitHub Enterprise-account.
  4. Kopieer de inhoud van het bestand Certificaat (Base64) dat u hebt gedownload in de bovenstaande stappen van Azure Portal en plak ze in het juiste veld in de SAML-instellingen van het GitHub Enterprise-account.
  5. Klik op de Test SAML configuration knop en controleer of u zich kunt verifiëren vanuit het GitHub Enterprise-account voor Microsoft Entra-id.
  6. Wanneer de test is geslaagd, slaat u de instellingen op.
  7. Na verificatie via SAML voor de eerste keer vanuit het GitHub Enterprise-account wordt er een gekoppelde externe identiteit gemaakt in het GitHub Enterprise-account dat het aangemelde GitHub-gebruikersaccount koppelt aan het Microsoft Entra-gebruikersaccount.

Nadat u eenmalige aanmelding met SAML voor uw GitHub Enterprise-account hebt ingeschakeld, wordt eenmalige aanmelding met SAML standaard ingeschakeld voor alle organisaties die eigendom zijn van uw Enterprise-account. Alle leden moeten worden geverifieerd met eenmalige aanmelding met SAML om toegang te krijgen tot de organisaties waar ze lid van zijn, en enterprise-eigenaren moeten worden geverifieerd met behulp van eenmalige aanmelding met SAML bij het openen van een Enterprise-account.

Eenmalige aanmelding testen met een andere accounteigenaar of account van een ander lid van de organisatie

Nadat de SAML-integratie is ingesteld voor het GitHub Enterprise-account (dat ook van toepassing is op de GitHub-organisaties in het enterprise-account), moeten andere eigenaren van enterprise-accounts die zijn toegewezen aan de app in Microsoft Entra ID, kunnen navigeren naar de URL van het GitHub-ondernemingsaccount (https://github.com/enterprises/<enterprise account>), verifiëren via SAML en toegang krijgen tot het beleid en de instellingen onder het GitHub Enterprise-account.

Een organisatie-eigenaar voor een organisatie in een Enterprise-account moet een gebruiker uitnodigen om lid te worden van zijn/haar GitHub-organisatie. Meld u aan bij GitHub.com met een organisatie-eigenaarsaccount en volg de stappen in het artikel om B.Simon uit te nodigen voor de organisatie. Er moet een GitHub-gebruikersaccount worden gemaakt voor B.Simon als dat nog niet bestaat.

Als u de GitHub-organisatietoegang wilt testen onder het Enterprise-account met het testgebruikersaccount B.Simon:

  1. Nodig B.Simon uit voor een organisatie onder het Enterprise-account als een organisatie-eigenaar.
  2. Meld u aan bij GitHub.com met het gebruikersaccount dat u wilt koppelen aan het B.Simon Microsoft Entra-gebruikersaccount.
  3. Meld u met het B.Simon gebruikersaccount aan bij Microsoft Entra-id.
  4. Ga naar de GitHub-organisatie. De gebruiker moet worden gevraagd om te verifiëren via SAML. Na een geslaagde SAML-verificatie moet B.Simon toegang hebben tot de resources van de organisatie.

Volgende stappen

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