Konfigurera GitHub Enterprise Server för automatisk användaretablering med Microsoft Entra-ID

I den här artikeln beskrivs de steg som du behöver utföra i både GitHub Enterprise Server och Microsoft Entra-ID för att konfigurera automatisk användaretablering. När det är konfigurerat etablerar och avetablerar Microsoft Entra-ID automatiskt användare och/eller grupper till GitHub Enterprise Server med hjälp av Microsoft Entra-etableringstjänsten. Viktig information om vad den här tjänsten gör, hur den fungerar och vanliga frågor finns i Automatisera användaretablering och avetablering till SaaS-program med Microsoft Entra-ID.

Funktioner som stöds

• Skapa användare i GitHub Enterprise Server
• Ta bort användare i GitHub Enterprise Server när de inte längre behöver åtkomst
• Behåll användarattribut synkroniserade mellan Microsoft Entra ID och GitHub Enterprise Server
• Etablera grupper och gruppmedlemskap i GitHub Enterprise Server
• Enkel inloggning till GitHub Enterprise Server (rekommenderas)

Förutsättningar

Scenariot som beskrivs i den här artikeln förutsätter att du redan har följande förutsättningar:

• Ett Microsoft Entra-användarkonto med en aktiv prenumeration. Om du inte redan har ett kan du skapa ett konto kostnadsfritt.
• En av följande roller:
  • Programadministratör
  • Molnapplikationsadministratör
  • Programägare.

• GitHub Enterprise Server, fullständigt initierad och konfigurerad för inloggning med SAML SSO via din Microsoft Entra-klientorganisation.

Steg 1: Planera provisioneringsutbyggnaden

1. Lär dig mer om hur tillhandahållandetjänsten fungerar.
2. Fastställ vem som omfattas av försörjningen.
3. Ta reda på vilka data som ska mappas mellan Microsoft Entra ID och GitHub Enterprise Server.

Steg 2: Konfigurera GitHub Enterprise Server för att stödja etablering med Microsoft Entra-ID

Lär dig hur du aktiverar etablering för GitHub Enterprise Server här.

Steg 3: Lägg till GitHub Enterprise Server från Microsoft Entra-programgalleriet

Lägg till GitHub Enterprise Server från Microsoft Entra-programgalleriet för att börja hantera etablering till GitHub Enterprise Server. Om du tidigare har konfigurerat GitHub Enterprise Server för enkel inloggning kan du använda samma program. Vi rekommenderar dock att du skapar en separat app när du testar integreringen från början. Läs mer om att lägga till ett program från galleriet här.

Steg 4: Definiera vilka som omfattas av provisioner

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som etableras baserat på tilldelning till programmet, eller baserat på attribut för användaren eller gruppen. Om du väljer att avgränsa vem som ska ha åtkomst till din app baserat på tilldelning, kan du följa stegen för att tilldela användare och grupper till applikationen. Om du väljer att avgränsa vem som provisioneras enbart utifrån attributen för användaren eller gruppen kan du använda ett avgränsningsfilter.

• Börja litet. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När omfånget för etablering är inställt på tilldelade användare och grupper kan du styra detta genom att tilldela en eller två användare eller grupper till appen. När omfånget är inställt på alla användare och grupper kan du ange ett attributbaserat omfångsfilter.

• Om du behöver extra roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till GitHub Enterprise Server

Det här avsnittet vägleder dig genom stegen för att konfigurera Microsoft Entra-etableringstjänsten för att skapa, uppdatera och inaktivera användare och/eller grupper i TestApp baserat på användar- och/eller grupptilldelningar i Microsoft Entra-ID.

Så här konfigurerar du automatisk användaretablering för GitHub Enterprise Server i Microsoft Entra-ID:

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

2. Bläddra till Entra ID>Enterprise-appar

   

3. I programlistan väljer du GitHub Enterprise Server.

   

4. Välj fliken Provisionering.

   

