Konfigurowanie rozwiązania Vonage na potrzeby automatycznej aprowizacji użytkowników przy użyciu Microsoft Entra ID

W tym artykule opisano kroki, które należy wykonać zarówno w systemie Vonage, jak i Microsoft Entra ID w celu skonfigurowania automatycznej aprowizacji użytkowników. Po skonfigurowaniu usługi Microsoft Entra ID automatycznie aprowizuje i dezaprowizuje użytkowników i grupy do Vonage za pomocą usługi aprowizacji Microsoft Entra. Aby uzyskać ważne szczegółowe informacje na temat działania tej usługi oraz odpowiedzi na często zadawane pytania, sprawdź Automatyzuj aprowizację użytkowników i deaprowizację w aplikacjach SaaS za pomocą Microsoft Entra ID.

Obsługiwane możliwości

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 .
• Dzierżawa Vonage.
• Konto użytkownika w aplikacji Vonage z uprawnieniami administratora.

Krok 1: Zaplanuj wdrożenie zaopatrzenia

1. Dowiedz się, jak działa usługa aprowizacji.
2. Określ, kto znajduje się w zakresie udostępniania.
3. Ustal, jakie dane chcesz zmapować pomiędzy Microsoft Entra ID a Vonage.

Krok 2. Konfigurowanie rozwiązania Vonage w celu obsługi aprowizacji przy użyciu Microsoft Entra ID

1. Zaloguj się do portalu administracyjnego firmy Vonage przy użyciu użytkownika administracyjnego.

2. W obszarze nawigacji po lewej stronie wybierz pozycję Konto>. Zostanie otwarta strona ustawień zarządzania tożsamościami między domenami (SCIM).

3. W sekcji Ustawienia uwierzytelniania i poświadczenia usługi wybierz pozycję Microsoft Entra jako dostawcę tożsamości. Lista rozwijana Metoda uwierzytelniania jest wstępnie wypełniona poświadczeniami klienta OAuth 2.0.

   Uwaga

   Po zmianie poświadczeń w aplikacji Vonage istniejące zadanie aprowizacji w Microsoft Entra ID może na krótko kontynuować korzystanie z bieżącego tokenu dostępu. Tokeny te zwykle wygasają godzinę po ich wystawieniu i nie można ich odświeżyć po zmianie poświadczeń w systemie Vonage, co może powodować tymczasowe błędy aprowizacji. Po zaktualizowaniu poświadczeń w Microsoft Entra ID kolejne cykle synchronizacji używają nowych poświadczeń i ponawiają nieudane operacje aprowizacji. W przypadku tych niepowodzeń nie jest wymagana żadna dodatkowa akcja.

4. W oknie dialogowym Gotowe do wygenerowania poświadczeń usługi wybierz pozycję Kontynuuj.

5. Wprowadź co najmniej jeden adres e-mail administratora dostawcy tożsamości i wybierz pozycję Generuj poświadczenia.

6. Skopiuj następujące wartości z okna dialogowego i zapisz je w bezpiecznej lokalizacji, takiej jak menedżer haseł. Każda wartość ma własną ikonę kopiowania.

   Pole	Opis
   Punkt końcowy tokenu	Punkt końcowy tokenu dostarczony przez firmę Vonage.
   Adres URL dzierżawcy	Adres URL dzierżawcy dostarczony przez firmę Vonage.
   identyfikator klienta	Automatycznie wygenerowany identyfikator klienta.
   Identyfikator klucza tajnego klienta	Automatycznie wygenerowany klucz tajny klienta, który jest widoczny tylko raz.

7. Po skopiowaniu wszystkich czterech wartości wybierz pozycję Gotowe , aby zamknąć okno dialogowe.

   Warning

   Identyfikator klucza tajnego klienta jest trwale maskowany po wybraniu pozycji Gotowe. Jeśli go utracisz, wybierz pozycję Wygeneruj ponownie, aby wygenerować nowy sekret.

Krok 3. Dodawanie aplikacji Vonage z galerii aplikacji Microsoft Entra

