Vodič za integraciju uređaja za Webex za Cisco BroadWorks

Datum	Verzija dokumenta	Opis promjene
12. svibnja 2023	1.7	Dodano Webex za BroadWorks integrirani Cisco RoomOS uređaji i Poboljšanja pretraživanja imenika za W4B integrirane RoomOS uređaje ispod Značajke krajnjeg korisnika za odjeljak Webex integrirani uređaji .
27. veljače 2023	1.6	Ažurirano Konfigurirajte usluge za OS sobe stepenice ispod Ugradnja uređaja .
17. veljače 2023	1.5	Dodano Jedinstvena povijest poziva za MPP telefone Webex odjeljak pod Značajke krajnjeg korisnika za Webex integrirane uređaje .
14. listopada 2022.	1.4	Ažurirani proces ugradnje za Room OS ispod Uključivanje OS u sobu odjeljak za uključivanje SRV zapisi. Ažurirano Zahtjevi za konfiguraciju BroadWorksa ispod Preduvjeti za OS sobe odjeljak s pokazivačem na Vodič za rješenje za zahtjeve za provođenje provizija.
20. lipnja 2022.	1.3	Ažurirano Preduvjeti za OS sobe i Preduvjeti za MPP uređaj s pokazivačem na Vodič za rješenja za zahtjeve za provođenje provizije. Ažurirano OS uređaji u sobi za pružanje usluga i Opskrba MPP uređaja uključiti informacije za različite metode opskrbe.
3. lipnja 2022	1.2	Ispravljeni profil uređaja Vrsta aktivacije značajke broj (02283) in Preduvjeti za OS sobe i Preduvjeti za MPP uređaj
27. svibnja 2022.	1.1	Ispravljeni zahtjevi za namjensku DMS instancu po partnerskoj organizaciji. Dodano Predgovor poglavlje. Ažuriran naslov kao "Vodič za integraciju uređaja".
20. svibnja 2022.	1.0	Prvo objavljivanje

Pregled ugradnje uređaja

Ovo poglavlje opisuje kako ugraditi uređaje u Webex za Cisco BroadWorks. Ovo poglavlje pokriva sljedeće slučajeve upotrebe:

Ugrađeni novi Webex Room OS uređaji (koristeći aktivacijske kodove)
Ugrađeni novi MPP uređaji
Dodajte Webex mogućnost postojećim MPP uređajima

Preporučujemo da ovu značajku implementirate na ADP poslužitelje neovisne o izdanju. Međutim, XSP također podržava ovu značajku. Ako koristite XSP, onda gdje se ovaj dokument odnosi na "ADP", možete zamijeniti "XSP", osim ako tekst ne navodi samo ADP.
Ova značajka podržava i Personal i Workspace uređaje.

Uključivanje OS u sobu

Webex za Cisco BroadWorks podržava ugradnju aktivacijskog koda za dijeljene uređaje i uređaje s operativnim sistemom u radnom prostoru.

Uključivanje uređaja s aktivacijskim kodovima

Uključivanje uređaja s aktivacijskim kodovima pruža jednostavan i siguran način ugradnje Room OS uređaja. Aktivacijski kod je 16-znamenkasti jednokratni sustav generiran pristupni kod koji korisnik mora unijeti na uređaj da bi se uređaj ugradio. Aktivacijski kod je sigurno povezan s namjeravanim korisnički račun i osigurava da samo namjeravani korisnik ulazi na uređaj povezan s istim računom. Nakon što korisnik unese ispravan kod, uređaj se povezuje na Webex i BroadWorks, dovršava registraciju, preuzima svoju konfiguracijska datoteka i spreman je za korištenje.

Sljedeći Room OS uređaji podržavaju uključivanje s aktivacijskim kodovima:

Webex serija ploča (sobni OS)
Webex Desk Series (Sobni OS)
Webex Room Series (Sobni OS)

Proces ugradnje za Room OS

Sljedeći proces pokazuje što se događa kada se uređaj Room OS ugradi pomoću aktivacijskih kodova:

Administrator partnera osigurava primarnog korisnika i uređaj u BroadWorksu, a zatim generira aktivacijski kod u BroadWorksu.
Vlasniku uređaja šalje se e-poruka koja sadrži aktivacijski kod uređaja.
Vlasnik uređaja pokreće uređaj.
Uređaj od vlasnika uređaja traži da unese aktivacijski kod.
Vlasnik uređaja upisuje aktivacijski kod na uređaju.
Uređaj se uključuje u BroadWorks i Webex koristeći sljedeći podproces:
- Room OS uređaj šalje zahtjev za aktivaciju Webex uslugama. GDS provjerava aktivacijski kod i ako je kod ispravan, uređaj se uključuje u Webex. Webex vraća token uređaja uređaju.
- Uređaj šalje zahtjev za aktivaciju BroadWorks DM-u zajedno s tokenom stroja i MAC adresa.
- BroadWorks autorizira i ugrađuje uređaj.
- Uređaj šalje zahtjev BroadWorks DM-u za ažuriranu konfiguraciju. Strojni token je uključen za autorizaciju.
- BroadWorks autorizira token, locira ažuriranu konfiguracijsku datoteku i vraća ažuriranu konfiguracijska datoteka.
- Room OS će pokušati locirati NAPTR zapis za domenu navedenu u konfiguracijska datoteka jer očekuje da će pronaći SRV unos za_sip ._tls .<domain_in_config > ako nema NAPTR zapisa, RoomOS će tada pokušati potražiti SRV zapis nakon kojeg slijedi A zapis.
  
  SRV zapis mora biti_sip ._tls . jer će roomOS podržavati samo TLS za transport i SRTP za medije.
Uređaj se registrira i spreman je za korištenje.

Sljedeći dijagram pruža pojednostavljeni pregled procesa ugradnje.