5. Ställ in etableringsläget på Automatisk.

   

6. Under avsnittet Administratörsautentiseringsuppgifter anger du url:en för din GitHub Enterprise Server-klientorganisation och en hemlig token. Värdena för fälten är i följande format:

   • Klientorganisations-URL: https://<your-github-server-domain>/api/v3/scim
   • Hemlig token: Den personliga åtkomsttoken (PAT) som du skapade för etableringskontot i din GitHub Enterprise Server-instans.

   Välj Testanslutning för att se till att Microsoft Entra-ID kan ansluta till GitHub Enterprise Server. Om anslutningen misslyckas kontrollerar du att ditt GitHub Enterprise Server-konto har administratörsbehörighet och försöker igen.

   

7. I fältet E-postavisering anger du e-postadressen till en person eller grupp som ska få meddelanden om etableringsfel och markerar kryssrutan Skicka ett e-postmeddelande när ett fel inträffar .

   

8. Välj Spara.

9. Under avsnittet Mappningar väljer du Etablera Microsoft Entra-ID-användare.

10. Granska de användarattribut som synkroniseras från Microsoft Entra-ID till GitHub Enterprise Server i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha användarkontona i GitHub Enterprise Server för uppdateringsåtgärder. Om du väljer att ändra det matchande målattributet måste du se till att GitHub Enterprise Server-API:et stöder filtrering av användare baserat på det attributet. Välj knappen Spara för att checka in eventuella ändringar.

    Attribute	Typ
    userName	String
    externalId	String
    emails[type eq "work"].value	String
    active	Boolean
    name.givenName	String
    name.familyName	String
    name.formatted	String
    displayName	String

11. Under avsnittet Mappningar väljer du Etablera Microsoft Entra ID-grupper.

12. Granska gruppattributen som synkroniseras från Microsoft Entra-ID till GitHub Enterprise Server i avsnittet Attributmappning . Attributen som valts som Matchande egenskaper används för att matcha grupperna i GitHub Enterprise Server för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

    Attribute	Typ
    displayName	String
    externalId	String
    members	Hänvisning

13. Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i artikeln Omfångsfilter.

14. Om du vill aktivera Microsoft Entra-etableringstjänsten för GitHub Enterprise Server ändrar du etableringsstatusen till På i avsnittet Inställningar .

    

15. Definiera de användare och/eller grupper som du vill etablera till GitHub Enterprise Server genom att välja önskade värden i Omfång i avsnittet Inställningar .

    

16. När du är redo att konfigurera väljer du Spara.

    

Den här åtgärden startar den inledande synkroniseringscykeln för alla användare och/eller grupper som definierats i omfånget i avsnittet Inställningar . Den inledande cykeln tar längre tid att utföra än efterföljande cykler, som inträffar ungefär var 40:e minut så länge Microsoft Entra-etableringstjänsten körs.

Steg 6: Övervaka distributionen

När du har konfigurerat etableringen använder du följande resurser för att övervaka distributionen:

1. Använd provisioneringsloggarna för att avgöra vilka användare som har provisionerats framgångsrikt eller inte.
2. Kontrollera förloppsindikatorn för att se statusen för försörjningscykeln och hur nära den är att slutföras.
3. Om etableringskonfigurationen verkar vara i ett feltillstånd hamnar programmet i karantän. Läs mer om karantäntillstånd i artikeln karantänstatus för programvaruförsörjning.

Ändringslogg

• 2021-02-18 – Stöd för gruppetablering har lagts till.
• 2025-08-19 – Uppdaterade länkar och omnämnanden av "GitHub AE" till "GitHub Enterprise Server" för att återspegla det aktuella produktnamnet.

Ytterligare resurser

• Hantera etablering av användarkonton för Enterprise Apps
• Vad är programåtkomst och enkel inloggning med Microsoft Entra-ID?

Relaterat innehåll

• Lär dig hur du granskar loggar och hämtar rapporter om automatiseringsaktiviteter