- Domov
- /
- Článok
Synchronizácia adresárov v službe Webex pre Cisco BroadWorks
Tento článok popisuje, ako nasadiť Directory Sync v Webex pre Cisco BroadWorks. Článok je určený pre administrátorov Service Provider v partnerských organizáciách.
Prehľad synchronizácie adresárov
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.
BroadWorks Call Records |
Opis |
Pridané do adresára Webex cez... |
---|---|---|
Webex pre používateľov Cisco BroadWorks |
Používatelia majú povolenú službu Webex pre Cisco BroadWorks |
Poskytovanie používateľov (napr. poskytovanie prostredníctvom toku) |
Používatelia, ktorí volajú iba cez BroadWorks |
Volanie používateľov, ktorí nie sú zaregistrovaní, do Webexu |
Synchronizácia adresára |
Entity, ktoré nevolajú používateľa |
Napr. telefón do konferenčnej miestnosti, fax, číslo skupiny Hunt |
Synchronizácia adresára |
Telefónne zoznamy BroadWorks |
Záznamy telefónneho zoznamu BroadWorks:
|
Synchronizácia adresára (synchronizácia telefónneho zoznamu) |
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):
Typ kontaktu Webex |
Kontaktný zdroj |
Maximálne |
Synchronizované z BroadWorks... |
API používané na synchronizáciu |
---|---|---|---|---|
Kontakty organizácie |
Synchronizácia adresára |
30 000 kontaktov |
Podnikové bežné telefónne zoznamy |
|
Skupinové spoločné telefónne zoznamy (pre skupinu poskytovateľov služieb)** |
| |||
Používateľské kontakty |
Synchronizácia adresára |
1500 kontaktov |
Osobné telefónne zoznamy | /adresáre/osobné |
Pridané ručne používateľom |
500 kontaktov |
N/A |
N/A | |
Skupinové kontakty |
Synchronizácia adresára |
30 000 kontaktov na skupinu |
Skupinové spoločné telefónne zoznamy (pre podnikovú skupinu)** | /directory/groupcommon |
**Položky skupinových bežných telefónnych zoznamov sa synchronizujú odlišne v závislosti od toho, či je BroadWorks v režime Enterprise alebo v režime poskytovateľa služieb. Hodnota parametra isBroadWorksEnterprise
(true alebo false) určuje, ako sa zoznam synchronizuje:
-
True—Synchronizovať ako skupinový kontakt
-
False – Synchronizovať ako kontakt organizácie
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.
-
Požiadavky na synchronizáciu adresára
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
Povoliť synchronizáciu adresára (nová šablóna)
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.
Povoliť synchronizáciu adresára (existujúca šablóna)
1 |
Prihláste sa do Partnerského centra a vyberte položku Nastavenia. |
2 |
Prejdite na položku BroadWorks Calling a kliknite na položku Zobraziť šablóny. |
3 |
Vyberte vhodnú šablónu zákazníka a prejdite na položku BroadWorks Directory Sync. |
4 |
Ak chcete predvolene povoliť synchronizáciu adresárov pre organizácie nových zákazníkov, ktoré používajú túto šablónu: |
5 |
Ak chcete povoliť synchronizáciu adresárov pre existujúce organizácie zákazníkov, ktoré používajú túto šablónu: Ak chcete zakázať synchronizáciu adresára, postupujte podľa vyššie uvedeného postupu a:
|
Č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.
Spustiť okamžitú synchronizáciu
1 |
Prihláste sa do Partnerského centra ( http://admin.webex.com) a vyberte položku Nastavenia. |
2 |
Prejdite na položku BroadWorks Calling a kliknite na položku Zobraziť šablóny. |
3 |
Vyberte vhodnú šablónu zákazníka a prejdite na položku BroadWorks Directory Sync. |
4 |
Kliknite na položku Zobraziť stav synchronizácie zoznamu zákazníkov. |
5 |
Pre organizáciu zákazníka, ktorú chcete synchronizovať, kliknite na tri bodky úplne vpravo a vyberte možnosť Synchronizovať teraz. |
6 |
Kliknutím na tlačidlo Obnoviť zobrazíte výsledky synchronizácie. |
Exportujte synchronizované záznamy do CSV
1 |
Prihláste sa do Partnerského centra ( http://admin.webex.com) a vyberte položku Nastavenia. |
2 |
Prejdite na položku BroadWorks Calling a kliknite na položku Zobraziť šablóny. |
3 |
Vyberte vhodnú šablónu zákazníka a prejdite na položku BroadWorks Directory Sync. |
4 |
Kliknite na položku Zobraziť stav synchronizácie zoznamu zákazníkov. |
5 |
Začiarknite priľahlé začiarkavacie políčka pre každú organizáciu, ktorú chcete zahrnúť do exportu. |
6 |
Kliknite na položku Exportovať výsledky. |
Verejné rozhrania API pre synchronizáciu adresárov
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
. PresyncStatus
zadajte príkazSYNC_NOW
. -
Získať stav synchronizácie adresára pre podnik – zadajte podnikové
id
a spustite, aby ste získali stav atrackingId
najnovšej synchronizácie. PomocoutrackingID
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ť.
Synchronizácia viacerých podnikov s API
-
Synchronizácia adresárov vám umožňuje synchronizovať naraz iba jeden podnik z klastra Broadworks prostredníctvom synchronizácie na požiadanie. Ak sa pokúsite synchronizovať viac ako jeden podnik, zobrazí sa chyba 429
-
Čas potrebný na spustenie synchronizácie pre jeden podnik sa líši v závislosti od veľkosti podniku.
1 |
Spustite rozhranie API List BroadWorks Enterprises a vygenerujte zoznam podnikov, ktoré chcete synchronizovať. |
2 |
Spustite rozhranie API Trigger Directory Sync for an Enterprise v prvom podniku v zozname. |
3 |
Počkajte niekoľko sekúnd a potom spustite rozhranie API Get Directory Sync Status , aby ste získali stav synchronizácie. |
4 |
Po dokončení synchronizácie vykonajte kroky 2 až 4 na ďalšom podniku v zozname. Opakujte tieto kroky, kým nezosynchronizujete celý zoznam. |
Kódy chýb pre synchronizáciu adresára
Nasledujúce chybové kódy sa vzťahujú na Directory Sync.
Kód chyby |
Chybové hlásenie |
---|---|
600000 |
Neočakávaná chyba synchronizácie používateľov externého adresára Broadworks. |
600001 |
Synchronizácia používateľa externého adresára Broadworks zlyhala. |
600002 |
Synchronizácia používateľov externého adresára Broadworks musela byť pred dokončením ukončená. |
600003 |
Synchronizácia používateľa s externým adresárom Broadworks bola úspešná len čiastočne. Niektoré zákaznícke organizácie sa nepodarilo synchronizovať. |
600004 |
Pre sadu ConfigSet nie je povolená synchronizácia používateľov externého adresára Broadworks. |
600005 |
Pre sadu ConfigSet práve prebieha synchronizácia používateľa s externým adresárom Broadworks. |
600006 |
Vlákna synchronizácie používateľov externého adresára Broadworks sú zaneprázdnené alebo sa vypínajú, preto nebudú prijímať ďalšie požiadavky na synchronizáciu, skúste to znova neskôr. |
600007 |
Identita Org CustomerConfig sa nenašla. |
600008 |
CustomerConfig sa nenachádza v partnerskej organizácii. |
600009 |
Broadworks External Directory User Sync nie je možné spustiť, pretože klaster broadworks priradený k CustomerConfig je zaneprázdnený |
600010 |
Broadworks External Directory User Sync nemožno spustiť, pretože k CustomerConfig nie je priradený žiadny klaster broadworks. |
600011 |
Synchronizácia používateľa s externým adresárom Broadworks nie je povolená pre CustomerConfig. |
600012 |
Synchronizáciu používateľa s externým adresárom Broadworks nemožno spustiť, pretože synchronizácia hybridného adresára je už povolená pre CustomerConfig. |
600013 |
Synchronizácia používateľov s externým adresárom Broadworks zlyhala pri pridávaní používateľov a účtov počítačov do úložiska identity. |
600014 |
Synchronizácia používateľa externého adresára Broadworks zlyhala pri pokuse o pripojenie ku klastru Broadworks. Chyba z Broadworks - %s. |
600015 |
Aplikácia Broadworks External Directory User Sync nenašla žiadneho zodpovedajúceho používateľa v úložisku identity. |
600017 |
Synchronizácia telefónneho zoznamu BroadWorks zlyhala pri synchronizácii všetkých kontaktov používateľov a podnikov/organizácií. |
600018 |
Synchronizácia telefónneho zoznamu BroadWorks zlyhala pre používateľov v podniku/organizácii. |
600019 |
Synchronizácia telefónneho zoznamu BroadWorks zlyhala pri synchronizácii kontaktov podniku/organizácie. |
600020 |
Synchronizáciu používateľa s externým adresárom BroadWorks nemožno zakázať, pretože prebieha synchronizácia CustomerConfig. |
600022 |
Synchronizácia jedného používateľa s externým adresárom BroadWorks nie je možná, pretože podnik nemá žiadneho zabezpečeného používateľa. |
600023 |
Synchronizácia jedného používateľa s externým adresárom BroadWorks nie je možná, pretože používateľ už v tejto organizácii existuje. |
600024 |
Synchronizácia externého adresára BroadWorks pre jedného používateľa nie je možná, pretože sa v BroadWorks nenašiel žiadny zodpovedajúci používateľ. |
600025 |
Synchronizácia používateľa s externým adresárom BroadWorks zlyhala pri aktualizácii používateľského účtu v CI. |
600026 |
Synchronizácia používateľa s externým adresárom BroadWorks zlyhala pri aktualizácii konta počítača v CI. |
600027 |
Synchronizácia jedného používateľa s externým adresárom BroadWorks nie je možná, pretože v BroadWorks sa našlo viacero používateľov. |
600028 |
Synchronizácia jedného používateľa s externým adresárom BroadWorks nie je možná, pretože mala byť dokončená aspoň jedna synchronizácia podnikového adresára. |
600029 |
Synchronizácia používateľov externého adresára BroadWorks zlyhala, pretože podnik nemá žiadneho zabezpečeného používateľa. |
História zmien
Nasledujúca tabuľka sumarizuje aktualizácie tohto článku.
Dátum |
Revízia |
---|---|
14. februára 2023 |
Aktualizovaná sekcia Maximálne hodnoty a zdroj synchronizácie adresára . |
10. decembra 2022 |
Termín Complete Immediate Sync bol aktualizovaný na Trigger Directory Sync |
19. júla 2022 |
Upresnenia a opravy prehľadových informácií:
|
9. mája 2022 |
|
7. apríla 2022 |
|
28. marca 2022 |
|
24. marca 2022 |
Do podmienok synchronizácie adresára bol pridaný zoznam typov synchronizovaných telefónnych čísel. Synchronizácia teraz zahŕňa mobilné telefónne čísla. |
16. marca 2022 |
|
17. decembra 2021 |
|
16. decembra 2021 |
|
8. decembra 2021 |
|