Dela via

Självstudie: Microsoft Entra SSO-integrering med en GitHub Enterprise-molnorganisation

  • Artikel

I den här självstudien får du lära dig hur du integrerar en GitHub Enterprise-molnorganisation med Microsoft Entra-ID. När du integrerar en GitHub Enterprise-molnorganisation med Microsoft Entra-ID kan du:

  • Kontroll i Microsoft Entra-ID som har åtkomst till din GitHub Enterprise-molnorganisation.
  • Hantera åtkomst till din GitHub Enterprise-molnorganisation på en central plats.

Förutsättningar

För att komma igång behöver du följande:

Beskrivning av scenario

I den här självstudien konfigurerar och testar du enkel inloggning med Microsoft Entra i en testmiljö.

För att konfigurera integreringen av GitHub i Microsoft Entra-ID måste du lägga till GitHub från galleriet i din lista över hanterade SaaS-appar.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
  2. Bläddra till Identity>Applications Enterprise-program>>Nytt program.
  3. I avsnittet Lägg till från galleriet skriver du GitHub i sökrutan.
  4. Välj GitHub Enterprise Cloud – Organisation från resultatpanelen och lägg sedan till appen. Vänta några sekunder medan appen läggs till i din klientorganisation.

Du kan också använda guiden Konfiguration av företagsappar. I den här guiden kan du lägga till ett program i din klientorganisation, lägga till användare/grupper i appen, tilldela roller samt gå igenom SSO-konfigurationen. Läs mer om Microsoft 365-guider.

Konfigurera och testa Microsoft Entra SSO för GitHub

Konfigurera och testa Microsoft Entra SSO med GitHub med hjälp av en testanvändare med namnet B.Simon. För att enkel inloggning ska fungera måste du upprätta en länkrelation mellan en Microsoft Entra-användare och den relaterade användaren i GitHub.

Utför följande steg för att konfigurera och testa Microsoft Entra SSO med GitHub:

  1. Konfigurera Microsoft Entra SSO – så att användarna kan använda den här funktionen.
    1. Skapa en Microsoft Entra-testanvändare – för att testa enkel inloggning med Microsoft Entra med B.Simon.
    2. Tilldela Microsoft Entra-testanvändaren – för att göra det möjligt för B.Simon att använda enkel inloggning med Microsoft Entra.
  2. Konfigurera GitHub SSO – för att konfigurera inställningarna för enkel inloggning på programsidan.
    1. Skapa GitHub-testanvändare – för att ha en motsvarighet till B.Simon i GitHub som är länkad till Microsoft Entra-representationen av användaren.
  3. Testa enkel inloggning – för att kontrollera om konfigurationen fungerar.

Konfigurera enkel inloggning med Microsoft Entra

Följ de här stegen för att aktivera Enkel inloggning i Microsoft Entra.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till Identity>Applications>Enterprise-program> GitHub>Enkel inloggning.

  3. På sidan Välj en enkel inloggningsmetod väljer du SAML.

  4. På sidan Konfigurera enkel inloggning med SAML klickar du på pennikonen för Grundläggande SAML-konfiguration för att redigera inställningarna.

    Redigera grundläggande SAML-konfiguration

  5. I avsnittet Grundläggande SAML-konfiguration anger du värdena för följande fält:

    a. I textrutan Identifierare (entitets-ID) anger du en URL enligt följande mönster: https://github.com/orgs/<Organization ID>

    b. Skriv en URL med följande mönster i textrutan Svars-URL: https://github.com/orgs/<Organization ID>/saml/consume

    c. I textrutan Inloggnings-URL anger du en URL enligt följande mönster: https://github.com/orgs/<Organization ID>/sso

    Kommentar

    Observera att detta inte är de verkliga värdena. Du måste uppdatera dessa värden med faktisk identifierare, svars-URL och inloggnings-URL. Här föreslår vi att du använder det unika värdet för strängen i identifieraren. Gå till GitHub-administrationsavsnittet för att hämta dessa värden.

  6. GitHub-programmet förväntar sig SAML-intyg i ett visst format, vilket kräver att du lägger till anpassade attributmappningar i konfigurationen av SAML-tokenattribut. Följande skärmbild visar listan över standardattribut, medan unik användaridentifierare (namn-ID) mappas med user.userprincipalname. GitHub-programmet förväntar sig att unik användaridentifierare (namn-ID) mappas med user.mail, så du måste redigera attributmappningen genom att klicka på ikonen Redigera och ändra attributmappningen.

    Skärmbild som visar avsnittet

  7. På sidan Konfigurera enkel inloggning med SAML går du till avsnittet SAML-signeringscertifikat, klickar du på Ladda ned för att ladda ned Certifikat (Base64) från de angivna alternativen enligt dina behov och sparar det på datorn.

    Länk för nedladdning av certifikatet

  8. I avsnittet Konfigurera GitHub kopierar du lämpliga URL:er efter behov.

    Kopiera konfigurations-URL:er

Skapa en Microsoft Entra-testanvändare

I det här avsnittet skapar du en testanvändare med namnet B.Simon.

  1. Logga in på administrationscentret för Microsoft Entra som minst användaradministratör.
  2. Gå till Identitet>Användare>Alla användare.
  3. Välj Ny användare>Skapa ny användare överst på skärmen.
  4. Följ dessa steg i användaregenskaperna :
    1. I fältet Visningsnamn anger du B.Simon.
    2. I fältet Användarens huvudnamn anger du username@companydomain.extension. Exempel: B.Simon@contoso.com
    3. Markera kryssrutan Visa lösenord och skriv sedan ned det värde som visas i rutan Lösenord.
    4. Välj Granska + skapa.
  5. Välj Skapa.

