Priročnik za integracijo naprav za Webex za Cisco BroadWorks

Datum	Različica dokumenta	Opis spremembe
12. maj 2023	1.7	Dodano Webex za integrirane naprave Cisco RoomOS BroadWorks in Izboljšave iskanja po imeniku za naprave W4B Integrated RoomOS Spodaj Funkcije za končnega uporabnika za razdelek integriranih naprav Webex.
27. februar 2023	1.6	Posodobljeno Konfigurirajte storitve za Room OS koraki pod Vključevanje naprave.
17. februar 2023	1.5	Dodano Poenotena zgodovina klicev za telefone MPP, ki podpirajo Webex razdelek pod Funkcije za končnega uporabnika za integrirane naprave Webex.
14. oktober 2022	1.4	Posodobljen postopek vkrcanja za Room OS Spodaj Uvajanje OS v sobi razdelek za vključitev zapisov SRV. Posodobljeno Konfiguracijske zahteve BroadWorks Spodaj Predpogoji za operacijski sistem sobe razdelek s kazalcem na vodnik po rešitvah za zahteve po zagotavljanju pretoka.
20. junij 2022	1.3	Posodobljeno Predpogoji za operacijski sistem sobe in Predpogoji za napravo MPP s kazalcem na vodnik po rešitvah za zahteve po zagotavljanju pretoka. Posodobljeno Naprave operacijskega sistema sobe za zagotavljanje in Zagotavljanje MPP naprave za vključitev informacij za različne načine zagotavljanja.
3. junij 2022	1.2	Popravljena aktivacijska številka funkcije vrste profila naprave (02283) v Predpogoji za operacijski sistem sobe in Predpogoji za napravo MPP
27. maj 2022	1.1	Popravljena zahteva za namensko instanco DMS na partnersko organizacijo. Dodano Predgovor odsek. Posodobljen naslov kot "Vodnik za integracijo naprave".
20. maj 2022	1.0	Začetna objava

Pregled namestitve naprave

V tem poglavju je opisano, kako vkrcati naprave v Webex za Cisco BroadWorks. To poglavje zajema naslednje primere uporabe:

Vgrajene nove naprave Webex Room OS (z uporabo aktivacijskih kod)
Vgrajene nove MPP naprave
Dodajte zmogljivost Webex obstoječim napravam MPP

Priporočamo, da to funkcijo uvedete na strežnikih ADP, neodvisnih od izdaje. Vendar XSP podpira tudi to funkcijo. Če uporabljate XSP, lahko tam, kjer se ta dokument nanaša na »ADP«, nadomestite »XSP«, razen če besedilo določa samo ADP.
Ta funkcija podpira naprave Personal in Workspace.

Uvajanje OS v sobi

Webex za Cisco BroadWorks podpira vkrcanje aktivacijske kode tako za naprave OS v skupni rabi kot za naprave z delovnim prostorom.

Vključevanje naprave z aktivacijskimi kodami

Device Onboarding z aktivacijskimi kodami omogoča preprost in varen način za vključitev naprav Room OS. Aktivacijska koda je 16-mestna enkratna sistemsko ustvarjena koda, ki jo mora uporabnik vnesti v napravo, da jo vključi v napravo. Aktivacijska koda je varno povezana s predvidenim uporabniškim računom in zagotavlja, da samo predvideni uporabnik vkrca napravo, povezano z istim računom. Ko uporabnik vnese pravilno kodo, se naprava poveže z Webexom in BroadWorksom, dokonča registracijo, prenese konfiguracijsko datoteko in je pripravljena za uporabo.

Naslednje naprave Room OS podpirajo vključitev z aktivacijskimi kodami:

Webex Board Series (Sobni OS)
Webex Desk Series (Sobni OS)
Webex Room Series (Sobni OS)

Postopek vkrcanja za Room OS

Naslednji postopek prikazuje, kaj se zgodi, ko se naprava Room OS vključi z uporabo aktivacijskih kod:

Skrbnik partnerja zagotovi primarnega uporabnika in napravo v BroadWorks in nato ustvari aktivacijsko kodo v BroadWorks.
E-poštno sporočilo, ki vsebuje aktivacijsko kodo naprave, se pošlje lastniku naprave.
Lastnik naprave zažene napravo.
Naprava pozove lastnika naprave, da vnese aktivacijsko kodo.
Lastnik naprave v napravo vnese aktivacijsko kodo.
Naprava se vključi v BroadWorks in Webex z naslednjim podprocesom:
- Naprava Room OS pošlje zahtevo za aktivacijo storitvam Webex. Aktivacijsko kodo potrdi GDS in če je koda pravilna, se naprava vključi v Webex. Webex napravi vrne strojni žeton.
- Naprava pošlje zahtevo za aktivacijo BroadWorks DM skupaj z žetonom naprave in naslovom MAC.
- BroadWorks avtorizira in vključi napravo.
- Naprava pošlje BroadWorks DM zahtevo za posodobljeno konfiguracijo. Strojni žeton je vključen za avtorizacijo.
- BroadWorks avtorizira žeton, poišče posodobljeno konfiguracijsko datoteko in vrne posodobljeno konfiguracijsko datoteko.
- Room OS bo poskušal poiskati zapis NAPTR za domeno, navedeno v konfiguracijski datoteki, saj pričakuje, da bo našel vnos SRV za _sip._tls.<domain_in_config> če zapis NAPTR ni prisoten, bo RoomOS nato poskusil poiskati zapis SRV, ki mu sledi zapis A.
  
  Zapis SRV mora biti _sip._tls. saj bo roomOS podpiral samo TLS za transport in SRTP za medije.