Za detaljne informacije o ugradnji Room OS-a, uključujući detaljnije dijagrame toka, pogledajte opis značajke Cisco BroadWorks poboljšanja za Webex-Aware ugradnju uređaja .

Autentifikacija uređaja (putem tokena nositelja OAuth)

Provjera autentičnosti uređaja za Room OS uređaje zahtijeva da omogućite Cisco OAuth Bearer Tokene na BroadWorksu. Tijekom onboardinga, token nositelja se prosljeđuje preko zaglavlja Aktiviraj autorizaciju i služi za identifikaciju uređaja. IdP potvrđuje token nositelja i vraća UUID (UUID stroja za uređaje radnog prostora ili UUID korisnika za osobne uređaje) kao subjekt nositelja. BroadWorks sprema UUID kao naziv naziv uređaja na mrežnom poslužitelju.

Preduvjeti za OS sobe

Minimalna verzija sobnog OS-a

Room OS 10.13 minimalno

Zahtjevi BroadWorks zakrpa

Ova značajka je podržana od verzije 2021.11 ADP poslužitelja neovisnog o izdanju (RI) bez zahtjeva za zakrpu.

Za poslužitelje koji nisu RI, morate imati instalirane sljedeće zakrpe (iz grupa zakrpa ap381367, ap381951, ap382198) da biste mogli koristiti značajku. Instalirajte zakrpe koje se odnose na vaše izdanje:

Za R22:

AP.as.22.0.1123.ap381367
AP.as.22.0.1123.ap382236
AP.nfm.22.0.1123.ap381367
AP.ns.22.0.1123.ap381367
AP.platforma.22.0.1123.ap381367
AP.platforma.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

Za R23:

AP.as.23.0.1075.ap381367
AP.as.23.0.1075.ap382236
AP.ns.23.0.1075.ap381367
AP.platform.23.0.1075.ap382198
AP.platform.23.0.1075.ap381367
AP.xsp.23.0.1075.ap381367
AP.xsp.23.0.1075.ap382198
AP.ps.23.0.1075.ap381367

Za R24:

AP.as.24.0.944.ap381367
AP.as.24.0.944.ap381951
AP.as.24.0.944.ap382236

Zahtjevi platforme BroadWorks

Ova je značajka dostupna na:

R22: dostupno samo na XSP-u
R23: dostupno na XSP ili ADP (neovisno o izdanju)
R24: dostupno na ADP-u (neovisno o izdanju)

Zahtjevi za konfiguraciju BroadWorksa

Za implementaciju ovog rješenja, Flowthrough provizija mora biti konfigurirana kako bi se omogućilo Broadworksu da dobavlja uređaje za Webex.

Prilikom konfiguriranja protočne provizije, nije obvezno koristiti protočnu dodelu za pružanje usluga korisnicima, tj. možete nastaviti koristiti svoje postojeće metode opskrbe (API, pouzdana/nepouzdana e- e-pošta, sam korisnik, itd.) za dostavljanje korisnika. Vidi "Zahtjevi za opskrbu" u Vodič za rješenje za Webex za Cisco BroadWorks .
Pobrinite se da Integrirani IM+P usluga je omogućena na BroadWorksu i upućuje na BroadWorks Provisioning Bridge.

URL za premošćivanje dodijeljen je kada je predložak korisnika primijenjen na organizaciju. To je trebalo biti dovršeno tijekom vašeg početnog postavljanja Webex za Cisco BroadWorks. Da biste pronašli postojeći URL u Partner Hubu, pogledajte Konfigurirajte poslužitelj aplikacija s URL -om usluge pružanja u Vodič za rješenje za Webex za Cisco BroadWorks .
Ako imate više partnerskih organizacija, potrebna vam je namjenska instanca usluge upravljanja uređajima (DMS) po partneru.

Preduvjeti za ugradnju aktivacijskog koda s OS-om sobe

Provjerite je li postavljeno sljedeće:

Postavite uslugu aktivacije uređaja na BroadWorks. Za detalje pogledajte Cisco BroadWorks Secure Onboarding koristeći aktivacijske kodove .
Provjerite je li postavka DAS URL -a za klaster BroadWorks postavljena na URL usluge upravljanja uređajima (DMS). Da biste vidjeli trenutnu postavku URL -a DAS-a u Partner Hubu, idite na Postavke > BroadWorks poziva > Prikaz klastera i odaberite odgovarajući klaster. URL se pojavljuje ispod Postavke sučelja .

Sljedeće značajke BroadWorksa moraju biti aktivirane na AS-u:

101377 Poboljšanja za ugradnju Webex i MPP uređaja
25088 Podrška slušalicama za DECT uređaje
24104 Podrška za višećelijsko ulančavanje za DECT uređaje
20077 Poboljšanja upravljanja uređajima
19559 Poboljšanja upravljanja vizualnim uređajima
02283 Poboljšanja prilagodbe vrste profila uređaja

Na primjer, pokrenite sljedeću naredbu da biste omogućili 101377. Promijenite broj značajke kada aktivirate druge značajke: AS_CLI/System/ActivatableFeature> aktiviraj 101377

Ako su sve navedene zakrpe instalirane, a značajka koja se može aktivirati nije navedena za vaše određeno AS izdanje, to je zato što je već uključena u vaše osnovno izdanje AS i ne zahtijeva aktivaciju.

Pokrenite sljedeću CLI naredba na mrežnom poslužitelju:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled istina

Provjerite je li CA koji potpisuje vaš SBC certifikat naveden na Popisu pouzdanosti OS-a sobe. popis pouzdanih Room OS-a možete vidjeti iz Web portal uređaja . Na portalu odaberite Sigurnost > Collaboration Edge za pregled popisa CA.

Tijek uključivanja OS u sobu

Dovršite sljedeće zadatke kako biste konfigurirali svoj sustav za podršku ugradnje uređaja s aktivacijskim kodovima za sljedeće Webex Room OS uređaje:

Serija Webex ploča
Serija Webex Desk
Webex serija soba

