Sdílet prostřednictvím

Kurz: Integrace jednotného přihlašování Microsoft Entra s GitHub Enterprise Serverem

  • Článek

V tomto kurzu se dozvíte, jak integrovat GitHub Enterprise Server s Microsoft Entra ID. Když integrujete GitHub Enterprise Server s Microsoft Entra ID, můžete:

  • Řízení v Microsoft Entra ID, který má přístup k GitHub Enterprise Serveru.
  • Povolte uživatelům automatické přihlášení k GitHub Enterprise Serveru pomocí jejich účtů Microsoft Entra.
  • Spravujte účty v jednom centrálním umístění.

Požadavky

Abyste mohli začít, potřebujete následující položky:

  • Předplatné Microsoft Entra. Pokud předplatné nemáte, můžete získat bezplatný účet.
  • GitHub Enterprise Server připravený k inicializaci.
  • Spolu s cloudovou aplikací Správa istrator může aplikace Správa istrator přidávat nebo spravovat aplikace v Microsoft Entra ID. Další informace najdete v tématu Předdefinované role v Azure.

Popis scénáře

V tomto kurzu nakonfigurujete a otestujete jednotné přihlašování Microsoft Entra v testovacím prostředí.

  • GitHub Enterprise Server podporuje jednotné přihlašování iniciované sp a IDP.
  • GitHub Enterprise Server podporuje zřizování uživatelů za běhu .
  • GitHub Enterprise Server podporuje automatizované zřizování uživatelů.

Pokud chcete nakonfigurovat integraci GitHub Enterprise Serveru do Microsoft Entra ID, musíte přidat GitHub Enterprise Server z galerie do seznamu spravovaných aplikací SaaS.

  1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.
  2. Přejděte k podnikovým aplikacím>Identita>Aplikace>– Nová aplikace.
  3. V části Přidat z galerie zadejte do vyhledávacího pole GitHub Enterprise Server.
  4. Na panelu výsledků vyberte GitHub Enterprise Server a pak přidejte aplikaci. Počkejte několik sekund, než se aplikace přidá do vašeho tenanta.

Alternativně můžete také použít Průvodce konfigurací podnikové aplikace. V tomto průvodci můžete do tenanta přidat aplikaci, přidat uživatele nebo skupiny do aplikace, přiřadit role a také si projít konfiguraci jednotného přihlašování. Přečtěte si další informace o průvodcích Microsoft 365.

Konfigurace a testování jednotného přihlašování Microsoft Entra pro GitHub Enterprise Server

Nakonfigurujte a otestujte jednotné přihlašování Microsoft Entra s GitHub Enterprise Serverem pomocí testovacího uživatele s názvem B.Simon. Aby jednotné přihlašování fungovalo, musíte vytvořit vztah propojení mezi uživatelem Microsoft Entra a souvisejícím uživatelem na GitHub Enterprise Serveru.

Pokud chcete nakonfigurovat a otestovat jednotné přihlašování Microsoft Entra s GitHub Enterprise Serverem, proveďte následující kroky:

  1. Nakonfigurujte jednotné přihlašování Microsoft Entra – aby uživatelé mohli tuto funkci používat.
    1. Vytvoření testovacího uživatele Microsoft Entra – k otestování jednotného přihlašování Microsoft Entra pomocí B.Simon.
    2. Přiřaďte testovacího uživatele Microsoft Entra – aby B.Simon mohl používat jednotné přihlašování Microsoft Entra.
  2. Konfigurace jednotného přihlašování k GitHub Enterprise Serveru – konfigurace nastavení jednotného přihlašování na straně aplikace
    1. Vytvořte testovacího uživatele GitHub Enterprise Serveru – aby měl protějšek B.Simon na GitHub Enterprise Serveru, který je propojený s reprezentací uživatele Microsoft Entra.
  3. Otestujte jednotné přihlašování a ověřte, jestli konfigurace funguje.

Konfigurace jednotného přihlašování Microsoft Entra

Následujícím postupem povolíte jednotné přihlašování microsoftu Entra.

  1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.

  2. Přejděte k podnikovým aplikacím>identit>>GitHub Enterprise Server>s jednotným přihlašováním.

  3. Na stránce Vybrat metodu jednotného přihlašování vyberte SAML.

  4. Na stránce Nastavení jednotného přihlašování pomocí SAML klikněte na ikonu tužky pro základní konfiguraci SAML a upravte nastavení.

    Screenshot shows to edit Basic S A M L Configuration.

  5. Pokud chcete nakonfigurovat aplikaci v režimu iniciovaném protokolem IDP, proveďte v části Základní konfigurace SAML následující kroky:

    a. Do textového pole Identifikátor (ID entity) zadejte adresu URL pomocí následujícího vzoru: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

    b. Do textového pole Adresa URL odpovědi zadejte adresu URL pomocí následujícího vzoru: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

  6. Klikněte na Nastavit další adresy URL a proveďte následující krok, pokud chcete nakonfigurovat aplikaci v režimu iniciovaném aktualizací SP :

    Do textového pole Přihlásit se na adresu URL zadejte adresu URL pomocí následujícího vzoru: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

    Poznámka:

    Tyto hodnoty nejsou reálné. Aktualizujte tyto hodnoty skutečným identifikátorem, adresou URL odpovědi a přihlašovací adresou URL. Pokud chcete získat tyto hodnoty, obraťte se na tým podpory klienta GitHub Enterprise Serveru. Můžete také odkazovat na vzory uvedené v části Základní konfigurace SAML.

  7. Aplikace GitHub Enterprise Serveru očekává kontrolní výrazy SAML v určitém formátu, což vyžaduje přidání mapování vlastních atributů na konfiguraci atributů tokenu SAML. Následující snímek obrazovky ukazuje seznam výchozích atributů.

    Screenshot shows the image of Enterprise Server application.

  8. Upravit atributy uživatele a deklarace identity

  9. Klikněte na Přidat novou deklaraci identity a do textového pole zadejte jméno jako správce ( v hodnotě správce se rozlišují malá a velká písmena).

  10. Rozbalte podmínky deklarace identity a vyberte Členy z typu Uživatel.

  11. Klikněte na Vybrat skupiny a vyhledejte skupinu , kterou chcete zahrnout, kde by její členové měli být správci GHES.

  12. Vyberte atribut pro zdroj a jako hodnotu zadejte true (bez uvozovek).

  13. Klikněte na možnost Uložit.

    Screenshot shows to manage claim for attributes.

    Poznámka:

    Pokud chcete vědět, jak přidat deklaraci identity, postupujte podle odkazu.

  14. Na stránce Nastavit jednotné přihlašování pomocí SAML v části Podpisový certifikát SAML vyhledejte certifikát (Base64) a vyberte Stáhnout a stáhněte certifikát a uložte ho do počítače.

    Screenshot shows the Certificate download link.

  15. V části Nastavení GitHub Enterprise Serveru zkopírujte odpovídající adresy URL podle vašeho požadavku.

    Screenshot shows to copy appropriate configuration U R L.

