Omówienie synchronizacji katalogów

Synchronizacja katalogów zapewnia, że webex dla użytkowników Cisco BroadWorks może używać katalogu Webex do wywoływania dowolnej jednostki wywołującej z serwera BroadWorks. Gdy ta funkcja jest włączona, pełny katalog wywołujący z serwera BroadWorks jest synchronizowany z katalogiem Webex. Użytkownicy mogą uzyskać dostęp do katalogu z aplikacji Webex i wywołać dowolną jednostkę wywołującą z serwera BroadWorks.

Synchronizacja katalogów obejmuje synchronizację zarówno informacji o połączeniach użytkowników, jak i list telefonów. Zsynchronizowane rekordy listy telefonów są zapisywane w jednym z dwóch typów kontaktów w katalogu Webex:

  • Kontakty organizacji — te kontakty są przechowywane w organizacji i są dostępne dla każdego użytkownika w organizacji.

  • Kontakty użytkowników — te kontakty są przechowywane względem użytkownika i są dostępne tylko dla użytkownika, który jest właścicielem kontaktu.


Webex dla Cisco BroadWorks provisioning obejmuje domyślną synchronizację użytkowników wiadomości i skojarzonych z nimi informacji o wywołaniach z serwera BroadWorks do katalogu Webex. Jednak domyślna synchronizacja inicjowania obsługi pomija użytkowników niebędących użytkownikami wiadomości i jednostki niebędące użytkownikami (na przykład telefon w sali konferencyjnej, faks lub numer grupy wyszukiwania). Włączenie synchronizacji katalogów zapewnia, że wszystkie encje wywołujące zostaną dodane do katalogu Webex.

Warunki synchronizacji katalogów

  • Administratorzy partnerów muszą włączyć tę funkcję na poziomie partnera. Administratorzy partnerów mogą włączać i wyłączać tę funkcję dla wielu organizacji klientów w ramach jednej operacji.

  • Domyślnie synchronizacja początkowa następuje tydzień po włączeniu synchronizacji (czas wybrany do rozpoczęcia synchronizacji jest losowy). Jednak organizacje klientów mogą użyć opcji Synchronizuj teraz, aby ominąć tygodniowy okres oczekiwania i ukończyć natychmiastową synchronizację dla danej organizacji klienta.

  • Domyślnie synchronizacja katalogów jest uruchamiana co tydzień dla każdego klienta. Każda synchronizacja odbywa się tydzień po ostatniej synchronizacji, niezależnie od tego, czy synchronizacja została zaplanowana, czy wyzwolona ręcznie za pomocą funkcji Synchronizujteraz.

  • Jeśli wystąpi błąd synchronizacji, synchronizacja jest automatycznie wznawiana co 24 godziny, aż do następnej zaplanowanej synchronizacji.

  • Synchronizacja ignoruje użytkowników, którzy nie mają numeru telefonu.

  • W Centrum partnerów można wyświetlić informacje o stanie synchronizacji dla danego klienta. Ponadto można wyeksportować szczegółowe informacje o ostatniej synchronizacji do rekordu CSV. Rekord CSV jest bardziej szczegółowy niż wyświetlacz Control Hub i może pomóc w rozwiązywaniu problemów, analizach i inspekcji.

  • Kontakty użytkownika są przechowywane w zaszyfrowanym formacie, a tylko użytkownik, który jest właścicielem kontaktu, ma dostęp do klucza deszyfrującego.

  • Ta funkcja synchronizuje następujące typy list telefonów z serwera BroadWorks:

    • Wspólne listy telefonów dla przedsiębiorstw

    • Grupowanie wspólnych list telefonów

    • Osobiste listy telefonów

Synchronizacja katalogów i maksymalne liczby kontaktów

Poniżej przedstawiono maksymalną liczbę kontaktów dozwolonych przez synchronizację katalogów dla każdego typu kontaktu Webex:

  • 500 Kontakty organizacyjne

  • 500 kontaktów użytkownika — dla użytkownika maksymalna liczba kontaktów użytkownika obejmuje zsynchronizowane kontakty użytkownika i kontakty ręczne (kontakty dodawane przez użytkownika ręcznie za pośrednictwem aplikacji Webex)

