Konfigurowanie programu Templafy OpenID Connect na potrzeby automatycznej aprowizacji użytkowników

Celem tego artykułu jest zademonstrowanie kroków, które należy wykonać w programie Templafy OpenID Connect i Microsoft Entra ID w celu skonfigurowania identyfikatora Entra firmy Microsoft w celu automatycznego aprowizowania i anulowania aprowizacji użytkowników i/lub grup w programie Templafy OpenID Connect.

Uwaga

W tym artykule opisano łącznik zbudowany na bazie usługi aprowizacji użytkowników Microsoft Entra. 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.

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. — Jedną z następujących ról: — Administrator aplikacji - Administrator aplikacji w chmurze - właściciel aplikacji..

• Najemca Templafy.
• Konto użytkownika w aplikacji Templafy z uprawnieniami administratora.

Krok 1. Zaplanuj wdrożenie prowizjonowania

1. Dowiedz się więcej na temat sposobu działania usługi aprowizacji.
2. Określ, kto znajdzie się w zakresie udostępniania.
3. Określ, jakie dane mają być zmapowane między Microsoft Entra ID a Templafy OpenID Connect.

Przypisywanie użytkowników do narzędzia Templafy OpenID Connect

Identyfikator Entra firmy Microsoft używa koncepcji nazywanej przypisaniami , aby określić, którzy użytkownicy powinni otrzymywać dostęp do wybranych aplikacji. W kontekście automatycznej aprowizacji użytkowników synchronizowane są tylko użytkownicy i/lub grupy przypisane do aplikacji w usłudze Microsoft Entra ID.

Przed skonfigurowaniem i włączeniem automatycznej aprowizacji użytkowników należy zdecydować, którzy użytkownicy i/lub grupy w usłudze Microsoft Entra ID potrzebują dostępu do aplikacji Templafy OpenID Connect. Po podjęciu decyzji możesz przypisać tych użytkowników i/lub grupy do narzędzia Templafy OpenID Connect, wykonując poniższe instrukcje:

• Przypisywanie użytkownika lub grupy do aplikacji dla przedsiębiorstw

Ważne porady dotyczące przypisywania użytkowników do programu Templafy OpenID Connect

• Zaleca się przypisanie pojedynczego użytkownika Microsoft Entra do aplikacji Templafy OpenID Connect, aby przetestować konfigurację automatycznej aprowizacji użytkowników. Więcej użytkowników i/lub grup może być przypisanych później.

• Podczas przypisywania użytkownika do aplikacji Templafy OpenID Connect należy wybrać dowolną prawidłową rolę specyficzną dla aplikacji (jeśli jest dostępna) w oknie dialogowym przypisywania. Użytkownicy z rolą Dostęp domyślny są wykluczeni z aprowizacji.

Krok 2. Konfigurowanie narzędzia Templafy OpenID Connect w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Przed skonfigurowaniem narzędzia Templafy OpenID Connect na potrzeby automatycznej aprowizacji użytkowników za pomocą identyfikatora Entra firmy Microsoft należy włączyć aprowizację protokołu SCIM w programie Templafy OpenID Connect.

1. Zaloguj się do konsoli administracyjnej templafy. Kliknij pozycję Administracja.

   

2. Kliknij pozycję Metoda uwierzytelniania.

   

3. Skopiuj wartość klucza API SCIM. Ta wartość jest wprowadzana w polu Tajny Token na karcie Provisioning aplikacji Templafy OpenID Connect.

   

Krok 3. Dodawanie aplikacji Templafy OpenID Connect z galerii

Aby skonfigurować aplikację Templafy OpenID Connect na potrzeby automatycznej aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft, należy dodać aplikację Templafy OpenID Connect z galerii aplikacji Microsoft Entra do listy zarządzanych aplikacji SaaS.

Aby dodać aplikację Templafy OpenID Connect z galerii aplikacji Microsoft Entra, wykonaj następujące kroki:

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji w chmurze.
2. Przejdź do Tożsamość>Aplikacje>Aplikacje dla przedsiębiorstw>Nowa aplikacja.
3. W sekcji Dodawanie z galerii wpisz Templafy OpenID Connect, wybierz pozycję Templafy OpenID Connect w polu wyszukiwania.
4. Wybierz pozycję Templafy OpenID Connect z panelu wyników, a następnie dodaj aplikację. Poczekaj kilka sekund, aż aplikacja zostanie dodana do dzierżawy.

Krok 4. Konfigurowanie automatycznego prowizjonowania użytkowników do Templafy OpenID Connect

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

Napiwek

