- Начало
- /
- Статия
Синхронизиране на директории в Webex за Cisco BroadWorks
Тази статия описва как да разгърнете Directory Sync в Webex за Cisco BroadWorks. Статията е предназначена за администратори на доставчици на услуги в партньорски организации.
Общ преглед на синхронизиране
Синхронизирането на директории гарантира, че потребителите на Webex за Cisco BroadWorks могат да използват директорията Webex от приложението Webex, за да се обадят на всеки повикващ обект от сървъра BroadWorks. Тази функция синхронизира информацията за извикване на BroadWorks, която не е част от предоставянето на потребителя в директорията на Webex.
Webex за Cisco BroadWorks потребителското осигуряване актуализира директорията на Webex с данни за обаждания за Webex за потребители на Cisco BroadWorks (основен телефонен номер, мобилен телефонен номер, разширение), но пропуска записи за външни повиквания. Въпреки това, когато синхронизирането на директориите е включено, функцията също синхронизира следните записи за повикване в директорията Webex.
-
Потребители, които се обаждат само за Broadworks (които не са включени в Webex)
-
Субекти, които не се обаждат от потребители (например телефон в конферентната зала, факс машина, номер на група за лов)
-
Записи в телефонния списък на BroadWorks
Следващата таблица обобщава записите за повикване на BroadWorks и показва как те се добавят към директорията Webex.
|
Записи за обаждания на BroadWorks |
Описание |
Добавено към директорията Webex чрез... |
|---|---|---|
|
Webex за потребители на Cisco BroadWorks |
Потребителите са активирани за Webex за Cisco BroadWorks |
Осигуряване на потребителя (напр. осигуряване на поток) |
|
Обаждащи се само на потребители на Broadworks |
Обаждане на потребители, които не са включ ени в Webex |
Синхронизация на директория |
|
Непотребителски повикващи субекти |
Например телефон за конферентна зала, факс машина, номер на групата Хънт |
Синхронизация на директория |
|
Телефонни списъци на BroadWorks |
Записи в телефонния списък на BroadWorks:
|
Синхронизиране на директории (синхронизиране на телефон |
Условия за синхронизиране
-
Администраторите на партньорите трябва да активират функцията на ниво партньор. Администраторите на партньори могат да включват или изключват функцията за множество клиентски организации в една операция.
-
По подразбиране първоначалното синхронизиране се извършва една седмица след активирането на синхронизирането (времето, избрано за стартиране на синхронизирането, е случайно). Клиентските организации обаче могат да използват опцията Sync Now, за да заобиколят едноседмичния период на изчакване и да задействат незабавна синхронизация за дадена клиентска организация.
-
По подразбиране синхронизирането на директории работи седмично за всеки клиент. Всяко синхронизиране се извършва една седмица след последното синхронизиране, независимо дали последната синхронизация е планирана или задействана ръчно с Sync Now.
-
Максималният брой едновременни синхронизиране на клъстер на BroadWorks е два: едно планирано синхронизиране и едно синхронизиране при поискване (чрез API или GUI на Partner Hub). Администраторите обаче не могат да изпълняват две синхронизации при поискване едновременно от един и същ BroadWorks. Това ограничение съществува независимо дали синхронизирането е инициирано чрез API или чрез опцията Sync Now в Partner Hub. Освен това Webex няма да планира две планирани синхронизации, които да се изпълняват едновременно от един и същ BroadWorks.
-
Ако възникне повреда на синхронизирането, Webex се опитва отново да синхронизира автоматично на всеки 24 часа до следващото планирано синхронизиране.
-
Синхронизирането игнорира потребителите, които нямат телефонен номер.
-
В Partner Hub можете да преглеждате информацията за състоянието на синхронизиране за даден клиент. Освен това можете да експортирате подробна информация за последното синхронизиране към CSV запис. CSV записът предоставя повече подробности от дисплея на контролния център и може да помогне при отстраняване на неизправности, анализи и одит.
-
Webex съхранява потребителски контакти в криптиран формат. Само потребителят, който притежава контакта, има достъп до ключа за декриптиране.
-
За обаждащи се само за потребители на Broadworks и лица, които не се обаждат потребители, тази функция синхронизира следните типове телефонни номера от BroadWorks:
-
Основен телефонен номер
-
Номер на мобилен телефон
-
Разширение
Синхронизирането обаче изключва от синхронизирането потребители, обаждащи се само за Broadworks и непотребителски повикващи обекти, ако няма нито основен телефонен номер или разширение.
Настройката на услугата за поверителност на ниво потребител на BroadWorks не се поддържа като част от синхронизирането на директории.
-
Телефонен списък на BroadWorks и максимуми за контакти
Синхронизирането на директории също синхронизира записите в списъка с телефони на BroadWorks с Webex Contacts. Синхронизираните записи се добавят към един от следните типове контакти:
-
Организационни контакти — Webex съхранява тези контакти срещу организация. Всеки потребител има достъп до организационните контакти за своята организация. Максимумът е до 30000 контакта.
-
Потребителски контакти — Webex съхранява тези контакти срещу потребител. Само потребителят, който притежава контакта, може да получи достъп до записа за контакт. Максимумът е до 2000 контакта (1500 синхронизирани контакта+500 контакта за ръчно въвеждане).
Следващата таблица картографира типовете контакти на Webex спрямо източника на контакти (синхронизиран от телефонен списък на BroadWorks или добавен ръчно):
|
Тип контакт Webex |
Източник за контакт |
Максимум |
Синхронизирано от BroadWorks... |
API, използван за синхронизиране |
|---|---|---|---|---|
|
Организационни контакти |
Синхронизация на директория |
30000 контакта |
Общи списъци с телефони на предприятията |
|
|
Групови общи телефонни списъци (за група доставчици на услуги) ** |
| |||
|
Потребителски контакти |
Синхронизация на директория |
1500 контакта |
Лични телефонни списъци | /директории/лични |
|
Добавено ръчно от потребителя |
500 контакта |
N/A |
N/A | |
|
Групови контакти |
Синхронизация на директория |
30000 контакта на група |
Групови общи телефонни списъци (за група от предприятия) ** | /директории/групообщи |
**Записите за общи телефонни списъци в групите се синхронизират по различен начин в зависимост от това дали BroadWorks е в режим на корпоративен или в режим на доставчик на услуги. Стойността на параметъра isBroadworksEnterprise (вярно или невярно) определя как списъкът се синхронизира:
-
True — Синхронизиране като групов контакт
-
Фалши—Синхронизиране като контакт на организацията
Следните условия се прилагат относно начина, по който Directory Sync обработва максималните контакти:
-
Ако дадена организация надвишава максимално разрешените контакти за синхронизиране (30000 контакта на организацията или 30000 общи контакта в групата), синхронизирането на директории изключва записи над максималния праг. Няма конкретен ред, приложен към синхронизирани или пропуснати контакти.
-
Ако някой от вашите клиенти надвишава максимално разрешения брой контакти в която и да е категория, препоръчваме ви да повдигнете дело пред Cisco, за да изключите тази организация от синхронизиране на директории.
-
Ръчните контакти са контакти, които потребителят добавя ръчно в приложението Webex. Потребителят може да добави до 500 ръчни контакта. Ръчните контакти попадат в по-голямата категория контакти с потребителя в Webex, но не са включени в синхронизацията.
-
Общият комбиниран лимит за контакти в организацията (30000) и групови контакти (30000 на група) е 200000.
Актуализации
Следва как директорията Webex обработва актуализациите:
-
Ако името на контакта се промени в BroadWorks, съществуващият контакт се изтрива от директорията Webex и се създава нов контакт.
-
Ако номерът за контакт се промени в BroadWorks, Webex актуализира съществуващия контакт в директорията Webex с новия номер.
След като администратор актуализира контакт в BroadWorks, следните условия очертават, когато актуализацията се показва в приложението Webex на потребителя:
-
Ако актуализацията е за повикващ потребител само за Broadworks или непотребителски повикващ обект, актуализацията се показва в Webex приложението на потребителя веднага след последващото синхронизиране на директорията.
-
Ако актуализацията е към запис в списъка с телефони на BroadWorks:
-
За потребителски контакти — актуализациите се показват в приложението Webex на потребителя веднага след последващото синхронизиране на директорията.
-
За групови контакти - Актуализациите се показват в приложението Webex на потребителите веднага след последващото синхронизиране на директорията.
-
За контакти с организацията — директорията Webex се актуализира при последващото синхронизиране на директорията, но потребителите няма да видят промяната в приложението Webex, докато не рестартират приложението Webex или докато не изтече локалният 72-часов кеш таймер.
-
Предпоставки за синхронизиране
Препоръчваме ви да използвате следните настройки:
-
Стойности за ограничаване на скоростта — Задайте следните свойства на системата за контрол на претоварването (XSP_CLI/Applications/XSI-Actions/OverloadControl):
-
UserDirectoryTransactionLimit — зададена на нулева стойност.
-
GlobalDirectoryTransactionLimit — зададена на нулева стойност.
Препоръчва се да зададете UserDirectoryTransactionLimit и GlobalDirectoryTransactionLimit на нулева стойност. Ако обаче решите да зададете стойности, всяка от тях трябва да бъде зададена на поне пет пъти стойността на TransactionLimitPeriodSeconds (която трябва да бъде 1). -
-
Ограничения на транзакциите — Задайте следните стойности (XSP_CLI/System/CommunicationUlity/DefaultSettings):
-
UserTransactionLimit — зададен на поне 100.
-
TransaktionLimitPeriodSecs — зададено на 1.
-
-
Стойности за пейджинг — Задаване на свойствата на системата за пейджинг (XSP_CLI/Приложения/XSI-действия/пейджинг):
-
Размер на страницата по подразбиране—зададено на 50
-
ДостъпноUserMaxLimit—зададено на 100
-
-
CTI интерфейс — Не забравяйте да качите тези Webex CA сертификати в магазина за доверие на CTI интерфейса и да активирате удостоверяването на клиента в CTI интерфейса.
Освен това, в зависимост от вашата версия на BroadWorks, препоръчваме да приложите следните системни корекции към внедряването на BroadWorks, преди да активирате тази функция:
-
За R24: не се изисква пластир
Активиране на синхронизиране на директории (Нов
Администраторите на партньорите могат да активират синхронизиране на директории за клиентски шаблон, докато създават новия шаблон Всяка нова клиентска организация, която е присвоена към този шаблон, ще има активирано синхронизиране на директории. За подробности вижте „Конфигуриране на вашите шаблони за внедряване“ в Конфигу риране на вашата партньорска организация в партньорския център в Ръ ководството за решения за Webex за Cisco BroadWorks.
Какво да правя по-нататък
Уверете се, че потребителите ви знаят, че трябва поне веднъж да щракнат върху раздела Контак ти в приложението Webex, за да включат функцията в приложението Webex. Това трябва да бъде завършено само веднъж.
Активиране на синхронизиране на директория (съществуващ
| 1 |
Влезте в партньорския център и изберете Клиенти. |
| 2 |
В ша блоните за внед ряване изберете Клиента. |
| 3 |
Кликнете върху Настройките на услугата, в секцията Предпочитания активирайте синхронизиране на директориите. |
| 4 |
За да активирате синхронизирането на директории по подразбиране за нови организации на клиенти, които използват този шаблон: |
| 5 |
За да активирате синхронизирането на директории за съществуващи клиентски организации, които използват този шаблон: Ако искате да деактивирате синхронизирането на директории, следвайте горната процедура и:
|
Какво да правя по-нататък
Уверете се, че потребителите ви знаят, че трябва поне веднъж да щракнат върху раздела Контак ти в приложението Webex, за да включат функцията в приложението Webex. Това трябва да бъде завършено само веднъж.
Задействане на незабавна синхро
| 1 |
Влезте в партньорския център (http://admin.webex.com) и изберете На стройки. |
| 2 |
Превъртете до BroadWorks Calling и щ ракнете върху Пре глед на шаблони. |
| 3 |
Изберете подходящия шаблон за клиент и превъртете до BroadWorks Directory Sync. |
| 4 |
Щракнете върху Показване на списъка със състоянието на синхронизи ране |
| 5 |
За организацията на клиенти, която искате да синхронизирате, щракнете върху трите точки вдясно и изберете Син хронизиране сега. |
| 6 |
Щракнете върху Об новяване, за да видите резултатите от синхронизирането. |
Експортиране на записи за синхронизация в CSV
| 1 |
Влезте в партньорския център (http://admin.webex.com) и изберете На стройки. |
| 2 |
Превъртете до BroadWorks Calling и щ ракнете върху Пре глед на шаблони. |
| 3 |
Изберете подходящия шаблон за клиент и превъртете до BroadWorks Directory Sync. |
| 4 |
Щракнете върху Показване на списъка със състоянието на синхронизи ране |
| 5 |
Поставете отметка в съседните квадратчета за всяка организация, която искате да включите в експорта. |
| 6 |
Щракнете върху Експортиране на резултати. |
Публични API за синхронизиране на директория
Публичните API са налични на developer.webex.com, които позволяват на администраторите на партньори да актуализират настройките за синхронизиране на директориите за организациите клиенти, които управляват, за да задействат незабавно синхронизиране или да получат информация за състоянието на синхронизиране. Методите за синхронизиране на директории са групирани в BroadWorks Enterprises:
-
Списък на предприятията на BroadWor
ks — Използвайте този метод на API, за да получите списък на предприятията под даден доставчик на услуги и идентификатора на всяко предприятие.Трябва да въведетеSPEnterpriseID, както е зададен в предоставянето. -
Актуализиране на синхронизирането на директории за BroadWorks Enterprise — Въведете
идентификатора на предприятието, за да актуализирате състоянието на syc на директория за това предприятие, като активирате или деактивирате синхронизирането на директории -
Задействане на синхронизиране на директории за предприя тие — Използвайте този метод на API, ако искате да задействате незабавна синхронизация за даден
идентификатор на предприятието. ЗаSyncStatus въведете командатаSYNC_NOW. -
Получаване на състоянието на синхронизиране на директорията за предприя тие — Въведете
идентификатора на предприятието и стартирайте, за да получите статус ипроследяване на най-новата синхронизация. Можете да използватеTrackingID, за да стартирате допълнителни анализи чрез инструменти като Kibana и Grafana.
Освен това администраторите могат да използват интерфейса за синхронизиране на директории за един потребител, за да задейст ват синхронизиране на директории при поискване за един потребител.
За подробна API документация вижте https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Трябва да влезете, за да прочетете спецификацията на API на адрес https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Синхронизиране на множество предприятия с API
-
Синхронизирането на директории ви позволява да синхронизирате само едно предприятие от клъстер на Broadworks наведнъж чрез синхронизация при поискване. Ако се опитате да синхронизирате повече от едно предприятие, ще получите грешка 429
-
Времето, необходимо за задействане на синхронизация за едно предприятие, варира в зависимост от размера на предприятието.
| 1 |
Стартирайте API List BroadWorks Enterprises, за да генерирате списък с предприятия, които искате да синхронизирате. |
| 2 |
Стартирайте Trigger Directory Sync за корпоративен API на първото предприятие в списъка. |
| 3 |
Изчакайте няколко секунди и след това стартирайте API за получаване на състоянието на синхронизиране на директорията, за да получите състоянието на синхронизиране. |
| 4 |
След като синхронизирането приключи, изпълнете стъпки от 2 до 4 в следващото предприятие в списъка. Повторете тези стъпки, докато синхронизирате целия списък. |
Кодове за грешки за синхронизиране на директория
Следните кодове за грешки се прилагат за синхронизиране на директории.
|
Код за грешка |
Съобщение за грешка |
|---|---|
|
600000 |
Неочаквана грешка при синхронизиране на потребителя за външна директория Broadworks. |
|
600001 |
Синхронизирането на потребителя с външна директория на Broadworks се провали |
|
600002 |
Потребителската синхронизация на външната директория на Broadworks трябваше да бъде прекратена преди завършване. |
|
600003 |
Синхронизирането на потребителя с външна директория на Broadworks само частично успя. Някои организации на клиенти не успяха да синхронизират. |
|
600004 |
Потребителското синхронизиране на външната директория на Broadworks не е активирано за ConfigSet. |
|
600005 |
Синхронизирането на потребителя с външна директория на Broadworks е в ход за ConfigSet. |
|
600006 |
Нишките за синхронизиране на потребителите на външна директория на Broadworks са заети или се изключват, следователно няма да приемат повече заявки за синхронизиране, опитайте отново по-късно. |
|
600007 |
Организацията за самоличност на CustomerConfig не е намерена. |
|
600008 |
CustomerConfig не се намира в организацията на партньорите. |
|
600009 |
Потребителското синхронизиране на външната директория на Broadworks не може да се изпълнява, тъй като широкообхватният клъстер, свързан с CustomerConfig, е зает |
|
600010 |
Потребителското синхронизиране на външната директория на Broadworks не може да се изпълнява, тъй като няма широкообхватен клъстер, свързан с CustomerConfig. |
|
600011 |
Синхронизирането на потребителя с външна директория на Broadworks не е активирано за CustomerConfig. |
|
600012 |
Потребителското синхронизиране на външната директория на Broadworks не може да се изпълнява, тъй като синхронизирането на хибридната директория вече е активирано за CustomerConfig. |
|
600013 |
Потребителската синхронизация на външната директория на Broadworks не успя да добави потребители и машинни акаунти към магазина за самоличност. |
|
600014 |
Потребителското синхронизиране на външната директория на Broadworks се провали, докато се опитвате да се свържете с клъстера Broadworks. Грешка от Broadworks - %s. |
|
600015 |
Потребителското синхронизиране на външната директория на Broadworks не намери съвпадащ потребител в магазина за самоличност. |
|
600017 |
Синхронизирането на телефонния списък на BroadWorks не успя да синхронизира всички контакти на потребители и предприя тие/организация. |
|
600018 |
Синхронизирането на телефонния списък на BroadWorks е неуспешно за потребители в предприятието/организа цията. |
|
600019 |
Синхронизирането на телефонния списък на BroadWorks не успя да синхронизира контактите от предприятие/организация |
|
600020 |
Синхронизирането на потребителя с външна директория на BroadWorks не може да бъде деактивирано, тъй като синхронизирането на CustomerConfig е в ход. |
|
600022 |
Синхронизирането на един потребител на външната директория на BroadWorks не е възможно, тъй като предприятието няма предоставен потребител. |
|
600023 |
Синхронизирането на един потребител на външната директория на BroadWorks не е възможно, тъй като потребителят вече съществува в тази организация. |
|
600024 |
Синхронизирането на един потребител за външна директория на BroadWorks не е възможно, тъй като в BroadWorks не е намерен съвпадащ потребител. |
|
600025 |
Потребителското синхронизиране на външната директория на BroadWorks не успя да актуализира потребителския акаунт в CI. |
|
600026 |
Потребителското синхронизиране на външната директория на BroadWorks не успя да актуализира акаунта на машината в CI. |
|
600027 |
Синхронизирането на един потребител за външна директория на BroadWorks не е възможно, тъй като в BroadWorks са намерени множество потребители. |
|
600028 |
Синхронизирането на външната директория на BroadWorks за един потребител не е възможно, тъй като е трябвало да е завършено поне едно синхронизиране на корпоративни директории. |
|
600029 |
Синхронизирането на потребителя с външна директория на BroadWorks се провали, тъй като предприятието няма предостав ен потребител. |
Промяна на историята
Следващата таблица обобщава актуализациите на тази статия.
|
Дата |
Ревизиране |
|---|---|
|
Февруари 14, 2023 |
Актуализи рана секция Максимум за синхронизиране на директория и източник |
|
Декември 10, 2022 |
Актуализиран термина Завършване на незабавна синхрони зация към синхронизация |
|
Юли 19, 2022 |
Пояснения и корекции на обзорната информация:
|
|
май 09, 2022 |
|
|
април 07, 2022 |
|
|
Март 28, 2022 |
|
|
Март 24, 2022 |
Добавен е списък на синхронизираните типове телефонни номера към условията за син хронизиране на директорията. Синхронизирането вече включва номера на мобилни телефони. |
|
Март 16, 2022 |
|
|
Декември 17, 2021 |
|
|
Декември 16, 2021 |
|
|
Декември 08, 2021 |
|