1	Konfigurirajte usluge za OS sobe Konfigurirajte podršku za BroadWorks za uređaje Room OS.
2	OS uređaji u sobi za pružanje usluga Omogućite novi uređaj na BroadWorksu.
3	Zatražite aktivacijski kod U profilu uređaja zatražite aktivacijski kod. Kôd će automatski biti poslan primarnom korisniku.

Konfigurirajte usluge za OS sobe

Prije nego što možete ugraditi bilo koji novi Room OS uređaj, postavite sljedeće parametre na razini sustava da biste uključili OAuth autentifikaciju.

Podignite Zahtjev za uslugu kod svog agenta za onboarding ili kod Cisco TAC -a kako biste osigurali Cisco OAuth za svoj račun Cisco Identity Provider Federation. Naslov svog zahtjev za uslugom "ADP AuthService Configuration".

Ako ste već dobili vjerodajnice Cisco OAuth Identity Provider koristeći jedan od tokova u ovom dokumentu, nema potrebe za stvaranjem novog zahtjeva. Međutim, ako ste Cisco OAuth vjerodajnice dobili pomoću tijeka koji nije u ovom dokumentu, dovršite novi zahtjev za uslugom da ažurirate svoje vjerodajnice.

Cisco vam daje ID klijenta OAutha, tajnu klijenta i token za osvježavanje koji vrijedi 60 dana. Ako token istekne prije nego što ga upotrijebite sa svojim ADP-om, možete podići drugi zahtjev.

Omogućite OAuth pomoću ove CLI naredba:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> postavi omogući istinito

Provjerite uključuje li opseg OAuth broadworks-konektor-korisnik (opseg je zadano omogućeno). Pokrenite ovu naredbu da provjerite svoje opsege:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth/Scopes> dobiti

Konfigurirajte parametre Cisco Identity Provider koristeći donje CLI naredbe.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> postaviti omogućeno netočno

postavite clientId —pogledajte odgovor na zahtjev za uslugom za ID.
postaviti clientSecret —pogledajte odgovor na zahtjev za uslugom za tajnu.
postavite ime izdavatelja —pogledajte sljedeću tablicu za URL.
postavite issuerUrl —pogledajte sljedeću tablicu za URL.
postavite tokenInfoUrl <IdPProxy_ —pogledajte sljedeće tablice za URL.
postavite ciResponseBodyMaxSizeInBytes 65536

Tablica 1. Postavite izdavača i issuerURL
Ako je CI klaster...	Postavite issuerName i issuerURL na...
SAD-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ako ne znate svoje CI klaster , možete dobiti informacije iz podataka o korisniku u prikazu Help Desk Control Huba.

Tablica 2. Postavite tokenInfoURL
Ako je klaster Teams...	Postavite tokenInfoURL na... ( URL proxy IDP-a)
ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
Ako ne znate svoje Klaster timova , možete dobiti informacije iz podataka o korisniku u prikazu Help Desk Control Huba. Za testiranje, možete provjeriti je li tokenInfoURL valjan zamjenom " `idp/autentikacija` " dio URL -a s " `ping` ".

Konfigurirajte pružatelje identiteta za Cisco Federation koristeći sljedeće naredbe:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> dodajte FederationPartner refreshToken

Nova lozinka:

Ponovno upišite novu lozinku:

...Gotovo

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> dobiti

Token za osvježavanje imena partnera

==================================

FederationPartner ********

Pronađen je 1 unos.

ADP_ CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

postavite flsUrl https://cifls.webex.com/federation
postavite refreshPeriodInMinutes 60
postavite partnerName FederationPartner

Token za osvježavanje sada je u kontekstu CiscoIdentityProvider/Partners i partnerName iz konteksta CiscoIdentityProvider/Federation mora odgovarati partneru dodanom u kontekstu CiscoIdentityProvider/Partners.

Ako koristite ADP RI učitavanje starije od 2022.10, R23 XSP bez zakrpe AP.xsp.23.0.1075.ap383838 ili R22 XSP, tada:

Ne morate postavljati partnera pod 'System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>'
Token za osvježavanje mora biti postavljen pod: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

Izbrišite sve postojeće opsege unutar sljedeća tri konteksta pod ADP_ CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Opsegovi
Admin/Dopuštene uloge
Admin/opsezi dopušteni

Za svaki kontekst pokrenite a dobiti da dobijete postojeće opsege i zatim ih izbrišete. Na primjer:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Scopes> dobiti delete <name_of_scope_ 1> izbriši <name_of_scope_ 2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/RolesAllowed> dobiti delete <name_of_scope_ 1> izbriši <name_of_scope_ 2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/ScopesAllowed> dobiti delete <name_of_scope_ 1> izbriši <name_of_scope_ 2>

OS uređaji u sobi za pružanje usluga

Na BroadWorksu omogućite Room OS uređaj (Webex Board Series, Webex Desk Series ili Webex Room Series).