Obowiązują następujące warunki:

  • Jeśli organizacja ma więcej niż 500 kontaktów w którejkolwiek z kategorii, synchronizacja wyklucza wpisy powyżej progu limitu 500. Nie ma określonej kolejności stosowanej do zsynchronizowanych lub pominiętych kontaktów.

  • Jeśli użytkownik doda kontakty ręcznie w aplikacji Webex, maksymalna liczba kontaktów użytkownika jest określana przez odjęcie kontaktów ręcznych od zsynchronizowanych kontaktów użytkownika. Na przykład, jeśli użytkownik doda 100 kontaktów ręcznie w aplikacji Webex, synchronizacja katalogów pozwala na synchronizację do 400 kontaktów użytkownika z BroadWorks dla tego użytkownika.

  • Zalecamy, aby jeśli jedna z organizacji klientów ma więcej niż 500 kontaktów w którejkolwiek z kategorii, zgłosić sprawę do Cisco, aby wykluczyć tę organizację z synchronizacji katalogów.

Poniższa tabela mapuje typy kontaktów Webex na listę telefonów BroadWorks, z której są synchronizowane rekordy:

Tabela 1. Typy kontaktów synchronizacji katalogów i źródło synchronizacji

Typ kontaktu Webex

Zsynchronizowane z BroadWorks...

Interfejs API używany do synchronizacji

Kontakty organizacji

Wspólne listy telefonów dla przedsiębiorstw

/directories/enterprisecommon

Grupowanie wspólnych list telefonów (w trybie usługodawcy)**

/directories/groupcommon

Kontakty użytkowników

Grupowanie wspólnych list telefonów (w trybie przedsiębiorstwa)**

/directories/groupcommon

Osobiste listy telefonów

/directories/personal


**Grupowe listy wspólnych telefonów są synchronizowane w różny sposób w zależności od tego, czy BroadWorks jest w trybie Enterprise Mode czy Service Provider. Wartość isBroadWorksEnterprise parametr (true lub false) określa sposób synchronizacji listy:

  • Prawda — synchronizacja jako kontakt organizacji

  • Fałsz — synchronizacja jako kontakt użytkownika

Aktualizacje

Po zaktualizowaniu kontaktu w BroadWorks, następujące kontury, gdy aktualizacja jest wyświetlana w aplikacji Webex użytkownika:

  • Aktualizacje kontaktów organizacji są wyświetlane w aplikacji Webex po ponownym uruchomieniu aplikacji przez użytkownika lub po wygaśnięciu lokalnego 72-godzinnego czasomierza pamięci podręcznej aplikacji.

  • Aktualizacje kontaktów użytkownika są natychmiast wyświetlane w aplikacji Webex dla tego użytkownika.

Poniżej opisano, w jaki sposób katalog Webex obsługuje aktualizacje:

  • Jeśli nazwa kontaktu zmieni się w BroadWorks, istniejący kontakt zostanie usunięty z katalogu Webex i zostanie utworzony nowy kontakt.

  • Jeśli numer kontaktowy zmieni się w BroadWorks, istniejący kontakt w katalogu Webex zostanie zaktualizowany o nowy numer.

Wymagania wstępne dotyczące synchronizacji katalogów

Wymagania toggle

Dla tej funkcji istnieją następujące przełączniki funkcji. Pamiętaj, aby skontaktować się z przedstawicielem Webex dla Cisco BroadWorks, aby je ustawić.

Przełącznik funkcji

Zastosowany do...

Opis

webex-for-broadworks-phone-list-sync

Partner

Obowiązkowe przełączanie. Włącza synchronizację listy telefonów dla wszystkich organizacji klientów w ramach tego partnera.

Musi być włączony.

webex-for-broadworks-phone-list-sync-disable

Organizacja klienta

Opcjonalny przełącznik. Wyłącza synchronizację listy telefonów dla danej organizacji, nawet jeśli funkcja jest włączona na poziomie partnera i w szablonie klienta.

Zastosuj ten przełącznik tylko wtedy, gdy chcesz wyłączyć synchronizację listy telefonów dla określonej organizacji klienta. W przeciwnym razie możesz pozostawić go wyłączonym.


 
Na przykład należy zastosować ten przełącznik do wszystkich organizacji, które wymagają więcej niż 500 kontaktów.

hidden-personal-contacts-enabled-ga

Użytkownik

Opcjonalny przełącznik. Ukrywa kontakty osobiste przed wyszukiwaniem w katalogu zakończonym przez tego użytkownika.

hidden-org-contacts-enabled-ga

Użytkownik

