- Početak
- /
- Članak
Sinkronizacija direktorija u usluzi Webex za Cisco BroadWorks
U ovom se članku opisuje kako implementirati sinkronizaciju direktorija u Webexu za Cisco BroadWorks. Članak je namijenjen administratorima davatelja usluga u partnerskim organizacijama.
Pregled sinkronizacije direktorija
Sinkronizacija direktorija osigurava da korisnici Webexa za Cisco BroadWorks mogu koristiti direktorij Webex iz aplikacije Webex za pozivanje bilo kojeg pozivajućeg entiteta s BroadWorks poslužitelja. Ova značajka sinkronizira BroadWorks informacije o pozivima koje nisu bile dio dodjele resursa korisnicima direktoriju Webex.
Webex za Cisco BroadWorks korisničke resurse ažurira Webex direktorij s detaljima poziva za Webex za Cisco BroadWorks korisnike (primarni telefonski broj, broj mobilnog telefona, proširenje), ali izostavlja vanjske zapise poziva. Međutim, kada je uključena sinkronizacija direktorija, značajka također sinkronizira sljedeće zapise pozivanja s direktorijem Webexa.
-
Korisnici poziva samo za BroadWorks (koji nisu uključeni u Webex)
-
Subjekti koji ne pozivaju korisnike (npr. telefon u konferencijskoj dvorani, faks uređaj, broj lovačke skupine)
-
Stavke BroadWorks telefonskog popisa
Sljedeća tablica sažima BroadWorks zapise pozivanja i pokazuje kako se dodaju u Direktorij Webexa.
BroadWorks pozivni zapisi |
Opis |
Dodano u Webex Directory putem... |
---|---|---|
Webex za korisnike Cisco BroadWorksa |
Korisnicima je omogućen Webex za Cisco BroadWorks |
Dodjela resursa korisnicima (npr. dodjela resursa flowthroughu) |
Korisnici poziva samo za BroadWorks |
Pozivanje korisnika koji nisu uključeni u Webex |
Sinkronizacija direktorija |
Pozivni entiteti koji nisu korisnici |
Npr., telefon u konferencijskoj dvorani, faks uređaj, broj hunt grupe |
Sinkronizacija direktorija |
BroadWorks telefonski popisi |
Stavke BroadWorks telefonskog popisa:
|
Sinkronizacija direktorija (sinkronizacija telefonskog popisa) |
Uvjeti sinkronizacije direktorija
-
Administratori partnera moraju omogućiti značajku na razini partnera. Administratori partnera mogu uključiti ili isključiti značajku za više korisničkih organizacija u jednoj operaciji.
-
Prema zadanim postavkama početna sinkronizacija odvija se tjedan dana nakon omogućivanja sinkronizacije (vrijeme odabrano za pokretanje sinkronizacije je slučajno). Međutim, korisničke organizacije mogu upotrijebiti opciju Sinkroniziraj sada kako bi zaobišle razdoblje čekanja od tjedan dana i aktivirale neposrednu sinkronizaciju za određenu korisničku organizaciju.
-
Prema zadanim postavkama, sinkronizacija direktorija izvodi se tjedno za svakog kupca. Svaka sinkronizacija odvija se tjedan dana nakon posljednje sinkronizacije, bez obzira na to je li posljednja sinkronizacija zakazana ili pokrenuta ručno pomoću značajke Sinkroniziraj sada.
-
Maksimalan broj istovremenih sinkronizacija po BroadWorks klasteru je dva: jedna zakazana sinkronizacija i jedna sinkronizacija na zahtjev (putem API-ja ili GUI-ja partnerskog huba). Međutim, administratori ne mogu istovremeno pokrenuti dvije sinkronizacije na zahtjev iz iste BroadWorks. Ovo ograničenje postoji bez obzira na to je li sinkronizacija pokrenuta putem API-ja ili putem opcije Sinkroniziraj sada u partnerskom hubu. Osim toga, Webex neće zakazati dvije zakazane sinkronizacije koje će se istovremeno izvoditi iz istog BroadWorksa.
-
Ako dođe do pogreške pri sinkronizaciji, Webex automatski ponovno nastavlja sinkronizaciju svaka 24 sata do sljedeće zakazane sinkronizacije.
-
Sinkronizacija zanemaruje korisnike koji nemaju telefonski broj.
-
U partnerskom hubu možete pregledati informacije o stanju sinkronizacije za određenog kupca. Osim toga, detaljne informacije o posljednjoj sinkronizaciji možete izvesti u CSV zapis. CSV zapis pruža više detalja od prikaza Kontrolnog čvorišta i može pomoći u otklanjanju poteškoća, analitici i nadzoru.
-
Webex pohranjuje korisničke kontakte u šifriranom obliku. Samo korisnik u čijem je vlasništvu kontakt ima pristup ključu za dešifriranje.
-
Za korisnike koji pozivaju samo za BroadWorks i entitete koji ne pozivaju korisnike, ova značajka sinkronizira sljedeće vrste telefonskih brojeva iz BroadWorksa:
-
Primarni telefonski broj
-
Broj mobilnog telefona
-
Proširenje
Međutim, sinkronizacija isključuje korisnike poziva samo za BroadWorks i entitete koji ne pozivaju korisnike iz sinkronizacije ako nema primarnog telefonskog broja ili proširenja.
Postavka usluge privatnosti na korisničkoj razini BroadWorks nije podržana kao dio sinkronizacije direktorija.
-
BroadWorks telefonski popis i maksimumi kontakata
Sinkronizacija direktorija također sinkronizira stavke BroadWorks telefonskog popisa s Webex kontaktima. Sinkronizirani unosi dodaju se jednoj od sljedećih vrsta kontakata:
-
Kontakti tvrtke ili ustanove – Webex pohranjuje te kontakte u odnosu na tvrtku ili ustanovu. Svaki korisnik može pristupiti kontaktima tvrtke ili ustanove za svoju tvrtku ili ustanovu. Maksimalan je broj do 30000 kontakata.
-
Korisnički kontakti – Webex pohranjuje te kontakte protiv korisnika. Unosu kontakta može pristupiti samo korisnik u čijem je vlasništvu kontakt. Maksimum je do 2000 kontakata (1500 sinkroniziranih kontakata + 500 kontakata za ručni unos).
Sljedeća tablica mapira vrste kontakata webexa s izvorom kontakta (sinkronizirana s BroadWorks telefonskog popisa ili ručno dodana):
Vrsta kontakta Webexa |
Izvor kontakta |
Maksimalno |
Sinkronizirano iz BroadWorksa... |
API koji se koristi za sinkronizaciju |
---|---|---|---|---|
Kontakti tvrtke ili ustanove |
Sinkronizacija direktorija |
30000 kontakata |
Poslovni zajednički telefonski popisi |
|
Grupiranje uobičajenih telefonskih popisa (za grupu davatelja usluga)** |
| |||
Korisnički kontakti |
Sinkronizacija direktorija |
1500 kontakata |
Osobni telefonski popisi | /direktoriji/osoblje |
Korisnik je ručno dodao |
500 kontakata |
n.d. |
n.d. | |
Grupni kontakti |
Sinkronizacija direktorija |
30000 kontakata po skupini |
Grupiraj uobičajene telefonske popise (za grupu Enterprise)** | /direktoriji/groupcommon |
**Grupni unosi zajedničkih telefonskih popisa sinkroniziraju se različito, ovisno o tome je li BroadWorks u načinu rada za velike tvrtke ili davatelja usluga. Vrijednost parametra isBroadWorksEnterprise
(istina ili laž) određuje kako se popis sinkronizira:
-
Točno — sinkroniziraj kao grupni kontakt
-
False — Sinkronizacija kao kontakt tvrtke ili ustanove
Primjenjuju se sljedeći uvjeti oko načina na koji sinkronizacija direktorija obrađuje maksimume kontakata:
-
Ako organizacija prekorači maksimalan dopušteni broj kontakata za sinkronizaciju (30000 kontakata organizacije ili 30000 zajedničkih kontakata po skupini), sinkronizacija direktorija isključuje unose iznad maksimalnog praga. Ne postoji određeni redoslijed primijenjen na sinkronizirane ili izostavljene kontakte.
-
Ako jedan od vaših klijenata premaši maksimalan dopušteni broj kontakata u bilo kojoj kategoriji, preporučujemo da pokrenete slučaj s Ciscom kako biste tu organizaciju isključili iz sinkronizacije direktorija.
-
Ručni kontakti kontakti su kontakti koje korisnik ručno dodaje u aplikaciji Webex. Korisnik može dodati do 500 ručnih kontakata. Ručni kontakti spadaju u veću kategoriju kontakta korisnika na Webexu, ali nisu uključeni u sinkronizaciju.
-
Ukupno kombinirano ograničenje za kontakte organizacije (30000) i kontakte skupine (30000 po skupini) iznosi 200000.
Ažuriranja
Slijedi način na koji direktorij Webex obrađuje ažuriranja:
-
Ako se ime kontakta promijeni na BroadWorksu, postojeći kontakt briše se iz direktorija Webex i stvara se novi kontakt.
-
Ako se broj kontakta promijeni na BroadWorksu, Webex ažurira postojeći kontakt u direktoriju Webex novim brojem.
Nakon što administrator ažurira kontakt na BroadWorksu, sljedeći uvjeti ocrtavaju kada se ažuriranje prikaže u korisnikovoj web-aplikaciji Webex:
-
Ako se ažuriranje odnosi na korisnika koji poziva samo za BroadWorks ili entitet koji ne zove korisnika, ažuriranje se prikazuje u korisnikovoj web-aplikaciji odmah nakon naknadne sinkronizacije direktorija.
-
Ako se ažuriranje odnosi na stavku BroadWorks telefonskog popisa:
-
Za korisničke kontakte – ažuriranja se prikazuju u korisnikovoj web-aplikaciji odmah nakon naknadne sinkronizacije direktorija.
-
Za grupne kontakte – ažuriranja se u korisnicima aplikacije Webex prikazuju odmah nakon sljedeće sinkronizacije direktorija.
-
Za kontakte tvrtke ili ustanove – direktorij Webex ažurira se pri sljedećoj sinkronizaciji direktorija, ali korisnici neće vidjeti promjenu u aplikaciji Webex dok ponovno ne pokrenu aplikaciju Webex ili dok ne istekne lokalni 72-satni mjerač vremena predmemorije.
-
Preduvjeti za sinkronizaciju direktorija
Preporučujemo da koristite sljedeće postavke:
-
Vrijednosti ograničavanja brzine – postavite sljedeća svojstva sustava OverloadControl (XSP_CLI/Applications/Xsi-Actions/OverloadControl):
-
userDirectoryTransactionLimit – postavite na null vrijednost.
-
globalDirectoryTransactionLimit – postavite na null vrijednost.
Preporučuje se postavljanje userDirectoryTransactionLimit i globalDirectoryTransactionLimit na null vrijednost. Međutim, ako odlučite dodijeliti vrijednosti, svaka mora biti postavljena na najmanje pet puta veću vrijednost transakcijeLimitPeriodSecond (koja bi trebala biti 1). -
-
Ograničenja transakcija – postavite sljedeće vrijednosti (XSP_CLI/System/CommunicationUtility/DefaultSettings):
-
userTransactionLimit – postavite na najmanje 100.
-
transactionLimitPeriodSecs – postavi na 1.
-
-
Vrijednosti stranične stranice – postavite svojstva straničnog sustava (XSP_CLI/Applications/Xsi-Actions/Straničavanje):
-
defaultPageSize – postavi na 50
-
dostupnoUserMaxLimit – postavljeno na 100
-
-
CTI sučelje – obavezno prenesite te Webex CA certifikate u spremište pouzdanih vrijednosti sučelja CTI i omogućite provjeru autentičnosti klijenta na CTI sučelju.
Osim toga, ovisno o izdanju BroadWorksa, preporučujemo da prije omogućivanja ove značajke na broadworks implementaciju primijenite sljedeće zakrpe sustava na BroadWorks implementaciju:
-
Za R22:
AP.as.22.0.1123.ap368517
-
Za R23:
AP.as.23.0.1075.ap368517
-
Za R24: nije potrebna zakrpa
Omogući sinkronizaciju direktorija (novi predložak)
Administratori partnera mogu omogućiti sinkronizaciju direktorija za predložak klijenta tijekom stvaranja novog predloška. Sve nove korisničke organizacije koje se dodijele tom predlošku omogućit će sinkronizaciju direktorija. Detalje potražite u odjeljku "Konfiguriranje predložaka kupaca" u odjeljku Konfiguriranje partnerske organizacije u partnerskom hubu u vodiču za rješenja za Webex za Cisco BroadWorks.
Što učiniti dalje
Provjerite znaju li vaši korisnici da barem jednom moraju kliknuti karticu Kontakti u aplikaciji Webex kako bi uključili značajku u aplikaciji Webex. To treba dovršiti samo jednom.
Omogući sinkronizaciju direktorija (postojeći predložak)
1 |
Prijavite se u partnersko središte i odaberite Postavke. |
2 |
Pomaknite se do broadworks poziva i kliknite Prikaz predložaka. |
3 |
Odaberite odgovarajući predložak klijenta i pomaknite se do BroadWorks Sinkronizacije direktorija. |
4 |
Da biste omogućili sinkronizaciju direktorija prema zadanim postavkama za nove organzije klijenata koji koriste ovaj predložak: |
5 |
Da biste omogućili sinkronizaciju direktorija za postojeće korisničke organizacije koje koriste ovaj predložak: Ako želite onemogućiti sinkronizaciju direktorija, slijedite gore navedeni postupak i:
|
Što učiniti sljedeće
Provjerite znaju li vaši korisnici da barem jednom moraju kliknuti karticu Kontakti u aplikaciji Webex kako bi uključili značajku u aplikaciji Webex. To treba dovršiti samo jednom.
Aktiviraj trenutačnu sinkronizaciju
1 |
Prijavite se u Čvorište partnera ( http://admin.webex.com) i odaberite Postavke. |
2 |
Pomaknite se do broadworks poziva i kliknite Prikaz predložaka. |
3 |
Odaberite odgovarajući predložak klijenta i pomaknite se do BroadWorks Sinkronizacije direktorija. |
4 |
Kliknite Pokaži popis stanjasinkronizacije klijenata. |
5 |
Za organizaciju korisnika koju želite sinkronizirati kliknite tri točke na krajnjoj desnoj strani i odaberite Sinkroniziraj odmah. |
6 |
Kliknite Osvježi da biste vidjeli rezultate sinkronizacije. |
Izvoz zapisa sinkronizacije u CSV
1 |
Prijavite se u Čvorište partnera ( http://admin.webex.com) i odaberite Postavke. |
2 |
Pomaknite se do broadworks poziva i kliknite Prikaz predložaka. |
3 |
Odaberite odgovarajući predložak klijenta i pomaknite se do BroadWorks Sinkronizacije direktorija. |
4 |
Kliknite Pokaži popis stanjasinkronizacije klijenata. |
5 |
Potvrdite susjedne potvrdne okvire za svaku organizaciju koju želite uključiti u izvoz. |
6 |
Kliknite Izvezi rezultate. |
Javni API-ji za sinkronizaciju direktorija
Javni API-ji dostupni su na developer.webex.com koji partnerskim administratorima omogućuju ažuriranje postavki sinkronizacije direktorija za korisničke organizacije kojima upravljaju, pokretanje trenutne sinkronizacije ili dobivanje informacija o statusu sinkronizacije. Metode sinkronizacije direktorija grupirane su u odjeljku BroadWorks Enterprises:
-
Popis BroadWorks poduzeća– upotrijebite ovu API metodu kako biste dobili popis poduzeća pod određenim davateljem usluga i
ID
svakog poduzeća. Morate unijetispEnterpriseId
kako je dodijeljen u omogućavanju. -
Ažuriranje sinkronizacije direktorija za BroadWorks Enterprise– unesite
ID
poduzeća kako biste ažurirali status syc direktorija za to poduzeće, omogućavajući ili onemogućavajući sinkronizaciju direktorija. -
Aktiviranje sinkronizacije direktorija za poduzeće – koristite ovu API metodu ako želite aktivirati trenutačnu sinkronizaciju za određeni
ID
poduzeća. ZasyncStatus
unesite naredbuSYNC_NOW
. -
Dobivanje statusa sinkronizacije direktorija za poduzeće– unesite
ID
poduzeća i pokrenite kako biste dobili status iID praćenja
najnovije sinkronizacije.ID za praćenje
možete upotrijebiti za pokretanje dodatne analitike putem alata kao što su Kibana i Grafana.
Osim toga, administratori mogu koristiti sinkronizaciju direktorija okidača za API jednog korisnika za pokretanje sinkronizacije direktorija na zahtjev za jednog korisnika.
Detaljnu dokumentaciju API-ja potražite u odjeljku https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
Morate se prijaviti da biste pročitali specifikaciju API-ja na . https://developer.webex.com/docs/api/v1/broadworks-subscribers
Sinkronizacija više poduzeća s API-jem
-
Sinkronizacija direktorija omogućuje vam sinkronizaciju samo jedne tvrtke iz Broadworks klastera odjednom putem sinkronizacije na zahtjev. Ako pokušate sinkronizirati više poduzeća, prikazat će se pogreška 429
-
Vrijeme koje je potrebno za pokretanje sinkronizacije za jedno poduzeće razlikuje se ovisno o veličini poduzeća.
1 |
Pokrenite Popis BroadWorks Enterprises API da biste generirali popis poduzeća koja želite sinkronizirati. |
2 |
Pokrenite sinkronizaciju direktorija okidača za Enterprise API na prvoj tvrtki na popisu. |
3 |
Pričekajte nekoliko sekundi, a zatim pokrenite API za dohvaćanje statusa sinkronizacije direktorija da biste dobili status sinkronizacije. |
4 |
Nakon završetka sinkronizacije dovršite korake od 2 do 4 na sljedećoj tvrtki na popisu. Ponavljajte ove korake dok ne sinkronizirate cijeli popis. |
Kodovi pogrešaka za sinkronizaciju direktorija
Sljedeći kodovi pogrešaka primjenjuju se na sinkronizaciju direktorija.
Kôd pogreške |
Poruka o pogrešci |
---|---|
600000 |
U korisničkoj sinkronizaciji vanjskog direktorija Broadworks došlo je do pogreške. |
600001 |
Korisnička sinkronizacija vanjskog direktorija Broadworks nije uspjela. |
600002 |
Korisnička sinkronizacija vanjskog direktorija Broadworks prekinuta je prije dovršenja. |
600003 |
Korisnička sinkronizacija vanjskog direktorija Broadworks djelomično je uspjela. Nije uspjela sinkronizacija nekih korisničkih organizacija. |
600004 |
Korisnička sinkronizacija vanjskog direktorija Broadworks nije omogućena za konfiguracijski skup. |
600005 |
U tijeku je korisnička sinkronizacija vanjskog direktorija Broadworks za konfiguracijski skup. |
600006 |
Nizovi korisničke sinkronizacija vanjskog direktorija Broadworks zauzeti su ili se isključuju, zbog čega se ne mogu prihvatiti dodatni zahtjevi za sinkronizaciju; pokušajte ponovno kasnije. |
600007 |
Nije pronađena organizacija identiteta korisničke konfiguracije. |
600008 |
Korisnička konfiguracija nije pronađena u partnerskoj organizaciji. |
600009 |
Širokopojasna sinkronizacija korisnika vanjskog imenika ne može se pokrenuti jer je širokopojasni klaster pridružen CustomerConfigu zauzet |
600010 |
Korisnička sinkronizacija vanjskog direktorija Broadworks ne može se pokrenuti jer s korisničkom konfiguracijom nije povezan nijedan Broadworks klaster. |
600011 |
Korisnička sinkronizacija vanjskog direktorija Broadworks nije omogućena za korisničku konfiguraciju. |
600012 |
Korisnička sinkronizacija vanjskog direktorija Broadworks ne može se pokrenuti jer je za korisničku konfiguraciju već omogućena sinkronizacija hibridnog direktorija. |
600013 |
Korisnička sinkronizacija vanjskog direktorija Broadworks nije uspjela dodati korisničke i računalne računa u spremište identiteta. |
600014 |
Korisnička sinkronizacija vanjskog direktorija Broadworks nije uspjela tijekom pokušaja povezivanja s Broadworks klasterom. Pogreška iz Broadworksa - %s. |
600015 |
Korisnička sinkronizacija vanjskog direktorija Broadworks nije pronašla odgovarajućeg korisnika u spremištu identiteta. |
600017 |
Sinkronizacija BroadWorks telefonskog popisa nije uspjela sinkronizirati sve kontakte korisnika i poduzeća/organizacije. |
600018 |
Sinkronizacija BroadWorks telefonskog popisa nije uspjela za korisnike u tvrtki/organizaciji. |
600019 |
Sinkronizacija BroadWorks telefonskog popisa nije uspjela sinkronizirati kontakte tvrtke/organizacije. |
600020 |
BroadWorks sinkronizacija korisnika vanjskog imenika ne može se onemogućiti jer je sinkronizacija CustomerConfig u tijeku. |
600022 |
Širokopojasna sinkronizacija jednog korisnika vanjskog imenika nije moguća jer tvrtka nema dodijeljenog korisnika. |
600023 |
Širokopojasna sinkronizacija jednog korisnika vanjskog direktorija nije moguća jer korisnik već postoji u ovoj tvrtki ili ustanovi. |
600024 |
Sinkronizacija jednog korisnika broadworks vanjskog direktorija nije moguća jer u BroadWorksu nije pronađen odgovarajući korisnik. |
600025 |
BroadWorks sinkronizacija korisnika vanjskog direktorija nije uspjela ažurirati korisnički račun u CI. |
600026 |
BroadWorks sinkronizacija korisnika vanjskog direktorija nije uspjela ažurirati račun računala u CI. |
600027 |
Širokopojasna sinkronizacija jednog korisnika vanjskog imenika nije moguća jer je u BroadWorksu pronađeno više korisnika. |
600028 |
Širokopojasna sinkronizacija jednog korisnika vanjskog imenika nije moguća jer je trebala biti dovršena barem jedna sinkronizacija direktorija tvrtke. |
600029 |
BroadWorks sinkronizacija korisnika vanjskog imenika nije uspjela jer tvrtka nema dodijeljenog korisnika. |
Promijeni povijest
Sljedeća tablica sažima ažuriranja ovog članka.
Datum |
Revizija |
---|---|
14. veljače 2023. |
Ažurirani su odjeljak Maksimalne sinkronizacije direktorija i izvor . |
10. prosinca 2022. |
Ažuriran je pojam Dovrši neposrednu sinkronizaciju da bi se aktivirala sinkronizacija direktorija |
19. srpnja 2022. |
Pojašnjenja i ispravci informacija o pregledu:
|
09. svibnja 2022. |
|
07. travnja 2022. |
|
28. ožujka 2022. |
|
24. ožujka 2022. |
Dodan je popis sinkroniziranih vrsta telefonskih brojeva u uvjete sinkronizacije direktorija. Sinkronizacija sada uključuje brojeve mobilnih telefona. |
16. ožujka 2022. |
|
17. prosinca 2021. |
|
16. prosinca 2021. |
|
08. prosinca 2021. |
|