Udostępnij za pośrednictwem


Konfigurowanie usługi Twingate 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 Twingate, jak i w Microsoft Entra ID, aby skonfigurować automatyczne udostępnianie użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje i anuluje aprowizowanie użytkowników i grup do usługi Twingate za pomocą usługi aprowizacji 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.

Obsługiwane możliwości

  • Tworzenie użytkowników w usłudze Twingate
  • Usuwanie użytkowników w usłudze Twingate, gdy nie wymagają już dostępu
  • Zachowywanie synchronizacji atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i usługą Twingate
  • Aprowizuj grupy i członkostwa w grupach w usłudze Twingate
  • Logowanie jednokrotne do usługi Twingate (zalecane)

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 .
  • Dzierżawa usługi Twingate w warstwie produktu, która obsługuje integrację dostawcy tożsamości. Aby uzyskać szczegółowe informacje na temat różnych warstw produktów, zobacz Cennik usługi Twingate .
  • Konto użytkownika w usłudze Twingate z uprawnieniami administratora.

Krok 1. Planowanie wdrożenia aprowizacji

  1. Dowiedz się, jak działa usługa aprowizacji.
  2. Określ, kto znajduje się w zakresie aprowizacji.
  3. Ustal, jakie dane mają być mapowane między identyfikatorem Entra firmy Microsoft i usługą Twingate.

Krok 2. Konfigurowanie usługi Twingate do obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

  1. Zaloguj się do konsoli administracyjnej usługi Twingate.

  2. Przejdź do Ustawienia > Dostawca tożsamości

  3. Wybierz przycisk ..., aby otworzyć menu akcji. Wybierz pozycję Wygeneruj ponownie token SCIM. Należy pamiętać, że spowoduje to unieważnienie istniejącego tokenu, jeśli istnieje.

    Zrzut ekranu przedstawiający menu akcji Entra firmy Microsoft.

  4. Skopiuj SCIM Endpoint i token SCIM z okna modalnego. Te dane są wprowadzane, odpowiednio w polach Adres URL dzierżawy i Token tajny w zakładce Aprowizacja aplikacji Twingate.

    Zrzut ekranu modalu informacyjnego SCIM.

Dodaj aplikację Twingate z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w usłudze Twingate. Jeśli wcześniej skonfigurowano usługę Twingate dla 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 jest przypisywany do 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 przypisany wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru określania zakresu.

  • Zacznij od mniejszej skali. Przeprowadź test z użyciem mniejszego zestawu użytkowników i grup, zanim wdrożysz to rozwiązanie dla wszystkich. W przypadku ustawienia zakresu aprowizacji na przypisanych użytkowników i grupy możesz w tym celu przypisać do aplikacji jednego czy dwóch użytkowników bądź jedną lub dwie grupy. 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 w usłudze Twingate

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 Twingate na podstawie przypisań użytkowników i/lub grup w usłudze Microsoft Entra ID.

Aby skonfigurować automatyczną aprowizację użytkowników dla usługi Twingate w usłudze Microsoft Entra ID:

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

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

    Zrzut ekranu przedstawiający blok Aplikacje dla przedsiębiorstw.

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

    Zrzut ekranu przedstawiający link aplikacji Twingate na liście aplikacji.

  4. Wybierz kartę Provisioning.

    Zrzut ekranu karty Provisioning.

  5. Ustaw tryb aprowizacji na automatyczny.

    Zrzut ekranu przedstawiający kartę Aprowizowanie automatyczne.

  6. W sekcji Poświadczenia administratora wprowadź adres URL dzierżawy Twingate i Token Tajny. Wybierz pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z usługą Twingate. Jeśli połączenie nie powiedzie się, upewnij się, że twoje konto usługi Twingate ma uprawnienia administratora i spróbuj ponownie.

    Żeton

  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 .

    Zrzut ekranu przedstawiający wiadomość e-mail z powiadomieniem.

  8. Wybierz pozycję Zapisz.

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

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

    Atrybut Typ Obsługiwane do filtrowania
    Identyfikator zewnętrzny Sznurek
    userName Sznurek
    aktywne Wartość logiczna
    emails[typ eq "praca"].wartość Sznurek
    nazwa.imię Sznurek
    imię.nazwisko Sznurek
  11. W sekcji Mapowania wybierz Synchronizuj grupy Microsoft Entra z Twingate.

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

    Atrybut Typ Obsługiwane do filtrowania
    Identyfikator zewnętrzny Sznurek
    nazwa wyświetlana Sznurek
    członkowie Odwołanie
  13. Aby skonfigurować filtry określania zakresu, zapoznaj się z następującymi instrukcjami podanymi w artykule Filtr zakresu.

  14. Aby włączyć usługę aprowizacji Microsoft Entra dla Twingate, zmień stan aprowizacji na Włącz w sekcji Ustawienia.

    Zrzut ekranu przedstawiający przełączenie stanu aprowizacji w pozycji Włączone.

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

    Zrzut ekranu zakresu aprowizacji.

  16. Gdy wszystko będzie gotowe do konfigurowania, wybierz pozycję Zapisz.

    Zrzut ekranu przedstawiający zapisywanie konfiguracji oprogramowania.

Ta operacja rozpoczyna początkowy cykl synchronizacji 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ą co około 40 minut, o ile usługa aprowizacji firmy Microsoft jest uruchomiona.

Krok 6. Zmiana ustawienia Wymagane przypisanie

Ustawieniem domyślnym jest Nie, co umożliwia użytkownikom logowanie się do usługi Twingate bez przypisania w aplikacji przedsiębiorstwa.

  1. Wybierz Właściwości.

    Zrzut ekranu przedstawiający właściwości.

  2. Ustaw wymagane przypisanie na Tak

    Zrzut ekranu przedstawiający przypisanie właściwości.

  3. Wybierz Zapisz

    Zrzut ekranu przedstawiający zapisane właściwości.

Krok 7. Monitorowanie wdrożenia

Po skonfigurowaniu aprowizacji możesz skorzystać z następujących zasobów, aby monitorować wdrożenie:

  1. Użyj dzienników aprowizacji , aby określić, którzy użytkownicy zostali pomyślnie aprowizowani lub których aprowizacja się nie powiodła.
  2. Sprawdź pasek postępu , aby zobaczyć stan cyklu wdrażania i sprawdzić, jak blisko jest do zakończenia.
  3. Jeśli konfiguracja aprowizacji jest w złej kondycji, aplikacja przejdzie w stan kwarantanny. Dowiedz się więcej o stanach kwarantanny tutaj.

Dodatkowe zasoby