1	Na BroadWorks CommPilot provjerite Vrsta profila identiteta/uređaja konfiguraciju kako biste vidjeli postoji li vrsta uređaja za ovaj uređaj s sobnim OS-om. Ako vrsta uređaja ne postoji na BroadWorksu, uvezite vrsta uređaja u BroadWorks pomoću DTAF datoteke koju preuzimate s cisco.com.
2	Nakon što uvezete vrsta uređaja, provjerite postoje li sljedeće postavke unutar Vrsta profila identiteta/uređaja konfiguracija: Provjerite Dopusti ugradnju aktivacijskog koda potvrdni okvir Provjerite Pošaljite zahtjev za aktivacijski kod putem poslužitelja za Poruke potvrdni okvir. Postavi Način provjere autentičnosti da Nosilac .
3	Provjerite ima li datoteka profila uređaja SIP postavke koje želite koristiti. U Datoteka vrste identiteta/profila uređaja uvjerite se u to Način provjere autentičnosti je Nosilac .
4	Izradite profil uređaja s postavkama za svoj novi uređaj. U Dodaj/izmijeni identitet/profil uređaja stranicu, ostavite polje MAC adresa prazno.
5	Konfigurirajte primarnog korisnika. Na Korisnici Dodaj stranicu, označite ili poništite kvačicu jeMjesto prema tome namjeravate li uređaj biti osobni ili za zajednički radni prostor. Označeno—uređaj radnog prostora Neoznačeno – osobni uređaj Uređaji za dijeljeni radni prostor također zahtijevaju da dodijelite primarnog korisnika. Možete dodijeliti primarnog korisnika kojeg želite.
6	Dovršite opciju koja odgovara vrsti vrsta uređaja i načinu opskrbe koju želite koristiti: Uređaj je za zajednički radni prostor—Upotrijebite Omogućite radni prostor BroadWorks API za dovršetak pripreme za uređaj radnog prostora. Uređaj je osobni; koju želite omogućiti korištenjem javnih API-ja—Upotrijebite Omogućavanje API-ja za pretplatnike API da dovršite opskrbu za primarnog korisnika. Uređaj je osobni; želite da korisnici koriste samoaktivaciju—Proslijedite URL portala za aktivaciju korisnika korisniku. Korisnik mora potvrditi svoju adresa e-pošte kako bi dovršio dodjelu. Uređaj je osobni; želite koristiti dostavljanje protoka—idite na 7. korak.
7	Ako je uređaj za osobnu upotrebu, a želite koristiti protočnu opskrbu, tada za primarnog korisnika dodijelite Integrirani IM+P usluga. Na Korisnik > Profil stranicu, dodajte uslugu IM+P: Od Profil stranicu, kliknite Dodijelite usluge . Na popisu Dostupne usluge , odaberite Integrirani IM&P i strelicom premjestite stavku na Korisničke usluge kutija. Kliknite na U redu. Kliknite Profil . Samo pouzdani tijek e-pošte. Dodajte korisnika e-mail adresa. Ova postavka služi kao IM&P e-pošta za dostavljanje protoka za Webex za Cisco BroadWorks. To nije potrebno ako koristite nepouzdani tok e-pošte. Korisnički predložak na Webex mora biti konfiguriran s postavkama za protočnu opskrbu s pouzdanim ili nepouzdanim e-porukama. Za detalje pogledajte Vodič za rješenje za Webex za Cisco BroadWorks .

Što učiniti sljedeće

Zatražite aktivacijski kod za Room OS uređaj.

Zatražite aktivacijski kod

Nakon što se vaš uređaj i korisnik omogući na BroadWorksu, zatražite da se korisniku pošalje aktivacijski kod.

1	U Identitet/profil uređaja stranicu, potražite i otvorite profil uređaja za svoj novi uređaj.
2	Kliknite na Aktivacija uređaja tab.
3	Kliknite Zatražite aktivacijski kod .

Sustav generira aktivacijski kod i (pod uvjetom da ste ispravno konfigurirali sustav), sustav šalje aktivacijski kod primarnom korisniku e-poštom.

Što učiniti sljedeće

Dajte uređaj korisniku. Nakon što korisnik uključi uređaj, mora unijeti aktivacijski kod koji je poslan u e-mailu. Time će se uređaj ugraditi u Webex za Cisco BroadWorks.

MPP uključenje u Webex

Ovaj odjeljak opisuje ugradnju novih ili postojećih MPP uređaja na Webex za Cisco BroadWorks. Imajte na umu da se "postojeći" odnosi na MPP uređaj koji postoji na BroadWorksu, ali nema mogućnost Webex .

Ugradnja MPP uređaja (novi uređaji)

Tijekom onboardinga, administrator ažurira BroadWorks s podrškom za MPP, nadogradi firmver uređaja i daje uređaj na BroadWorks za dovršetak ugradnje.

Sljedeći dijagram pruža pregled procesa uključivanja nakon provjere valjanosti aktivacijskog koda koji korisnik unese.

Ugradnja MPP uređaja (postojeći uređaji)

Za postojeće MPP uređaje, gdje uređaj već postoji na BroadWorksu, ali nije uključen u Webex, ažurirajte BroadWorks i firmver uređaja kako biste podržali ugradnju MPP-a na Webex . Nakon ažuriranja, uređaj se automatski uključuje u Webex .

Više informacija

Za više informacija o ugradnji MPP uređaja na Webex pogledajte opis značajke Cisco BroadWorks DMS poboljšanja za Webex koja omogućuju MPP uređaje .

Preduvjeti za MPP uređaj

Minimalna MPP verzija

MPP firmware 11.3.7 minimalno

Zahtjevi BroadWorks zakrpa

Ova značajka je podržana od verzije 2021.11 ADP poslužitelja neovisnog o izdanju (RI) bez zahtjeva za zakrpu.

Za R22:

AP.as.22.0.1123.ap381367
AP.as.22.0.1123.ap382236
AP.nfm.22.0.1123.ap381367
AP.ns.22.0.1123.ap381367
AP.platforma.22.0.1123.ap381367
AP.platforma.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

Za R23:

AP.as.23.0.1075.ap381367
AP.as.23.0.1075.ap382236
AP.ns.23.0.1075.ap381367
AP.platform.23.0.1075.ap382198
AP.platform.23.0.1075.ap381367
AP.xsp.23.0.1075.ap381367
AP.xsp.23.0.1075.ap382198
AP.ps.23.0.1075.ap381367

Za R24:

AP.as.24.0.944.ap381367
AP.as.24.0.944.ap381951
AP.as.24.0.944.ap382236

Zahtjevi platforme BroadWorks

Ova je značajka dostupna na:

R22: dostupno samo na XSP-u
R23: dostupno na XSP ili ADP (neovisno o izdanju)
R24: dostupno na ADP-u (neovisno o izdanju)

Zahtjevi za konfiguraciju BroadWorksa