Naprava se registrira in je pripravljena za uporabo.

Naslednji diagram ponuja poenostavljen pregled postopka vkrcanja.

Za podrobne informacije o vključitvi v sistem Room OS, vključno s podrobnejšimi diagrami poteka, glejte opis funkcije Izboljšave Cisco BroadWorks za Webex-Aware Device Onboarding.

Preverjanje pristnosti naprave (prek nosilnih žetonov OAuth)

Preverjanje pristnosti naprav za naprave Room OS zahteva, da omogočite nosilne žetone Cisco OAuth na BroadWorks. Med vkrcanjem se žeton nosilca posreduje prek glave Activate Authorization in služi za identifikacijo naprave. IdP potrdi nosilni žeton in vrne UUID (strojni UUID za naprave delovnega prostora ali uporabniški UUID za osebne naprave) kot nosilec. BroadWorks shrani UUID kot ime naprave v omrežnem strežniku.

Predpogoji za operacijski sistem sobe

Minimalna različica operacijskega sistema Room

Soba OS 10,13 najmanj

Zahteve za popravke BroadWorks

Ta funkcija je podprta od različice 2021.11 strežnika ADP Release Independent (RI) brez zahtev za popravke.

Za strežnike, ki niso RI, morate imeti nameščene naslednje popravke (iz skupin popravkov ap381367, ap381951, ap382198), da lahko uporabite funkcijo. Namestite popravke, ki veljajo za vašo izdajo:

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.platforma.23.0.1075.ap382198
AP.platforma.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

Zahteve za platformo BroadWorks

Ta funkcija je na voljo na:

R22: na voljo samo na XSP
R23: na voljo na XSP ali ADP (neodvisno od izdaje)
R24: na voljo na ADP (Release Independent)

Konfiguracijske zahteve BroadWorks

Za implementacijo te rešitve mora biti oskrba Flowthrough konfigurirana tako, da Broadworksu omogoči oskrbo naprav za Webex.

Med konfiguriranjem pretočne oskrbe ni obvezna uporaba pretočne oskrbe za oskrbo uporabnikov, tj. lahko še naprej uporabljate obstoječe oskrbovalne metode (API, zaupanja vredna/nezaupanja vredna e-pošta, sam uporabnik itd.) za oskrbo uporabnikov. Glejte "Zahteve za zagotavljanje" v Vodnik po rešitvah Webex za Cisco BroadWorks.

Prepričajte se, da je Integrirano IM+P storitev je omogočena na BroadWorks in kaže na BroadWorks Provisioning Bridge.

URL mosta za zagotavljanje je bil dodeljen, ko je bila predloga stranke uporabljena za organizacijo. To bi morali dokončati med prvotno nastavitvijo Webex za Cisco BroadWorks. Če želite najti obstoječi URL v središču za partnerje, glejte Konfigurirajte aplikacijski strežnik z URL-jem storitve zagotavljanja v Vodnik po rešitvah Webex za Cisco BroadWorks.
Če imate več partnerskih organizacij, potrebujete namenski primerek storitve upravljanja naprav (DMS) za vsakega partnerja.

Predpogoji za vključitev aktivacijske kode v sistem Room OS

Prepričajte se, da je nastavljeno naslednje:

Razmestite storitev aktiviranja naprave na BroadWorks. Za podrobnosti glejte Cisco BroadWorks Secure Onboarding z uporabo aktivacijskih kod.
Preverite, ali je nastavitev URL-ja DAS za gručo BroadWorks nastavljena na URL storitev upravljanja naprav (DMS). Če si želite ogledati trenutno nastavitev URL-ja DAS v Partner Hubu, pojdite na nastavitve > BroadWorks Calling > Ogled grozdov in izberite ustrezno gručo. URL je prikazan pod Nastavitve vmesnika.

V AS morajo biti aktivirane naslednje funkcije BroadWorks:

101377 Izboljšave za vkrcanje naprav Webex in MPP
25088 Podporne slušalke za naprave DECT
24104 Podpira večcelično veriženje za naprave DECT
20077 Izboljšave upravljanja naprav
19559 Izboljšave upravljanja vizualnih naprav
02283 Izboljšave prilagajanja vrste profila naprave

Na primer, zaženite naslednji ukaz, da omogočite 101377. Spremenite številko funkcije, ko aktivirate druge funkcije: AS_CLI/System/ActivatableFeature> activate 101377

Če so nameščeni vsi navedeni popravki in funkcija, ki jo je mogoče aktivirati, ni navedena za vašo izdajo AS, je to zato, ker je že vključena v vašo osnovno izdajo AS in ne zahteva aktivacije.