Możesz również włączyć logowanie jednokrotne oparte na protokole OpenID dla aplikacji Templafy, postępując zgodnie z instrukcjami podanymi w artykule Templafy Single sign-on (Logowanie jednokrotne oparte na protokole OpenID). Jednokrotne logowanie można skonfigurować niezależnie od automatycznego udostępniania użytkowników, chociaż te dwie funkcje się wzajemnie uzupełniają.

Aby skonfigurować automatyczne wdrażanie użytkowników dla Templafy OpenID Connect w systemie Microsoft Entra ID:

1. Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji w chmurze.

2. Przejdź do Identity>Applications>Enterprise applications

   

3. Na liście aplikacji wybierz pozycję Templafy OpenID Connect.

   

4. Wybierz kartę Konfigurowanie.

   

5. Ustaw Tryb aprowizacji na Automatyczny.

   

6. W sekcji Poświadczenia administratora wprowadź dane w polu URL dzierżawyhttps://scim.templafy.com/scim. Wprowadź wartość klucza interfejsu API SCIM pobraną wcześniej w tokenie tajnym. Kliknij pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z aplikacją Templafy. Jeśli połączenie nie powiedzie się, upewnij się, że konto Templafy 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, i zaznacz pole wyboru — Wyślij powiadomienie e-mail w przypadku wystąpienia błędu.

   

8. Kliknij przycisk Zapisz.

9. W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników firmy Microsoft Entra z programem Templafy OpenID Connect.

10. Przejrzyj atrybuty użytkownika, które są synchronizowane z identyfikatora Entra firmy Microsoft do narzędzia Templafy OpenID Connect w sekcji Mapowanie atrybutów. Atrybuty wybrane jako Właściwości dopasowania są używane do dopasowania kont użytkowników w programie Templafy OpenID Connect na potrzeby operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługiwane do filtrowania
    userName	String	✓
    aktywny	Wartość logiczna
    nazwa wyświetlana	String
    tytuł	String
    preferowany język	String
    imię	String
    name.nazwisko	String
    phoneNumbers[type eq "work"].value	String
    phoneNumbers[type eq "mobile"].value	String
    phoneNumbers[typ eq "fax"].wartość	String
    externalId	String
    adresy[typ eq "praca"].lokalizacja	String
    adresy[typ eq "praca"].kodPocztowy	String
    addresses[type eq "work"].region	String
    adresy[type eq "work"].adresUlicy	Sznurek
    addresses[type eq "praca"].kraj	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:wydział	String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	String

    Uwaga

    Funkcja odnajdywania schematu jest włączona dla tej aplikacji.

11. W sekcji Mapowania wybierz pozycję Synchronizuj grupy Microsoft Entra z Templafy.

12. Przejrzyj atrybuty grupy, które są synchronizowane z identyfikatora Entra firmy Microsoft do narzędzia Templafy OpenID Connect w sekcji Mapowanie atrybutów. Atrybuty wybrane jako Właściwości dopasowania są używane do dopasowywania grup w narzędziu Templafy OpenID Connect na potrzeby operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Filtrowanie jest obsługiwane
    nazwa wyświetlana	String	✓
    członkowie	Odwołanie
    externalId	String

    Uwaga

    Funkcja odnajdywania schematu jest włączona dla tej aplikacji.

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 Microsoft Entra dla programu Templafy OpenID Connect, zmień stan aprowizacji na Włączony w sekcji Ustawienia.

    

15. Zdefiniuj użytkowników i/lub grupy, które chcesz aprowizować w programie Templafy OpenID Connect, wybierając żądane wartości w obszarze Zakres w sekcji Ustawienia.

    

16. Gdy wszystko będzie gotowe do aprowizacji, kliknij przycisk Zapisz.

    

    Ta operacja rozpoczyna początkową synchronizację wszystkich użytkowników i/lub grup zdefiniowanych w obszarze Zakres w sekcji Ustawienia. Synchronizacja początkowa trwa dłużej niż kolejne synchronizacje, które są wykonywane co około 40 minut, o ile usługa udostępniania zasobów Microsoft Entra jest uruchomiona. Możesz użyć sekcji Szczegóły synchronizacji, aby monitorować postęp i śledzić linki do raportu aktywności aprowizacji, w którym opisano wszystkie akcje wykonywane przez usługę aprowizacji firmy Microsoft na Templafy OpenID Connect.

Krok 5. 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.

Dziennik zmian

• 05.04.2023 — Dodano obsługę odnajdywania schematów.

Więcej zasobów

• 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ń związanych z wdrażaniem