Konfigurowanie aplikacji Contentstack 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 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:

Planowanie wdrożenia aprowizacji

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.

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:

  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ę Contentstack.

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

  4. Wybierz kartę Provisioning.

    Zrzut ekranu zakładki Konfiguracja.

  5. Wybierz + Nową konfigurację.

    Zrzut ekranu przedstawiający kartę Automatyczne aprowizowanie.

  6. W polu Tenant URL wprowadź swój Contentstack Tenant URL i token tajny. Wybierz pozycję Test Connection aby upewnić się, że Microsoft Entra ID może nawiązać połączenie z aplikacją Contentstack. Jeśli połączenie nie powiedzie się, upewnij się, że konto contentstack ma wymagane uprawnienia administratora i spróbuj ponownie.

    Zrzut ekranu przedstawiający połączenie testowe aprowizacji.

  7. Wybierz pozycję Utwórz , aby utworzyć konfigurację.

  8. Wybierz Właściwości na stronie Przegląd.

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

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

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

  11. 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 (nazwa użytkownika) Sznurek ✓ ✓
    nazwa.imię Sznurek
    nazwa.nazwisko Sznurek
    aktywny logiczny
  12. 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ługa filtrowania Wymagane przez Contentstack
    nazwa wyświetlana Sznurek ✓ ✓
    członkowie Referencja
  13. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

  14. Użyj prowizjonowania na żądanie, aby zweryfikować synchronizację z niewielką liczbą użytkowników przed wdrożeniem na szerszą skalę w organizacji.

  15. Gdy wszystko będzie gotowe do aprowizacji, wybierz pozycję Rozpocznij aprowizację na stronie Przegląd .

Monitoruj swoje wdrożenie

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ć status cyklu aprowizacji i 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