Konfigurowanie aplikacji Swit 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 usłudze Swit, jak i identyfikatorze Entra firmy Microsoft, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu identyfikator Entra firmy Microsoft automatycznie aprowizuje i anuluje aprowizację użytkowników i grup w usłudze Swit 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.

Obsługiwane możliwości

  • Tworzenie użytkowników w usłudze Swit.
  • Usuń użytkowników w usłudze Swit, gdy nie będą już wymagać dostępu.
  • Zachowaj synchronizację atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i usługą Swit.
  • Zarządzaj grupami i członkostwami w grupach w usłudze Swit.

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 .
  • Konto użytkownika w usłudze Swit z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

  1. Dowiedz się, jak działa usługa wdrażania.
  2. Określ, kto jest objęty zakresem udostępniania.
  3. Określ, jakie dane należy zmapować między Microsoft Entra ID a Swit.

Krok 2. Konfigurowanie aplikacji Swit w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Aby skonfigurować aplikację Swit do obsługi aprowizacji przy użyciu Microsoft Entra ID, wyślij wiadomość e-mail na adres help@swit.io.

Dodaj aplikację Swit z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie wdrażaniem w usłudze Swit. Jeśli wcześniej skonfigurowano aplikację Swit 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ś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ć, komu aplikacja będzie udostępniana na podstawie przypisania, możesz skorzystać z kroków do przypisania użytkowników i grup do aplikacji. Jeśli zdecydujesz się określić, kto jest objęty zakresem 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. Gdy zakres przydzielania jest ustawiony na przypisanych użytkowników i grupy, możesz kontrolować to, przypisując jednego lub dwóch użytkowników albo jedną lub dwie grupy 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 automatycznej aprowizacji użytkowników na platformie Swit

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

Konfiguracja automatycznego aprowizowania użytkowników dla Swit w Microsoft Entra ID

  1. Zaloguj się do centrum administracyjnego Microsoft Entra z uprawnieniami co najmniej Administratora 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ę Swit.

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

  4. Wybierz zakładkę Provisioning.

    Zrzut ekranu przedstawiający opcje Zarządzania z wyróżnioną opcją Przydzielania zasobów.

  5. Wybierz + Nową konfigurację.

    Zrzut ekranu opcji

  6. W sekcji Poświadczenia administratora wybierz pozycję Autoryzuj , upewnij się, że wprowadzono poświadczenia administratora konta Swit. Wybierz pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z usługą Swit. Jeśli połączenie nie powiedzie się, upewnij się, że konto Swit ma uprawnienia administratora i spróbuj ponownie.

    Zrzut ekranu przedstawiający okno dialogowe tokenu autoryzacji Swit.

  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.

    Zrzut ekranu przedstawiający stronę Właściwości zarządzania.

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

  11. Przejrzyj atrybuty użytkownika, które są synchronizowane z identyfikatora Entra firmy Microsoft do usługi Swit 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 Swit na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API Swit obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut Typ Obsługa filtrowania Wymagane przez Swit
    userName Sznurek
    aktywny logiczny
    phoneNumbers[typ eq "komórkowy"].wartość Sznurek
    phoneNumbers[rodzaj eq "praca"].value Sznurek
    nazwa wyświetlana Sznurek
    Identyfikator zewnętrzny Sznurek
    preferowany język Sznurek
  12. Wybierz pozycję Grupy.

  13. Przejrzyj atrybuty grupy, które są synchronizowane z Microsoft Entra ID do Swit w sekcji Mapowanie atrybutów. Atrybuty wybrane jako Właściwości dopasowania są używane do dopasowania grup w usłudze Swit na potrzeby operacji aktualizacji. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut Typ Obsługa filtrowania Wymagane przez Swit
    nazwa wyświetlana Sznurek
    Identyfikator zewnętrzny Sznurek
    Członkowie Źródło
  14. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

  15. Użyj udostępniania na żądanie, aby zweryfikować synchronizację z kilkoma użytkownikami przed szerszym wdrożeniem w całej organizacji.

  16. 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.

Więcej zasobów