Zaženite naslednji ukaz CLI na omrežnem strežniku:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Prepričajte se, da je CA, ki podpisuje vaše potrdilo SBC, navedena na seznamu zaupanja v OS Room. Seznam zaupanja vrednega operacijskega sistema Room OS si lahko ogledate na Spletni portal naprave. Na portalu izberite Varnost > Rob sodelovanja za ogled seznama CA.

Tok vkrcanja v sistem Room OS

Izvedite naslednje naloge, da konfigurirate svoj sistem za podporo Device Onboarding z aktivacijskimi kodami za naslednje naprave Webex Room OS:

Serija plošč Webex
Serija pisalnih miz Webex
Serija sob Webex

1	Konfigurirajte storitve za Room OS Konfigurirajte podporo BroadWorks za naprave Room OS.
2	Naprave operacijskega sistema sobe za zagotavljanje Zagotovite novo napravo na BroadWorks.
3	Zahtevaj aktivacijsko kodo V profilu naprave zahtevajte aktivacijsko kodo. Koda bo samodejno poslana po e-pošti primarnemu uporabniku.

Konfigurirajte storitve za Room OS

Preden lahko vključite katero koli novo napravo Room OS, nastavite naslednje parametre sistemske ravni, da vklopite preverjanje pristnosti OAuth.

Vložite zahtevo za storitev pri svojem agentu za vkrcanje ali pri Cisco TAC za zagotavljanje Cisco OAuth za vaš račun Cisco Identity Provider Federation. Zahtevo po storitvi poimenujte »Konfiguracija ADP AuthService«.

Če ste poverilnice ponudnika identitete Cisco OAuth že pridobili z enim od tokov v tem dokumentu, vam ni treba ustvariti nove zahteve. Če pa ste pridobili poverilnice Cisco OAuth s tokom, ki ni v tem dokumentu, izpolnite novo zahtevo za storitev, da posodobite svoje poverilnice.

Cisco vam da ID odjemalca OAuth, skrivnost odjemalca in žeton za osvežitev, ki velja 60 dni. Če žeton poteče, preden ga uporabite s svojim ADP, lahko vložite novo zahtevo.

Omogočite OAuth s tem ukazom CLI:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/OAuth> set enable true

Prepričajte se, da obseg OAuth vključuje broadworks-connector-user (obseg je privzeto omogočen). Zaženite ta ukaz, da preverite svoje obsege:

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

Konfigurirajte parametre Cisco Identity Provider z uporabo spodnjih ukazov CLI.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> set enabled false

set clientId <clientId> — glejte odgovor na zahtevo za storitev za ID.
set clientSecret <clientSecret> —glejte odgovor na zahtevo storitve za skrivnost.
set issuerName <URL> — glejte naslednjo tabelo za URL.
set issuerUrl <URL> — glejte naslednjo tabelo za URL.
set tokenInfoUrl <IdPProxy_URL> —glejte naslednje tabele za URL.
set ciResponseBodyMaxSizeInBytes 65536

Tabela 1. Nastavite ime izdajatelja in URL izdajatelja

Če je CI Cluster ...

Nastavite ime izdajatelja in URL izdajatelja na ...

ZDA-A

https://idbroker.webex.com/idb

https://idbroker-eu.webex.com/idb

US-B

https://idbroker-b-us.webex.com/idb

Če ne poznate svojega Grozd CI, lahko pridobite informacije iz podrobnosti o stranki v pogledu službe za pomoč uporabnikom Control Huba.

Če je Teams Cluster ... Nastavi tokenInfoURL na ... (URL proxy IdP)

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

Če ne poznate svojega Grozd ekip, lahko pridobite informacije iz podrobnosti o stranki v pogledu službe za pomoč uporabnikom Control Huba.
Za testiranje lahko preverite, ali je tokenInfoURL veljaven, tako da zamenjate " idp/authenticate" del URL-ja z " ping".

Konfigurirajte ponudnike identitete za Cisco Federation z naslednjimi ukazi:

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

New Password: <token from service request>

Re-type New Password: <token from service request>

...Done

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

Partner Name Refresh Token

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

FederationPartner ********

1 entry found.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

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

Osveževalni žeton je zdaj v kontekstu CiscoIdentityProvider/Partners in partnerName iz konteksta CiscoIdentityProvider/Federation se mora ujemati s partnerjem, dodanim v kontekstu CiscoIdentityProvider/Partners.

Če uporabljate nalaganje ADP RI, starejše od 2022.10, R23 XSP brez popravka AP.xsp.23.0.1075.ap383838 ali R22 XSP, potem:

Ni vam treba nastaviti partnerja pod 'System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>'
Žeton za osvežitev mora biti nastavljen pod: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

Počisti vse obstoječe obsege v naslednjih treh kontekstih pod ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Scopes
Admin/RolesAllowed
Admin/ScopesAllowed