Za implementaciju ovog rješenja, Flowthrough provizija mora biti konfigurirana kako bi se omogućilo Broadworksu da dobavlja uređaje za Webex.

Prilikom konfiguriranja protočne provizije, nije obvezno koristiti protočnu dodelu za pružanje usluga korisnicima, tj. možete nastaviti koristiti svoje postojeće metode opskrbe (API, pouzdana/nepouzdana e- e-pošta, sam korisnik, itd.) za dostavljanje korisnika. Vidi "Zahtjevi za opskrbu" u Vodič za rješenje za Webex za Cisco BroadWorks .
Pobrinite se da Integrirani IM+P usluga je omogućena na BroadWorksu i upućuje na BroadWorks Provisioning Bridge.

URL za premošćivanje dodijeljen je kada je predložak korisnika primijenjen na organizaciju. To je trebalo biti dovršeno tijekom vašeg početnog postavljanja Webex za Cisco BroadWorks. Da biste pronašli postojeći URL u Partner Hubu, pogledajte Konfigurirajte poslužitelj aplikacija s URL -om usluge pružanja u Vodič za rješenje za Webex za Cisco BroadWorks .
Ako imate više partnerskih organizacija, potrebna vam je namjenska instanca usluge upravljanja uređajima (DMS) po partneru.

Certifikati i vatrozidi

Provjerite jeste li konfigurirali sljedeće:

Zahtjevi certifikata—MPP uređaji koriste mTLS provjeru autentičnosti pomoću certifikata uređaja. MAC adresa uređaja, koju daje certifikat, provjerava autentičnost uređaja. Preuzmite potrebne certifikate za svoj MPP uređaj shttps://www.cisco.com/security/pki/ .

Prenesite svoje certifikate kako biste uspostavili povjerenje na ADP ili vatrozid. Na primjer, ako prenosite u ADP, upotrijebite ovu naredbu:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
Zahtjevi vatrozida—Ako se ADP nalazi iza vatrozida, vaš vatrozid mora biti konfiguriran s pravilom za izdvajanje MAC adresa iz certifikata uređaja i postavljanje u zaglavlje za provjeru autentičnosti koje se zatim prosljeđuje ADP-u. Na primjer, obrazac identiteta .*([0-9a-fA-F]{12} ).* može se koristiti za izdvajanje MAC adresa, koja se zatim može staviti u zaglavlje koje koristi opisni naziv (na primjer, maaddress ).

Ako ADP nije iza vatrozida, prethodni zahtjev ne postoji.

Aktivacija značajke

Aktivirajte sljedeće značajke BroadWorksa na AS-u:

101377 Poboljšanja za ugradnju Webex i MPP uređaja
25088 Podrška slušalicama za DECT uređaje
23775 Daljinsko resetiranje za MPP uređaje
24104 Podrška za višećelijsko ulančavanje za DECT uređaje
20077 Poboljšanja upravljanja uređajima
19559 Poboljšanja upravljanja vizualnim uređajima
02283 Poboljšanja prilagodbe vrste profila uređaja

Na primjer, pokrenite sljedeću naredbu da omogućite 101377. Promijenite broj značajke kada aktivirate druge značajke: AS_CLI/System/ActivatableFeature> aktiviraj 101377

Pokrenite sljedeći CLI na mrežnom poslužitelju:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled istina

Zahtjevi za aktivacijski kod

Neobavezno Aktivacijski kodovi nisu obvezni za ugradnju MPP uređaja. Međutim, ako želite koristiti aktivacijske kodove, pogledajte Zatražite aktivacijski kod za MPP za dodatne zahtjeve koji su specifični za aktivacijske kodove s MPP-om.

Tijek uključivanja MPP uređaja

Dovršite sljedeće zadatke kako biste konfigurirali svoj sustav da podržava ugradnju MPP uređaja na Webex za Cisco BroadWorks.

Ako dodajete mogućnost Webex na MPP uređaj koji već postoji na BroadWorksu, dovršite samo korake 1 i 2.

1	Konfigurirajte usluge za MPP (Novi ili postojeći MPP uređaji). Konfigurirajte podršku sustava za MPP na Webex za Cisco BroadWorks.
2	Nadogradite firmver MPP uređaja (Postojeći MPP uređaji). Za sve postojeće MPP uređaje za koje želite dodati mogućnost Webex , nadogradite na najnoviji firmware uređaja.
3	Opskrba MPP uređaja (Samo novi MPP uređaji). Ako uređaj ne postoji na BroadWorksu, omogućite uređaj i primarnog korisnika na BroadWorksu.
4	Zatražite aktivacijski kod za MPP (Neobavezno). Ako želite koristiti aktivacijske kodove za ugrađene MPP uređaje, zatražite aktivacijski kod.

Konfigurirajte usluge za MPP

Ažurirajte svoje postavke postavke sustava BroadWorks kako biste podržali MPP uređaje (nove ili postojeće) na Webex za Cisco BroadWorks. Dovršite ovaj korak samo jednom. Ne morate ponavljati ovaj postupak za svaki MPP uređaj.

Prije početka

Ako se ADP nalazi iza vatrozida, vaš vatrozid mora biti konfiguriran s pravilom za izdvajanje MAC adresa iz certifikata uređaja i postavljanje u zaglavlje za provjeru autentičnosti koje se zatim prosljeđuje ADP-u. Na primjer, obrazac identiteta .*([0-9a-fA-F]{12} ).* može se koristiti za izdvajanje MAC adresa, koja se zatim može staviti u zaglavlje koje koristi opisni naziv (na primjer, maaddress ).

Za pomoć s konfiguracijama pogledajte dokumentaciju vašeg vatrozida.

Podignite Zahtjev za uslugu kod svog agenta za onboarding ili kod Cisco TAC -a kako biste osigurali Cisco OAuth za svoj račun Cisco Identity Provider Federation. Koristite "ADP AuthService Configuration" da naslovite svoj zahtjev.