Tilldela Microsoft Entra-testanvändaren

I det här avsnittet gör du det möjligt för B.Simon att använda enkel inloggning genom att ge åtkomst till GitHub.

  1. Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.

  2. Bläddra till GitHub för Identity>Applications Enterprise-program.>>

  3. På appens översiktssida hittar du avsnittet Hantera och väljer Användare och grupper.

  4. Välj Lägg till användare och välj sedan Användare och grupper i dialogrutan Lägg till tilldelning .

  5. I dialogrutan Användare och grupper väljer du B.Simon i listan Användare och klickar sedan på knappen Välj längst ned på skärmen.

  6. Om du förväntar dig att en roll ska tilldelas till användarna kan du välja den i listrutan Välj en roll . Om ingen roll har konfigurerats för den här appen visas rollen "Standardåtkomst" markerad.

    användarroll

  7. I dialogrutan Lägg till tilldelning klickar du på knappen Tilldela.

Konfigurera Enkel inloggning i GitHub

  1. Logga in på din GitHub-organisationswebbplats som administratör i ett annat webbläsarfönster.

  2. Gå till Inställningar och klicka på Säkerhet.

    Skärmbild som visar menyn

  3. Markera rutan Aktivera SAML-autentisering och visa konfigurationsfälten för enkel inloggning och utför följande steg:

    Skärmbild som visar avsnittet

    a. Kopiera url-värdet för enkel inloggning och klistra in det här värdet i textrutan Inloggnings-URL i den grundläggande SAML-konfigurationen.

    b. Kopiera värdet för konsumenttjänstens URL för försäkran och klistra in det här värdet i textrutan Svars-URL i den grundläggande SAML-konfigurationen.

  4. Konfigurera följande fält:

    Skärmbild som visar textrutorna

    a. I textrutan Inloggnings-URL klistrar du in värdet för inloggnings-URL som du kopierade tidigare.

    b. I textrutan Utfärdare klistrar du in det Microsoft Entra-identifierarvärde som du kopierade tidigare.

    c. Öppna det nedladdade certifikatet från Azure-portalen i Anteckningar och klistra in innehållet i textrutan Offentligt certifikat.

    d. Klicka på ikonen Redigera för att redigera Signature Method (Signaturmetod) och Digest Method (Hashmetod) från RSA-SHA1 och SHA1 till RSA-SHA256 och SHA256 enligt nedan.

    e. Uppdatera url:en för konsumenttjänsten för försäkran (svars-URL) från standard-URL:en så att URL:en i GitHub matchar URL:en i Azure-appregistreringen.

    Skärmbild som visar bilden.

  5. Klicka på Testa SAML-konfiguration för att bekräfta att inga verifieringsfel eller andra fel inträffade under enkel inloggning.

    Skärmbild som visar inställningarna.

  6. Klicka på Spara

Kommentar

Enkel inloggning i GitHub autentiserar till en specifik organisation i GitHub och ersätter inte autentisering av själva GitHub. Om användarens github.com-session har upphört att gälla kan det därför hända att du blir ombedd att autentisera med ID/lösenord för GitHub under processen för enkel inloggning.

Skapa GitHub-testanvändare

Målet med det här avsnittet är att skapa en användare som kallas Britta Simon i GitHub. GitHub stöder automatisk användaretablering, vilket är aktiverat som standard. Du hittar mer information här om hur du konfigurerar automatisk användaretablering.

Om du behöver skapa användare manuellt så gör du följande:

  1. Logga in på din GitHub-företagsplats som administratör.

  2. Klicka på Personer.

    Skärmbild som visar GitHub-webbplatsen med Personer valt.

  3. Klicka på Invite member (Bjud in medlem).

    Skärmbild som visar bjud in användare.

  4. På dialogrutan Invite member (Bjud in medlem) utför du följande steg:

    a. I textrutan E-post anger du e-postadressen för Britta Simon-kontot.

    Skärmbild som visar Bjud in personer.

    b. Klicka på Skicka inbjudan.

    Skärmbild som visar dialogrutan

    Kommentar

    Microsoft Entra-kontoinnehavaren får ett e-postmeddelande och följer en länk för att bekräfta sitt konto innan det blir aktivt.

Testa enkel inloggning

I det här avsnittet testar du konfigurationen av enkel inloggning med Microsoft Entra med följande alternativ.

  • Klicka på Testa det här programmet, detta omdirigeras till GitHub-inloggnings-URL där du kan initiera inloggningsflödet.

  • Gå till GitHub-inloggnings-URL direkt och initiera inloggningsflödet därifrån.

  • Du kan använda Microsoft Mina appar. När du klickar på GitHub-panelen i Mina appar omdirigeras den till GitHub-inloggnings-URL. Mer information om Mina appar finns i Introduktion till Mina appar.

Nästa steg

När du har konfigurerat GitHub kan du framtvinga sessionskontroll, vilket skyddar exfiltrering och infiltration av organisationens känsliga data i realtid. Sessionskontrollen utökas från villkorlig åtkomst. Lär dig hur du framtvingar sessionskontroll med Microsoft Defender för molnet Apps.