Za vsak kontekst zaženite a get da pridobite obstoječe obsege in jih nato izbrišete. Na primer:

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Scopes> get
   delete <name_of_scope_1>
   delete <name_of_scope_2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/RolesAllowed> get
   delete <name_of_scope_1>
   delete <name_of_scope_2>

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Admin/ScopesAllowed> get
   delete <name_of_scope_1>
   delete <name_of_scope_2>

Naprave operacijskega sistema sobe za zagotavljanje

V BroadWorks zagotovite napravo Room OS (Webex Board Series, Webex Desk Series ali Webex Room Series).

V BroadWorks CommPilot preverite Vrsta identitete/profila naprave konfiguracijo, da vidite, ali vrsta naprave obstaja za to napravo Room OS. Če vrsta naprave ne obstaja v BroadWorks, uvozite vrsto naprave v BroadWorks z datoteko DTAF, ki jo prenesete s cisco.com.

Ko uvozite vrsto naprave, se prepričajte, da znotraj Vrsta identitete/profila naprave konfiguracija:

Preverite Dovoli vključitev aktivacijske kode potrditveno polje
Preverite Pošljite zahtevo za aktivacijsko kodo prek strežnika za sporočila potrditveno polje.
Set Način preverjanja pristnosti do Nosilec.

Preverite, ali ima datoteka profila naprave nastavitve SIP, ki jih želite uporabiti. V Datoteka vrste profila identitete/naprave poskrbi da Način preverjanja pristnosti je Nosilec.

Ustvarite profil naprave z nastavitvami za vašo novo napravo. V Dodaj/spremeni profil identitete/naprave strani, pustite polje naslova MAC prazno.

Konfigurirajte primarnega uporabnika. Na Dodajanje uporabnikov strani, označite ali počistite polje isPlace glede na to, ali nameravate napravo uporabljati kot osebno ali za skupni delovni prostor.

Potrjeno—Delovna naprava
Neoznačeno—osebna naprava

Naprave delovnega prostora v skupni rabi prav tako zahtevajo, da dodelite primarnega uporabnika. Določite lahko primarnega uporabnika, ki ga želite.

Izpolnite možnost, ki ustreza vrsti naprave in načinu zagotavljanja, ki ga želite uporabiti:

Naprava je za skupni delovni prostor – uporabite Zagotavljanje delovnega prostora BroadWorks API za dokončanje zagotavljanja za napravo delovnega prostora.
Naprava je osebna; želite omogočiti uporabo javnih API-jev – uporabite API za naročnike BroadWorks za dokončanje zagotavljanja za primarnega uporabnika.
Naprava je osebna; želite, da uporabniki uporabljajo samoaktivacijo – uporabniku posredujte URL portala za aktiviranje uporabnika. Uporabnik mora potrditi svoj e-poštni naslov, da dokonča oskrbo.
Naprava je osebna; želite uporabiti pretočno zagotavljanje—pojdite na 7. korak.

Če je naprava za osebno uporabo in želite uporabiti pretočno zagotavljanje, potem za primarnega uporabnika dodelite Integrirano IM+P storitev. Na Uporabnik > Profil stran dodajte storitev IM+P:

Iz Profil strani, kliknite Dodeljevanje storitev.
Na seznamu Razpoložljive storitve, izberite Integrirano IM&P in s puščico premaknite predmet na Uporabniške storitve škatla.
Kliknite v redu.
Kliknite Profil.

Samo zaupanja vreden tok e-pošte. Dodajte uporabnika E-naslov naslov. Ta nastavitev služi kot e-pošta IM&P za zagotavljanje pretoka v Webex za Cisco BroadWorks. To ni potrebno, če uporabljate nezaupanja vreden tok e-pošte.

Predlogo stranke na Webexu je treba konfigurirati z nastavitvami za zagotavljanje pretoka z zaupanja vrednimi ali nezaupnimi e-poštnimi sporočili. Za podrobnosti glejte Vodnik po rešitvah Webex za Cisco BroadWorks.

Kaj storiti naprej

Zahtevajte aktivacijsko kodo za napravo Room OS.

Zahtevaj aktivacijsko kodo

Ko sta vaša naprava in uporabnik omogočena na BroadWorks, zahtevajte, da se uporabniku pošlje aktivacijska koda.

1	V Profil identitete/naprave strani, poiščite in odprite profil naprave za svojo novo napravo.
2	Kliknite na Aktivacija naprave zavihek.
3	Kliknite Zahtevaj aktivacijsko kodo.

Sistem ustvari aktivacijsko kodo in (pod pogojem, da ste pravilno konfigurirali sistem), pošlje aktivacijsko kodo po e-pošti primarnemu uporabniku.

Kaj storiti naprej

Napravo zagotovite uporabniku. Ko uporabnik priključi napravo, mora vnesti aktivacijsko kodo, ki je bila poslana v e-pošti. To bo napravo vključilo v Webex za Cisco BroadWorks.

MPP vkrcanje na Webex

Ta razdelek opisuje vključitev novih ali obstoječih naprav MPP v Webex za Cisco BroadWorks. Upoštevajte, da se 'obstoječa' nanaša na napravo MPP, ki obstaja v BroadWorksu, vendar nima zmogljivosti Webex.

Vključevanje naprave MPP (nove naprave)

