Konfigurowanie aplikacji M-Files 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 M-Files i Microsoft Entra ID w celu skonfigurowania automatycznego prowizjonowania użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie provisionuje i deprowizuje użytkowników i grupy do M-Files 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

• Utwórz użytkowników w M-Files.
• Usuń użytkowników w usłudze M-Files, gdy nie będą już wymagać dostępu.
• Zachowaj synchronizację atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i plikami M-Files.
• Konfiguruj grupy i członkostwa w systemie M-Files.
• Logowanie jednokrotne do aplikacji M-Files (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 .
• Subskrypcja chmury M-Files (chmura klasyczna nie jest obsługiwana).
• Konto użytkownika w usłudze M-Files z dostępem administratora subskrypcji lub administratora dostępu do zarządzania plikami M-Files.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

1. Dowiedz się, jak działa usługa wdrażania.
2. Określ, kto znajduje się w zakresie , związanym z wdrażaniem.
3. Ustal, jakie dane mają być mapowane między Microsoft Entra ID a M-Files.
4. Niezbędne mapowania są wstępnie zdefiniowane, ale można przypisać dwa dodatkowe pola danych do M-Files.

Krok 2. Konfigurowanie funkcji M-Files w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Przed skonfigurowaniem automatycznego tworzenia użytkowników w systemie M-Files, upewnij się, że wszystkie repozytoria w Twojej subskrypcji mają wyłączoną synchronizację użytkowników w M-Files Admin.

Jeśli wcześniej skonfigurowano zarządzanie funkcjami użytkownika w usłudze M-Files Manage przy użyciu własnej aplikacji Entra ID, nie można zmienić konfiguracji, aby korzystać z aplikacji M-Files z galerii aplikacji Microsoft Entra. Jeśli zamiast tego chcesz użyć aplikacji M-Files, usuń istniejącą konfigurację z obszaru Zarządzanie plikami M-Files i wyłącz lub usuń powiązaną aplikację Entra ID. Następnie postępuj zgodnie z tymi instrukcjami, aby utworzyć nową konfigurację.

1. Zaloguj się do aplikacji M-Files Manage pod adresem https://manage.m-files.com.
2. W obszarze nawigacji po lewej stronie wybierz pozycję Aprowizowanie.
3. Przejdź do karty Konfiguracja .
4. W sekcji Tworzenie konfiguracji aprowizacji użytkowników wybierz Aplikację z galerii usługi Azure AD.
5. Wprowadź niezbędne informacje.
   • W polu Nazwa konfiguracji wprowadź unikatową nazwę konfiguracji.
   • Wybierz pozycję Domyślny typ licencji dla aprowizowanych użytkowników. Wszyscy aprowizowani użytkownicy najpierw uzyskają tę licencję. Typ licencji grupy użytkowników można zmienić na wyższy po aprowizacji grup użytkowników. Jeśli w subskrypcji nie ma wystarczającej liczby dostępnych licencji domyślnego typu licencji, wszyscy użytkownicy nie otrzymają licencji.
6. Wybierz ikonę kopiowania ( ) dla każdego elementu danych utworzonego przez narzędzie M-Files Manage i zanotuj wartości.

Uwaga

Tajny klucz klienta nie jest wyświetlany nigdzie indziej, gdy zamkniesz okno dialogowe.

Krok 3. Dodawanie plików M-Files z galerii aplikacji Microsoft Entra

Dodaj aplikację M-Files z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w usłudze M-Files. Jeśli wcześniej skonfigurowano aplikację M-Files 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ę ustalić, kto ma mieć dostęp do Twojej aplikacji na podstawie przypisania, możesz skorzystać z kroków , aby przypisać użytkowników i grupy do aplikacji. Jeśli zdecydujesz się określić zakres przyznawania zasobów wyłącznie na podstawie atrybutów użytkownika lub grupy, możesz użyć filtru 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. Jeśli zakres aprowizacji jest ustawiony na przypisanych użytkowników i grupy, możesz to kontrolować, przypisując jednego lub dwóch użytkowników lub grup do aplikacji. W przypadku ustawienia zakresu na wszystkich użytkowników i wszystkie grupy, możesz określić filtrowanie zakresu na podstawie atrybutów.

• Jeśli potrzebujesz dodatkowych ról, możesz zaktualizować manifest aplikacji, aby dodać nowe role.

Krok 5. Konfigurowanie automatycznego aprowizowania użytkowników dla M-Files

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 TestApp na podstawie przypisań użytkowników i/lub grup w identyfikatorze Entra firmy Microsoft.

Aby skonfigurować automatyczną aprowizację użytkowników dla aplikacji M-Files w usłudze 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.

   

3. Na liście aplikacji wybierz pozycję M-Files.

   

4. Wybierz zakładkę Provisioning.

   

5. Ustaw Tryb zaopatrywania na Automatyczny.

   

6. W sekcji Poświadczenia administratora wpisz adres URL dzierżawy M-Files, punkt końcowy tokenu, identyfikator klienta oraz jego tajny klucz. Wybierz pozycję Testuj połączenie, aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z M-Files. Jeśli połączenie nie powiedzie się, upewnij się, że wprowadzone wartości są poprawne i spróbuj ponownie.

   

7. W polu Adres e-mail do powiadomień wpisz adres e-mail osoby lub grupy, która ma otrzymywać powiadomienia o błędach autoryzacji, a następnie zaznacz pole wyboru Wyślij powiadomienie e-mail w przypadku wystąpienia błędu.

   

8. Wybierz Zapisz.

9. Opcjonalnie: Jeśli chcesz zsynchronizować dodatkowe informacje o użytkowniku, możesz zdefiniować dwa dodatkowe pola, które mają być synchronizowane z usługą M-Files Manage. Informacje są wyświetlane w sekcji Dodatkowe informacje 1 i Dodatkowe informacje 2 na stronie Informacje o użytkowniku .

   1. W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników Microsoft Entra do M-Files.
   2. W sekcji Mapowanie atrybutów wybierz pozycję Dodaj nowe mapowanie.
   3. Użyj następujących wartości:
      • Typ mapowania: Bezpośredni
      • Atrybut źródłowy: wprowadź atrybut Entra ID
      • Atrybut docelowy: Wybierz urn:ietf:params:scim:schemas:extension:info:2.0:User:info1 lub urn:ietf:params:scim:schemas:extension:info:2.0:User:info2
      • Dopasuj obiekty przy użyciu tego atrybutu: Nie
      • Zastosuj to mapowanie: Zawsze
   4. Wybierz OK
   5. Opcjonalnie: aby zsynchronizować dwa dodatkowe pola danych do zarządzania plikami M, dodaj drugie mapowanie z innym dostępnym atrybutem docelowym.

Uwaga

Nie zaleca się wprowadzania zmian w domyślnych mapowaniach atrybutów.

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

2. Aby włączyć usługę aprowizacji Microsoft Entra dla M-Files, zmień Stan aprowizacji na Wł w sekcji Ustawienia.

   

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

   

4. Gdy będziesz gotowy do konfiguracji, wybierz Zapisz.

   

Ta operacja spowoduje rozpoczęcie cyklu synchronizacji początkowej 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ą mniej więcej co 40 minut, pod warunkiem, że usługa wdrażania Microsoft Entra 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 w artykule dotyczącym udostępniania aplikacji i statusu kwarantanny.

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 w usłudze Microsoft Entra ID?.

Powiązana zawartość

• Po zakończeniu aprowizacji użytkowników utwórz łącza między aprowizowaną grupą użytkowników i grupami użytkowników M-Files w usłudze M-Files Manage. Aby uzyskać instrukcje, zobacz M-Files Manage — Podręcznik użytkownika.
• Dowiedz się, jak przeglądać dzienniki i uzyskiwać raporty dotyczące aktywności zaopatrzeniowej.