Konfigurowanie usługi Gtmhub na potrzeby automatycznej aprowizacji użytkowników

W tym artykule opisano kroki, które należy wykonać zarówno w usłudze Gtmhub, jak i identyfikatorze Entra firmy Microsoft, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje i deaprozwizuje użytkowników i grupy do Gtmhub, 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.

Uwaga

Obecnie, gdy skonfigurowana jest automatyczna aprowizacja użytkowników przy użyciu wyłącznie Microsoft Entra, firma Microsoft automatycznie anuluje aprowizowanie użytkowników i grup w usłudze Gtmhub oraz mapuje użytkowników do ich odpowiednich zespołów za pomocą usługi aprowizacji Microsoft Entra. Jednak w 2021 roku, po włączeniu jednokrotnego logowania w usłudze Gtmhub, użytkownicy są automatycznie aprowizowani w momencie logowania przez SSO i automatycznie przypisywani do odpowiedniego zespołu.

Obsługiwane możliwości

• Usuń użytkowników w usłudze Gtmhub, gdy nie będą już wymagać dostępu.
• Zachowaj synchronizację atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i usługą Gtmhub.
• Automatycznie przyporządkuj użytkowników do ich zespołów i wyrównaj ich.

Wymagania wstępne

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

• dzierżawca Microsoft Entra.
• Jedną z następujących ról: administrator aplikacji , administrator aplikacji w chmurze lub właściciel aplikacji .
• Konto Enterprise Gtmhub.

Krok 1: Zaplanuj wdrożenie usług

1. Dowiedz się więcej, jak działa usługa aprowizacji.
2. Określ, kto znajduje się w zakresie udostępniania w ramach.
3. Ustal, jakie dane mają mapowanie między identyfikatorem Entra firmy Microsoft iGtmhub.

Krok 2. Konfigurowanie usługi Gtmhub w celu obsługi mapowania zespołu i anulowania aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft

Aby połączyć aplikację do zarządzania zasobami z kontem Gtmhub, musisz wygenerować token SCIM i przygotować adres URL dzierżawy.

Aby wydać nowy token SCIM:

1. Zaloguj się na konto Gtmhub. Przejdź do Ustawienia > Konfiguracja > Tokeny interfejsu API.

   Karta tokenów interfejsu API

2. Wybierz pozycję Wystaw token i wybierz pozycję SCIM. Wprowadź nazwę tokenu i wybierz przycisk Generuj token API.

   karta generowania tokenów

3. Po wygenerowaniu tokenu możesz skopiować go i użyć w aplikacji microsoft Entra provisioning.

   

Aby utworzyć adres URL klienta:

1. Adres URL dzierżawy musi mieć następujący format:

   https://app.gtmhub.com/api/v1/scim/azure/{account_id}

2. Jeśli twoje konto Gtmhub znajduje się w centrum danych USA, musisz również dodać centrum danych do adresu URL:

   https://app.us.gtmhub.com/api/v1/scim/azure/{account_id}

3. Aby uzyskać identyfikator konta, przejdź do pozycji Ustawienia a następnie wybierz kartę Tokeny interfejsu API i skopiuj identyfikator konta:

Krok 3. Dodawanie aplikacji Gtmhub z galerii aplikacji Microsoft Entra

Dodaj aplikację Gtmhub z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w usłudze Gtmhub. Jeśli wcześniej skonfigurowano aplikację Gtmhub na potrzeby logowania jednokrotnego, możesz użyć tej samej aplikacji. Zalecamy jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Więcej informacji o dodawaniu aplikacji z galerii znajdziesz tutaj.

Krok 4: Określenie, kto jest objęty zakresem aprowizacji

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ę ustalić, kto ma mieć dostęp do Twojej aplikacji na podstawie przypisania, możesz skorzystać z kroków , aby przypisać użytkowników i grupy do aplikacji. Jeśli zdecydujesz się określić zakres przyznawania zasobów 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. W przypadku ustawienia zakresu na wszystkich użytkowników i wszystkie grupy, możesz określić filtrowanie 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 do Gtmhub

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 usługi Gtmhub w ramach Microsoft Entra ID:

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

2. Przejdź do Tożsamość>Aplikacje>Aplikacje dla przedsiębiorstw

   

3. Na liście aplikacji wybierz pozycję Gtmhub.

   

4. Wybierz kartę Provisionowanie.

   

5. Ustaw Tryb zaopatrywania na Automatyczny.

   

6. W sekcji Poświadczenia administratora wprowadź adres URL klienta Gtmhub i token tajny. Wybierz pozycję Testuj połączenie, aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z Gtmhub. Jeśli połączenie nie powiedzie się, upewnij się, że twoje konto Gtmhub ma uprawnienia administratora i spróbuj ponownie.

   

7. W polu Adres e-mail do powiadomień wpisz adres e-mail osoby lub grupy, która ma otrzymywać powiadomienia o błędach autoryzacji, a następnie zaznacz pole wyboru Wyślij powiadomienie e-mail w przypadku wystąpienia błędu.

   

8. Wybierz Zapisz.

9. W sekcji mapowania wybierz pozycję Synchronizuj użytkowników usługi Microsoft Entra z usługą Gtmhub.

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

    Atrybut	Typ	Obsługa filtrowania
    userName	Sznurek	✓
    externalId	Sznurek	✓
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Użytkownik:kierownik	Źródło

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

12. Aby włączyć usługę aprowizacji Microsoft Entra dla Gtmhub, zmień stan aprowizacji na Włączony w sekcji Ustawienia.

    

13. Zdefiniuj użytkowników i/lub grupy, które chcesz przydzielać do Gtmhub, wybierając żądane wartości w Zakres w sekcji Ustawienia.

    

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

    

Ta operacja spowoduje rozpoczęcie cyklu synchronizacji początkowej wszystkich użytkowników i grup zdefiniowanych w obszarze Zakres w sekcji Ustawienia. Cykl początkowy trwa dłużej niż kolejne cykle, które występują mniej więcej co 40 minut, pod warunkiem, że usługa wdrażania Microsoft Entra 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 w artykule dotyczącym udostępniania aplikacji i statusu kwarantanny.

Dodatkowe zasoby

• Zarządzanie aprowizacją kont użytkowników w aplikacjach dla przedsiębiorstw
• Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?

Powiązana zawartość

• Dowiedz się, jak przeglądać dzienniki i uzyskiwać raporty dotyczące działań przydzielania zasobów