Kurz: Konfigurace spravovaného uživatele GitHub Enterprise (OIDC) pro automatické zřizování uživatelů

Tento kurz popisuje kroky, které potřebujete provést v GitHub Enterprise Managed User (OIDC) i v Microsoft Entra ID ke konfiguraci automatického zřizování uživatelů. Při konfiguraci microsoft Entra ID automaticky zřídí a zruší zřizování uživatelů a skupin pro Uživatele spravovaného uživatele GitHub Enterprise (OIDC) pomocí služby Microsoft Entra provisioning. Důležité podrobnosti o tom, co tato služba dělá, jak funguje, a nejčastější dotazy najdete v tématu Automatizace zřizování a rušení zřizování uživatelů pro aplikace SaaS pomocí Microsoft Entra ID.

Poznámka:

GitHub Enterprise Managed User (EMU) je jiný typ účtu GitHub Enterprise. Pokud jste výslovně nepožadovali instanci EMU, máte standardní účet GitHub Enterprise. V takovém případě si projděte dokumentaci ke konfiguraci zřizování uživatelů ve vaší organizaci, která není EMU. Zřizování uživatelů není podporováno pro standardní účty GitHub Enterprise, ale podporuje se pro organizace ve standardním účtu GitHub Enterprise.

Podporované možnosti

• Vytváření uživatelů ve spravovaném uživateli GitHub Enterprise (OIDC)
• Odebrání uživatelů ve spravovaném uživateli GitHub Enterprise (OIDC), pokud už nevyžadují přístup
• Udržování atributů uživatele synchronizovaných mezi ID Microsoft Entra a spravovaným uživatelem GitHub Enterprise (OIDC)
• Zřízení skupin a členství ve skupinách ve spravovaném uživateli GitHub Enterprise (OIDC)
• Jednotné přihlašování ke spravovanému uživateli GitHub Enterprise (OIDC) (doporučeno).

Požadavky

Scénář popsaný v tomto kurzu předpokládá, že už máte následující požadavky:

• Tenant Microsoft Entra
• Jedna z následujících rolí: Správce aplikací, Správce cloudových aplikací nebo Vlastník aplikace.
• Povolili a nakonfigurovali Podnikoví spravovaní uživatelé GitHub Enterprise pro přihlášení pomocí jednotného přihlašování OIDC prostřednictvím vašeho tenanta Microsoft Entra.

Poznámka:

Tato integrace je také dostupná pro použití z prostředí Microsoft Entra US Government Cloud. Tuto aplikaci najdete v Galerii cloudových aplikací Microsoft Entra US Government a nakonfigurujete ji stejným způsobem jako ve veřejném cloudu.

Krok 1: Plánování nasazení zřizování

1. Seznamte se s fungováním služby zřizování.
2. Zjistěte, kdo bude v rozsahu zřizování.
3. Určete, jaká data se mají mapovat mezi ID Microsoft Entra a spravovaným uživatelem GitHub Enterprise.

Krok 2: Příprava na konfiguraci zřizování pomocí ID Microsoft Entra

1. Identifikujte adresu URL tenanta. Toto je hodnota, kterou zadáte do pole Adresa URL tenanta na kartě Zřizování aplikace spravovaného uživatele GitHub Enterprise.

   • V případě podniku v GitHub.com je https://api.github.com/scim/v2/enterprises/{enterprise}adresa URL tenanta .
   • V případě podniku na GHE.com je adresa URL tenanta https://api.{subdomain}.ghe.com/scim/v2/enterprises/{subdomain}

2. Ujistěte se, že jste vytvořili token s oborem scim:enterprise pro uživatele nastavení vašeho podniku. Tato hodnota se zadává do pole Token tajného kódu na kartě Zřizování aplikace spravovaného uživatele GitHub Enterprise. Viz Začínáme s podnikovými spravovanými uživateli na webu GitHub Docs.

Krok 3: Přidání spravovaného uživatele GitHub Enterprise (OIDC) z galerie aplikací Microsoft Entra

Přidejte spravovaného uživatele GitHub Enterprise (OIDC) z galerie aplikací Microsoft Entra, abyste mohli začít spravovat zřizování pro spravovaného uživatele GitHub Enterprise (OIDC). Pokud jste dříve nastavili spravovaného uživatele GitHub Enterprise (OIDC) pro jednotné přihlašování, můžete použít stejnou aplikaci. Při počátečním testování integrace se ale doporučuje vytvořit samostatnou aplikaci. Další informace o přidání aplikace z galerie najdete tady.

Krok 4: Definujte, kdo bude v oboru zřizování

Služba zřizování Microsoft Entra umožňuje určit rozsah, který bude zřízen na základě přiřazení k aplikaci nebo na základě atributů uživatele nebo skupiny. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí pro vaši aplikaci, na základě přiřazení, můžete k aplikaci přiřadit uživatele a skupiny pomocí následujících kroků. Pokud se rozhodnete nastavit rozsah uživatelů, kteří se zřídí, pouze na základě atributů jednotlivých uživatelů nebo skupin, můžete použít filtr rozsahu, jak je popsáno tady.

• Začněte v malém. Než se pustíte do zavádění pro všechny, proveďte testování s malou skupinou uživatelů a skupin. Pokud je rozsah zřizování nastavený na přiřazené uživatele a skupiny, můžete testování provést tak, že k aplikaci přiřadíte jednoho nebo dva uživatele nebo skupiny. Pokud je rozsah nastavený na všechny uživatele a skupiny, můžete určit filtr rozsahu na základě atributů.