Cisco vam daje ID klijenta OAutha, tajnu klijenta i token za osvježavanje koji vrijedi 60 dana. Ako token istekne prije nego što ga upotrijebite sa svojim ADP-om, možete podići drugi zahtjev.

Konfigurirajte parametre Cisco Identity Provider izvođenjem sljedećih CLI naredbi.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> postaviti omogućeno netočno

postavite clientId —pogledajte odgovor na zahtjev za uslugom za ID.
postaviti clientSecret —pogledajte odgovor na zahtjev za uslugom za tajnu.
postavite ime izdavatelja —pogledajte sljedeću tablicu za URL.
postavite issuerUrl —pogledajte sljedeću tablicu za URL.
postavite ciResponseBodyMaxSizeInBytes 65536

Tablica 3. Postavite izdavača i issuerURL
Ako je CI klaster...	Postavite issuerName i issuerURL na...
SAD-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Ako ne znate svoje CI klaster , možete dobiti informacije iz podataka o korisniku u prikazu Help Desk Control Huba.

Postavite url DM Bridgea koristeći donju CLI naredba. URL DM Bridgea razlikuje se za svaki Teams klaster (koji ste izvukli u 2. koraku).

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> postavite url = <url_of_ DM_ Bridge> opseg = dm-bridge:device_auth

Stol 4. DM_ URL za premošćivanje
Ako je klaster Teams...	Postavi DM_ Premotavanje URL -a na...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
AFRA	dm-bridge-k.wbx2.com

Omogućite ekstrakciju MAC adresa i provjeru autentičnosti pomoću zaglavlja za provjeru autentičnosti ili certifikata za provjeru autentičnosti. Iz sigurnosnih razloga preporučamo da koristite samo jednu od opcija:

Zaglavlje provjere autentičnosti—ako se ADP nalazi iza vatrozida, upotrijebite CLI na ADP-u da omogućite ekstrakciju MAC adresa za zaglavlje provjere autentičnosti. Ova konfiguracija daje ADP-u mogućnost prepoznavanja MAC adresa iz zaglavlja Authentication. Na primjer:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> postavi omogući istinito

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> set identityPattern "macaddress:.*([0-9a-fA-F]{12} ).*"

U ovom primjeru, maaddress je dodijeljeno ime sa .*([0-9a-fA-F]{12} ).* predstavlja uzorak koji se dodjeljuje zaglavlju. Ako zaglavlje nazovete drugačije od maaddress , prilagodite svoj CLI u skladu s tim.
Certifikat za provjeru autentičnosti—ako ADP nije iza vatrozida, do provjere autentičnosti dolazi izravno između uređaja i ADP-a. Upotrijebite sljedeće CLI naredbe da omogućite ekstrakciju MAC adresa na certifikatu uređaja za provjeru autentičnosti:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> postavi omogući istinito

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> postavi uzorak identiteta ".*([0-9a-fA-F]{12} ).*"

Nadogradite firmver MPP uređaja

Prije početka

Provjerite je li BroadWorks ažuriran servisnom podrškom za MPP.

Nadogradite firmver uređaja na najnoviju verziju kako biste osigurali da MPP uređaj podržava mogućnost Webex .

Za više informacija o nadogradnjama firmvera, pogledajte Napomene o izdanju za izdanje firmvera vašeg modela telefona.

Što učiniti sljedeće

Postojeći MPP uređaji—nakon nadogradnje, uređaj se automatski uključuje na Webex . Korisnik može početi koristiti Webex usluge na uređaju.
Novi MPP uređaji—Omogućite novi MPP uređaj na BroadWorksu.

Opskrba MPP uređaja

Ako novi MPP uređaj ne postoji na BroadWorksu, omogućite uređaj na BroadWorksu.

1	Na BroadWorks CommPilot provjerite Vrsta profila identiteta/uređaja konfiguraciju kako biste vidjeli postoji li vrsta uređaja za ovaj MPP uređaj. Ako vrsta uređaja ne postoji na BroadWorksu, uvezite vrsta uređaja u BroadWorks pomoću DTAF datoteke koja se preuzima s cisco.com.
2	Na BroadWorks CommPilot otvorite Vrsta profila identiteta/uređaja i provjerite Dopusti ugradnju aktivacijskog koda potvrdni okvir.
3	Napravite Vrsta profila identiteta/uređaja Datoteka sa SIP postavkama koje želite koristiti.
4	Napravite Identitet/profil uređaja s postavkama za vaš novi uređaj. U MAC adresa polje, unesite MAC adresa uređaja. Ako koristite aktivacijske kodove za ugrađene MPP uređaje, ostavite MAC adresa polje prazno.
5	Konfigurirajte primarnog korisnika. Na Korisnici Dodaj stranicu, postavite jeMjesto potvrdni okvir prema tome je li uređaj osobni ili za zajednički radni prostor: Označeno—uređaj radnog prostora Neoznačeno – osobni uređaj
6	Dovršite opciju koja odgovara vrsti vrsta uređaja i načinu opskrbe koju želite koristiti: Uređaj je za zajednički radni prostor—Upotrijebite Omogućite radni prostor BroadWorks API za dovršetak pripreme za uređaj radnog prostora. Uređaj je osobni; koju želite omogućiti korištenjem javnih API-ja—Upotrijebite Omogućavanje API-ja za pretplatnike API da dovršite opskrbu za primarnog korisnika. Uređaj je osobni; želite da korisnici koriste samoaktivaciju—Proslijedite URL portala za aktivaciju korisnika korisniku. Korisnik mora potvrditi svoju adresa e-pošte kako bi dovršio dodjelu. Uređaj je osobni; želite koristiti dostavljanje protoka—idite na 7. korak.
7	Ako je uređaj za osobnu upotrebu, a želite koristiti protočnu opskrbu, tada za primarnog korisnika dodijelite Integrirani IM+P usluga. Na Korisnik > Profil stranicu, dodajte uslugu IM+P: Od Profil stranicu, kliknite Dodijelite usluge . Na popisu Dostupne usluge , odaberite Integrirani IM&P i strelicom premjestite stavku na Korisničke usluge kutija. Kliknite na U redu. Kliknite Profil . Samo pouzdani tijek e-pošte. Dodajte korisnika e-mail adresa. Ova postavka služi kao IM&P e-pošta za dostavljanje protoka za Webex za Cisco BroadWorks. To nije potrebno ako koristite nepouzdani tok e-pošte. Korisnički predložak na Webex mora biti konfiguriran s postavkama za protočnu opskrbu s pouzdanim ili nepouzdanim e-porukama. Za detalje pogledajte Vodič za rješenje za Webex za Cisco BroadWorks .

