Synchronizácia adresára zaisťuje, že používatelia Webex for Cisco BroadWorks môžu používať adresár Webex z aplikácie Webex na volanie akejkoľvek volajúcej entity zo servera BroadWorks. Táto funkcia synchronizuje informácie o volaniach BroadWorks, ktoré neboli súčasťou používateľského poskytovania, do adresára Webex.

Webex pre používateľov Cisco BroadWorks aktualizuje adresár Webex s podrobnosťami o volaniach pre používateľov Webex pre Cisco BroadWorks (primárne telefónne číslo, číslo mobilného telefónu, klapka), ale vynecháva záznamy o externých hovoroch. Keď je však synchronizácia adresára zapnutá, funkcia synchronizuje aj nasledujúce záznamy volaní do adresára Webex.

• Používatelia volajúci iba cez BroadWorks (ktorí nie sú zaregistrovaní na Webex)

• Subjekty, ktoré nevolajú používateľov (napr. telefón v konferenčnej miestnosti, fax, číslo loveckej skupiny)

• Položky telefónneho zoznamu BroadWorks

Nasledujúca tabuľka sumarizuje záznamy volaní BroadWorks a ukazuje, ako sa pridávajú do adresára Webex.

Podmienky synchronizácie adresára

• Správcovia partnerov musia túto funkciu povoliť na úrovni partnera. Správcovia partnerov môžu túto funkciu zapnúť alebo vypnúť pre viacero zákazníckych organizácií v rámci jednej operácie.

• V predvolenom nastavení sa počiatočná synchronizácia uskutoční jeden týždeň po povolení synchronizácie (čas vybraný na spustenie synchronizácie je náhodný). Organizácie zákazníkov však môžu použiť možnosť Synchronizovať teraz na obídenie týždňovej čakacej lehoty a spustenie okamžitej synchronizácie pre danú organizáciu zákazníka.

• V predvolenom nastavení sa synchronizácia adresárov spúšťa týždenne pre každého zákazníka. Každá synchronizácia sa uskutoční jeden týždeň po poslednej synchronizácii bez ohľadu na to, či bola posledná synchronizácia naplánovaná alebo spustená manuálne pomocou funkcie Synchronizovať teraz.

• Maximálny počet simultánnych synchronizácií na klaster BroadWorks sú dva: jedna plánovaná synchronizácia a jedna synchronizácia na požiadanie (cez rozhranie API alebo GUI partnerského centra). Správcovia však nemôžu súčasne spustiť dve synchronizácie na požiadanie z rovnakého BroadWorks. Toto obmedzenie platí bez ohľadu na to, či bola synchronizácia spustená prostredníctvom rozhrania API alebo prostredníctvom možnosti Synchronizovať teraz v Partnerskom centre. Okrem toho Webex nenaplánuje spustenie dvoch plánovaných synchronizácií v rovnakom čase z rovnakého BroadWorks.

• Ak dôjde k zlyhaniu synchronizácie, Webex sa automaticky pokúsi o synchronizáciu každých 24 hodín až do ďalšej naplánovanej synchronizácie.

• Synchronizácia ignoruje používateľov, ktorí nemajú telefónne číslo.

• V Partner Hub si môžete zobraziť informácie o stave synchronizácie pre daného zákazníka. Okrem toho môžete exportovať podrobné informácie o poslednej synchronizácii do záznamu CSV. Záznam CSV poskytuje viac podrobností ako zobrazenie Control Hub a môže pomôcť pri riešení problémov, analýze a auditovaní.

• Webex ukladá používateľské kontakty v šifrovanom formáte. Prístup k dešifrovaciemu kľúču má iba používateľ, ktorý kontakt vlastní.

• Pre používateľov, ktorí volajú iba BroadWorks, a entity volajúcich používateľov, ktorí nie sú používateľmi, táto funkcia synchronizuje nasledujúce typy telefónnych čísel z BroadWorks:

  • Primárne telefónne číslo

  • Číslo mobilného telefónu

  • Rozšírenie

  Synchronizácia však zo synchronizácie vylúči iba volajúcich používateľov BroadWorks a entity, ktoré nevolajú používateľa, ak nie je prítomné ani primárne telefónne číslo ani klapka.

  Nastavenie služby ochrany osobných údajov na úrovni používateľa BroadWorks nie je podporované ako súčasť synchronizácie adresára.

