Acest articol descrie cum să implementați Directory Sync în Webex pentru Cisco BroadWorks. Articolul este destinat administratorilor Furnizorilor de servicii din organizațiile partenere.
Prezentare generală a Sincronizării directorului
Sincronizarea directorului asigură că 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 făceau parte din configurarea utilizatorilor în directorul Webex .
Configurarea utilizatorilor Webex for Cisco BroadWorks actualizează directorul Webex cu detalii de apelare pentru utilizatorii Webex for Cisco BroadWorks (număr de telefon primar , număr de număr de telefon mobil, interior), dar omite înregistrările apelurilor externe. Cu toate acestea, când Sincronizarea directorului este activată, caracteristica sincronizează și următoarele înregistrări de apeluri în directorul Webex .
Utilizatori care apelează exclusiv BroadWorks (care nu sunt integrați în Webex)
Entități apelante non-utilizatoare (de exemplu, un telefon dintr-o sală de conferințe, un fax, un număr de grup de hunt )
Intrări în 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 apeluri BroadWorks |
Descriere |
Adăugat în Webex Directory prin... |
---|---|---|
Webex pentru utilizatorii Cisco BroadWorks |
Utilizatorii sunt activați pentru Webex pentru Cisco BroadWorks |
Configurarea utilizatorilor (de exemplu, configurarea indirectă) |
Utilizatori care apelează exclusiv BroadWorks |
Apelarea utilizatorilor care sunt nu integrat în Webex |
Sincronizare director |
Entități apelante non-utilizator |
De exemplu, un telefon dintr-o sală de conferințe, un fax, un număr de grup Hunt |
Sincronizare director |
Liste de telefoane BroadWorks |
Intrări în lista de telefoane BroadWorks:
|
Sincronizare director (sincronizare listă de telefoane) |
Pentru mai multe detalii despre configurarea utilizatorilor, consultați Ghidul de soluții Webex pentru Cisco BroadWorks .
|
Condiții de sincronizare director
Administratorii parteneri trebuie să activeze caracteristica la nivel de partener. Administratorii parteneri pot activa sau dezactiva caracteristica pentru mai multe organizații cu clienți într-o singură operațiune.
În mod implicit, sincronizarea inițială are loc la o săptămână de la activarea sincronizării (ora aleasă pentru începerea sincronizării este aleatorie). Cu toate acestea, organizațiile clienți pot utiliza Sincronizare acum opțiunea de a ocoli perioada de așteptare de o săptămână și de a declanșa o sincronizare imediată pentru o anumită organizație client.
În mod implicit, directory Sync 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 Sincronizare acum .
Numărul număr maxim de sincronizări simultane pentru fiecare cluster BroadWorks este de două: o sincronizare programată și una la cerere (prin API sau GUI Partner Hub ). Cu toate acestea, administratorii nu pot rula două sincronizari 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 Sincronizare acum opțiune în Partner Hub. În plus, Webex nu va programa două sincronizari programate să ruleze în același timp din același BroadWorks.
Dacă apare o eroare de sincronizare, Webex reîncercă sincronizarea automat la fiecare 24 de ore, până la următoarea sincronizare programată.
Sincronizarea ignoră utilizatorii care nu au număr de telefon.
În Partner Hub, puteți vizualiza informații 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ă exclusiv BroadWorks și entitățile care apelează fără utilizatori, această funcție sincronizează următoarele tipuri de număr de telefon din BroadWorks:
Număr de telefon principal
Număr de telefon mobil
Extensie
Cu toate acestea, sincronizarea exclude din sincronizare utilizatorii care apelează exclusiv BroadWorks și entitățile apelante non-utilizatoare dacă nu este prezent nici un număr de telefon primar, nici un interior.
Lista de telefoane BroadWorks și numărul maxim de contacte
Sincronizarea directorului sincronizează și intrările din lista de telefon BroadWorks cu Webex Contacts. Intrările sincronizate sunt adăugate la unul dintre următoarele tipuri de contact:
Contacte organizație — Webex stochează aceste contacte într-o organizație. 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 în contact. Maximul este de până la 2000 de contacte (1500 de contacte sincronizate + 500 de contacte cu introducere manuală).
Numai intrările din Listă de telefon sunt adăugate în Webex Contacts. Utilizatorii care apelează exclusiv BroadWorks și entitățile apelante non-utilizator care sunt incluse în Sincronizarea directorului nu sunt adăugate în Contacte decât dacă un utilizator Webex îi adaugă manual în Contacte.
|
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 |
Sursă contact |
Maximum |
Sincronizat din BroadWorks... |
API utilizat pentru sincronizare |
---|---|---|---|---|
Contactele organizației |
Sincronizare director |
30000 de contacte |
Liste de telefoane comune Enterprise |
|
Liste de telefoane comune de grup (pentru un grup de furnizori de servicii)** |
|
|||
Contactele utilizatorilor |
Sincronizare director |
1500 de contacte |
Liste personale de telefoane |
/directories/personal |
Adăugat manual de către utilizator |
500 de contacte |
Nu este cazul |
Nu este cazul |
|
Grupați contactele |
Sincronizare director |
30000 de contacte per grup |
Liste de telefoane comune de grup (pentru un grup Enterprise)** |
/directories/groupcommon |
**Intrarile din listele de telefoane comune de grup se sincroniza diferit, în funcție de faptul că BroadWorks este în modul Enterprise sau modul Furnizor de servicii. Valoarea
|
În ceea ce privește modul în care Directory Sync gestionează numărul maxim de contacte se aplică următoarele condiții:
Dacă o organizație depășește numărul maxim de contacte permise pentru sincronizare (30000 de contacte ale organizației sau 30000 de contacte comune ale grupului per grup), sincronizarea directorului exclude intrările care depășesc pragul maxim. Nu există o ordine specială aplicată contactelor sincronizate sau omise.
Dacă unul dintre clienții dvs. depășește numărul maxim permis de contacte în oricare dintre categorii, vă recomandăm să adresați o acțiune la Cisco pentru a exclude organizația respectivă din sincronizarea directorului.
Contactele manuale sunt contactele 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 cu utilizatorul din Webex, dar nu sunt incluse în sincronizare.
Limita totală combinată pentru contactele organizației (30000) și contactele de grup (30000 per grup) este de 200000.
Actualizări
Iată cum gestionează directorul Webex actualizările:
Dacă nume contact se modifică în BroadWorks, contactul existent este șters din directorul Webex și este creat un contact nou.
Dacă numărul de contact se modifică în BroadWorks, Webex actualizează contactul existent în directorul Webex cu noul număr.
După ce un administrator actualizează un contact în BroadWorks, următoarele condiții descriu momentul în care actualizarea se afișează în aplicația Webex unui utilizator:
Dacă actualizarea se adresează unui utilizator care apelează exclusiv BroadWorks sau al unei entități apelante non-utilizator, actualizarea se afișează în aplicația Webex a unui utilizator imediat după sincronizarea ulterioară a directorului.
Dacă actualizarea se referă la o intrare din lista de telefoane BroadWorks:
Pentru contactele utilizatorilor – Actualizările se afișează în aplicația Webex a utilizatorului imediat după sincronizarea ulterioară a directorului.
Pentru contactele de grup - Actualizările se afișează în aplicația Webex utilizatorilor imediat după sincronizarea ulterioară a directorului.
Pentru persoanele de contact din organizație – Directorul Webex este actualizat la sincronizarea ulterioară a directorului, dar utilizatorii nu vor vedea schimbarea în aplicația Webex până când nu repornesc aplicația Webex sau până la expirarea cronometrului cache de 72 de ore local.
Actualizările informații utilizator Webex pentru Cisco BroadWorks sunt tratate ca parte a proceselor de configurare.
|
Control Hub conține o opțiune de a adăuga sau edita contacte la nivel de organizație în Control Hub printr-un fișier CSV. Administratorii parteneri și administratorii clienți cu acces la Control Hub pot accesa această opțiune. Cu toate acestea, actualizarea contactelor prin Control Hub nu este acceptată de Webex pentru Cisco BroadWorks. Actualizările de contacte aplicate în Control Hub nu se sincronizează înapoi în BroadWorks și nu sunt disponibile pentru căutările în directoare de pe telefoanele de birou.
|
Cerințe prealabile pentru sincronizarea directorului
Vă recomandăm să utilizați următoarele setări:
Exemplele de mai jos presupun că utilizați un server XSP. Pentru serverele ADP, înlocuiți (XSP_ CLI) cu (ADP_ CLI).
|
Valori limită ale ratei – Setați următoarele proprietăți ale sistemului OverloadControl (XSP_ CLI/Aplicații/Xsi-Actions/OverloadControl):
userDirectoryTransactionLimit — Setați la o valoare nulă.
globalDirectoryTransactionLimit — Setați la o valoare nulă.
Se recomandă 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 tranzacțieiLimitPeriodSeconds (care ar trebui să fie 1).Limite tranzacții – Setați următoarele valori (XSP_ CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit — Setați la cel puțin 100.
transactionLimitPeriodSecs — Setați la 1.
Valori de difuzare – Setați proprietățile sistemului de difuzare (XSP_ CLI/Aplicații/Xsi-Actions/Paging):
defaultPageSize – Setați la 50
availableUserMaxLimit — Setată la 100
Interfață CTI – Asigurați-vă că încărcați certificatele Webex CA respective în depozitul de încredere al interfeței CTI și că activați autentificarea clientului în 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 R22:
AP.as.22.0.1123.ap368517
Pentru R23:
AP.as.23.0.1075.ap368517
Pentru R24: nu este necesar niciun plasture
Activare sincronizare director (șablon nou)
Administratorii parteneri pot activa Directory Sync pentru un șablon de client în timp ce creează noul șablon. Orice organizații clienți noi care sunt alocate șablonului respectiv vor avea sincronizarea directoare activată. Pentru detalii, consultați „Configurarea șabloanelor de client” în Configurați-vă organizația partener în Partner Hub în cadrul Ghid de soluții pentru Webex pentru Cisco BroadWorks .
Ce trebuie să faceți în continuare
Asigurați-vă că utilizatorii știu că trebuie să facă clic pe Contacte din aplicația Webex cel puțin o dată pentru a activa funcția din aplicația Webex . Aceasta trebuie finalizată o singură dată.
Activare sincronizare director (șablon existent)
1 | Conectați-vă la Partner Hub și alegeți Setări . |
||
2 | Derulați la BroadWorks Calling și faceți clic Vizualizare șabloane . |
||
3 | Selectați șablonul de client corespunzător și derulați la BroadWorks Directory Sync . |
||
4 | Pentru a activa implicit sincronizarea directoarelor pentru noile organizații clienți care utilizează acest șablon:
|
||
5 | Pentru a activa sincronizarea directoarelor pentru organizațiile clienți existente care utilizează acest șablon:
|
Ce este de făcut în continuare
Asigurați-vă că utilizatorii știu că trebuie să facă clic pe Contacte din aplicația Webex cel puțin o dată pentru a activa funcția din aplicația Webex . Aceasta trebuie finalizată o singură dată.
Declanșare sincronizare 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 Vizualizare șabloane . |
3 | Selectați șablonul de client corespunzător și derulați la BroadWorks Directory Sync . |
4 | Faceți clic Afișează starea sincronizării listei clienților . |
5 | Pentru organizația client pe care doriți să o sincronizați, faceți clic pe cele trei puncte din extrema dreaptă și selectați Sincronizare acum . |
6 | Faceți clic Reîmprospătare pentru a vedea rezultatele sincronizării. |
Exportați înregistrări sincronizate î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 Vizualizare șabloane . |
3 | Selectați șablonul de client corespunzător și derulați la BroadWorks Directory Sync . |
4 | Faceți clic Afișează starea sincronizării listei 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 Exportați rezultatele . |
API-uri publice pentru Directory Sync
API-urile publice sunt disponibile pe developer.webex.com care le permit administratorilor parteneri să actualizeze setările de Sincronizare director pentru organizațiile clienți pe care le administrează, să declanșeze o sincronizare imediată sau să obțină informații despre starea sincronizării. Metodele de sincronizare director sunt grupate în BroadWorks Enterprises :
Listați BroadWorks Enterprises —Utilizați această metodă API pentru a obține o listă a întreprinderilor din cadrul unui anumit Furnizor de servicii și al fiecărei întreprinderi
id
. Trebuie să introducețispEnterpriseId
așa cum este atribuit în provisioning.Actualizare Directory Sync pentru o companie BroadWorks Enterprise —Intră în întreprindere
id
pentru a actualiza starea directory syc pentru acea întreprindere, activând sau dezactivând sincronizarea directorului.Declanșare sincronizare director pentru o întreprindere —Utilizați această metodă API dacă doriți să declanșați o sincronizare imediată pentru o anumită întreprindere
id
. PentrusyncStatus
, introducețiSYNC_NOW
comanda.Obțineți starea sincronizarii directorului pentru o întreprindere —Intră în întreprindere
id
și rulați pentru a obține un statut șitrackingId
din cea mai recentă sincronizare. Puteți utilizatrackingID
pentru a rula analize suplimentare prin instrumente precum Kibana și Grafana.
În plus, administratorii pot utiliza Declanșare sincronizare director pentru un singur utilizator API pentru a declanșa o sincronizare a directorului la cerere pentru un singur utilizator.
Pentru documentație detaliată API , consultațihttps://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide .
Trebuie să vă conectați pentru a citi specificația API lahttps://developer.webex.com/docs/api/v1/broadworks-subscribers .
Sincronizați mai multe întreprinderi cu API
|
1 | Rulați Listați BroadWorks Enterprises API pentru a genera o listă de companii pe care doriți să le sincronizați.
|
2 | Rulați Declanșare sincronizare director pentru o întreprindere API pe prima întreprindere din listă. |
3 | Așteptați câteva secunde și apoi rulați Obțineți starea sincronizării directorului API pentru a obține starea de sincronizare.
|
4 | După ce sincronizarea se termină, parcurgeți pașii de la 2 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ă Directory Sync.
Cod de eroare |
Mesaj de Eroare |
---|---|
600000 |
Eroare neaşteptată Sincronizare utilizator director extern Broadworks. |
600001 |
Sincronizare utilizator de director extern Broadworks nereușită. |
600002 |
Sincronizarea utilizatorului de director extern Broadworks a trebuit să fie încheiată înainte de finalizare. |
600003 |
Sincronizarea utilizatorului de director extern Broadworks a reușit parțial. Anumite organizații ale clientului nu au putut fi sincronizate. |
600004 |
Sincronizarea utilizatorului de director extern Broadworks nu este activată pentru setul de configurare. |
600005 |
Sincronizarea utilizatorului de director extern Broadworks este în curs pentru setul de configurare. |
600006 |
Șirurile de sincronizare a utilizatorului de director extern Broadworks sunt ocupate sau se opresc și deci nu vor accepta alte solicitări de sincronizare; încercați din nou mai târziu. |
600007 |
Nu a fost găsită identitatea organizației în configurația de client. |
600008 |
Configuraţia de client nu a fost găsită în organizaţia parteneră. |
600009 |
Sincronizarea utilizatorului director extern Broadworks nu poate fi rulată, deoarece clusterul broadworks asociat cu CustomerConfig este ocupat |
600010 |
Sincronizarea utilizatorului de director extern Broadworks nu poate fi efectuată deoarece nu există niciun cluster broadworks asociat configurației de client. |
600011 |
Sincronizarea utilizatorului de director extern Broadworks nu este activată pentru configurația de client. |
600012 |
Sincronizarea utilizatorului de director extern Broadworks nu poate fi rulată deoarece sincronizarea directoarelor hibride este deja activată pentru configuraţia clientului. |
600013 |
Sincronizarea utilizatorului de director extern Broadworks nu a putut adăuga utilizatori și conturi de dispozitive în memoria de identități. |
600014 |
Sincronizarea utilizatorului de director extern Broadworks a eşuat în timp ce încerca să se conecteze la clusterul Broadworks. Eroare de la Broadworks - %s. |
600015 |
Sincronizarea utilizatorului de director extern Broadworks nu a găsit niciun utilizator potrivit în memoria de identităţi. |
600017 |
BroadWorks Phone List Sync nu a reușit să sincronizați toate contactele utilizatorilor și ale companiei/organizației. |
600018 |
Sincronizarea listei de telefon BroadWorks a eșuat pentru utilizatorii din întreprindere/organizație. |
600019 |
BroadWorks Phone List Sync nu a reușit să sincronizați contactele companiei/organizației. |
600020 |
Sincronizarea utilizatorului BroadWorks External Directory nu poate fi dezactivată, deoarece sincronizarea CustomerConfig este în curs. |
600022 |
Sincronizarea utilizatorului unic director extern BroadWorks nu este posibilă, deoarece întreprinderea nu are niciun utilizator configurat. |
600023 |
Sincronizarea utilizatorului unic director extern BroadWorks nu este posibilă, deoarece utilizatorul există deja în această organizație. |
600024 |
Sincronizarea utilizatorului unic director extern BroadWorks nu este posibilă, deoarece nu a fost găsit niciun utilizator corespunzător în BroadWorks. |
600025 |
BroadWorks External Directory User Sync nu a reușit actualizarea cont utilizator în CI. |
600026 |
BroadWorks External Directory User Sync nu a reușit să actualizeze contul computerului în CI. |
600027 |
Sincronizarea utilizatorului unic director extern BroadWorks nu este posibilă, deoarece au fost găsiți mai mulți utilizatori în BroadWorks. |
600028 |
Sincronizarea utilizatorului unic a directorului extern BroadWorks nu este posibilă, deoarece cel puțin o sincronizare a director la nivel de întreprindere ar fi trebuit să fie finalizată. |
600029 |
Sincronizarea utilizatorului director extern BroadWorks a eșuat, deoarece întreprinderea nu are niciun utilizator configurat. |
Istoric modificări
Următorul tabel rezumă actualizările acestui articol.
Dată |
Revizuire |
---|---|
14 februarie 2023 |
Actualizat Maximum și sursă de sincronizare director secțiunea. |
10 decembrie 2022 |
S-a actualizat termenul Finalizați sincronizarea imediată la Declanșare sincronizare director |
19 iulie 2022 |
Clarificări și corecții la informațiile de prezentare generală:
|
09 mai 2022 |
|
07 aprilie 2022 |
|
28 martie 2022 |
|
24 martie 2022 |
S-a adăugat lista de tipuri de număr de telefon sincronizate la Condiții de sincronizare director . Sincronizarea include acum numere de telefon mobil . |
16 martie 2022 |
|
17 decembrie 2021 |
|
16 decembrie 2021 |
|
08 decembrie 2021 |
|