Konfigurowanie aplikacji Contentstack na potrzeby automatycznej aprowizacji użytkowników
W tym artykule opisano kroki, które należy wykonać zarówno w Contentstack, jak i Microsoft Entra ID, aby skonfigurować automatyczną aprowizację użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje i dezaktywuje użytkowników na platformie Contentstack 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 aplikacji Contentstack.
- Usuń użytkowników w aplikacji Contentstack, gdy nie będą już wymagać dostępu.
- Utrzymuj synchronizację atrybutów użytkownika między Microsoft Entra ID a Contentstack.
- Logowanie jednokrotne do aplikacji Contentstack (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.
- Konto użytkownika w aplikacji Contentstack z co najmniej uprawnieniami administratora użytkownika.
Planowanie wdrożenia aprowizacji
- Dowiedz się więcej na temat sposobu działania usługi aprowizacji.
- Określ, kto znajduje się w zakresie prowizjonowania.
- Określ, jakie dane zmapować między Microsoft Entra ID a Contentstack.
Konfigurowanie aplikacji Contentstack w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft
Skontaktuj się z wsparciem technicznym Contentstack, aby otworzyć zgłoszenie serwisowe, które umożliwi platformie Contentstack obsługę konfiguracji z użyciem Microsoft Entra ID. Upewnij się, że należy podać domenę sieci contentstack (na przykład acme.Contentstack.com), dla której chcesz włączyć aprowizację użytkowników. Następnie otrzymasz adres URL dzierżawy i token tajny na potrzeby autoryzacji.
Contentstack z galerii aplikacji Microsoft Entra
Dodaj Contentstack z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem do Contentstack. Jeśli wcześniej skonfigurowano aplikację Contentstack dla logowania jednokrotnego, możesz użyć tej samej aplikacji. Zaleca się jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji. Więcej informacji o dodawaniu aplikacji z galerii znajdziesz tutaj.
Zdefiniuj, kto znajduje się w zakresie przydziału zasobów.
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 czegoś 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.
Konfiguracja automatycznego aprowizowania użytkowników w Contentstack
Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji firmy Microsoft w celu tworzenia, aktualizowania i wyłączania użytkowników w aplikacji Contentstack na podstawie przypisań użytkowników w usłudze Microsoft Entra ID.
Aby skonfigurować automatyczne udostępnianie użytkowników dla aplikacji Contentstack w Microsoft Entra ID:
Zaloguj się do centrum administracyjnego firmy Microsoft Entra co najmniej jako administrator aplikacji w chmurze.
Przejdź do Identity>Applications>aplikacji dla przedsiębiorstw
Na liście aplikacji wybierz pozycję Contentstack.
Wybierz kartę Provisioning.
Ustaw Tryb konfiguracji na Automatyczny.
W sekcji Poświadczenia administratora wprowadź adres URL dzierżawy Contentstack, punkt końcowy tokenu, identyfikator klienta i klucz tajny klienta. 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 konto M-Files ma uprawnienia administratora i spróbuj ponownie.
W polu Wiadomość e-mail z powiadomieniem wprowadź adres e-mail osoby, która powinna otrzymywać powiadomienia o błędach aprowizacji, a następnie zaznacz pole wyboru Wyślij powiadomienie e-mail w przypadku wystąpienia błędu.
Wybierz pozycję Zapisz.
W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników firmy Microsoft Entra z platformą Contentstack.
Przejrzyj atrybuty użytkownika, które są synchronizowane z Microsoft Entra ID do Contentstack w sekcji Mapowanie atrybutów. Atrybuty wybrane jako pasujące właściwości są używane do dopasowania kont użytkowników w Contentstack na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API contentstack obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.
Atrybut Typ Obsługa filtrowania Wymagane przez Contentstack userName String ✓ ✓ name.givenName String nazwa.nazwisko String aktywny boolean W sekcji Mapowania wybierz Synchronizuj grupy Microsoft Entra z Contentstack.
Przejrzyj atrybuty grupy, które są synchronizowane z Microsoft Entra ID do Contentstack w sekcji Mapowanie atrybutów. Atrybuty wybrane jako Właściwości dopasowywania są używane do dopasowywania grup w stosie zawartości na potrzeby operacji aktualizacji. Wybierz przycisk Zapisz, aby zatwierdzić wszelkie zmiany.
Atrybut Typ Obsługiwane dla filtrowania Wymagane przez Contentstack nazwa wyświetlana String ✓ ✓ członkowie Referencja Aby skonfigurować filtry określania zakresu, zapoznaj się z poniższymi instrukcjami podanymi w artykule Filtrowanie zakresu.
Aby włączyć usługę aprowizacji Microsoft dla Contentstack, zmień Status aprowizacji na Włączony w sekcji Ustawienia.
Zdefiniuj użytkowników, których chcesz aprowizować w aplikacji Contentstack, wybierając żądane wartości w obszarze Zakres w sekcji Ustawienia.
Gdy będziesz gotowy do konfiguracji, wybierz Zapisz.
Ta operacja rozpoczyna początkowy cykl synchronizacji wszystkich użytkowników zdefiniowanych w obszarze Zakres w sekcji Ustawienia. Cykl początkowy trwa dłużej niż kolejne cykle, które odbywają się co około 40 minut, pod warunkiem, że usługa Microsoft Entra jest uruchomiona.
Monitoruj swoje wdrożenie
Po skonfigurowaniu aprowizacji użyj następujących zasobów, aby monitorować wdrożenie:
- 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ł.
- Sprawdź pasek postępu, aby zobaczyć status cyklu aprowizacji i jak blisko jest do zakończenia
- 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 aprowizacją kont użytkowników w aplikacjach dla przedsiębiorstw
- Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?