Samouczek: konfigurowanie protokołu SAML2 templafy na potrzeby automatycznej aprowizacji użytkowników

Celem tego samouczka jest zademonstrowanie kroków, które należy wykonać w templafy SAML2 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 środowisku Templafy SAML2.

Nuta

W tym samouczku opisano łącznik oparty na usłudze aprowizacji użytkowników 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.

Warunki wstępne

W scenariuszu opisanym w tym samouczku założono, że masz już następujące wymagania wstępne:

• Dzierżawa firmy Microsoft Entra.
• Dzierżawa Templafy.
• Konto użytkownika w aplikacji Templafy z uprawnieniami administratora.

Krok 1. Planowanie wdrożenia aprowizacji

1. Dowiedz się, jak działa usługa aprowizacji.
2. Określ, kto będzie w zakresie aprowizacji.
3. Ustal, jakie dane mają być mapowanie między identyfikatorem Microsoft Entra ID i templafy SAML2.

Przypisywanie użytkowników do narzędzia Templafy SAML2

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 biblioteki Templafy SAML2. Po podjęciu decyzji możesz przypisać tych użytkowników i/lub grupy do biblioteki Templafy SAML2, 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 templafy SAML2

• Zaleca się przypisanie pojedynczego użytkownika microsoft Entra do aplikacji Templafy SAML2 w celu przetestowania automatycznej konfiguracji aprowizacji użytkowników. Więcej użytkowników i/lub grup może być przypisanych później.

• Podczas przypisywania użytkownika do szablonu Templafy SAML2 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 biblioteki Templafy SAML2 do obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Przed skonfigurowaniem biblioteki Templafy SAML2 na potrzeby automatycznej aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft należy włączyć aprowizowanie protokołu SCIM w środowisku Templafy SAML2.

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

   

2. Kliknij pozycję Metoda uwierzytelniania.

   

3. Skopiuj wartość interfejsu API-klucza SCIM. Ta wartość jest wprowadzana w polu Token tajny na karcie Aprowizacja aplikacji Templafy SAML2.

   

Krok 3. Dodawanie aplikacji Templafy SAML2 z galerii

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

Aby dodać aplikację Templafy SAML2 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 sekcji Identity Applications Enterprise applications>New application (Aplikacje dla przedsiębiorstw w aplikacji> dla>przedsiębiorstw).
3. W sekcji Dodawanie z galerii wpisz Templafy SAML2, wybierz pozycję Templafy SAML2 w polu wyszukiwania.
4. Wybierz pozycję Templafy SAML2 z panelu wyników, a następnie dodaj aplikację. Zaczekaj kilka sekund na dodanie aplikacji do dzierżawy.

Krok 4. Konfigurowanie automatycznej aprowizacji użytkowników w środowisku Templafy SAML2

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

Napiwek

Możesz również włączyć logowanie jednokrotne oparte na protokole SAML dla aplikacji Templafy, postępując zgodnie z instrukcjami podanymi w samouczku dotyczącym logowania jednokrotnego aplikacji Templafy. Logowanie jednokrotne można skonfigurować niezależnie od automatycznej aprowizacji użytkowników, chociaż te dwie funkcje uzupełniają się wzajemnie.

Aby skonfigurować automatyczną aprowizację użytkowników dla biblioteki Templafy SAML2 w identyfikatorze Entra firmy Microsoft:

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

2. Przejdź do aplikacji dla przedsiębiorstw usługi Identity Applications>>

   

3. Na liście aplikacji wybierz pozycję Templafy SAML2.

   

4. Wybierz kartę Aprowizacja .

   

5. Ustaw tryb aprowizacji na automatyczny.

   

6. W sekcji Poświadczenia administratora wprowadź adres https://scim.templafy.com/scim URL dzierżawy. 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 templafy SAML2.

10. Przejrzyj atrybuty użytkownika, które są synchronizowane z identyfikatora Entra firmy Microsoft do templafy SAML2 w sekcji Mapowania atrybutów . Atrybuty wybrane jako Pasujące właściwości są używane do dopasowania kont użytkowników w templafy SAML2 na potrzeby operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługiwane do filtrowania
    userName	Struna	✓
    aktywny	Boolowski
    displayName	Struna
    tytuł	Struna
    preferredLanguage	Struna
    name.givenName	Struna
    name.familyName	Struna
    phoneNumbers[type eq "work"].value	Struna
    phoneNumbers[type eq "mobile"].value	Struna
    phoneNumbers[type eq "fax"].value	Struna
    externalId	Struna
    addresses[type eq "work"].locality	Struna
    addresses[type eq "work"].postalCode	Struna
    addresses[type eq "work"].region	Struna
    addresses[type eq "work"].streetAddress	Struna
    addresses[type eq "work"].country	Struna
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department	Struna
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization	Struna

    Nuta

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

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

12. Przejrzyj atrybuty grupy, które są synchronizowane z identyfikatora Entra firmy Microsoft do templafy SAML2 w sekcji Mapowania atrybutów . Atrybuty wybrane jako pasujące właściwości są używane do dopasowania grup w templafy SAML2 do operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługiwane do filtrowania
    displayName	Struna	✓
    Członków	Odniesienie
    externalId	Struna

    Nuta

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

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

14. Aby włączyć usługę aprowizacji Firmy Microsoft dla templafy SAML2, zmień stan aprowizacji na Wł . w sekcji Ustawienia .

    

15. Zdefiniuj użytkowników i/lub grupy, które chcesz aprowizować w usłudze Templafy SAML2, 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 aprowizacji firmy Microsoft 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 w usłudze Templafy SAML2.

Krok 5. Monitorowanie wdrożenia

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

• Użyj dzienników aprowizacji, aby określić, którzy użytkownicy zostali pomyślnie aprowizowani lub nie powiodły się
• Sprawdź pasek postępu, aby zobaczyć stan cyklu aprowizacji i sposób jego zamknięcia do ukończenia
• Jeśli konfiguracja aprowizacji wydaje się być w złej kondycji, aplikacja przechodzi do kwarantanny. Dowiedz się więcej o stanach kwarantanny tutaj.

Dziennik zmian

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

Więcej zasobów

• 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?

Następne kroki

• Dowiedz się, jak przeglądać dzienniki i pobierać raporty dotyczące działań aprowizacji