BroadWorks Phone List a maximum kontaktov

Synchronizácia adresára tiež synchronizuje položky telefónneho zoznamu BroadWorks s kontaktmi Webex. Synchronizované záznamy sa pridajú k jednému z nasledujúcich typov kontaktov:

• Kontakty organizácie – Webex ukladá tieto kontakty proti organizácii. Každý používateľ má prístup ku kontaktom organizácie pre svoju organizáciu. Maximum je až 30 000 kontaktov.

• Kontakty používateľa – Webex ukladá tieto kontakty voči používateľovi. Prístup k záznamu kontaktu má iba používateľ, ktorý kontakt vlastní. Maximum je až 2 000 kontaktov (1 500 synchronizovaných kontaktov + 500 kontaktov manuálneho zadávania).

Nasledujúca tabuľka mapuje typy kontaktov Webex so zdrojom kontaktov (synchronizované z telefónneho zoznamu BroadWorks alebo pridané manuálne):

Nasledujúce podmienky sa vzťahujú na to, ako Directory Sync spracováva maximá kontaktov:

• Ak organizácia prekročí maximálny povolený počet kontaktov pre synchronizáciu (30 000 kontaktov organizácie alebo 30 000 spoločných kontaktov skupiny na skupinu), synchronizácia adresára vylúči položky presahujúce maximálny limit. Na synchronizované alebo vynechané kontakty sa nevzťahuje žiadne konkrétne poradie.

• Ak jeden z vašich zákazníkov prekročí maximálny povolený počet kontaktov v niektorej kategórii, odporúčame, aby ste sa obrátili na spoločnosť Cisco, aby bola táto organizácia vylúčená zo synchronizácie adresárov.

• Manuálne kontakty sú kontakty, ktoré používateľ pridáva manuálne do aplikácie Webex. Používateľ môže pridať až 500 manuálnych kontaktov. Manuálne kontakty spadajú do väčšej kategórie kontaktov používateľa na Webexe, ale nie sú zahrnuté v synchronizácii.

• Celkový kombinovaný limit pre organizačné kontakty (30 000) a skupinové kontakty (30 000 na skupinu) je 200 000.

Aktualizácie

Nižšie uvádzame, ako adresár Webex spracováva aktualizácie:

• Ak sa meno kontaktu zmení na BroadWorks, existujúci kontakt sa odstráni z adresára Webex a vytvorí sa nový kontakt.

• Ak sa kontaktné číslo v BroadWorks zmení, Webex aktualizuje existujúci kontakt v adresári Webex novým číslom.

Keď správca aktualizuje kontakt na BroadWorks, keď sa aktualizácia zobrazí v aplikácii Webex používateľa, načrtnú nasledujúce podmienky:

• Ak je aktualizácia určená iba volajúcemu používateľovi BroadWorks alebo entite, ktorá nevolá používateľa, aktualizácia sa zobrazí v aplikácii Webex používateľa ihneď po nasledujúcej synchronizácii adresára.

• Ak sa aktualizácia týka položky telefónneho zoznamu BroadWorks:

  • Pre používateľské kontakty – aktualizácie sa zobrazia v aplikácii Webex používateľa ihneď po nasledujúcej synchronizácii adresára.

  • Pre skupinové kontakty - Aktualizácie sa zobrazia v používateľskej aplikácii Webex ihneď po následnej synchronizácii adresára.

  • Pre organizačné kontakty – Adresár Webex sa aktualizuje pri nasledujúcej synchronizácii adresára, ale používatelia neuvidia zmenu v aplikácii Webex, kým nereštartujú aplikáciu Webex alebo kým nevyprší miestny 72-hodinový časovač vyrovnávacej pamäte.

Odporúčame vám použiť nasledujúce nastavenia:

• Obmedzujúce hodnoty rýchlosti – nastavte nasledujúce vlastnosti systému OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):

  • userDirectoryTransactionLimit – nastavte na nulovú hodnotu.

  • globalDirectoryTransactionLimit – nastavte na nulovú hodnotu.

  Odporúča sa nastaviť userDirectoryTransactionLimit a globalDirectoryTransactionLimit na nulovú hodnotu. Ak sa však rozhodnete priradiť hodnoty, každá musí byť nastavená na aspoň päťnásobok hodnotytransakcieLimitPeriodSeconds (čo by malo byť 1).

• Limity transakcií – nastavte nasledujúce hodnoty (XSP_CLI/System/CommunicationUtility/DefaultSettings):

  • userTransactionLimit – nastavte aspoň na 100.

  • transakcieLimitPeriodSecs – nastavte na 1.

• Hodnoty stránkovania – nastavte vlastnosti systému stránkovania (XSP_CLI/Applications/Xsi-Actions/Paging):

  • defaultPageSize – nastavte na 50

  • availableUserMaxLimit – nastavte na 100

• Rozhranie CTI – nezabudnite nahrať tieto certifikáty CA Webex do úložiska dôveryhodnosti rozhrania CTI a povoliť autentifikáciu klienta v rozhraní CTI.

Okrem toho v závislosti od vášho vydania BroadWorks odporúčame, aby ste pred povolením tejto funkcie použili nasledujúce systémové opravy na nasadenie BroadWorks:

• Pre R22: AP.as.22.0.1123.ap368517

• Pre R23: AP.as.23.0.1075.ap368517

• Pre R24: nie je potrebná žiadna záplata

Správcovia partnerov môžu pri vytváraní novej šablóny povoliť synchronizáciu adresára pre šablónu zákazníka. Všetky nové organizácie zákazníkov, ktoré budú priradené k tejto šablóne, budú mať povolenú synchronizáciu adresárov. Podrobnosti nájdete v časti „Konfigurácia zákazníckych šablón“ v časti Konfigurácia partnerskej organizácie v partnerskom centre v rámci Solution Guide for Webex for Cisco BroadWorks.

Čo robiť ďalej

Uistite sa, že vaši používatelia vedia, že na zapnutie funkcie v aplikácii Webex musia aspoň raz kliknúť na kartu Kontakty v aplikácii Webex. Toto je potrebné dokončiť iba raz.

Verejné rozhrania API sú k dispozícii na stránke developer.webex.com , ktoré umožňujú správcom partnerov aktualizovať nastavenia synchronizácie adresárov pre organizácie zákazníkov, ktoré spravujú, spustiť okamžitú synchronizáciu alebo získať informácie o stave synchronizácie. Metódy synchronizácie adresárov sú zoskupené pod BroadWorks Enterprises:

• Uveďte zoznam podnikov BroadWorks – použite túto metódu rozhrania API na získanie zoznamu podnikov pod daným poskytovateľom služieb a id každého podniku. Musíte zadať spEnterpriseId pridelené pri poskytovaní.

• Aktualizovať synchronizáciu adresára pre BroadWorks Enterprise – zadajte podnikové id a aktualizujte stav synchronizácie adresára pre daný podnik, čím povolíte alebo zakážete synchronizáciu adresára.

• Spustiť synchronizáciu adresára pre podnik – túto metódu rozhrania API použite, ak chcete spustiť okamžitú synchronizáciu pre dané podnikové id. Pre syncStatus zadajte príkaz SYNC_NOW .

• Získať stav synchronizácie adresára pre podnik – zadajte podnikové id a spustite, aby ste získali stav a trackingId najnovšej synchronizácie. Pomocou trackingID môžete spustiť ďalšie analýzy prostredníctvom nástrojov, ako sú Kibana a Grafana.

Okrem toho môžu správcovia použiť rozhranie Trigger Directory Sync for a Single User API na spustenie synchronizácie adresára na požiadanie pre jedného používateľa.

Podrobnú dokumentáciu rozhrania API nájdete v časti https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.

Ak si chcete prečítať špecifikáciu API na stránke https://developer.webex.com/docs/api/v1/broadworks-subscribers, musíte sa prihlásiť.

Nasledujúce chybové kódy sa vzťahujú na Directory Sync.

Nasledujúca tabuľka sumarizuje aktualizácie tohto článku.