• Pokud potřebujete další role, můžete aktualizovat manifest aplikace a přidat nové role.

Krok 5: Konfigurace automatického zřizování uživatelů pro spravovaného uživatele GitHub Enterprise (OIDC)

Tato část vás provede postupem konfigurace služby zřizování Microsoft Entra pro vytvoření, aktualizaci a zakázání uživatelů a/nebo skupin v aplikaci TestApp na základě přiřazení uživatelů a/nebo skupin v Microsoft Entra ID.

Konfigurace automatického zřizování uživatelů pro spravovaného uživatele GitHub Enterprise (OIDC) v Microsoft Entra ID:

1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň správce cloudových aplikací.

2. Přejděte k podnikovým aplikacím identit>>

   

3. V seznamu aplikací vyberte Spravovaného uživatele GitHub Enterprise (OIDC).

   

4. Vyberte kartu Zřizování.

   

5. Nastavte Režim zřizování na hodnotu Automaticky.

   

6. V části Přihlašovací údaje správce zadejte adresu URL tenanta OIDC (GitHub Enterprise Managed User) a token tajného klíče. Klikněte na Test připojení a ujistěte se, že se Microsoft Entra ID může připojit ke spravovanému uživateli GitHub Enterprise (OIDC). Pokud se připojení nezdaří, ujistěte se, že váš účet OIDC (GitHub Enterprise Managed User) vytvořil tajný token jako vlastník podniku a zkuste to znovu.

   • Do pole Adresa URL tenanta zadejte adresu URL tenanta, kterou jste identifikovali dříve.

     Pokud je například adresa URL https://github.com/enterprises/octo-corppodnikového účtu , název podnikového účtu je octo-corp.

   • Jako token tajného kódu vložte osobní přístupový token GitHubu, který jste vytvořili dříve.

     

7. Do pole Oznamovací e-mail zadejte e-mailovou adresu osoby nebo skupiny, na kterou by se měla odesílat oznámení o chybách zřizování, a zaškrtněte políčko Když dojde k selhání, poslat oznámení e-mailem.

   

8. Zvolte Uložit.

9. V části Mapování vyberte možnost Zřídit uživatele Microsoft Entra ID.

10. Zkontrolujte atributy uživatele, které jsou synchronizovány z Microsoft Entra ID do GitHub Enterprise Managed User (OIDC) v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti se používají ke shodě uživatelských účtů ve spravovaném uživateli GitHub Enterprise (OIDC) pro operace aktualizace. Pokud se rozhodnete změnit odpovídající cílový atribut, musíte zajistit, aby rozhraní API spravovaného uživatele GitHub Enterprise (OIDC) podporovalo filtrování uživatelů na základě daného atributu. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut	Typ	Podporováno pro filtrování
    externalId	String	✓
    userName	String
    aktivní	Logická hodnota
    Role.	String
    displayName	String
    name.givenName	String
    name.familyName	String
    name.formatted	String
    emails[type eq "work"].value	String
    email[type eq "home"].value	String
    email[type eq "other"].value	String

11. V části mapování vyberte Zřídit skupiny ID Microsoft Entra.

12. Zkontrolujte atributy skupiny, které jsou synchronizovány z Microsoft Entra ID do GitHub Enterprise Managed User (OIDC) v části Mapování atributů. Atributy vybrané jako odpovídající vlastnosti slouží ke shodě skupin ve spravovaném uživateli GitHub Enterprise (OIDC) pro operace aktualizace. Výběrem tlačítka Uložit potvrďte všechny změny.

    Atribut	Typ	Podporováno pro filtrování
    externalId	String	✓
    displayName	String
    členové	Reference

13. Pokud chcete nakonfigurovat filtry rozsahu, postupujte podle pokynů uvedených v kurzu k filtrům rozsahu.

14. Pokud chcete povolit službu zřizování Microsoft Entra pro spravovaného uživatele GitHub Enterprise (OIDC), změňte stav zřizování na Zapnuto v části Nastavení .

    

15. Definujte uživatele nebo skupiny, které chcete zřídit pro spravovaného uživatele GitHub Enterprise (OIDC) výběrem požadovaných hodnot v oboru v části Nastavení.

    

16. Až budete připravení zřídit, klikněte na Uložit.

    

Tato operace zahájí cyklus počáteční synchronizace všech uživatelů a skupin definovaných v nabídce Rozsah v části Nastavení. Počáteční cyklus trvá déle než následné cykly, ke kterým dochází přibližně každých 40 minut, pokud je spuštěná služba zřizování Microsoft Entra.

Krok 6: Monitorování nasazení

Po dokončení konfigurace zřizování můžete své nasazení monitorovat pomocí následujících prostředků:

1. S využitím protokolů zřizování můžete zjistit, kteří uživatelé se zřídili úspěšně a kteří neúspěšně.
2. Zkontrolujte indikátor průběhu a podívejte se na stav cyklu zřizování a jeho zavření.
3. Pokud se zdá, že konfigurace zřizování je v pořádku, aplikace přejde do karantény. Další informace o stavech karantény najdete tady.

Další materiály

• Správa zřizování uživatelských účtů pro podnikové aplikace
• Co je přístup k aplikacím a jednotné přihlašování pomocí Microsoft Entra ID?

Další kroky

• Zjistěte, jak procházet protokoly a získat sestavy aktivit zřizování.