Vytvoření testovacího uživatele Microsoft Entra

V této části vytvoříte testovacího uživatele s názvem B.Simon.

  1. Přihlaste se k Centru pro správu Microsoft Entra alespoň jako uživatel Správa istrator.
  2. Přejděte k identitě>Uživatelé>Všichni uživatelé.
  3. V horní části obrazovky vyberte Nový uživatel>Vytvořit nového uživatele.
  4. Ve vlastnostech uživatele postupujte takto:
    1. Do pole Zobrazovaný název zadejte B.Simon.
    2. Do pole Hlavní název uživatele zadejte .username@companydomain.extension Například B.Simon@contoso.com.
    3. Zaškrtněte políčko Zobrazit heslo a potom poznamenejte hodnotu, která se zobrazí v poli Heslo.
    4. Vyberte Zkontrolovat a vytvořit.
  5. Vyberte Vytvořit.

Přiřazení testovacího uživatele Microsoft Entra

V této části povolíte B.Simonu používat jednotné přihlašování tím, že udělíte přístup k GitHub Enterprise Serveru.

  1. Přihlaste se do Centra pro správu Microsoft Entra jako alespoň cloudová aplikace Správa istrator.
  2. Přejděte na Podnikové aplikace Identita>Applications>>GitHub Enterprise Server.
  3. Na stránce s přehledem aplikace vyberte Uživatelé a skupiny.
  4. Vyberte Přidat uživatele nebo skupinu a pak v dialogovém okně Přidat přiřazení vyberte Uživatelé a skupiny.
    1. V dialogovém okně Uživatelé a skupiny vyberte B.Simon ze seznamu Uživatelé a potom klikněte na tlačítko Vybrat v dolní části obrazovky.
    2. Pokud očekáváte přiřazení role uživatelům, můžete ji vybrat v rozevíracím seznamu Vybrat roli . Pokud pro tuto aplikaci nebyla nastavena žádná role, zobrazí se vybraná výchozí role pro přístup.
    3. V dialogovém okně Přidat přiřazení klikněte na tlačítko Přiřadit .

Konfigurace jednotného přihlašování k GitHubu Enterprise Serveru

Pokud chcete nakonfigurovat jednotné přihlašování na straně GitHub Enterprise Serveru, musíte postupovat podle zde uvedených pokynů.

Vytvoření testovacího uživatele GitHub Enterprise Serveru

V této části se na GitHub Enterprise Serveru vytvoří uživatel S názvem B.Simon. GitHub Enterprise Server podporuje zřizování uživatelů za běhu, které je ve výchozím nastavení povolené. V této části není žádná položka akce. Pokud uživatel na GitHub Enterprise Serveru ještě neexistuje, vytvoří se po ověření nový.

GitHub Enterprise Server také podporuje automatické zřizování uživatelů. Další podrobnosti o konfiguraci automatického zřizování uživatelů najdete tady .

Testování jednotného přihlašování

V této části otestujete konfiguraci jednotného přihlašování Microsoft Entra s následujícími možnostmi.

Inicializovaná aktualizace:

  • Klikněte na Otestovat tuto aplikaci. Tím se přesměruje na přihlašovací adresu URL GitHub Enterprise Serveru, kde můžete zahájit tok přihlášení.

  • Přejděte přímo na přihlašovací adresu URL GitHub Enterprise Serveru a spusťte tok přihlášení odtud.

Iniciovaný protokol IDP:

  • Klikněte na Otestovat tuto aplikaci a měli byste být automaticky přihlášení k Serveru GitHub Enterprise, pro který jste nastavili jednotné přihlašování.

K otestování aplikace v libovolném režimu můžete také použít Microsoft Moje aplikace. Když kliknete na dlaždici GitHub Enterprise Server v Moje aplikace, pokud je nakonfigurovaný v režimu sp, budete přesměrováni na přihlašovací stránku aplikace pro zahájení toku přihlášení a pokud je nakonfigurovaný v režimu IDP, měli byste být automaticky přihlášení k Serveru GitHub Enterprise, pro který jste nastavili jednotné přihlašování. Další informace naleznete v tématu Microsoft Entra Moje aplikace.

Další kroky