Što učiniti sljedeće

Neobavezno Ako želite koristiti aktivacijske kodove za ugrađene MPP uređaje, zatražite aktivacijski kod na BroadWorksu.

Zatražite aktivacijski kod za MPP

(Izborno) Webex za Cisco BroadWorks ne zahtijeva aktivacijske kodove za ugrađene nove MPP uređaje. Međutim, ako odlučite koristiti aktivacijske kodove, ispunite Zatražite aktivacijski kod postupak za traženje aktivacijskog koda za novi uređaj.

Preduvjeti za korištenje aktivacijskih kodova s MPP uređajima

Ako koristite ugradnju aktivacijskog koda za MPP uređaje, provjerite zadovoljava li vaš sustav sljedeće zahtjeve specifične za aktivacijski kod.

Usluga aktivacije uređaja — Ispunite sljedeće zahtjeve kako biste omogućili uslugu aktivacije uređaja:

Postavite uslugu aktivacije uređaja na BroadWorks. Za detalje pogledajte Cisco BroadWorks Secure Onboarding koristeći aktivacijske kodove .
Usmjerite uslugu aktivacije uređaja (DAS) na usluge upravljanja uređajima (DMS) na BroadWorks AS pomoću sljedeće CLI naredba:

AS_CLI/Interface/DAS> postavite url <url_of_ DMS>
Provjerite je li postavka DAS URL -a za klaster BroadWorks postavljena na URL usluge upravljanja uređajima (DMS). Da biste vidjeli trenutnu postavku URL -a DAS-a u Partner Hubu, idite na Postavke > BroadWorks poziva > Prikaz klastera i odaberite odgovarajući klaster. URL se pojavljuje ispod Postavke sučelja .

Cisco Global Discovery Services (GDS) —GDS je potreban kako bi se osigurao aktivacijski kod. Omogućite GDS na BroadWorksu dovršavanjem oba koraka u nastavku:

Izradite zahtjev za uslugom da biste omogućili svoj GDS račun. Cisco vam daje ID klijenta, tajnu klijenta, token za osvježavanje i GDS domenu.

Nakon što se vaš GDS račun omogući, omogućite GDS na ADP-u koristeći sljedeći CLI:

ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> dobiti set gdsDomain <gds_domain_from zahtjev za uslugom> npr https://activation.webex.com postavite clientId <id_from_service_request > clientSecret <secret_from_service_request > refreshToken <token_from_service_request >

Osim gore navedenih preduvjeta specifičnih za aktivacijski kod, vaš sustav mora ispunjavati opće preduvjete MPP-a u Preduvjeti za MPP uređaj .

Zatražite aktivacijski kod

Dovršite sljedeće korake kako biste zatražili aktivacijski kod za novi MPP uređaj.

U Identitet/profil uređaja stranicu, potražite i otvorite profil uređaja za svoj novi uređaj.
Kliknite na Aktivacija uređaja tab.
Kliknite Zatražite aktivacijski kod .

Sustav generira aktivacijski kod i šalje ga e-poštom primarnom korisniku. Korisnik mora unijeti kod na uređaju kako bi dovršio onboarding.

Pregled uslužnosti

Control Hub sadrži opcije uslužnosti koje administratorima omogućuju pregled statusa uređaja, zajedno sa skupom opcija održavanja. Administratori mogu:

Pogledajte trenutni status uređaja
Ponovno pokrenite uređaj daljinski
Pošaljite izvješće o problemu za rješavanje problema
Izbrišite uređaj

Pregledajte status uređaja

Koristite ovaj postupak za prikaz izvješća o statusu uređaja iz Control Huba. Status uključuje pojedinosti kao što su status registracije, MAC adresa, SIP adresa, IP adresa i serijski broj.

1	Prijavite se na instancu Control Huba za organizaciju korisnika.
2	Kliknite Uređaji.
3	Kliknite odgovarajući uređaj.

Ponovno pokrenite uređaj

Koristite ovaj postupak za ponovno pokretanje uređaja iz sučelja Control Hub-a.

1	Prijavite se na instancu Control Huba za organizaciju korisnika.
2	Kliknite Uređaji.
3	Odaberite uređaj.
4	Od Radnje padajući izbornik, odaberite Ponovno pokretanje .

Prijavi problem

Ako naiđete na probleme s uređajem, koristite ovaj postupak za slanje izvješća o problemu Cisco TAC -u radi rješavanja problema.

1	Prijavite se na instancu Control Huba za organizaciju korisnika.
2	Kliknite Uređaji.
3	Kliknite odgovarajući uređaj.
4	Od Radnje , odaberite Prijavite problem .
5	Pregledajte sažetak izvješća.

Izbriši uređaj

Koristite ovaj postupak za brisanje uređaja iz Control Huba.

1	Prijavite se na instancu Control Huba za organizaciju korisnika.
2	Kliknite Uređaji.
3	Odaberite odgovarajući uređaj.
4	Od Radnje padajući izbornik, odaberite Izbriši .

Promijenite vlasnika uređaja

