Konfigurowanie serwera GitHub Enterprise Server na potrzeby automatycznej aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft

W tym artykule opisano kroki, które należy wykonać zarówno w usłudze GitHub Enterprise Server, jak i identyfikatorze Microsoft Entra ID, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu identyfikator Entra firmy Microsoft automatycznie aprowizuje użytkowników i/lub grupy w usłudze GitHub Enterprise Server przy użyciu usługi aprowizacji firmy Microsoft. Aby uzyskać ważne szczegółowe informacje na temat działania tej usługi, sposobu jej działania i często zadawanych pytań, zobacz Automatyzowanie aprowizacji użytkowników i anulowania aprowizacji aplikacji SaaS przy użyciu identyfikatora Entra firmy Microsoft.

Obsługiwane funkcje

Wymagania wstępne

W scenariuszu opisanym w tym artykule przyjęto założenie, że masz już następujące wymagania wstępne:

• Konto użytkownika Microsoft Entra z aktywną subskrypcją. Jeśli jeszcze go nie masz, możesz bezpłatnie utworzyć konto.
• Jedna z następujących ról:
  • Administrator aplikacji
  • Administrator aplikacji w chmurze
  • Właściciel aplikacji.

• GitHub Enterprise Server, w pełni zainicjowany i skonfigurowany do logowania przy użyciu logowania jednokrotnego SAML za pośrednictwem dzierżawy firmy Microsoft Entra.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

1. Dowiedz się, jak działa usługa aprowizacji.
2. Określ, kto znajduje się w zakresie udostępniania.
3. Określ, jakie dane mają być mapowanie między identyfikatorem Entra firmy Microsoft i serwerem GitHub Enterprise Server.

Krok 2. Konfigurowanie serwera GitHub Enterprise Server w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Dowiedz się, jak włączyć aprowizację serwera GitHub Enterprise Server tutaj.

Krok 3. Dodawanie serwera GitHub Enterprise Server z galerii aplikacji Microsoft Entra

Dodaj serwer GitHub Enterprise Server z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem na serwerze GitHub Enterprise Server. Jeśli wcześniej skonfigurowano serwer GitHub Enterprise Server na potrzeby logowania jednokrotnego, możesz użyć tej samej aplikacji. Zalecamy jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Dowiedz się więcej o dodawaniu aplikacji z galerii tutaj.

Krok 4. Określ, kto jest objęty zakresem udostępniania

Usługa aprowizacji Microsoft Entra umożliwia definiowanie, kto ma być aprowizowany na podstawie przypisania do aplikacji lub na podstawie atrybutów użytkownika lub grupy. Jeśli zdecydujesz się określić, kto ma dostęp do Twojej aplikacji na podstawie przypisania, możesz użyć kroków przypisywania użytkowników i grup do aplikacji. Jeśli zdecydujesz się określić, kto jest przydzielony wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru zakresu.

• Zacznij od małego Przeprowadź test z użyciem mniejszego zestawu użytkowników i grup, zanim wdrożysz to rozwiązanie dla wszystkich. Jeśli zakres aprowizacji jest ustawiony na przypisanych użytkowników i grupy, możesz to kontrolować, przypisując jednego lub dwóch użytkowników lub grup do aplikacji. Gdy zakres jest ustawiony na wszystkich użytkowników i grupy, można określić filtr określania zakresu na podstawie atrybutów.

• Jeśli potrzebujesz dodatkowych ról, możesz zaktualizować manifest aplikacji , aby dodać nowe role.

Krok 5. Konfigurowanie automatycznej aprowizacji użytkowników na serwerze GitHub Enterprise Server

Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji firmy Microsoft w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w usłudze TestApp na podstawie przypisań użytkowników i/lub grup w identyfikatorze Entra firmy Microsoft.

Aby skonfigurować automatyczną aprowizację użytkowników dla serwera GitHub Enterprise Server w usłudze Microsoft Entra ID:

1. Zaloguj się do centrum administracyjnego Microsoft Entra z uprawnieniami co najmniej Administratora aplikacji w chmurze.

2. Przejdź do aplikacji Entra ID>Dla przedsiębiorstw

   

3. Na liście aplikacji wybierz pozycję GitHub Enterprise Server.

   

4. Wybierz kartę Aprowizacja .

   