Med vkrcanjem skrbnik posodobi BroadWorks s podporo za MPP, nadgradi vdelano programsko opremo naprave in omogoči napravo v BroadWorks za dokončanje vkrcanja.

Naslednji diagram ponuja pregled postopka vključitve po potrditvi aktivacijske kode, ki jo uporabnik vnese.

Vključevanje naprave MPP (obstoječe naprave)

Za obstoječe naprave MPP, kjer naprava že obstaja v BroadWorks, vendar ni vgrajena v Webex, posodobite BroadWorks in vdelano programsko opremo naprave za podporo vkrcanja MPP v Webex. Po posodobitvah se naprava samodejno vključi v Webex.

Več informacij

Za več informacij o vključitvi naprave MPP v Webex glejte opis funkcije Izboljšave Cisco BroadWorks DMS za naprave MPP, ki omogočajo Webex.

Predpogoji za napravo MPP

Najmanjša različica MPP

Vdelana programska oprema MPP najmanj 11.3.7

Zahteve za popravke BroadWorks

Ta funkcija je podprta od različice 2021.11 strežnika ADP Release Independent (RI) brez zahtev za popravke.

Za strežnike, ki niso RI, morate imeti nameščene naslednje popravke (iz skupin popravkov ap381367, ap381951, ap382198), da lahko uporabite funkcijo. Namestite popravke, ki veljajo za vašo izdajo:

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.platforma.23.0.1075.ap382198
AP.platforma.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

Zahteve za platformo BroadWorks

Ta funkcija je na voljo na:

R22: na voljo samo na XSP
R23: na voljo na XSP ali ADP (neodvisno od izdaje)
R24: na voljo na ADP (Release Independent)

Konfiguracijske zahteve BroadWorks

Za implementacijo te rešitve mora biti oskrba Flowthrough konfigurirana tako, da Broadworksu omogoči oskrbo naprav za Webex.

Prepričajte se, da je Integrirano IM+P storitev je omogočena na BroadWorks in kaže na BroadWorks Provisioning Bridge.

URL mosta za zagotavljanje je bil dodeljen, ko je bila predloga stranke uporabljena za organizacijo. To bi morali dokončati med prvotno nastavitvijo Webex za Cisco BroadWorks. Če želite najti obstoječi URL v središču za partnerje, glejte Konfigurirajte aplikacijski strežnik z URL-jem storitve zagotavljanja v Vodnik po rešitvah Webex za Cisco BroadWorks.
Če imate več partnerskih organizacij, potrebujete namenski primerek storitve upravljanja naprav (DMS) za vsakega partnerja.

Certifikati in požarni zidovi

Prepričajte se, da ste konfigurirali naslednje:

Zahteve za potrdila – naprave MPP uporabljajo avtentikacijo mTLS s potrdilom naprave. Naslov MAC naprave, ki ga zagotavlja potrdilo, overja napravo. Prenesite potrebna potrdila za svojo MPP napravo iz https://www.cisco.com/security/pki/.

Naložite svoja potrdila, da vzpostavite zaupanje v ADP ali požarni zid. Če na primer nalagate v ADP, uporabite ta ukaz:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
Zahteve požarnega zidu – če je ADP za požarnim zidom, mora biti vaš požarni zid konfiguriran s pravilom za ekstrahiranje naslova MAC iz potrdila naprave in ga postavi v glavo za preverjanje pristnosti, ki se nato posreduje ADP-ju. Na primer, vzorec identitete .*([0-9a-fA-F]{12}).* lahko uporabite za ekstrahiranje naslova MAC, ki ga nato lahko postavite v glavo, ki uporablja opisno ime (npr. macaddress).

Če ADP ni za požarnim zidom, prejšnja zahteva ne obstaja.

Aktivacija funkcije

V AS aktivirajte naslednje funkcije BroadWorks:

101377 Izboljšave za vkrcanje naprav Webex in MPP
25088 Podporne slušalke za naprave DECT
23775 Remote Reset za MPP naprave
24104 Podpira večcelično veriženje za naprave DECT
20077 Izboljšave upravljanja naprav
19559 Izboljšave upravljanja vizualnih naprav
02283 Izboljšave prilagajanja vrste profila naprave

Na primer, zaženite naslednji ukaz, da omogočite 101377. Spremenite številko funkcije, ko aktivirate druge funkcije: AS_CLI/System/ActivatableFeature> activate 101377

Zaženite naslednji CLI na omrežnem strežniku:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Zahteve za aktivacijsko kodo

Neobvezno. Aktivacijske kode niso obvezne za vključitev naprave MPP. Če pa želite uporabiti aktivacijske kode, glejte Zahtevajte aktivacijsko kodo za MPP za dodatne zahteve, ki so specifične za aktivacijske kode z MPP.

Tok vkrcanja naprave MPP

Izvedite naslednje naloge, da konfigurirate svoj sistem za podporo vkrcanja naprave MPP v Webex za Cisco BroadWorks.

Če dodajate zmožnost Webex napravi MPP, ki že obstaja v BroadWorksu, dokončajte samo koraka 1 in 2.

