W tym artykule opisano, jak wdrożyć usługę Directory Sync w aplikacji Webex dla Cisco BroadWorks. Artykuł jest przeznaczony dla administratorów usługodawców w organizacjach partnerskich.
Omówienie synchronizacji katalogów
Synchronizacja katalogów gwarantuje, że użytkownicy aplikacji Webex for Cisco BroadWorks mogą używać katalogu Webex z aplikacji Webex do nawiązywania połączeń z dowolnym podmiotem nawiązującym połączenie z serwera BroadWorks. Ta funkcja synchronizuje informacje o połączeniach BroadWorks, które nie były częścią obsługi administracyjnej użytkowników, z katalogiem Webex .
Obsługa administracyjna użytkowników Webex dla Cisco BroadWorks aktualizuje katalog Webex o szczegóły połączeń dla użytkowników Webex dla użytkowników Cisco BroadWorks (podstawowy numer telefonu, numer telefonu komórkowego, numer wewnętrzny), ale pomija rekordy połączeń zewnętrznych. 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 z usługi BroadWorks (którzy nie są dołączeni do usługi Webex)
Jednostki niebędące użytkownikami dzwoniącymi (np. telefon w sali konferencyjnej, faks, numer grupy wyszukiwania)
Wpisy na liście telefonów BroadWorks
Poniższa tabela podsumowuje rekordy połączeń BroadWorks i pokazuje, w jaki sposób są one dodawane do katalogu Webex .
Rejestr połączeń BroadWorks |
Opis |
Dodano do katalogu Webex przez... |
---|---|---|
Użytkownicy Webex dla Cisco BroadWorks |
Użytkownicy mogą korzystać z Webex dla Cisco BroadWorks |
Inicjowanie obsługi administracyjnej użytkowników (np. obsługa administracyjna przepływowa) |
Użytkownicy dzwoniący tylko z usługi BroadWorks |
Nawiązywanie połączeń z użytkownikami, którzy są nie włączono do Webex |
Synchronizacja katalogów |
Jednostki niebędące użytkownikami dzwoniącymi |
Np. telefon w sali konferencyjnej, faks, numer grupy Hunt |
Synchronizacja katalogów |
Listy telefonów BroadWorks |
Wpisy na liście telefonów BroadWorks:
|
Synchronizacja katalogów (synchronizacja listy telefonów) |
Aby uzyskać więcej informacji na temat inicjowania obsługi administracyjnej użytkowników, zobacz Przewodnik po rozwiązaniach Webex dla Cisco BroadWorks .
|
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 jej włączeniu (godzina rozpoczęcia synchronizacji jest wybierana losowo). Organizacje klientów mogą jednak korzystać Synchronizuj teraz możliwość pominięcia jednotygodniowego okresu oczekiwania i natychmiastowej synchronizacji dla danej organizacji klienta.
Domyślnie Directory Sync jest uruchamiana co tydzień dla każdego klienta. Każda synchronizacja następuje tydzień po ostatniej synchronizacji, niezależnie od tego, czy ostatnia synchronizacja została zaplanowana, czy uruchomiona ręcznie za pomocą Synchronizuj teraz .
Maksymalna liczba jednoczesnych synchronizacji na klaster BroadWorks wynosi dwa: jedna synchronizacja zaplanowana i jedna synchronizacja na żądanie (za pośrednictwem API lub interfejsu graficznego Partner Hub). Jednak administratorzy nie mogą jednocześnie uruchamiać dwóch synchronizacji na żądanie z tego samego urządzenia BroadWorks. To ograniczenie istnieje niezależnie od tego, czy synchronizacja została zainicjowana za pośrednictwem API , czy Synchronizuj teraz w Partner Hub. Ponadto Webex nie planuje, aby dwie zaplanowane synchronizacje były uruchamiane w tym samym czasie z tego samego BroadWorks.
Jeśli wystąpi awaria 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ż wyświetlacz 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 będący właścicielem kontaktu ma dostęp do klucza odszyfrowywania.
W przypadku użytkowników korzystających tylko z usługi BroadWorks i jednostek niebędących użytkownikami ta funkcja synchronizuje następujące typy numerów telefonów z usługi BroadWorks:
Podstawowy numer telefonu
Numer telefonu komórkowego
Numer wewnętrzny
Jednak synchronizacja wyklucza z synchronizacji użytkowników korzystających tylko z usług BroadWorks i jednostki niebędące użytkownikami, jeśli nie ma ani podstawowego numeru telefonu, ani numeru wewnętrznego.
Lista telefonów BroadWorks i maksymalne wartości 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 dla swojej organizacji. Maksymalna liczba kontaktów to 30000.
Kontakty użytkownika — Webex przechowuje te kontakty dla użytkownika. Tylko użytkownik będący właścicielem kontaktu może uzyskać dostęp do wpisu kontaktu. Maksymalna liczba to 2000 kontaktów (1500 zsynchronizowanych kontaktów + 500 kontaktów wprowadzanych ręcznie).
Do kontaktów Webex są dodawane tylko wpisy z listy telefonów. Użytkownicy korzystający tylko z usługi BroadWorks oraz podmioty nawiązujące połączenia niebędące użytkownikami, które są uwzględnione w synchronizacji katalogu, nie są dodawani do Kontaktów, chyba że użytkownik Webex doda ich do Kontaktów ręcznie.
|
Poniższa tabela mapuje typy kontaktów Webex ze źródłem kontaktu (zsynchronizowane z listy telefonów BroadWorks lub dodane ręcznie):
Typ kontaktu Webex |
Źródło kontaktu |
Maksymalnie |
Zsynchronizowano z BroadWorks... |
API używany do synchronizacji |
---|---|---|---|---|
Kontakty organizacji |
Synchronizacja katalogów |
30000 kontaktów |
Wspólne listy telefonów przedsiębiorstwa |
|
Wspólne listy telefonów dla grupy (dla grupy dostawców usług)** |
|
|||
Kontakty użytkownika |
Synchronizacja katalogów |
1500 kontaktów |
Listy telefonów osobistych |
/directories/personal |
Dodano ręcznie przez użytkownika |
500 kontaktów |
nd. |
nd. |
|
Kontakty grupowe |
Synchronizacja katalogów |
30000 kontaktów na grupę |
Wspólne listy telefonów dla grupy (dla grupy Enterprise)** |
/directories/groupcommon |
**Wpisy grupowych wspólnych list telefonicznych są synchronizowane w różny sposób w zależności od tego, czy BroadWorks jest w trybie Enterprise, czy w trybie dostawcy usług. Wartość
|
Sposób obsługi wartości maksymalnych kontaktów przez usługę Directory Sync podlega następującym warunkom:
Jeśli organizacja przekroczy maksymalną liczbę kontaktów dozwolonych dla synchronizacji (30 000 kontaktów w organizacji lub 30 000 wspólnych kontaktów grupy na grupę), synchronizacja katalogów wykluczy wpisy powyżej maksymalnego progu. Nie ma określonej kolejności zastosowanej do zsynchronizowanych lub pominiętych kontaktów.
Jeśli jeden z Twoich klientów przekroczy maksymalną dozwoloną liczbę kontaktów w dowolnej kategorii, zalecamy zgłoszenie do Cisco sprawy o wykluczenie 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 Kontakty użytkownika w aplikacji Webex, ale nie są uwzględniane w synchronizacji.
Całkowity łączny limit dla kontaktów organizacji (30000) i kontaktów grupy (30000 na grupę) wynosi 200000.
Aktualizacje
Poniżej opisano, jak katalog Webex obsługuje aktualizacje:
Jeśli nazwa kontaktu ulegnie zmianie w BroadWorks, istniejący kontakt zostanie usunięty z katalogu Webex i zostanie utworzony nowy kontakt.
Jeśli numer kontaktowy ulegnie zmianie w BroadWorks, Webex zaktualizuje istniejący kontakt w katalogu Webex o nowy numer.
Gdy administrator zaktualizuje kontakt w BroadWorks, następujące warunki są określane, kiedy aktualizacja jest wyświetlana w aplikacji Webex użytkownika:
Jeśli aktualizacja dotyczy tylko użytkownika nawiązującego połączenie z usługą BroadWorks lub podmiotu nawiązującego połączenie niebędącego użytkownikiem, aktualizacja zostanie wyświetlona w aplikacji Webex użytkownika natychmiast po kolejnej synchronizacji katalogu.
Jeśli aktualizacja dotyczy wpisu na liście telefonów BroadWorks:
Kontakty użytkowników — aktualizacje są wyświetlane w aplikacji Webex użytkownika natychmiast po późniejszej synchronizacji katalogu.
W przypadku kontaktów grupowych — aktualizacje są wyświetlane w aplikacji Webex App 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 ponownie nie uruchomią aplikacji Webex lub nie wygaśnie lokalny 72-godzinny licznik czasu pamięci podręcznej.
Aktualizacje informacji o użytkownikach Webex for Cisco BroadWorks są obsługiwane w ramach procesów udostępniania.
|
Control Hub zawiera opcję dodawania lub edytowania kontaktów na poziomie organizacji w Control Hub za pomocą pliku CSV . Administratorzy partnerów i administratorzy klientów z dostępem do Control Hub mogą uzyskać dostęp do tej opcji. Jednak aktualizacja kontaktów za pośrednictwem Control Hub nie jest obsługiwana przez Webex dla Cisco BroadWorks. Aktualizacje kontaktów zastosowane w Control Hub nie są synchronizowane z powrotem do BroadWorks i są niedostępne dla przeszukiwania katalogów z telefonów stacjonarnych.
|
Wymagania wstępne synchronizacji katalogów
Zalecamy użycie następujących ustawień:
W poniższych przykładach założono, że używasz serwera XSP. W przypadku serwerów ADP zastąp (XSP_ CLI) z (ADP_ interfejsu wiersza polecenia).
|
Wartości ograniczenia szybkości — ustaw następujące właściwości systemu OverloadControl (XSP_ Interfejs wiersza polecenia/Aplikacje/Akcje Xsi/Kontrola przeciążenia):
userDirectoryTransactionLimit — ustaw wartość pustą.
globalDirectoryTransactionLimit — ustaw wartość pustą.
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 co najmniej 100.
transactionLimitPeriodSecs — ustaw wartość 1.
Wartości przywoływania — ustaw właściwości systemu przywoływania (XSP_ Interfejs wiersza polecenia/aplikacje/działania Xsi/przywoływanie):
defaultPageSize — ustaw na 50
availableUserMaxLimit — ustaw na 100
Interfejs CTI — upewnij się, że certyfikaty Webex CA zostały przesłane do magazynu zaufanych certyfikatów 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: nie jest wymagana poprawka
Włącz synchronizację katalogów (nowy szablon)
Administratorzy partnerów mogą włączyć usługę Directory Sync 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 klienta” w Skonfiguruj swoją organizację partnerską w Partner Hub w obrębie Przewodnik po rozwiązaniach Webex dla Cisco BroadWorks .
Co robić Dalej
Upewnij się, że użytkownicy wiedzą, że muszą kliknąć przycisk Kontakty co najmniej raz w aplikacji Webex , aby włączyć tę funkcję w aplikacji Webex . Należy to zrobić tylko raz.
Włącz synchronizację katalogów (istniejący szablon)
1 | Zaloguj się do Partner Hub i wybierz Ustawienia . |
||
2 | Przewiń do Połączenia BroadWorks i kliknij Wyświetl szablony . |
||
3 | Wybierz odpowiedni szablon klienta i przewiń do Synchronizacja katalogów BroadWorks . |
||
4 | Aby domyślnie włączyć synchronizację katalogów dla nowych organizacji klientów korzystających z tego szablonu:
|
||
5 | Aby włączyć synchronizację katalogów dla istniejących organizacji klientów korzystających z tego szablonu:
|
Co zrobić dalej
Upewnij się, że użytkownicy wiedzą, że muszą kliknąć przycisk Kontakty co najmniej raz w aplikacji Webex , aby włączyć tę funkcję w aplikacji Webex . Należy to zrobić tylko raz.
Uruchom synchronizację natychmiastową
1 | Zaloguj się do Partner Hub (http://admin.webex.com ) i wybierz Ustawienia . |
2 | Przewiń do Połączenia BroadWorks i kliknij Wyświetl szablony . |
3 | Wybierz odpowiedni szablon klienta i przewiń do Synchronizacja katalogów BroadWorks . |
4 | Kliknij Pokaż listę stanu synchronizacji klientów . |
5 | W przypadku organizacji klienta, którą chcesz zsynchronizować, kliknij trzy kropki po prawej stronie i wybierz Synchronizuj teraz . |
6 | Kliknij Odśwież aby zobaczyć wyniki synchronizacji. |
Eksportuj zsynchronizowane rekordy do CSV
1 | Zaloguj się do Partner Hub (http://admin.webex.com ) i wybierz Ustawienia . |
2 | Przewiń do Połączenia BroadWorks i kliknij Wyświetl szablony . |
3 | Wybierz odpowiedni szablon klienta i przewiń do Synchronizacja katalogów BroadWorks . |
4 | Kliknij Pokaż listę stanu synchronizacji 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 dla usługi Directory Sync
Publiczne interfejsy API są dostępne na developer.webex.com które umożliwiają administratorom partnerów aktualizowanie ustawień Directory Sync dla organizacji klientów, którymi zarządzają, wyzwalanie natychmiastowej synchronizacji lub uzyskiwanie informacji o stanie synchronizacji. Metody synchronizacji katalogów są pogrupowane w obszarze BroadWorks Enterprises :
Wyświetlanie listy przedsiębiorstw BroadWorks — Użyj tej metody API , aby uzyskać listę przedsiębiorstw w ramach danego dostawcy usług i każdego przedsiębiorstwa
id
. Należy wprowadzić znakspEnterpriseId
zgodnie z przypisaną wartością podczas obsługi administracyjnej.Aktualizacja Directory Sync dla BroadWorks Enterprise —Wprowadź przedsiębiorstwo
id
aby zaktualizować stan synchronizowania katalogów dla tego przedsiębiorstwa, włączając lub wyłączając synchronizację katalogów.Uruchamianie synchronizacji katalogów w przedsiębiorstwie — Użyj tej metody API , jeśli chcesz wyzwolić natychmiastową synchronizację dla danego przedsiębiorstwa
id
. DlasyncStatus
, wprowadźSYNC_NOW
polecenie.Pobieranie stanu synchronizacji katalogów dla przedsiębiorstwa —Wprowadź przedsiębiorstwo
id
i uruchom, aby uzyskać status itrackingId
ostatniej synchronizacji. Możesz użyć przyciskutrackingID
do uruchamiania dodatkowych analiz za pomocą narzędzi, takich jak Kibana i Grafana.
Ponadto administratorzy mogą używać przycisku Uruchom synchronizację katalogów dla pojedynczego użytkownika API do wyzwalania synchronizacji katalogów na żądanie dla pojedynczego użytkownika.
Aby uzyskać szczegółową dokumentację API , zobaczhttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
Aby przeczytać specyfikację API , należy się zalogować pod adresemhttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Synchronizuj wiele przedsiębiorstw z API
|
1 | Uruchom Wyświetlanie listy przedsiębiorstw BroadWorks API do generowania listy przedsiębiorstw, które chcesz zsynchronizować.
|
2 | Uruchom Uruchamianie synchronizacji katalogów w przedsiębiorstwie API w pierwszym przedsiębiorstwie na liście. |
3 | Poczekaj kilka sekund, a następnie uruchom Pobieranie stanu synchronizacji katalogów API do uzyskiwania stanu synchronizacji.
|
4 | Po zakończeniu synchronizacji wykonaj kroki od 2 do 4 dla następnego przedsiębiorstwa na liście. Powtarzaj te kroki, aż zsynchronizujesz całą listę. |
Kody błędów synchronizacji katalogów
Następujące kody błędów dotyczą usługi Directory Sync.
Kod błędu |
Komunikat o błędzie |
---|---|
600000 |
Nieoczekiwany błąd synchronizacji katalogu użytkowników zewnętrznych środowiska BroadWorks. |
600001 |
Nie można zsynchronizować katalogu użytkowników zewnętrznych środowiska BroadWorks. |
600002 |
Synchronizacja katalogu użytkowników zewnętrznych środowiska Broadworks musiała zostać zakończona przed ukończeniem. |
600003 |
Synchronizacja katalogu użytkowników zewnętrznych środowiska Broadworks została wykonana tylko częściowo. Nie można zsynchronizować niektórych organizacji klientów. |
600004 |
Synchronizacja katalogu użytkowników zewnętrznych środowiska BroadWorks nie jest włączona dla parametru ConfigSet. |
600005 |
Trwa synchronizacja katalogu użytkowników zewnętrznych środowiska BroadWorks dla parametru ConfigSet. |
600006 |
Wątki synchronizacji katalogu użytkowników zewnętrznych środowiska BroadWorks są zajęte lub zamykane, dlatego nie przyjmą więcej żądań synchronizacji. Spróbuj ponownie później. |
600007 |
Nie znaleziono organizacji tożsamości dla parametru CustomerConfig. |
600008 |
Parametru CustomerConfig nie znaleziono w organizacji partnera. |
600009 |
Nie można uruchomić synchronizacji użytkowników katalogu zewnętrznego Broadworks, ponieważ klaster Broadworks powiązany z CustomerConfig jest zajęty |
600010 |
Nie można uruchomić synchronizacji katalogu użytkowników zewnętrznych środowiska BroadWorks, ponieważ nie ma klastrów BroadWorks powiązanych z parametrem CustomerConfig. |
600011 |
Synchronizacja katalogu użytkowników zewnętrznych środowiska BroadWorks nie jest włączona dla parametru CustomerConfig. |
600012 |
Nie można uruchomić synchronizacji katalogu użytkowników zewnętrznych środowiska BroadWorks, ponieważ synchronizacja katalogu hybrydowego jest już włączona dla parametru CustomerConfig. |
600013 |
Synchronizacja katalogu użytkowników zewnętrznych środowiska BroadWorks nie może dodać użytkowników i kont maszynowych do magazynu tożsamości. |
600014 |
W trakcie synchronizacji katalogu użytkowników zewnętrznych środowiska BroadWorks wystąpił błąd podczas próby nawiązania połączenia z klastrem BroadWorks. Błąd usługi Broadworks — %s. |
600015 |
Podczas synchronizacji katalogu użytkowników zewnętrznych środowiska BroadWorks w magazynie tożsamości nie znaleziono żadnego pasującego użytkownika. |
600017 |
Podczas synchronizacji listy telefonów BroadWorks nie udało się zsynchronizować wszystkich kontaktów użytkowników i przedsiębiorstwa/organizacji. |
600018 |
Synchronizacja listy telefonów BroadWorks nie powiodła się dla użytkowników w przedsiębiorstwie/organizacji. |
600019 |
Synchronizacja listy telefonów BroadWorks nie powiodła się podczas synchronizacji kontaktów przedsiębiorstwa/organizacji. |
600020 |
Nie można wyłączyć synchronizacji użytkowników katalogu zewnętrznego BroadWorks, ponieważ trwa synchronizacja CustomerConfig. |
600022 |
Synchronizacja pojedynczego użytkownika katalogu zewnętrznego BroadWorks nie jest możliwa, ponieważ przedsiębiorstwo nie ma przypisanego użytkownika. |
600023 |
Synchronizacja pojedynczego użytkownika katalogu zewnętrznego BroadWorks nie jest możliwa, ponieważ użytkownik już istnieje w tej organizacji. |
600024 |
Synchronizacja pojedynczego użytkownika katalogu zewnętrznego BroadWorks nie jest możliwa, ponieważ w BroadWorks nie znaleziono pasującego użytkownika. |
600025 |
Synchronizacja użytkowników katalogu zewnętrznego BroadWorks nie powiodła się podczas aktualizacji konta użytkownika w CI. |
600026 |
Synchronizacja użytkowników katalogu zewnętrznego BroadWorks nie powiodła się podczas aktualizacji konta komputera w CI. |
600027 |
Synchronizacja pojedynczego użytkownika katalogu zewnętrznego BroadWorks nie jest możliwa, ponieważ w BroadWorks znaleziono wielu użytkowników. |
600028 |
Synchronizacja pojedynczego użytkownika katalogu zewnętrznego BroadWorks nie jest możliwa, ponieważ co najmniej jedna synchronizacja katalogu korporacyjnego powinna zostać ukończona. |
600029 |
Synchronizacja użytkowników katalogu zewnętrznego BroadWorks nie powiodła się, ponieważ przedsiębiorstwo nie ma przypisanego użytkownika. |
Historia zmian
Poniższa tabela zawiera podsumowanie aktualizacji tego artykułu.
Data |
Wersja |
---|---|
14 lutego 2023 r. |
Zaktualizowano Wartości maksymalne i źródło synchronizacji katalogów sekcji. |
10 grudnia 2022 r. |
Zaktualizowano termin Zakończ natychmiastową synchronizację do Uruchom synchronizację katalogów |
19 lipca 2022 r. |
Wyjaśnienia i poprawki do informacji ogólnych:
|
09 maja 2022 r. |
|
07 kwietnia 2022 r. |
|
28 marca 2022 r. |
|
24 marca 2022 r. |
Dodano listę zsynchronizowanych typów numerów telefonów do Warunki synchronizacji katalogów . Synchronizacja obejmuje teraz numery telefonów komórkowych. |
16 marca 2022 r. |
|
17 grudnia 2021 r. |
|
16 grudnia 2021 r. |
|
08 grudnia 2021 r. |
|