5. Ustaw tryb aprowizacji na automatyczny.

   

6. W sekcji Poświadczenia administratora wprowadź adres URL dzierżawy serwera GitHub Enterprise Server i token tajny. Wartości pól mają następujący format:

   • Adres URL dzierżawy: https://<your-github-server-domain>/api/v3/scim
   • Token tajny: osobisty token dostępu utworzony dla konta aprowizacji w wystąpieniu serwera GitHub Enterprise Server.

   Wybierz pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z serwerem GitHub Enterprise Server. Jeśli połączenie nie powiedzie się, upewnij się, że konto serwera GitHub Enterprise Server ma uprawnienia administratora i spróbuj ponownie.

   

7. W polu Wiadomość e-mail z powiadomieniem wprowadź adres e-mail osoby lub grupy, która powinna otrzymywać powiadomienia o błędach aprowizacji, a następnie zaznacz pole wyboru Wyślij powiadomienie e-mail po wystąpieniu błędu .

   

8. Wybierz Zapisz.

9. W sekcji Mapowania wybierz pozycję Aprowizuj użytkowników identyfikatora entra firmy Microsoft.

10. Przejrzyj atrybuty użytkownika synchronizowane z identyfikatora Entra firmy Microsoft do serwera GitHub Enterprise Server w sekcji Mapowanie atrybutów . Atrybuty wybrane jako Pasujące właściwości są używane do dopasowania kont użytkowników w usłudze GitHub Enterprise Server na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API serwera GitHub Enterprise Server obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

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

11. W sekcji Mapowania wybierz pozycję Aprowizuj grupy identyfikatorów entra firmy Microsoft.

12. Przejrzyj atrybuty grupy synchronizowane z identyfikatora Entra firmy Microsoft do serwera GitHub Enterprise Server w sekcji Mapowanie atrybutów . Atrybuty wybrane jako Właściwości dopasowania są używane do dopasowania grup w usłudze GitHub Enterprise Server do operacji aktualizacji. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Attribute	Typ
    displayName	Sznurek
    externalId	Sznurek
    members	Reference

13. Aby skonfigurować filtry określania zakresu, zapoznaj się z poniższymi instrukcjami podanymi w artykule Filtrowanie zakresu.

14. Aby włączyć usługę aprowizacji firmy Microsoft dla serwera GitHub Enterprise Server, zmień stan aprowizacji na Wł . w sekcji Ustawienia .

    

15. Zdefiniuj użytkowników i/lub grupy, które chcesz aprowizować w usłudze GitHub Enterprise Server, wybierając żądane wartości w obszarze Zakres w sekcji Ustawienia .

    

16. Gdy będziesz gotowy do konfiguracji, wybierz Zapisz.

    

Ta operacja rozpoczyna początkowy cykl synchronizacji wszystkich użytkowników i/lub grup zdefiniowanych w obszarze Zakres w sekcji Ustawienia . Cykl początkowy trwa dłużej niż kolejne cykle, które występują co około 40 minut, o ile usługa aprowizacji firmy Microsoft jest uruchomiona.

Krok 6. Monitorowanie wdrożenia

Po skonfigurowaniu aprowizacji użyj następujących zasobów, aby monitorować wdrożenie:

1. Użyj dzienników przydzielania , aby określić, którzy użytkownicy zostali pomyślnie przydzieleni lub dla których proces przydzielania się nie powiódł.
2. Sprawdź pasek postępu , aby zobaczyć stan cyklu wdrażania i sprawdzić, jak blisko jest do zakończenia.
3. Jeśli konfiguracja aprowizacji wydaje się być w złej kondycji, aplikacja przechodzi do kwarantanny. Dowiedz się więcej o stanach kwarantanny z artykułu dotyczącego statusu kwarantanny podczas aprowizacji aplikacji.

Dziennik zmian

• 02/18/2021 — Dodano obsługę aprowizacji grup.
• 08/19/2025 — Zaktualizowano linki i wzmianki o "GitHub AE" do "GitHub Enterprise Server", aby odzwierciedlić bieżącą nazwę produktu.

Dodatkowe zasoby

• Zarządzanie aprowizowaniem konta użytkownika dla aplikacji dla przedsiębiorstw
• Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?

Treści powiązane

• Dowiedz się, jak przeglądać logi i pobierać raporty dotyczące działań udostępniania