1	Konfigurirajte storitve za MPP (Nove ali obstoječe MPP naprave). Konfigurirajte sistemsko podporo za MPP na Webexu za Cisco BroadWorks.
2	Nadgradite vdelano programsko opremo naprave MPP (Obstoječe MPP naprave). Za vse obstoječe naprave MPP, za katere želite dodati zmogljivost Webex, nadgradite na najnovejšo vdelano programsko opremo naprave.
3	Zagotavljanje MPP naprave (Samo nove naprave MPP). Če naprava ne obstaja v BroadWorks, zagotovite napravo in primarnega uporabnika v BroadWorks.
4	Zahtevajte aktivacijsko kodo za MPP (Neobvezno). Če želite uporabiti aktivacijske kode za vgrajene naprave MPP, zahtevajte aktivacijsko kodo.

Konfigurirajte storitve za MPP

Posodobite sistemske nastavitve BroadWorks za podporo naprav MPP (novih ali obstoječih) na Webexu za Cisco BroadWorks. Ta korak dokončajte samo enkrat. Tega postopka vam ni treba ponavljati za vsako napravo MPP.

Preden začneš

Če je ADP za požarnim zidom, mora biti vaš požarni zid konfiguriran s pravilom za ekstrahiranje naslova MAC iz potrdila naprave in ga postavi v glavo za preverjanje pristnosti, ki se nato posreduje ADP-ju. Na primer, vzorec identitete .*([0-9a-fA-F]{12}).* lahko uporabite za ekstrahiranje naslova MAC, ki ga nato lahko postavite v glavo, ki uporablja opisno ime (npr. macaddress).

Za pomoč pri konfiguracijah glejte dokumentacijo požarnega zidu.

Vložite zahtevo za storitev pri svojem agentu za vkrcanje ali pri Cisco TAC za zagotavljanje Cisco OAuth za vaš račun Cisco Identity Provider Federation. Za naslov svoje zahteve uporabite »ADP AuthService Configuration«.

Cisco vam da ID odjemalca OAuth, skrivnost odjemalca in žeton za osvežitev, ki velja 60 dni. Če žeton poteče, preden ga uporabite s svojim ADP, lahko vložite novo zahtevo.

Konfigurirajte parametre Cisco Identity Provider tako, da zaženete naslednje ukaze CLI.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider> set enabled false

set clientId <clientId> — glejte odgovor na zahtevo za storitev za ID.
set clientSecret <clientSecret> —glejte odgovor na zahtevo storitve za skrivnost.
set issuerName <URL> — glejte naslednjo tabelo za URL.
set issuerUrl <URL> — glejte naslednjo tabelo za URL.
set ciResponseBodyMaxSizeInBytes 65536

Tabela 3. Nastavite ime izdajatelja in URL izdajatelja

Če je CI Cluster ...

Nastavite ime izdajatelja in URL izdajatelja na ...

ZDA-A

https://idbroker.webex.com/idb

https://idbroker-eu.webex.com/idb

US-B

https://idbroker-b-us.webex.com/idb

Če ne poznate svojega Grozd CI, lahko pridobite informacije iz podrobnosti o stranki v pogledu službe za pomoč uporabnikom Control Huba.

Nastavite url DM Bridge s spodnjim ukazom CLI. URL DM Bridge je drugačen za vsako gručo Teams (ki ste jo potegnili v 2. koraku).

ADP_CLI/Applications/BroadworksDms/DeviceActivation/DMBridge> set
url = <url_of_DM_Bridge>
scope = dm-bridge:device_auth

Tabela 4. DM_Bridge URL
Če je Teams Cluster ...	Nastavi DM_Premosti URL do ...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
AFRA	dm-bridge-k.wbx2.com

Omogočite pridobivanje naslova MAC in preverjanje pristnosti z uporabo glave Authentication ali potrdila Authentication. Iz varnostnih razlogov priporočamo, da uporabite samo eno od možnosti:

Glava za preverjanje pristnosti – če je ADP za požarnim zidom, uporabite CLI na ADP, da omogočite pridobivanje naslova MAC za glavo za preverjanje pristnosti. Ta konfiguracija daje ADP zmožnost prepoznavanja naslova MAC iz glave Authentication. Na primer:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Headers> set enable true

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

V tem primeru macaddress je dodeljeno ime z .*([0-9a-fA-F]{12}).* ki predstavlja vzorec, ki se dodeli glavi. Če naslov imenujete drugače kot macaddress, ustrezno prilagodite svoj CLI.
Certifikat za preverjanje pristnosti – če ADP ni za požarnim zidom, pride do preverjanja pristnosti neposredno med napravo in ADP. Uporabite spodnje ukaze CLI, da omogočite pridobivanje naslova MAC na potrdilu naprave za preverjanje pristnosti:

ADP_CLI/Applications/BroadworksDms/AccessControl/Authentication/Certificates> set enable true

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

Nadgradite vdelano programsko opremo naprave MPP

Preden začneš

Prepričajte se, da je BroadWorks posodobljen s podporo storitev za MPP.