Dodaj Vonage z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie dostawami do Vonage. Jeśli wcześniej skonfigurowano aplikację Vonage na potrzeby 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 określenie, kto jest aprowizowany na podstawie przypisania do aplikacji lub atrybutów użytkownika czy grupy. Jeśli zdecydujesz się określić, kto jest udostępniany w Twojej aplikacji na podstawie przypisania, możesz użyć kroków przypisywania użytkowników i grup do aplikacji. Jeśli zdecydujesz się określić zakres, kto jest udostępniony 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. Gdy zakres przydzielania jest ustawiony na przypisanych użytkowników i grupy, możesz kontrolować to, przypisując jednego lub dwóch użytkowników albo jedną lub dwie grupy 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 automatycznej aprowizacji użytkowników w usłudze Vonage

Ta sekcja zawiera instrukcje konfigurowania usługi aprowizacji Microsoft Entra w celu tworzenia, aktualizowania i wyłączania użytkowników i/lub grup w usłudze Vonage na podstawie przypisań użytkowników i/lub grup w Microsoft Entra ID.

Konfigurowanie automatycznej aprowizacji użytkowników dla rozwiązania Vonage w Microsoft Entra ID

1. Zaloguj się do centrum administracyjne Microsoft Entra jako co najmniej Administrator aplikacji w chmurze.

2. Przejdź do Entra ID> Aplikacje dla przedsiębiorstw

   

3. Na liście aplikacji wybierz pozycję Vonage.

   

4. Wybierz kartę Provisioning.

   

5. W przypadku nowej konfiguracji wybierz pozycję Przegląd>+ Nowa konfiguracja.

   

   Aby zaktualizować istniejącą konfigurację, wybierz pozycję Łączność.

   

6. W obszarze Nowa konfiguracja lub Łączność użyj listy rozwijanej Wybierz metodę uwierzytelniania , aby zmienić metodę uwierzytelniania. Grant client credentials OAuth2 jest domyślnie wybierany dla nowych konfiguracji.

   Uwaga

   W przypadku istniejących konfiguracji grant kodu autoryzacji OAuth 2.0 pozostaje dostępny jako rezerwowy do 1 kwietnia 2027 r. Po tej dacie opcja zostanie usunięta. Przejdź na grant Client Credentials OAuth2 do 31 marca 2027 r., aby uniknąć zakłóceń aprowizacji.

7. Instrukcje dotyczące konfigurowania przepływu OAuth2 Client Credentials Grant: W polu Adres URL dzierżawcy wprowadź adres URL dzierżawcy Vonage. Wprowadź odpowiednio identyfikator klienta, klucz tajny klienta i punkt końcowy tokenu pobrane z portalu Vonage w polach Identyfikator klienta, Klucz tajny klienta i Punkt końcowy tokenu OAuth. Wybierz pozycję Testuj połączenie , aby zweryfikować poświadczenia.

   

8. Wybierz pozycję Utwórz dla nowej konfiguracji lub Zapisz podczas aktualizowania konfiguracji uwierzytelniania.

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

10. Wybierz ikonę Edytuj , aby edytować właściwości. Włącz wiadomości e-mail z powiadomieniami i podaj wiadomość e-mail, aby otrzymywać powiadomienia o kwarantannie. Włącz zapobieganie przypadkowym usunięciom. Wybierz Zastosuj, aby zapisać zmiany.

    

11. Vonage używa wstępnie ustawionych mapowań atrybutów na potrzeby aprowizacji użytkowników. Możesz wyświetlić te mapowania, wybierając pozycję Mapowanie atrybutów w panelu po lewej stronie, a następnie wybierając użytkowników. Aby dowiedzieć się, czy są obsługiwane dodatkowe atrybuty, zobacz dokumentację firmy Vonage.

12. Aby skonfigurować filtry określania zakresu, zapoznaj się z instrukcjami podanymi w artykule Określanie filtrów zakresu.

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

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

Krok 6. Monitorowanie wdrożenia

Po skonfigurowaniu aprowizacji użyj następujących zasobów, aby monitorować wdrożenie:

1. Użyj dzienników inicjowania obsługi, aby określić, którzy użytkownicy zostali pomyślnie lub niepomyślnie zainicjowani.
2. Sprawdź pasek postępu, aby zobaczyć stan cyklu aprowizacji i jak blisko jest ukoń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 Stan kwarantanny aprowizacji aplikacji.

Więcej zasobów

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

Powiązana zawartość

• Dowiedz się, jak przeglądać logi i pobierać raporty z działalności aprowizacyjnej