Opcjonalny przełącznik. Ukrywa kontakty organizacji przed wyszukiwaniem w katalogu zakończonym przez tego użytkownika.

Wymagania konfiguracji wstępnej

Zalecamy korzystanie z następujących ustawień:


W poniższych przykładach założono, że używasz serwera XSP. W przypadku serwerów ADP zamień (XSP_CLI) na (ADP_CLI).
  • Wartości graniczne szybkości — ustaw następujące właściwości systemu OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

    • userDirectoryTransactionLimit — ustaw wartość null.

    • globalDirectoryTransactionLimit — ustaw wartość null.


    Zaleca się ustawienie userDirectoryTransactionLimit i globalDirectoryTransactionLimit na wartość null. Jeśli jednak zdecydujesz się przypisać wartości, każda z nich musi być ustawiona na co najmniej pięciokrotność wartości transactionLimitPeriodSeconds (która powinna wynosić 1).
  • Limity transakcji — ustaw następujące wartości (XSP_CLI/System/CommunicationUtility/DefaultSettings):

    • userTransactionLimit — ustaw wartość co najmniej 100.

    • transactionLimitPeriodSecs — ustaw wartość 1.

  • Wartości stronicowania — ustaw właściwości systemu stronicowania (interfejs_wiersza polecenia XSP/Aplikacje/Xsi-Actions/Stronicowanie):

    • defaultPageSize — ustaw wartość 50

    • availableUserMaxLimit — ustaw wartość 100

  • Interfejs CTI — upewnij się, że certyfikaty Urzędu Certyfikacji Webex zostały przekazane do magazynu zaufania interfejsu CTI i włączono uwierzytelnianie klienta na interfejsie CTI.

Ponadto, w zależności od wersji BroadWorks, zalecamy zastosowanie następujących poprawek systemowych do wdrożenia BroadWorks przed włączeniem tej funkcji:


Aby uzyskać pełną listę wymagań dotyczących poprawek, które stanowią minimalne wymaganie dla Webex dla Cisco BroadWorks, zobacz BroadWorks Software Requirements w Przewodniku po rozwiązaniach dla Webex dla Cisco BroadWorks.

Włącz synchronizację katalogów (nowy szablon)

Administratorzy partnerscy mogą włączyć synchronizację katalogów dla szablonu klienta podczas tworzenia nowego szablonu. Wszystkie nowe organizacje klientów, które zostaną przypisane do tego szablonu, będą miały włączoną synchronizację katalogów. Szczegółowe informacje zawiera sekcja "Konfigurowanie szablonów klientów" w temacie Konfigurowanie organizacji partnerskiej w programie Partner Hub w Przewodniku po rozwiązaniach webex dla CiscoBroadWorks.

Co dalej

Upewnij się, że użytkownicy wiedzą, że muszą kliknąć kartę Kontakty w aplikacji Webex co najmniej raz, aby włączyć tę funkcję w aplikacji Webex. Należy to zrobić tylko raz.

Włącz synchronizację katalogów (istniejący szablon)

Administratorzy partnerscy mogą wykonać następujące kroki, aby włączyć synchronizację katalogów w istniejącym szablonie klienta, aby włączyć tę funkcję dla organizacji klientów korzystających z tego szablonu.

1

Zaloguj się do Centrum partnerów i wybierz pozycję Ustawienia.

2

Przewiń do pozycji Wywołanie BroadWorks i kliknij Wyświetl szablony.

3

Wybierz odpowiedni szablon klienta i przewiń do BroadWorks DirectorySync.

4

Aby domyślnie włączyć synchronizację katalogów dla nowych organizacji klientów, które używają tego szablonu:

  1. Ustaw włącz synchronizację katalogów BroadWorks i listy telefonów dla wszystkich nowych organizacji klientów, aby przełączyć naWłączone.

  2. Kliknij opcję Zapisz.

5

Aby włączyć synchronizację katalogów dla istniejących organizacji klientów, które używają tego szablonu:

  1. Kliknij Pokaż stan synchronizacji listy klientów.

  2. Zaznacz sąsiednie pola wyboru dla każdej organizacji, dla której chcesz włączyć tę funkcję.

  3. Kliknij włącz synchronizację.


 