Nadgradite vdelano programsko opremo naprave na najnovejšo različico, da zagotovite, da naprava MPP podpira zmogljivost Webex.

Za več informacij o nadgradnjah vdelane programske opreme glejte Opombe ob izdaji za izdajo vdelane programske opreme vašega modela telefona.

Kaj storiti naprej

Obstoječe naprave MPP – po nadgradnji se naprava samodejno vključi v Webex. Uporabnik lahko začne uporabljati storitve Webex na napravi.
Nove naprave MPP—Zagotovite novo napravo MPP na BroadWorks.

Zagotavljanje MPP naprave

Če nova naprava MPP ne obstaja v BroadWorks, zagotovite napravo v BroadWorks.

V BroadWorks CommPilot preverite Vrsta identitete/profila naprave konfiguracijo, da vidite, ali obstaja vrsta naprave za to napravo MPP. Če vrsta naprave ne obstaja v BroadWorks, uvozite vrsto naprave v BroadWorks z uporabo datoteke DTAF, ki jo prenesete s cisco.com.

V BroadWorks CommPilot odprite Vrsta identitete/profila naprave in preverite Dovoli vključitev aktivacijske kode potrditveno polje.

Ustvarite Vrsta identitete/profila naprave Datoteka z nastavitvami SIP, ki jih želite uporabiti.

Ustvarite Profil identitete/naprave z nastavitvami za vašo novo napravo. V Mac naslov polje vnesite naslov MAC naprave.

Če uporabljate aktivacijske kode za vgrajene naprave MPP, zapustite Mac naslov polje prazno.

Konfigurirajte primarnega uporabnika. Na Dodajanje uporabnikov stran, nastavite isPlace potrditveno polje glede na to, ali je naprava osebna ali za skupni delovni prostor:

Potrjeno—Delovna naprava
Neoznačeno—osebna naprava

Izpolnite možnost, ki ustreza vrsti naprave in načinu zagotavljanja, ki ga želite uporabiti:

Naprava je za skupni delovni prostor – uporabite Zagotavljanje delovnega prostora BroadWorks API za dokončanje zagotavljanja za napravo delovnega prostora.
Naprava je osebna; želite omogočiti uporabo javnih API-jev – uporabite API za naročnike BroadWorks za dokončanje zagotavljanja za primarnega uporabnika.
Naprava je osebna; želite, da uporabniki uporabljajo samoaktivacijo – uporabniku posredujte URL portala za aktiviranje uporabnika. Uporabnik mora potrditi svoj e-poštni naslov, da dokonča oskrbo.
Naprava je osebna; želite uporabiti pretočno zagotavljanje—pojdite na 7. korak.

Če je naprava za osebno uporabo in želite uporabiti pretočno zagotavljanje, potem za primarnega uporabnika dodelite Integrirano IM+P storitev. Na Uporabnik > Profil stran dodajte storitev IM+P:

Iz Profil strani, kliknite Dodeljevanje storitev.
Na seznamu Razpoložljive storitve, izberite Integrirano IM&P in s puščico premaknite predmet na Uporabniške storitve škatla.
Kliknite v redu.
Kliknite Profil.

Kaj storiti naprej

Neobvezno. Če želite uporabiti aktivacijske kode za vgrajene naprave MPP, zahtevajte aktivacijsko kodo na BroadWorks.

Zahtevajte aktivacijsko kodo za MPP

(Izbirno) Webex za Cisco BroadWorks ne zahteva aktivacijskih kod za vgradnjo novih naprav MPP. Če pa se odločite za uporabo aktivacijskih kod, izpolnite Zahtevaj aktivacijsko kodo postopek zahtevanja aktivacijske kode za novo napravo.

Predpogoji za uporabo aktivacijskih kod z napravami MPP

Če uporabljate vkrcanje aktivacijske kode za naprave MPP, se prepričajte, da vaš sistem izpolnjuje naslednje zahteve glede aktivacijske kode.

Storitev aktivacije naprave—Izpolnite naslednje zahteve, da omogočite storitev aktiviranja naprave:

Razmestite storitev aktiviranja naprave na BroadWorks. Za podrobnosti glejte Cisco BroadWorks Secure Onboarding z uporabo aktivacijskih kod.
Usmerite storitev aktiviranja naprav (DAS) na storitve upravljanja naprav (DMS) na BroadWorks AS z naslednjim ukazom CLI:

AS_CLI/Interface/DAS> set url <url_of_DMS>
Preverite, ali je nastavitev URL-ja DAS za gručo BroadWorks nastavljena na URL storitev upravljanja naprav (DMS). Če si želite ogledati trenutno nastavitev URL-ja DAS v Partner Hubu, pojdite na nastavitve > BroadWorks Calling > Ogled grozdov in izberite ustrezno gručo. URL je prikazan pod Nastavitve vmesnika.

Cisco Global Discovery Services (GDS)—GDS je potreben za zagotovitev aktivacijske kode. Omogočite GDS na BroadWorks tako, da dokončate oba spodnja koraka:

Ustvarite zahtevo za storitev za zagotavljanje vašega računa GDS. Cisco vam zagotovi ID odjemalca, skrivnost odjemalca, žeton za osvežitev in domeno GDS.

