Konfigurowanie aplikacji Playvox 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 programie Playvox, jak i identyfikatorze Entra firmy Microsoft w celu skonfigurowania automatycznej aprowizacji użytkowników. Po skonfigurowaniu, Microsoft Entra ID automatycznie tworzy i usuwa użytkowników lub grupy w usłudze Playvox przy użyciu usługi aprowizacji Microsoft Entra. Aby uzyskać ważne informacje na temat działania tej usługi i sposobu jej działania oraz często zadawanych pytań, zobacz Automatyzowanie aprowizacji użytkowników i anulowania aprowizacji aplikacji SaaS przy użyciu identyfikatora Microsoft Entra.

Obsługiwane funkcje

• Tworzenie użytkowników w usłudze Playvox.
• Usuń użytkowników w programie Playvox, gdy nie potrzebują już dostępu.
• Zachowaj synchronizację atrybutów użytkownika między identyfikatorem Entra firmy Microsoft i programem Playvox.

Wymagania wstępne

W tym scenariuszu 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 Playvox z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

1. Dowiedz się , jak działa usługa konfiguracji.

2. Określ, kto znajduje się w zakresie aprowizacji.

3. Określ, jakie dane mają być mapowane między Microsoft Entra ID a Playvox.

Krok 2. Konfigurowanie aplikacji Playvox do obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

1. Zaloguj się do konsoli administracyjnej programu Playvox i przejdź do pozycji Ustawienia > Klucze interfejsu API.

2. Wybierz pozycję Utwórz klucz interfejsu API.

   

3. Wprowadź zrozumiałą nazwę klucza interfejsu API, a następnie wybierz pozycję Zapisz. Po wygenerowaniu klucza interfejsu API wybierz pozycję Zamknij.

4. Na utworzonym kluczu interfejsu API wybierz ikonę Szczegóły .

   

5. Skopiuj i zapisz wartość BASE64 KEY . Później w portalu Azure wprowadzisz tę wartość w polu tekstowym Token tajny na karcie Aprowizacja aplikacji Playvox.

   

Krok 3. Dodawanie aplikacji Playvox z galerii aplikacji Microsoft Entra

Aby rozpocząć zarządzanie aprowizowaniem do Playvox, dodaj Playvox do dzierżawy Microsoft Entra z galerii aplikacji. Aby dowiedzieć się więcej, zobacz Szybki start: dodawanie aplikacji do dzierżawy usługi Microsoft Entra.

Jeśli wcześniej skonfigurowano aplikację Playvox na potrzeby logowania jednokrotnego, możesz użyć tej samej aplikacji. Zalecamy jednak utworzenie oddzielnej aplikacji podczas początkowego testowania integracji.

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ć zakres aprowizacji aplikacji na podstawie przypisania, możesz użyć kroków przypisywania 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. 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. 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 automatycznego udostępniania użytkowników do Playvox

W tej sekcji opisano kroki konfigurowania usługi aprowizacji firmy Microsoft w celu tworzenia, aktualizowania i wyłączania użytkowników lub grup na podstawie przypisań użytkowników lub grup w identyfikatorze Entra firmy Microsoft.

Aby skonfigurować automatyczną aprowizację użytkowników dla Playvox 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.

   

3. Na liście aplikacji wyszukaj i wybierz pozycję Playvox.

   

4. Wybierz kartę Aprowizacja .

   

5. Ustaw tryb aprowizacji na automatyczny.

   

6. Wprowadź w sekcji Poświadczenia administratora swój adres URL dzierżawy Playvox jako:

   https://{tenant}.playvox.com/scim/v1

   Wprowadź token tajny skopiowany wcześniej w kroku 2. Następnie wybierz pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z usługą Playvox. Jeśli połączenie nie powiedzie się, upewnij się, że konto playvox ma uprawnienia administratora i spróbuj ponownie.

   

7. W polu tekstowym Powiadomienie e-mail wprowadź adres e-mail osoby lub grupy, która otrzymuje powiadomienia o błędach aprowizacji. Następnie zaznacz pole wyboru Wyślij powiadomienie e-mail po wystąpieniu błędu .

   

8. Wybierz pozycję Zapisz.

9. W sekcji Mapowania wybierz pozycję Synchronizuj użytkowników usługi Microsoft Entra z Playvox.

10. Przejrzyj atrybuty użytkownika, które są synchronizowane z identyfikatora Entra firmy Microsoft do programu Playvox w sekcji Mapowanie atrybutów . Atrybuty wybrane jako pasujące właściwości są używane do dopasowywania kont użytkowników w programie Playvox na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, upewnij się, że interfejs API programu Playvox obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz pozycję Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut	Typ	Obsługa filtrowania
    userName	Sznurek	✓
    aktywny	Boolowski
    nazwa wyświetlana	Sznurek
    emails[typ eq "praca"].wartość	Sznurek
    nazwa.imię	Sznurek
    imię.nazwisko	Sznurek
    nazwa.sformatowana	Sznurek
    Identyfikator zewnętrzny	Sznurek

11. Aby skonfigurować filtry zakresu, zobacz instrukcje w artykule Filtrów zakresu.

12. Aby włączyć usługę aprowizacji Microsoft Entra dla programu Playvox, zmień stan aprowizacji na Włączony w sekcji Ustawienia.

    

13. W obszarze Ustawienia zdefiniuj użytkowników lub grupy do skonfigurowania w Playvox, wybierając odpowiednie wartości w obszarze Zakres.

    

14. Gdy będziesz gotowy do skonfigurowania, wybierz Zapisz.

    

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ż później. Późniejsze cykle występują co około 40 minut, pod warunkiem, że usługa 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 z artykułu dotyczącego statusu kwarantanny podczas aprowizacji aplikacji.

Dodatkowe zasoby

• Zarządzanie aprowizowaniem konta użytkownika dla aplikacji dla przedsiębiorstw
• Co to jest dostęp do aplikacji i logowanie jednokrotne przy użyciu identyfikatora Microsoft Entra ID?

Powiązana zawartość

• Dowiedz się, jak przeglądać logi i otrzymywać raporty dotyczące działań aprowizacji