Konfigurowanie narzędzia TerraTrue na potrzeby automatycznej aprowizacji użytkowników przy użyciu Microsoft Entra ID

W tym artykule opisano kroki, które należy wykonać zarówno w narzędziu TerraTrue, jak i Microsoft Entra ID w celu skonfigurowania automatycznej aprowizacji użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje i odprowizuje użytkowników oraz grupy do TerraTrue za pomocą usługi aprowizacji Microsoft Entra. Aby uzyskać ważne szczegółowe informacje na temat tego, co robi ta usługa, jak działa i często zadawanych pytań, zobacz Automatyzacja aprowizacji i dezaktywacja użytkowników w aplikacjach SaaS za pomocą Microsoft Entra ID.

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:

• Dzierżawa firmy Microsoft Entra.
• Jedną z następujących ról: administrator aplikacji , administrator aplikacji w chmurze lub właściciel aplikacji .
• Najemca TerraTrue.
• Konto użytkownika w narzędziu TerraTrue z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

1. Dowiedz się, jak działa usługa aprowizacji.
2. Określ, kto znajduje się w zakresie aprowizacji.
3. Określ, jakie dane chcesz przypisać między Microsoft Entra ID a TerraTrue.

Krok 2. Konfigurowanie narzędzia TerraTrue w celu obsługi aprowizacji przy użyciu Microsoft Entra ID

1. W narzędziu TerraTrue przejdź do Ustawienia organizacji > Uwierzytelnianie > SCIM lub odwiedź https://launch.terratrue.com/settings/auth/scim.

2. Następnie włącz przełącznik "Konfiguracja SCIM" i wybierz pozycję "Kopiuj klucz interfejsu API", aby skopiować klucz interfejsu API SCIM.

   

Krok 3. Dodawanie narzędzia TerraTrue z galerii aplikacji Microsoft Entra

Dodaj aplikację TerraTrue z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w programie TerraTrue. Jeśli wcześniej skonfigurowano narzędzie TerraTrue 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 udostępniania Microsoft Entra umożliwia ustalać, które osoby są udostępniane w oparciu o przypisanie do aplikacji lub w oparciu o atrybuty 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ć zakres, kto jest aprowizowany wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru określania 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 automatycznego udostępniania użytkowników do TerraTrue

Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji Microsoft Entra w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w narzędziu TerraTrue na podstawie przypisań użytkowników i/lub grup w Microsoft Entra ID.

Konfiguracja automatycznego aprowizowania użytkowników dla narzędzia TerraTrue w Microsoft Entra ID

1. Zaloguj się do centrum administracyjne Microsoft Entra jako co najmniej Administrator aplikacji w chmurze.

2. Przejdź do Entra ID> Aplikacje dla przedsiębiorstw

   

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

   

4. Wybierz kartę Konfiguracja.

   

5. Wybierz + Nową konfigurację.

   

6. W polu Tenant URL wprowadź swój Tenant URL i Secret Token narzędzia TerraTrue. Wybierz pozycję Test Connection aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z narzędziem TerraTrue. Jeśli połączenie nie powiedzie się, upewnij się, że konto narzędzia TerraTrue ma wymagane uprawnienia administratora i spróbuj ponownie.

   

7. Wybierz pozycję Utwórz , aby utworzyć konfigurację.

8. Wybierz Właściwości na stronie Przegląd.

9. Wybierz ikonę Edytuj , aby edytować właściwości. Włącz wiadomości e-mail z powiadomieniami i podaj wiadomość e-mail, aby otrzymywać powiadomienia o kwarantannie. Włącz zapobieganie przypadkowym usunięciom. Wybierz Zastosuj, aby zapisać zmiany.

   

10. Wybierz Mapowanie atrybutów w panelu po lewej stronie i wybierz użytkownicy.

11. Przejrzyj atrybuty użytkownika synchronizowane z Microsoft Entra ID do narzędzia TerraTrue w sekcji Attribute-Mapping. Atrybuty wybrane jako Właściwości dopasowania są używane do dopasowania kont użytkowników w narzędziu TerraTrue do operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API narzędzia TerraTrue obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    [No changes needed])	Typ	Obsługa filtrowania	Wymagane przez narzędzie TerraTrue
    userName	Sznurek	✓	✓
    aktywny	logiczny
    nazwa.imię	Sznurek
    imię.nazwisko	Sznurek
    nazwa.sformatowana	Sznurek

12. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

13. Użyj prowizjonowania na żądanie, aby zweryfikować synchronizację z niewielką liczbą użytkowników przed wdrożeniem na szerszą skalę w organizacji.

14. Gdy wszystko będzie gotowe do aprowizacji, wybierz pozycję Rozpocznij aprowizację na stronie Przegląd .

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.

Rozwiązywanie problemów i porady

Skontaktuj się z hello@terratrue.com, aby uzyskać pomoc w zapewnieniu prawidłowego działania procesu zapewniania zasobów.

Narzędzie TerraTrue udostępnia historię poprawek wszystkich zmian na koncie użytkownika widocznym dla dowolnego administratora narzędzia TerraTrue pod poniższym linkiem. Wszystkie zmiany wprowadzone przez użytkownika w wyniku aprowizacji SCIM są wyświetlane z kolumną Aktor o wartości "Użytkownik Systemu SCIM".

https://launch.terratrue.com/settings/history

Na koniec narzędzie TerraTrue ustawia nazwę wyświetlaną użytkownika na podstawie imienia i nazwiska otrzymanego podczas pierwszej synchronizacji użytkownika. Kolejne zmiany w nazwie wyświetlanej użytkownika mogą zostać wprowadzone przez administratora z poziomu programu TerraTrue w obszarze Ustawienia organizacji użytkowników pod poniższym linkiem:

https://launch.terratrue.com/settings/users

Więcej zasobów

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

Powiązana zawartość

• Dowiedz się, jak przeglądać logi i uzyskiwać raporty dotyczące działań związanych z aprowizacją