Udostępnij za pośrednictwem


Konfigurowanie tożsamości MURAL na potrzeby automatycznej aprowizacji użytkowników przy użyciu identyfikatora Entra firmy Microsoft

W tym artykule opisano kroki, które należy wykonać w tożsamości użytkownika MURAL i Microsoft Entra ID, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie dodaje i usuwa użytkowników oraz grupy do MURAL Identity 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 systemie tożsamości MURAL
  • Usuń użytkowników z systemu tożsamości MURAL, gdy nie potrzebują już dostępu.
  • Utrzymanie synchronizacji atrybutów użytkownika między Microsoft Entra ID i MURAL Identity
  • Zarządzaj grupami i członkostwami w grupach w MURAL Identity.
  • Jednokrotne logowanie do MURAL Identity (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 .
  • Udostępnianie SCIM jest dostępne tylko w planie Enterprise MURAL. Przed skonfigurowaniem aprowizacji SCIM skontaktuj się z członkiem zespołu ds. sukcesu klienta MURAL, aby włączyć tę funkcję.
  • Przed skonfigurowaniem automatycznej aprowizacji należy prawidłowo skonfigurować logowanie jednokrotne oparte na protokole SAML. Instrukcje dotyczące konfigurowania logowania jednokrotnego za pośrednictwem usługi Microsoft Entra ID for MURAL można znaleźć tutaj.

Krok 1. Planowanie wdrożenia aprowizacji

  1. Dowiedz się, jak działa usługa aprowizacji.
  2. Określ, kto znajduje się w zakresie dostarczania usług.
  3. Ustal, jakie dane zmapować między Identyfikator Entra Microsoft a tożsamością MURAL.

Krok 2. Konfigurowanie tożsamości MURAL w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Wykonaj kroki , aby uzyskać adres URL SCIM i unikatowy token interfejsu API ze strony Kluczy interfejsu API na pulpicie nawigacyjnym firmy MURAL. Użyj tego klucza w polu Tajny token w kroku 5.

Dodaj tożsamość MURAL z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem tożsamości MURAL. Jeśli wcześniej skonfigurowano tożsamość MURAL 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ę ustanowić, kto zostanie przydzielony do Twojej aplikacji na podstawie przypisania, możesz użyć kroków do przypisania użytkowników i grup do aplikacji. Jeśli zdecydujesz się ustalić, kto będzie objęty aprowizacją wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru określania zakresu.

  • Zacznij od czegoś małego. 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 kontrolować ten proces, przypisując do aplikacji jednego lub dwóch użytkowników albo 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 MURAL Identity

Ta sekcja prowadzi przez kroki konfigurowania usługi aprowizacji Microsoft Entra, aby tworzyć, aktualizować oraz wyłączać użytkowników i/lub grupy w MURAL Identity na podstawie przypisań użytkowników i/lub grup w Microsoft Entra ID.

Aby skonfigurować automatyczne udostępnianie użytkowników dla tożsamości MURAL 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

    Moduł aplikacji przedsiębiorstw

  3. Na liście aplikacji wybierz pozycję Mural Identity.

    Link do profilu MURAL na liście aplikacji

  4. Wybierz kartę Konfiguracja.

    Zakładka Konfiguracja

  5. Ustaw tryb aprowizacji na automatyczny.

    Konfigurowanie

  6. W sekcji Poświadczenia administratora wprowadź adres URL dzierżawy identyfikacyjnej MURAL i tajny klucz. Wybierz Testuj połączenie, aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z MURAL Identity. Jeśli połączenie nie powiedzie się, upewnij się, że konto tożsamości MURAL 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 .

    Wiadomość e-mail z powiadomieniem

  8. Wybierz pozycję Zapisz.

  9. W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników Microsoft Entra z tożsamością MURAL.

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

    Atrybut Typ Obsługa filtrowania Wymagane przez system tożsamości MURAL
    userName Sznurek
    emails[typ eq "praca"].wartość Sznurek
    aktywne Wartość logiczna
    imię Sznurek
    nazwa.nazwiskoRodzinne Sznurek
    Identyfikator zewnętrzny Sznurek
  11. W sekcji Mapowania wybierz pozycję Synchronizuj grupy Microsoft Entra z tożsamością MURAL.

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

    Atrybut Typ Obsługa filtrowania Wymagane przez system tożsamości MURAL
    nazwa wyświetlana Sznurek
    członkowie Referencja
    Identyfikator zewnętrzny Sznurek
  13. Aby skonfigurować filtry zakresu, zapoznaj się z poniższymi instrukcjami podanymi w artykule o filtrach zakresu.

  14. Aby włączyć usługę aprowizacji Microsoft Entra dla tożsamości MURAL, zmień stan aprowizacji na Włączony w sekcji Ustawienia.

    Stan dostępności przełączono na włączony

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

    Zakres świadczenia usług

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

    Zapisywanie konfiguracji dostarczania

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 Microsoft Entra provisioning jest uruchomiona.

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.

Porady dotyczące rozwiązywania problemów

  • Podczas aprowizacji użytkownika należy pamiętać, że w aplikacji MURAL nie obsługujemy numerów w polach nazw (czyli givenName lub familyName).
  • Podczas filtrowania wartości userName w punkcie końcowym GET upewnij się, że adres e-mail jest zapisany w całości małymi literami, w przeciwnym razie otrzymasz pusty wynik. Dzieje się tak, ponieważ konwertujemy adresy e-mail na małe litery podczas aprowizacji kont.
  • W przypadku anulowania aprowizacji użytkownika końcowego (ustawienie aktywnego atrybutu na false) użytkownik jest usuwany nietrwale i traci dostęp do wszystkich swoich obszarów roboczych. Gdy ten sam co użytkownik końcowy zostanie ponownie aktywowany bez obsługi administracyjnej (ustawienie aktywnego atrybutu na true), użytkownik nie ma wcześniej dostępu do użytkownika obszarów roboczych. Użytkownik końcowy zobaczy komunikat o błędzie "Zostałeś zdezaktywowany z tego obszaru roboczego" z opcją żądania ponownej aktywacji, którą administrator obszaru roboczego musi zatwierdzić.
  • Jeśli masz inne problemy, skontaktuj się z zespołem pomocy technicznej aplikacji MURAL Identity.

Dziennik zmian

22.06.2023 — Dodano obsługę aprowizacji grup.

Więcej zasobów