Ko je vaš račun GDS omogočen, omogočite GDS na ADP z naslednjim CLI:

ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> get
  set gdsDomain <gds_domain_from service request> e.g. https://activation.webex.com
  set clientId <id_from_service_request>
  clientSecret <secret_from_service_request>
  refreshToken <token_from_service_request>

Poleg zgornjih predpogojev, specifičnih za aktivacijsko kodo, mora vaš sistem izpolnjevati splošne predpogoje MPP v Predpogoji za napravo MPP.

Zahtevaj aktivacijsko kodo

Izvedite naslednje korake, da zahtevate aktivacijsko kodo za novo napravo MPP.

V Profil identitete/naprave strani, poiščite in odprite profil naprave za svojo novo napravo.
Kliknite na Aktivacija naprave zavihek.
Kliknite Zahtevaj aktivacijsko kodo.

Sistem ustvari aktivacijsko kodo in jo po e-pošti pošlje primarnemu uporabniku. Uporabnik mora za dokončanje vkrcanja vnesti kodo v napravo.

1	Prijavite se v instanco Control Hub za organizacijo strank.
2	Kliknite Naprave.
3	Izberite napravo.
4	Iz Dejanja spustni meni, izberite Znova zaženite.

1	Prijavite se v instanco Control Hub za organizacijo strank.
2	Kliknite Naprave.
3	Kliknite ustrezno napravo.
4	Od Dejanja, izberite Prijavi težavo.
5	Preglejte povzetek poročila.

1	Prijavite se v instanco Control Hub za organizacijo strank.
2	Kliknite Naprave.
3	Izberite ustrezno napravo.
4	Iz Dejanja spustni meni, izberite Izbriši.

števec	Opis
Modul: enterprises.broadsoft.broadworks.deviceActivation.activate
bwDASActivateRequests	Število skupnih prejetih zahtev za aktiviranje. To vključuje aktiviranje zahtev BroadWorks in aktiviranje zahtev Webex.
bwDASActivateFailures	Skupno število neuspešnih zahtev za aktiviranje. To vključuje neuspešne aktivirane zahteve BroadWorks in neuspešne aktivirane zahteve Webex.
bwDASActivateBroadWorksRequests	Število prejetih zahtev za aktiviranje BroadWorks.
bwDASActivateBroadWorksFailures	Število neuspešnih zahtev za aktiviranje BroadWorks. Ta števec ne upošteva napak avtorizacije in avtentikacije.
bwDASActivateWebexRequests	Število prejetih zahtev za aktiviranje Webexa.
bwDASActivateWebexFailures	Število zahtev za aktiviranje Webexa, ki se niso uspešno zaključile.
Modul: enterprises.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Število poslanih zahtev DMBridge.
bwDMBridgeFailures	Število zahtev DMBridge, ki se niso uspele uspešno dokončati.

O tem vodniku

Zgodovina sprememb dokumenta

Pregled namestitve naprave

Uvajanje OS v sobi

Vključevanje naprave z aktivacijskimi kodami

Postopek vkrcanja za Room OS

Preverjanje pristnosti naprave (prek nosilnih žetonov OAuth)

Predpogoji za operacijski sistem sobe

Minimalna različica operacijskega sistema Room

Zahteve za popravke BroadWorks

Zahteve za platformo BroadWorks

Konfiguracijske zahteve BroadWorks

Predpogoji za vključitev aktivacijske kode v sistem Room OS

Tok vkrcanja v sistem Room OS

Konfigurirajte storitve za Room OS

Naprave operacijskega sistema sobe za zagotavljanje

Kaj storiti naprej

Zahtevaj aktivacijsko kodo

Kaj storiti naprej

MPP vkrcanje na Webex

Vključevanje naprave MPP (nove naprave)

Vključevanje naprave MPP (obstoječe naprave)

Več informacij

Predpogoji za napravo MPP

Najmanjša različica MPP

Zahteve za popravke BroadWorks

Zahteve za platformo BroadWorks

Konfiguracijske zahteve BroadWorks

Certifikati in požarni zidovi

Aktivacija funkcije

Zahteve za aktivacijsko kodo

Tok vkrcanja naprave MPP

Konfigurirajte storitve za MPP

Preden začneš

Nadgradite vdelano programsko opremo naprave MPP

Preden začneš

Kaj storiti naprej

Zagotavljanje MPP naprave

Kaj storiti naprej

Zahtevajte aktivacijsko kodo za MPP

Predpogoji za uporabo aktivacijskih kod z napravami MPP

Zahtevaj aktivacijsko kodo

Pregled uporabnosti

Oglejte si stanje naprave

Znova zaženite napravo

Prijavi težavo

Izbriši napravo

Spremeni lastnika naprave

Kaj storiti naprej

Spremljanje delovanja

Poenotena zgodovina klicev

MPP telefoni, ki podpirajo Webex

Webex za BroadWorks integrirane naprave RoomOS

Izboljšave iskanja po imeniku za Webex za BroadWorks integrirane naprave RoomOS