Självstudie: Konfigurera GitHub AE för automatisk användaretablering

Artikel
10/26/2023

I den här självstudien beskrivs de steg som du behöver utföra i både GitHub AE och Microsoft Entra ID för att konfigurera automatisk användaretablering. När microsoft Entra-ID konfigureras etableras och avetableras användare och/eller grupper automatiskt till GitHub AE 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 AE
Ta bort användare i GitHub AE när de inte längre behöver åtkomst
Behåll användarattribut synkroniserade mellan Microsoft Entra ID och GitHub AE
Etablera grupper och gruppmedlemskap i GitHub AE
Enkel inloggning till GitHub AE (rekommenderas)

Förutsättningar

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

En Microsoft Entra-klientorganisation
Ett användarkonto i Microsoft Entra-ID med behörighet att konfigurera etablering (till exempel programadministratör, molnprogramadministratör, programägare eller global administratör).
GitHub AE, fullständigt initierad och konfigurerad för inloggning med SAML SSO via din Microsoft Entra-klientorganisation.

Steg 1: Planera etableringsdistributionen

Lär dig mer om hur etableringstjänsten fungerar.
Ta reda på vem som finns i etableringsomfånget.
Ta reda på vilka data som ska mappas mellan Microsoft Entra ID och GitHub AE.

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

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

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

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

Steg 4: Definiera vem som ska finnas i omfånget för etablering

Med Microsoft Entra-etableringstjänsten kan du omfångsbegränsa vem som ska etableras baserat på tilldelning till programmet och eller baserat på attribut för användaren och/eller gruppen. Om du väljer att omfånget vem som ska etableras i din app baserat på tilldelning kan du använda följande steg för att tilldela användare och/eller grupper till programmet. Om du väljer att omfånget vem som ska etableras enbart baserat på attribut för användaren och/eller gruppen kan du använda ett omfångsfilter enligt beskrivningen här.

Starta i liten skala. Testa med en liten uppsättning användare och grupper innan du distribuerar till alla. När etableringsomfånget har angetts till tilldelade användare och grupper, kan du kontrollera 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 ytterligare roller kan du uppdatera programmanifestet för att lägga till nya roller.

Steg 5: Konfigurera automatisk användaretablering till GitHub AE

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 AE i Microsoft Entra-ID:

Logga in på administrationscentret för Microsoft Entra som minst molnprogramadministratör.
Bläddra till Identity>Applications Enterprise-program>
I programlistan väljer du GitHub AE.
Välj fliken Etablering.
Ange Etableringsläge som Automatiskt.
I avsnittet Administratörsautentiseringsuppgifter anger du din GitHub AE-klient-URL och hemliga token som hämtades tidigare från steg 2. Klicka på Testa Anslut ion för att se till att Microsoft Entra ID kan ansluta till GitHub AE. Om anslutningen misslyckas kontrollerar du att ditt GitHub AE-konto har administratörsbehörighet och försöker igen.
I fältet E-postavisering anger du e-postadressen till den person eller grupp som ska ta emot meddelanden om etableringsfel. Markera sedan kryssrutan Skicka ett e-postmeddelande när ett fel uppstår.
Välj Spara.
Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-användare till GitHub AE.

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

Attribut	Type
userName	String
externalId	String
emails[type eq "work"].value	String
aktiv	Booleskt
name.givenName	String
name.familyName	String
name.formatted	String
displayName	String

Under avsnittet Mappningar väljer du Synkronisera Microsoft Entra-grupper till GitHub AE.
Granska de gruppattribut som synkroniseras från Microsoft Entra-ID till GitHub AE i avsnittet Attributmappning . De attribut som valts som Matchande egenskaper används för att matcha grupperna i GitHub AE för uppdateringsåtgärder. Välj knappen Spara för att checka in eventuella ändringar.

Attribut Type

displayName String

externalId String

medlemmar Referens
Information om hur du konfigurerar omfångsfilter finns i följande instruktioner i självstudien för omfångsfilter.
Om du vill aktivera Microsoft Entra-etableringstjänsten för GitHub AE ändrar du etableringsstatusen till På i avsnittet Inställningar.
Definiera de användare och/eller grupper som du vill etablera till GitHub AE genom att välja önskade värden i Omfång i avsnittet Inställningar.
När du är redo att etablera klickar du på Spara.

Attribut	Type
displayName	String
externalId	String
medlemmar	Referens

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 till att övervaka distributionen:

Använd etableringsloggarna för att se vilka användare som har etablerats och vilka som har misslyckats
Kontrollera förloppsindikatorn för att se status för etableringscykeln och hur nära den är att slutföras
Om etableringskonfigurationen verkar innehålla fel, kommer programmet att placeras i karantän. Läs mer om karantänstatus här.