- Pagină de pornire
- /
- Articol
Sincronizarea directorului în Webex pentru Cisco BroadWorks
Acest articol descrie modul de implementare a Directory Sync în Webex pentru Cisco BroadWorks. Articolul este destinat administratorilor furnizorilor de servicii din organizațiile partenere.
Sincronizare Directory Prezentare generală
Sincronizarea directorului asigură faptul că utilizatorii Webex pentru Cisco BroadWorks pot utiliza directorul Webex din aplicația Webex pentru a apela orice entitate apelantă de pe serverul BroadWorks. Această caracteristică sincronizează informațiile de apelare BroadWorks care nu au făcut parte din furnizarea de utilizatori în directorul Webex.
Furnizarea utilizatorilor Webex pentru Cisco BroadWorks actualizează directorul Webex cu detalii de apelare pentru utilizatorii Webex pentru Cisco BroadWorks (număr de telefon principal, număr de telefon mobil, extensie), dar omite înregistrările de apeluri externe. Cu toate acestea, când sincronizarea directorului este activată, caracteristica sincronizează, de asemenea, următoarele înregistrări de apeluri în directorul Webex.
-
Utilizatorii care apelează numai la Broadworks (care nu sunt conectați la Webex)
-
Entități de apel non-utilizator (de exemplu, un telefon din sala de conferințe, un aparat de fax, un număr de grup de vânătoare)
-
Intrări din lista de telefon BroadWorks
Următorul tabel rezumă înregistrările de apeluri BroadWorks și arată modul în care acestea sunt adăugate în directorul Webex.
|
Înregistrări de apeluri BroadWorks |
Descriere |
Adăugat la Directorul Webex prin... |
|---|---|---|
|
Webex pentru utilizatorii Cisco BroadWorks |
Utilizatorii sunt activați pentru Webex pentru Cisco BroadWorks |
Aprovizionarea utilizatorilor (de exemplu, furnizarea fluxthrough) |
|
Utilizatorii care apelează numai la Broadworks |
Apelarea utilizatorilor care nu sunt conectați la Webex |
Sincronizarea directorului |
|
Entități care apelează non-utilizator |
De exemplu, un telefon din sala de conferințe, un aparat de fax, un număr de grup Hunt |
Sincronizarea directorului |
|
Liste de telefoane BroadWorks |
Intrări din lista de telefon BroadWorks:
|
Sincronizare director (sincronizare listă de telefon) |
Condiții de sincronizare a directorului
-
Administratorii partenerilor trebuie să activeze caracteristica la nivel de partener. Administratorii parteneri pot activa sau dezactiva caracteristica pentru mai multe organizații client într-o singură operațiune.
-
În mod implicit, sincronizarea inițială are loc la o săptămână după activarea sincronizării (timpul ales pentru a începe sincronizarea este aleatoriu). Cu toate acestea, organizațiile client pot utiliza opțiunea Sinc ronizați acum pentru a ocoli perioada de așteptare de o săptămână și pentru a declanșa o sincronizare imediată pentru o anumită organizație client.
-
În mod implicit, sincronizarea directorului rulează săptămânal pentru fiecare client. Fiecare sincronizare are loc la o săptămână după ultima sincronizare, indiferent dacă ultima sincronizare a fost programată sau declanșată manual cu Sinc ronizare acum.
-
Numărul maxim de sincronizări simultane pe cluster BroadWorks este de două: o sincronizare programată și una sincronizare la cerere (prin API sau GUI Partner Hub). Cu toate acestea, administratorii nu pot rula două sincronizări la cerere în același timp din același BroadWorks. Această restricție există indiferent dacă sincronizarea a fost inițiată prin API sau prin opțiunea Sync Now din Partner Hub. În plus, Webex nu va programa două sincronizări programate pentru a rula în același timp de la același BroadWorks.
-
Dacă apare o eroare de sincronizare, Webex reîncearcă sincronizarea automat la fiecare 24 de ore până la următoarea sincronizare programată.
-
Sincronizarea ignoră utilizatorii care nu au un număr de telefon.
-
În Centrul pentru parteneri, puteți vizualiza informațiile despre starea sincronizării pentru un anumit client. În plus, puteți exporta informații detaliate despre ultima sincronizare într-o înregistrare CSV. Înregistrarea CSV oferă mai multe detalii decât afișajul Control Hub și poate ajuta la depanare, analiză și audit.
-
Webex stochează contactele utilizatorilor într-un format criptat. Numai utilizatorul care deține contactul are acces la cheia de decriptare.
-
Pentru utilizatorii care apelează numai Broadworks și entitățile de apelare care nu sunt utilizatori, această caracteristică sincronizează următoarele tipuri de numere de telefon de la BroadWorks:
-
Numărul principal de telefon
-
Număr de telefon mobil
-
Extensie
Cu toate acestea, sincronizarea exclude utilizatorii care apelează numai Broadworks și entitățile care apelează non-utilizator de la sincronizare dacă nu există nici un număr de telefon principal sau o extensie.
Setarea serviciului de confidențialitate la nivel de utilizator BroadWorks nu este acceptată ca parte a sincronizării directorului.
-
Lista telefonică BroadWorks și maximele de contact
Sincronizarea directorului sincronizează, de asemenea, intrările din lista de telefon BroadWorks cu persoanele de contact Webex. Intrările sincronizate sunt adăugate la unul dintre următoarele tipuri de contacte:
-
Persoane de contact ale organizației—Webex stochează aceste contacte împotriva unei organizații. Fiecare utilizator poate accesa contactele organizației pentru organizația sa. Maximul este de până la 30000 de contacte.
-
Contacte utilizator — Webex stochează aceste contacte împotriva unui utilizator. Numai utilizatorul care deține contactul poate accesa intrarea de contact. Maximul este de până la 2000 de contacte (1500 de contacte sincronizate + 500 de contacte de intrare manuală).
Următorul tabel mapează tipurile de contacte Webex cu sursa de contact (sincronizată dintr-o listă de telefon BroadWorks sau adăugată manual):
|
Tipul de contact Webex |
Sursa de contact |
Maximum |
Sincronizat de la BroadWorks... |
API utilizat pentru sincronizare |
|---|---|---|---|---|
|
Contacte organizaționale |
Sincronizarea directorului |
30000 contacte |
Liste de telefonie comune pentru întreprinderi |
|
|
Liste telefonice comune de grup (pentru un grup de furnizori de servicii) ** |
| |||
|
Contacte utilizator |
Sincronizarea directorului |
1500 contacte |
Liste de telefon personale | /directoare/personal |
|
Adăugat manual de către utilizator |
500 de contacte |
N/A |
N/A | |
|
Contacte de grup |
Sincronizarea directorului |
30000 de contacte pe grup |
Liste telefonice comune de grup (pentru un grup de întreprindere) ** | /directoare/groupcommon |
**Intrările Listelor de telefon comune de grup se sincronizează diferit, în funcție de faptul dacă BroadWorks se află în modul Enterprise sau în modul Furnizor de servicii. Valoarea parametrului isBroadworksEnterprise (adevărat sau fals) determină modul în care lista se sincronizează:
-
Adevărat — Sincronizare ca persoană de contact de grup
-
Fals — Sincronizați ca persoană de contact a organizației
Următoarele condiții se aplică în legătură cu modul în care Directory Sync gestionează maximele de contacte:
-
Dacă o organizație depășește numărul maxim de contacte permise pentru sincronizare (30000 persoane de contact ale organizației sau 30000 de contacte comune de grup per grup), sincronizarea directorului exclude intrările peste pragul maxim. Nu există nicio ordine specifică aplicată contactelor sincronizate sau omise.
-
Dacă unul dintre clienții dvs. depășește numărul maxim permis de contacte din oricare dintre categorii, vă recomandăm să ridicați un caz la Cisco pentru ca respectiva organizație să fie exclusă de la sincronizarea directorului.
-
Contactele manuale sunt contacte pe care un utilizator le adaugă manual în aplicația Webex. Un utilizator poate adăuga până la 500 de contacte manuale. Contactele manuale se încadrează în categoria mai mare de contacte utilizator de pe Webex, dar nu sunt incluse în sincronizare.
-
Limita totală combinată pentru contactele organizației (30000) și contactele de grup (30000 pe grup) este de 200000.
Actualizări
Următorul este modul în care directorul Webex gestionează actualizările:
-
Dacă numele contactului se schimbă pe BroadWorks, contactul existent este șters din directorul Webex și se creează un contact nou.
-
Dacă numărul de contact se modifică pe BroadWorks, Webex actualizează contactul existent în directorul Webex cu noul număr.
După ce un administrator actualizează un contact pe BroadWorks, următoarele condiții indică atunci când actualizarea se afișează în aplicația Webex a unui utilizator:
-
Dacă actualizarea se referă la un utilizator care apelează numai la Broadworks sau la o entitate apelantă non-utilizator, actualizarea se afișează în aplicația Webex a unui utilizator imediat după sincronizarea ulterioară a directorului.
-
Dacă actualizarea este la o intrare din lista de telefon BroadWorks:
-
Pentru contactele utilizatorului - Actualizările se afișează în aplicația Webex a utilizatorului imediat după sincronizarea ulterioară a directorului.
-
Pentru persoanele de contact de grup - Actualizările se afișează în aplicația Webex pentru utilizatori imediat după sincronizarea ulterioară a directorului.
-
Pentru persoanele de contact ale organizației—Directorul Webex este actualizat la sincronizarea ulterioară a directorului, dar utilizatorii nu vor vedea modificarea în aplicația Webex până când nu repornesc aplicația Webex sau până când expiră temporizatorul local de 72 de ore cache.
-
Cerințe preliminare de sincronizare
Vă recomandăm să utilizați următoarele setări:
-
Valori de limitare a ratei — Setați următoarele proprietăți ale sistemului OverloadControl (XSP_CLI/Applications/XSI-Actions/OverloadControl):
-
userDirectoryTransactionLimit—setat la o valoare nulă.
-
GlobalDirectoryTransactionLimit—setat la o valoare nulă.
Este recomandat să setați userDirectoryTransactionLimit și GlobalDirectoryTransactionLimit la o valoare nulă. Cu toate acestea, dacă decideți să atribuiți valori, fiecare trebuie să fie setată la cel puțin cinci ori valoarea TransactionLimitPeriodSeconds (care ar trebui să fie 1). -
-
Limite de tranzacție — Setați următoarele valori (XSP_CLI/System/CommunicationUtility/DefaultSettings):
-
userTransactionLimit—setat la cel puțin 100.
-
TransactionLimitPeriodSecs — setat la 1.
-
-
Valori de paginare — Setați proprietățile sistemului de paginare (XSP_CLI/Aplicații/Acțiuni XSI/Paginare):
-
DefaultPageSize — setat la 50
-
AvailableUserMaxLimit — setat la 100
-
-
Interfață CTI—Asigurați-vă că încărcați certificatele Webex CA în magazinul de încredere al interfeței CTI și activați autentificarea clientului pe interfața CTI.
În plus, în funcție de versiunea dvs. BroadWorks, vă recomandăm să aplicați următoarele corecții de sistem la implementarea BroadWorks înainte de a activa această caracteristică:
-
Pentru R24: nu este necesar un plasture
Activați sincronizarea directorului (șablon nou)
Administratorii parteneri pot activa Directory Sync pentru un șablon client în timp ce creează noul șablon. Orice organizaţii client noi care sunt atribuite acelui şablon vor avea activată sincronizarea directorului. Pentru detalii, consultați „Configurarea șabloanelor de integrare” din Configurarea organizației partenere în Centrul de parteneri din Ghi dul de soluții pentru Webex pentru Cisco BroadWorks.
Ce să faci în continuare
Asigurați-vă că utilizatorii dvs. știu că trebuie să facă clic pe fila Contac te din aplicația Webex cel puțin o dată pentru a activa caracteristica în aplicația Webex. Acest lucru trebuie completat o singură dată.
Activați sincronizarea directorului (șablon existent)
| 1 |
Conectați-vă la Partner Hub și alegeți Clienți. |
| 2 |
În Ș abloanele de integr are, selectați Clientul. |
| 3 |
Faceți clic pe Setările serviciului, în secțiunea P referințe activați sincronizarea directorului. |
| 4 |
Pentru a activa sincronizarea directorului în mod implicit pentru organizațiile noi ale clienților care utilizează acest șablon: |
| 5 |
Pentru a activa sincronizarea directorului pentru organizațiile client existente care utilizează acest șablon: Dacă doriți să dezactivați sincronizarea directorului, urmați procedura de mai sus și:
|
Ce să faci în continuare
Asigurați-vă că utilizatorii dvs. știu că trebuie să facă clic pe fila Contac te din aplicația Webex cel puțin o dată pentru a activa caracteristica în aplicația Webex. Acest lucru trebuie completat o singură dată.
Declanșați sincronizarea imediată
| 1 |
Conectați-vă la Partner Hub (http://admin.webex.com) și alegeți Setări. |
| 2 |
Derulați la BroadWorks Calling și faceți clic pe Vizualizare șabloane. |
| 3 |
Selectați șablonul corespunzător pentru client și derulați la BroadWorks Directory Sync. |
| 4 |
Faceți clic pe Afișați lista de stare de sincronizare a clienților. |
| 5 |
Pentru organizația de clienți pe care doriți să o sincronizați, faceți clic pe cele trei puncte din extrema dreaptă și selectați Sinc ronizați acum. |
| 6 |
Faceți clic pe Reîmprospă tare pentru a vedea rezultatele sincronizării. |
Exportați înregistrările de sincronizare în CSV
| 1 |
Conectați-vă la Partner Hub (http://admin.webex.com) și alegeți Setări. |
| 2 |
Derulați la BroadWorks Calling și faceți clic pe Vizualizare șabloane. |
| 3 |
Selectați șablonul corespunzător pentru client și derulați la BroadWorks Directory Sync. |
| 4 |
Faceți clic pe Afișați lista de stare de sincronizare a clienților. |
| 5 |
Bifați casetele de selectare adiacente pentru fiecare organizație pe care doriți să o includeți în export. |
| 6 |
Faceți clic pe Exportați rezultate. |
API-uri publice pentru sincronizarea directorului
API-urile publice sunt disponibile pe developer.webex.com, care permit administratorilor parteneri să actualizeze setările Directory Sync pentru organizațiile client pe care le gestionează, să declanșeze o sincronizare imediată sau să obțină informații despre starea sincronizării. Metodele de sincronizare a directorului sunt grupate în BroadWorks Enterprises:
-
Listați întreprinderile BroadWorks
- Utilizați această metodă API pentru a obține o listă de întreprinderi sub un anumit furnizor de servicii și ID-ul fiecărei întreprinderi.Trebuie să introducețiSPEnterpriseIDașa cum este atribuit în provizionare. -
Actualizați sincronizarea directorului pentru o întreprindere BroadWorks — Introduceți
ID-ul întreprinderii pentru a actualiza starea syc a directorului pentru acea întreprindere, activând sau dezactivând sincronizarea directorului. -
Activați sincronizarea directorului pentru o întreprindere — Utilizați această metodă API dacă doriți să declanșați o sincronizare imediată pentru un anumit
idde întreprindere. PentruSyncStatus, introduceți comandaSYNC_NOW. -
Obțineți starea sincronizării directoarelor pentru o întreprindere — Introduceți
ID-ul întreprinderii și rulați pentru a obține o stare și unID de urmărire a celei mai recentesincronizări. Puteți utilizaTrackingIDpentru a rula analize suplimentare prin instrumente precum Kibana și Grafana.
În plus, administratorii pot utiliza API-ul Trigger Directory Sync pentru un singur utilizator pentru a declanșa o sincronizare a directorului la cerere pentru un singur utilizator.
Pentru documentația API detaliată, consultați https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Trebuie să vă conectați pentru a citi specificația API la https://developer.webex.com/docs/api/v1/broadworks-subscribers.
Sincronizați mai multe întreprinderi cu API
-
Sincronizarea directoarelor vă permite să sincronizați o singură întreprindere dintr-un cluster Broadworks simultan printr-o sincronizare la cerere. Dacă încercați să sincronizați mai multe întreprinderi, veți primi o eroare 429
-
Timpul necesar pentru declanșarea unei sincronizări pentru o singură întreprindere variază în funcție de dimensiunea întreprinderii.
| 1 |
Rulați API-ul List BroadWorks Enterprises pentru a genera o listă de întreprinderi pe care doriți să le sincronizați. |
| 2 |
Rulați Trigger Directory Sync pentru o API Enterprise pe prima întreprindere din listă. |
| 3 |
Așteptați câteva secunde și apoi rulați API-ul Get Directory Sync Status API pentru a obține starea de sincronizare. |
| 4 |
După terminarea sincronizării, parcurgeți pașii 2 până la 4 pentru următoarea întreprindere din listă. Repetați acești pași până când ați sincronizat întreaga listă. |
Coduri de eroare pentru sincronizarea directorului
Următoarele coduri de eroare se aplică la Directory Sync.
|
Cod de eroare |
Mesaj de eroare |
|---|---|
|
600000 |
Eroare neașteptată de sincronizare utilizator a directorului extern Broadworks. |
|
600001 |
Sincronizarea utilizatorului directorului extern Broadworks a eșuat. |
|
600002 |
Sincronizarea utilizatorilor directorului extern Broadworks a trebuit să fie terminată înainte de finalizare. |
|
600003 |
Sincronizarea utilizatorilor directorului extern Broadworks a reușit doar parțial. Unele organizații clienți nu au reușit să se sincronizeze. |
|
600004 |
Sincronizarea utilizatorilor din directorul extern Broadworks nu este activată pentru ConfigSet. |
|
600005 |
Sincronizarea utilizatorilor directorului extern Broadworks este în curs de desfășurare pentru ConfigSet. |
|
600006 |
Firele de sincronizare a utilizatorilor din directorul extern Broadworks sunt ocupate sau se închid, prin urmare nu vor accepta mai multe solicitări de sincronizare, încercați din nou mai târziu. |
|
600007 |
Organismul de identitate al CustomerConfig nu a fost găsit. |
|
600008 |
CustomerConfig nu se găsește în organizația parteneră. |
|
600009 |
Sincronizarea utilizatorilor din directorul extern Broadworks nu poate fi executată deoarece clusterul broadworks asociat cu CustomerConfig este ocupat |
|
600010 |
Sincronizarea utilizatorilor din directorul extern Broadworks nu poate fi executată deoarece nu există niciun cluster broadworks asociat cu CustomerConfig. |
|
600011 |
Sincronizarea utilizatorilor din directorul extern Broadworks nu este activată pentru CustomerConfig. |
|
600012 |
Sincronizarea utilizatorilor din directorul extern Broadworks nu poate fi executată deoarece sincronizarea Directorului hibrid este deja activată pentru CustomerConfig. |
|
600013 |
Sincronizarea utilizatorilor din directorul extern Broadworks nu a reușit să adauge utilizatori și conturi de mașină la depozitul de identități. |
|
600014 |
Sincronizarea utilizatorilor directorului extern Broadworks a eșuat în timpul încercării de conectare la clusterul Broadworks. Eroare de la Broadworks - %s. |
|
600015 |
Broadworks External Directory User Sync nu a găsit niciun utilizator care să se potrivească în magazinul de identități. |
|
600017 |
BroadWorks Phone List Sync nu a reușit să sincronizeze toate persoanele de contact ale utilizatorilor și întreprinderi i/organizației. |
|
600018 |
Sincronizarea listei de telefon BroadWorks a eșuat pentru utilizatorii din întreprindere/organiz ație. |
|
600019 |
Sincronizarea listei de telefoane BroadWorks nu a reușit să sincronizeze contactele întreprinderii/organizației . |
|
600020 |
Sincronizarea utilizatorilor din directorul extern BroadWorks nu poate fi dezactivată deoarece sincronizarea CustomerConfig este în curs de desfășurare. |
|
600022 |
Sincronizarea unui singur utilizator al directorului extern BroadWorks nu este posibilă, deoarece întreprinderea nu are niciun utilizator furnizat. |
|
600023 |
Sincronizarea unui singur utilizator a directorului extern BroadWorks nu este posibilă deoarece utilizatorul există deja în această organizație. |
|
600024 |
Directorul extern BroadWorks Sincronizarea unui singur utilizator nu este posibilă deoarece nu a fost găsit niciun utilizator care să se potrivească în BroadWorks. |
|
600025 |
BroadWorks External Directory User Sync nu a reușit să actualizeze contul de utilizator în CI. |
|
600026 |
Sincronizarea utilizatorilor directorului extern BroadWorks nu a reușit să actualizeze contul de mașină în CI. |
|
600027 |
Sincronizarea unui singur utilizator a directorului extern BroadWorks nu este posibilă deoarece au fost găsiți mai mulți utilizatori în BroadWorks. |
|
600028 |
Sincronizarea unui singur utilizator a directorului extern BroadWorks nu este posibilă deoarece cel puțin o sincronizare a directorului întreprinderii ar fi trebuit să fie finalizată. |
|
600029 |
Sincronizarea utilizatorilor din directorul extern BroadWorks a eșuat, deoarece întreprinderea nu are niciun utilizator furnizat. |
Istoricul modificărilor
Următorul tabel rezumă actualizările acestui articol.
|
Data |
Revizuirea |
|---|---|
|
Februarie 14, 2023 |
Actualizat secțiunea Maximum de sincronizare a directoarelor și sursă. |
|
Decembrie 10, 2022 |
Actualizat termenul Sincron izare imediată completă pentru a declanșa sinc ronizarea directorului |
|
Iulie 19, 2022 |
Clarificări și corecții la informațiile de ansamblu:
|
|
09 mai, 2022 |
|
|
Aprilie 07, 2022 |
|
|
Martie 28, 2022 |
|
|
Martie 24, 2022 |
A fost adăugată lista tipurilor de numere de telefon sincronizate la Condițiile de sincronizare a directorului. Sincronizarea include acum numere de telefon mobil. |
|
Martie 16, 2022 |
|
|
Decembrie 17, 2021 |
|
|
Decembrie 16, 2021 |
|
|
08 decembrie 2021 |
|