Jeśli chcesz wyłączyć synchronizację katalogów, wykonaj powyższą procedurę i:

  • W kroku 4a ustaw przełącznik Włącz synchronizację książek telefonicznych dla wszystkich nowych organizacji klientów na Wyłączone, aby domyślnie wyłączyć synchronizację katalogów dla nowych organizacji klientów, które używają tego szablonu.

  • W kroku 5c kliknij wyłącz synchronizację, aby wyłączyć tę funkcję w istniejących organizacjach.

Co dalej?

Upewnij się, że użytkownicy wiedzą, że muszą kliknąć kartę Kontakty w aplikacji Webex co najmniej raz, aby włączyć tę funkcję w aplikacji Webex. Należy to zrobić tylko raz.

Pełna natychmiastowa synchronizacja

Opcja Synchronizuj teraz umożliwia administratorowi partnera ukończenie synchronizacji na żądanie dla danej organizacji klienta. Tę opcję można wybrać tylko dla poszczególnych organizacji klientów — nie ma opcji zbiorczej dla opcji Synchronizuj teraz.

1

Zaloguj się do Centrum partnerów (http://admin.webex.com) i wybierz pozycję Ustawienia.

2

Przewiń do pozycji Wywołanie BroadWorks i kliknij Wyświetl szablony.

3

Wybierz odpowiedni szablon klienta i przewiń do BroadWorks DirectorySync.

4

Kliknij Pokaż stan synchronizacji listy klientów.

5

W przypadku organizacji klienta, którą chcesz zsynchronizować, kliknij trzy kropki po prawej stronie i wybierz opcję Synchronizuj teraz.

6

Kliknij przycisk Odśwież, aby wyświetlić wyniki synchronizacji.

Eksportowanie rekordów synchronizacji do pliku CSV

Administratorzy partnerscy mogą eksportować szczegółowe informacje o ostatniej synchronizacji do pliku CSV. Plik CSV zawiera bardziej szczegółowy widok rekordu synchronizacji niż interfejs GUI Control Hub i może pomóc w rozwiązywaniu problemów i analizach.

1

Zaloguj się do Centrum partnerów (http://admin.webex.com) i wybierz pozycję Ustawienia.

2

Przewiń do pozycji Wywołanie BroadWorks i kliknij Wyświetl szablony.

3

Wybierz odpowiedni szablon klienta i przewiń do BroadWorks DirectorySync.

4

Kliknij Pokaż stan synchronizacji listy klientów.

5

Zaznacz sąsiednie pola wyboru dla każdej organizacji, którą chcesz uwzględnić w eksporcie.

6

Kliknij eksportuj wyniki.

Publiczne interfejsy API do synchronizacji katalogów

Publiczne interfejsy API są dostępne w developer.webex.com, które umożliwiają administratorom partnerów aktualizowanie ustawień synchronizacji katalogów dla zarządzanych przez nich organizacji klientów, wyzwalanie natychmiastowej synchronizacji lub uzyskiwanie informacji o stanie synchronizacji. Metody synchronizacji katalogów są zgrupowane w BroadWorksEnterprises. Istnieją cztery interfejsy API:

  • List BroadWorks Enterprises— Użyj tej metody API, aby uzyskać listę przedsiębiorstw w ramach danego dostawcy usług i każdego przedsiębiorstwa id. Musisz wprowadzić spEnterpriseId zgodnie z przypisaniem w aprowizacji.

  • Zaktualizuj synchronizację katalogów dla BroadWorks Enterprise— Wprowadź przedsiębiorstwo id, aby zaktualizować stan syc katalogu dla tego przedsiębiorstwa, włączając lub wyłączając synchronizację katalogów.

  • Wyzwalanie synchronizacji katalogów dlaprzedsiębiorstwa — użyj tej metody interfejsu API, jeśli chcesz wyzwolić natychmiastową synchronizację dla danego przedsiębiorstwa id. Dla syncStatus, wprowadź SYNC_NOW polecenie.

  • Uzyskiwanie stanu synchronizacji katalogów dlaprzedsiębiorstwa — wprowadź przedsiębiorstwo id i uruchom w celu uzyskania statusu i trackingId najnowszej synchronizacji. Możesz użyć trackingID do uruchamiania dodatkowych analiz za pomocą narzędzi takich jak Kibana i Grafana.

Aby uzyskać szczegółową dokumentację interfejsu API, zobacz https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Musisz się zalogować, aby przeczytać specyfikację interfejsu API pod adresem https://developer.webex.com/docs/api/v1/broadworks-subscribers.

Synchronizowanie wielu przedsiębiorstw za pomocą interfejsu API

Wykonaj tę procedurę, aby użyć publicznych interfejsów API do ukończenia synchronizacji katalogów dla wielu przedsiębiorstw.

  • Synchronizacja katalogów umożliwia synchronizację tylko jednego przedsiębiorstwa naraz. Jeśli spróbujesz zsynchronizować więcej niż jedno przedsiębiorstwo, pojawi się błąd 429.

  • Czas potrzebny na ukończenie synchronizacji dla pojedynczego przedsiębiorstwa różni się w zależności od wielkości przedsiębiorstwa.

1

Uruchom interfejs API List BroadWorks Enterprises, aby wygenerować listę przedsiębiorstw, które chcesz zsynchronizować.

  1. Ustaw startWith na ciąg początkowy identyfikatora przedsiębiorstwa lub usługodawcy.

  2. Kliknij przycisk Uruchom.

2

Uruchom Trigger Directory Sync dla interfejsu API przedsiębiorstwa na pierwszym przedsiębiorstwie na liście.

  1. Wprowadź identyfikator przedsiębiorstwa.

  2. Ustaw syncStatus na SYNC_NOW

  3. Kliknij przycisk Uruchom.

    Natychmiastowa synchronizacja zostanie uruchomiona dla przedsiębiorstwa. Ta synchronizacja jest wliczana do limitu jednej synchronizacji na wystąpienie.
3

Poczekaj kilka sekund, a następnie uruchom interfejs API Pobierz stan synchronizacji katalogu, aby uzyskać stan synchronizacji.

  1. Wprowadź identyfikator przedsiębiorstwa

  2. Kliknij przycisk Uruchom.

4

Po zakończeniu synchronizacji wykonaj kroki od 2 do 4 w następnym przedsiębiorstwie na liście. Powtarzaj te kroki, aż zostanie zsynchronizowana cała lista.

Kody błędów synchronizacji katalogów

Poniższe kody błędów dotyczą synchronizacji katalogów.

Kod błędu

Komunikat o błędzie

600000

Nieoczekiwany błąd synchronizacji użytkownika katalogu zewnętrznego Broadworks.

600001

Synchronizacja użytkowników katalogu zewnętrznego Broadworks nie powiodła się.

600002

Broadworks External Directory User Sync musiała zostać zakończona przed zakończeniem.

600003

Broadworks External Directory User Sync tylko częściowo się powiodło. Synchronizacja niektórych organizacji klientów nie powiodła się.

600004

Synchronizacja użytkowników katalogu zewnętrznego Broadworks nie jest włączona dla ConfigSet.

600005

Broadworks External Directory User Sync jest w toku dla ConfigSet.

600006

Wątki synchronizacji użytkowników katalogu zewnętrznego Broadworks są zajęte lub zamykane, dlatego nie zaakceptują więcej żądań synchronizacji, spróbuj ponownie później.

600007

Nie znaleziono tożsamości organizacji CustomerConfig.

600008

CustomerConfig nie znajduje się w organizacji partnerskiej.

600009

Nie można uruchomić synchronizacji użytkowników katalogu zewnętrznego Broadworks, ponieważ klaster broadworks skojarzony z CustomerConfig jest zajęty

600010

Nie można uruchomić Synchronizacji użytkowników katalogu zewnętrznego Broadworks, ponieważ z CustomerConfig nie jest skojarzony klaster broadworks.

600011

Broadworks External Directory User Sync nie jest włączona dla CustomerConfig.

600012

Nie można uruchomić Broadworks External Directory User Sync, ponieważ synchronizacja katalogu hybrydowego jest już włączona dla CustomerConfig.

600013

Broadworks External Directory User Sync nie może dodać użytkowników i kont komputerów do magazynu tożsamości.

600014

Synchronizacja użytkowników katalogu zewnętrznego Broadworks nie powiodła się podczas próby połączenia z klastrem Broadworks. Błąd z Broadworks - %s.

600015

Broadworks External Directory User Sync nie znalazł żadnego pasującego użytkownika w magazynie tożsamości.

600017

BroadWorks Phone List Sync nie może zsynchronizować wszystkich kontaktów użytkowników i przedsiębiorstw/organizacji.

600018

BroadWorks Phone List Sync nie powiodło się dla użytkowników w przedsiębiorstwie/organizacji.

600019

BroadWorks Phone List Sync nie może zsynchronizować kontaktów przedsiębiorstwa/organizacji.