Konfigurowanie aplikacji RingCentral 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 RingCentral, jak i Microsoft Entra ID, aby skonfigurować automatyczne przydzielanie użytkowników. Po skonfigurowaniu Microsoft Entra ID automatycznie aprowizuje i deaktywuje użytkowników oraz grupy do RingCentral przy użyciu 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 funkcje

  • Tworzenie użytkowników w aplikacji RingCentral
  • Usuwanie użytkowników w usłudze RingCentral, gdy nie wymagają już dostępu
  • Zachowywanie synchronizacji atrybutów użytkownika między Microsoft Entra ID a RingCentral
  • Logowanie jednokrotne do aplikacji RingCentral (zalecane)
  • Obsługiwane jest uwierzytelnianie w przepływie przyznawania autoryzacji kodem.

Rozwiązanie RingCentral jest dostępne w następujących wdrożeniach chmury krajowej.

Usługa globalna Rząd USA Chiny obsługiwane przez 21Vianet
✅ ✅

Wymagania wstępne

W scenariuszu opisanym w tym artykule przyjęto założenie, że masz już następujące wymagania wstępne:

Krok 1: Zaplanuj wdrożenie zaopatrzenia

  1. Dowiedz się, jak działa usługa aprowizacji.
  2. Określ, kto znajduje się w obszarze wdrożenia.
  3. Ustal, jakie dane mają być mapowane między Microsoft Entra ID a RingCentral.

Krok 2. Konfigurowanie aplikacji RingCentral w celu obsługi aprowizacji przy użyciu identyfikatora Entra firmy Microsoft

Konto administratora RingCentral jest wymagane do autoryzowania w sekcji Poświadczenia administratora w kroku 5.

W portalu administracyjnym RingCentral w obszarze Ustawienia konta —> Integracja katalogów ustaw ustawienie Dostawca katalogów na imageSCIM

Uwaga / Notatka

Aby przypisać licencje do użytkowników, skorzystaj z linku wideo tutaj.

Dodaj aplikację RingCentral z galerii aplikacji Microsoft Entra, aby rozpocząć zarządzanie aprowizowaniem w aplikacji RingCentral. Jeśli wcześniej skonfigurowano aplikację RingCentral dla 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 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ć, kto będzie aprowizowany do 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 aprowizowany 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. 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 RingCentral

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ć automatyczne udostępnianie użytkowników dla RingCentral 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ę RingCentral.

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

  4. Wybierz kartę Konfiguracja.

    Zrzut ekranu przedstawiający opcje zarządzania, z wyróżnioną opcją aprowizacji.

  5. Ustaw + Nowa konfiguracja.

    Zrzut ekranu przedstawiający zakładkę Aprowizowanie automatyczne.

  6. W polu Adres URL dzierżawcy wprowadź adres URL dzierżawcy RingCentral i sekretny token. Wybierz pozycję Testuj połączenie , aby upewnić się, że identyfikator Entra firmy Microsoft może nawiązać połączenie z aplikacją RingCentral. Jeśli połączenie nie powiedzie się, upewnij się, że konto RingCentral 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. Wybierz ołówek, aby edytować właściwości. Włącz wiadomości e-mail z powiadomieniami i podaj wiadomość e-mail, aby otrzymywać wiadomości e-mail z kwarantanny. Włącz zapobieganie przypadkowym usunięciom. Wybierz Zastosuj, aby zapisać zmiany.

    Zrzut ekranu przedstawiający stronę Właściwości aprowizacji z ustawieniami powiadomień i usuwania.

  10. Wybierz Mapowanie atrybutów w lewym panelu, a następnie wybierz użytkowników.

  11. Przejrzyj atrybuty użytkownika, które są synchronizowane z identyfikatora Entra firmy Microsoft do elementu RingCentral w sekcji Mapowanie atrybutów . Atrybuty wybrane jako Właściwości dopasowywania są używane do dopasowania kont użytkowników w usłudze RingCentral na potrzeby operacji aktualizacji. Jeśli zdecydujesz się zmienić pasujący atrybut docelowy, musisz upewnić się, że interfejs API RingCentral obsługuje filtrowanie użytkowników na podstawie tego atrybutu. Wybierz przycisk Zapisz , aby zatwierdzić wszelkie zmiany.

    Atrybut Typ
    userName (nazwa użytkownika) Sznurek
    Identyfikator zewnętrzny Sznurek
    aktywny logiczny
    tytuł Sznurek
    emails[typ eq "praca"].wartość Sznurek
    Adresy[typ eq "praca"].kraj Sznurek
    adresy[typ eq "praca"].region Sznurek
    adresy[typ eq "praca"].lokalizacja Sznurek
    adresy[typ równy "praca"].kodPocztowy Sznurek
    adresy[typ równy "praca"].adresUlicy Sznurek
    nazwa.imię Sznurek
    imię.nazwisko Sznurek
    phoneNumbers[typ eq "komórkowy"].wartość Sznurek
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Użytkownik:dział Sznurek
  12. Aby skonfigurować filtry określania zakresu, zapoznaj się z poniższymi instrukcjami podanymi w artykule Filtrowania 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 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.

Dziennik zmian

  • 10.09.2020 — Usunięto obsługę atrybutów "displayName" i "manager".
  • 03/15/2021 — zaktualizowano metodę autoryzacji z trwałego tokenu typu bearer do przepływu autoryzacji kodu OAuth.
  • 10/28/2021 — Zaktualizowano domyślne odwzorowanie na mail-> wiadomości e-mail[type eq "work"].value.
  • 10/28/2021 — Ograniczenie szybkości zostało zaktualizowane do 300/min dla odczytu, 1000/min dla zapisu.

Dodatkowe zasoby