Upotrijebite ovaj postupak za premještanje postojećeg uređaja koji je ugrađen pomoću aktivacijskih kodova na novog vlasnika uređaja.

Ovaj postupak pretpostavlja da je Dopusti ugradnju aktivacijskog koda opcija je omogućena za Identitet/profil uređaja koju ovaj uređaj koristi.

Izbrišite postojeću registraciju uređaja s Webex:

U Webex Control Hubu otvorite korisničku organizaciju kojoj pripada trenutni vlasnik uređaja.
Ispod Upravljanje , kliknite Uređaji .
Označite potvrdni okvir koji se nalazi uz uređaj koji želite premjestiti.
Kliknite Izbriši.

Registracija uređaja briše se iz Webex.

Na BroadWorksu deaktivirajte registraciju uređaja pod postojećim korisnikom:

Na BroadWorks CommPilot otvorite Identitet/profil uređaja koje uređaj koristi.
Kliknite na Aktivacija uređaja tab.
Kliknite Deaktivirajte uređaj .

Uređaj se deaktivira i odjavljuje s BroadWorksa. MAC adresa se briše sa stare Identitet/profil uređaja konfiguraciju.

Na BroadWorksu aktivirajte uređaj pomoću aktivacijskog koda drugog Identitet/profil uređaja koristi drugi korisnik:

Na BroadWorks CommPilot otvorite drugi Identitet/profil uređaja konfiguraciju za drugog korisnika.
Uvjerite se u to Dopusti ugradnju aktivacijskog koda provjerava se za Vrsta profila identiteta/uređaja koji se koristi.
U Identitet/profil uređaja prozoru, kliknite na Aktivacija uređaja tab.
Kliknite Zatražite aktivacijski kod .

Prikazuje se novi aktivacijski kod. Novi korisnik mora unijeti ovaj kod kako bi se uključio u uređaj.

Što učiniti sljedeće

Novi vlasnik uređaja upisuje aktivacijski kod na uređaju.
Uređaj se ponovno registrira na Webex i BroadWorks koristeći novu konfiguraciju. Novi Identitet/profil uređaja na BroadWorksu se automatski ažurira s MAC adresa uređaja.

Praćenje performansi

Za ovu značajku postoje sljedeći brojači performansi.

Brojač	Opis
Modul: enterprises.broadsoft.broadworks.deviceActivation.activate
bwDASActivateRequests	Broj ukupnog broja primljenih zahtjeva za aktivaciju. To uključuje aktiviranje zahtjeva za BroadWorks i aktiviranje zahtjeva Webex .
bwDASActivateFailures	Ukupan broj zahtjeva za aktivaciju koji se nisu uspjeli uspješno dovršiti. To uključuje zahtjeve za aktivaciju BroadWorksa koji nisu uspjeli i aktiviranje zahtjeva Webex koji nisu uspjeli.
bwDASActivateBroadWorksRequests	Broj primljenih zahtjeva za aktivaciju BroadWorksa.
bwDASActivateBroadWorksFailures	Broj zahtjeva za aktivaciju BroadWorksa koji nisu uspješno dovršeni. Ovaj brojač ne uzima u obzir neuspjehe autorizacije i provjere autentičnosti.
bwDASActivateWebexRequests	Broj primljenih zahtjeva za aktivaciju Webex .
bwDASActivateWebexFailures	Broj zahtjeva za aktivaciju Webex koji nisu uspješno dovršeni.
Modul: enterprises.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Broj poslanih DMBridge zahtjeva.
bwDMBridgeFailures	Broj DMBridge zahtjeva koji se nisu uspjeli uspješno dovršiti.

Vodič za integraciju uređaja za Webex za Cisco BroadWorks

Uvod

O ovom vodiču

Povijest promjena dokumenta

Integracija uređaja za Webex za Cisco BroadWorks

Pregled ugradnje uređaja

Uključivanje OS u sobu

Uključivanje uređaja s aktivacijskim kodovima

Proces ugradnje za Room OS

Autentifikacija uređaja (putem tokena nositelja OAuth)

Preduvjeti za OS sobe

Minimalna verzija sobnog OS-a

Zahtjevi BroadWorks zakrpa

Zahtjevi platforme BroadWorks

Zahtjevi za konfiguraciju BroadWorksa

Preduvjeti za ugradnju aktivacijskog koda s OS-om sobe

Tijek uključivanja OS u sobu

Konfigurirajte usluge za OS sobe

OS uređaji u sobi za pružanje usluga

Zatražite aktivacijski kod

MPP uključenje u Webex

Ugradnja MPP uređaja (novi uređaji)

Ugradnja MPP uređaja (postojeći uređaji)

Više informacija

Preduvjeti za MPP uređaj

Minimalna MPP verzija

Zahtjevi BroadWorks zakrpa

Zahtjevi platforme BroadWorks

Zahtjevi za konfiguraciju BroadWorksa

Certifikati i vatrozidi

Aktivacija značajke

Zahtjevi za aktivacijski kod

Tijek uključivanja MPP uređaja

Konfigurirajte usluge za MPP

Nadogradite firmver MPP uređaja

Opskrba MPP uređaja

Zatražite aktivacijski kod za MPP

Preduvjeti za korištenje aktivacijskih kodova s MPP uređajima

Zatražite aktivacijski kod

Mogućnost servisiranja uređaja

Pregled uslužnosti

Pregledajte status uređaja

Ponovno pokrenite uređaj

Prijavi problem

Izbriši uređaj

Promijenite vlasnika uređaja

Praćenje performansi

Značajke krajnjeg korisnika za Webex integrirane uređaje

Povijest objedinjenih poziva

MPP telefoni svjesni Webex

Webex za BroadWorks integrirani RoomOS uređaji

Poboljšanja pretraživanja imenika za Webex za BroadWorks integrirane RoomOS uređaje

Malo poslovanje

Poduzeće

Uređaji

Rješenja za

Resursi

Tvrtka