Synchronizacja katalogów w Webex dla Cisco BroadWorks

Synchronizacja katalogów zapewnia, że użytkownicy Webex dla Cisco BroadWorks mogą używać katalogu Webex z aplikacji Webex do wywoływania dowolnej jednostki wywołującej z serwera BroadWorks. Ta funkcja synchronizuje informacje o połączeniach BroadWorks, które nie były częścią aprowizacji użytkownika, z katalogiem Webex.

Webex dla użytkowników Cisco BroadWorks aktualizuje katalog Webex o szczegóły połączeń dla Webex dla użytkowników Cisco BroadWorks (podstawowy numer telefonu, numer telefonu komórkowego, numer wewnętrzny), ale pomija zewnętrzne rekordy połączeń. Jednak gdy synchronizacja katalogów jest włączona, funkcja synchronizuje również następujące rekordy połączeń z katalogiem Webex.

• Użytkownicy dzwoniący tylko do BroadWorks (którzy nie są dołączeni do Webex)

• Encje wywołujące inne niż użytkownik (np. telefon w sali konferencyjnej, faks, numer grupy wyszukiwania)

• Wpisy na liście telefonów BroadWorks

Poniższa tabela zawiera podsumowanie rekordów połączeń BroadWorks i pokazuje, w jaki sposób są one dodawane 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 początkowa synchronizacja odbywa się tydzień po włączeniu synchronizacji (czas wybrany do rozpoczęcia synchronizacji jest losowy). Organizacje klientów mogą jednak użyć opcji Synchronizuj teraz , aby pominąć tygodniowy okres oczekiwania i wyzwolić natychmiastową synchronizację dla danej organizacji klienta.

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

• Maksymalna liczba jednoczesnych synchronizacji na klaster BroadWorks wynosi dwie: jedna zaplanowana synchronizacja i jedna synchronizacja na żądanie (za pośrednictwem interfejsu API lub graficznego interfejsu użytkownika Partner Hub). Administratorzy nie mogą jednak uruchamiać dwóch synchronizacji na żądanie w tym samym czasie z tego samego BroadWorks. To ograniczenie istnieje niezależnie od tego, czy synchronizacja została zainicjowana za pośrednictwem interfejsu API, czy za pośrednictwem opcji Synchronizuj teraz w Partner Hub. Ponadto Webex nie zaplanuje uruchomienia dwóch zaplanowanych synchronizacji w tym samym czasie z tego samego BroadWorks.

• Jeśli wystąpi niepowodzenie synchronizacji, Webex automatycznie ponawia próbę synchronizacji co 24 godziny, aż do następnej zaplanowanej synchronizacji.

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

• W Partner Hub 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 zawiera więcej szczegółów niż ekran Control Hub i może pomóc w rozwiązywaniu problemów, analizie i inspekcji.

• Webex przechowuje kontakty użytkowników w zaszyfrowanym formacie. Tylko użytkownik, który jest właścicielem kontaktu, ma dostęp do klucza odszyfrowywania.

• W przypadku użytkowników dzwoniących tylko do BroadWorks i encji dzwoniących bez użytkowników ta funkcja synchronizuje następujące typy numerów telefonów z BroadWorks:

  • Podstawowy numer telefonu

  • Numer telefonu komórkowego

  • Numer wewnętrzny

  Jednak synchronizacja wyklucza z synchronizacji tylko użytkowników dzwoniących BroadWorks i encje dzwoniące niebędące użytkownikami, jeśli nie ma podstawowego numeru telefonu ani numeru wewnętrznego.

  Ustawienie usługi prywatności na poziomie użytkownika BroadWorks nie jest obsługiwane w ramach synchronizacji katalogów.

Lista telefonów BroadWorks i maksymalna liczba kontaktów

Synchronizacja katalogów synchronizuje również wpisy listy telefonów BroadWorks z kontaktami Webex. Zsynchronizowane wpisy są dodawane do jednego z następujących typów kontaktów:

• Kontakty organizacji — Webex przechowuje te kontakty w organizacji. Każdy użytkownik może uzyskać dostęp do kontaktów organizacji w swojej organizacji. Maksymalnie do 30000 kontaktów.

• Kontakty użytkownika — Webex przechowuje te kontakty względem użytkownika. Tylko użytkownik, który jest właścicielem kontaktu, może uzyskać dostęp do wpisu kontaktu. Maksymalnie do 2000 kontaktów (1500 zsynchronizowanych kontaktów + 500 kontaktów wprowadzanych ręcznie).

Poniższa tabela mapuje typy kontaktów Webex względem źródła kontaktu (zsynchronizowanego z listy telefonów BroadWorks lub dodanego ręcznie):

Następujące warunki dotyczą sposobu, w jaki Directory Sync obsługuje maksymalną liczbę kontaktów:

• Jeśli organizacja przekroczy maksymalną liczbę kontaktów dozwolonych do synchronizacji (30000 kontaktów organizacji lub 30000 wspólnych kontaktów grupy na grupę), synchronizacja katalogów wyklucza wpisy powyżej maksymalnego progu. Do zsynchronizowanych lub pominiętych kontaktów nie jest stosowana żadna konkretna kolejność.

• Jeśli jeden z Twoich klientów przekroczy maksymalną dozwoloną liczbę kontaktów w którejkolwiek z kategorii, zalecamy zgłoszenie sprawy do firmy Cisco w celu wykluczenia tej organizacji z synchronizacji katalogów.

• Kontakty ręczne to kontakty, które użytkownik dodaje ręcznie w aplikacji Webex. Użytkownik może dodać do 500 kontaktów ręcznych. Kontakty ręczne należą do większej kategorii Kontakt użytkownika w Webex, ale nie są uwzględniane w synchronizacji.

• Ogólny łączny limit kontaktów organizacji (30000) i kontaktów grupowych (30000 na grupę) wynosi 200000.

Aktualizacje

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, Webex zaktualizuje istniejący kontakt w katalogu Webex o nowy numer.

Gdy administrator zaktualizuje kontakt w BroadWorks, następujące warunki określają, kiedy aktualizacja jest wyświetlana w aplikacji Webex użytkownika:

• Jeśli aktualizacja dotyczy użytkownika wywołującego tylko BroadWorks lub encji wywołującej niebędącej użytkownikiem, aktualizacja jest wyświetlana w aplikacji Webex użytkownika natychmiast po kolejnej synchronizacji katalogu.

• Jeśli aktualizacja dotyczy wpisu na liście telefonów BroadWorks:

  • W przypadku kontaktów użytkownika — aktualizacje są wyświetlane w aplikacji Webex użytkownika natychmiast po kolejnej synchronizacji katalogu.

  • W przypadku kontaktów grupowych — aktualizacje są wyświetlane w aplikacji Webex użytkowników natychmiast po późniejszej synchronizacji katalogu.

  • W przypadku kontaktów organizacji — katalog Webex jest aktualizowany podczas kolejnej synchronizacji katalogu, ale użytkownicy nie zobaczą zmiany w aplikacji Webex, dopóki nie uruchomią ponownie aplikacji Webex lub nie wygaśnie lokalny 72-godzinny czasomierz pamięci podręcznej.

Zalecamy korzystanie z następujących ustawień:

• Wartości ograniczające szybkość — 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 wartości 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 (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – ustaw wartość 50.

  • availableUserMaxLimit – ustaw wartość 100

• Interfejs CTI — upewnij się, że certyfikaty Webex CA zostały przesłane do magazynu zaufania interfejsu CTI i aby włączyć uwierzytelnianie klienta w 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:

• Dla R22: AP.as.22.0.1123.ap368517

• Dla R23: AP.as.23.0.1075.ap368517

• Dla R24: Łatka nie jest wymagana

Administratorzy partnerów 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. Aby uzyskać szczegółowe informacje, zobacz "Konfigurowanie szablonów klientów" w temacie Konfigurowanie organizacji partnerskiej w Partner Hub w Przewodniku po rozwiązaniach dla Webex dla Cisco BroadWorks.

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 developer.webex.com dostępne są publiczne interfejsy API, 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 BroadWorks Enterprises:

• Lista przedsiębiorstwBroadWorks — ta metoda interfejsu API służy do uzyskiwania listy przedsiębiorstw podlegających danemu dostawcy usług oraz id. Musisz wprowadzić plik spEnterpriseId zgodnie z przypisaną w aprowizacji.

• Aktualizuj synchronizację katalogów dla przedsiębiorstwaBroadWorks — wprowadź nazwę przedsiębiorstwa id Aby zaktualizować stan syc katalogu dla tego przedsiębiorstwa, włączając lub wyłączając synchronizację katalogów.

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

• Uzyskaj stan synchronizacji katalogów dla przedsiębiorstwa— wprowadź nazwę przedsiębiorstwa id i uruchom w celu uzyskania statusu i trackingId najnowszej synchronizacji. Możesz użyć przycisku trackingID, aby uruchomić dodatkowe analizy za pomocą narzędzi, takich jak Kibana i Grafana.

Ponadto administratorzy mogą użyć interfejsu API Wyzwalanie synchronizacji katalogów dla jednego użytkownika , aby wyzwolić synchronizację katalogów na żądanie dla pojedynczego użytkownika.

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

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

Poniższe kody błędów mają zastosowanie do Directory Sync.

Poniższa tabela zawiera podsumowanie aktualizacji tego artykułu.