Tässä artikkelissa

Johdanto

Tietoa tästä oppaasta

Asiakirjan muutoshistoria

Laiteintegraatio Webex for Cisco BroadWorks -ohjelmistoon

Laitteen käyttöönoton yleiskatsaus

Room OS Onboarding

Huone OS Edellytykset

Room OS Onboarding Flow

MPP Onboarding Webexiin

MPP-laitteen edellytykset

MPP Device Onboarding Flow

Laitteen huollettavuus

Huollettavuuden yleiskatsaus

Näytä laitteen tila

Käynnistä laite uudelleen

Ilmoita ongelma

Poista laite

Laitteen omistajan vaihtaminen

Suorituskyvyn seuranta

Webexin integroitujen laitteiden loppukäyttäjäominaisuudet

Yhtenäinen soittohistoria

Hakemistohakua koskevat parannukset Webex for BroadWorks -integroituihin RoomOS-laitteisiin

Webex Cisco BroadWorksille -laiteintegrointiopas

Tässä artikkelissa

Onko sinulla palautetta?

Laitteen integrointiopas on suunnattu kumppanitason järjestelmänvalvojille. Asiakirjassa kuvataan, miten laitteita otetaan käyttöön ja hallitaan tällä ratkaisulla.

Johdanto

Tietoja tästä oppaasta

Tämä asiakirja on tarkoitettu Webex for Cisco BroadWorks -sovelluksen palveluntarjoajaorganisaatioiden kumppanijärjestelmänvalvojille. Oppaassa kuvataan Room OS- ja MPP-laitteiden käyttöönotto ja huolto Webex for Cisco BroadWorksille. Opas on jaettu kahteen osaan:

Laitteen käyttöönotto— Kuvaa Room OS -laitteiden (Room and Room Kit -sarjat, Desk-sarjat ja Board-sarjat) ja MPP-laitteiden liittämisen Webex for Cisco BroadWorksiin.
Laitteen huollettavuus— Kuvaa, kuinka hallita integroituja laitteita Control Hubissa.

Asiakirjan muutoshistoria

Seuraavassa taulukossa on yhteenveto tämän asiakirjan muutoshistoriasta.

Päivämäärä	Asiakirjan versio	Muutoksen kuvaus
12. toukokuuta 2023	1.7	Lisätty Webex for BroadWorks integroidut Cisco RoomOS -laitteet ja Hakemistohaun parannuksia W4B Integrated RoomOS Devices alla Webexin integroidut laitteet -osion loppukäyttäjäominaisuudet.
27. helmikuuta 2023	1.6	Päivitetty Määritä palvelut huonekäyttöjärjestelmälle astuu alle Laitteen käyttöönotto.
17. helmikuuta 2023	1.5	Lisätty Yhtenäinen puheluhistoria Webex-tietoisille MPP-puhelimille alla oleva osio Webexin integroitujen laitteiden loppukäyttäjäominaisuudet.
14. lokakuuta 2022	1.4	Päivitetty aloitusprosessi huonekäyttöjärjestelmään alla Huoneen käyttöjärjestelmän käyttöönotto osio sisältää SRV:n tietueet. Päivitetty BroadWorks-määritysvaatimukset alla Huoneen käyttöjärjestelmän edellytykset osio, jossa on osoitin Ratkaisuoppaaseen läpikulkuprosessin valmisteluvaatimuksia varten.
20. kesäkuuta 2022	1.3	Päivitetty Huoneen käyttöjärjestelmän edellytykset ja MPP-laitteen edellytykset osoittimella Ratkaisuoppaaseen läpikulkuprosessin valmisteluvaatimuksia varten. Päivitetty Varaa huoneen käyttöjärjestelmälaitteet ja Tarjoa MPP-laite sisällyttää tietoja eri hallintamenetelmistä.
03. kesäkuuta 2022	1.2	Korjattu Device Profile Type -ominaisuuden aktivointinumero (02283). Huoneen käyttöjärjestelmän edellytykset ja MPP-laitteen edellytykset
27. toukokuuta 2022	1.1	Korjattu vaatimus erilliselle DMS-esiintymälle kumppaniorganisaatiota kohti. Lisätty Esipuhe luku. Päivitetty otsikko "Device Integration Guide" -oppaaksi.
20. toukokuuta 2022	1.0	Ensimmäinen julkaisu

Device Integration for Webex for Cisco BroadWorks

Laitteen käyttöönoton yleiskatsaus

Tässä luvussa kuvataan laitteiden liittäminen Webex for Cisco BroadWorksiin. Tämä luku kattaa seuraavat käyttötapaukset:

Sisäänrakennetut uudet Webex Room OS -laitteet (käyttäen aktivointikoodeja)
Mukana uusia MPP-laitteita
Lisää Webex-ominaisuus olemassa oleviin MPP-laitteisiin

Suosittelemme, että otat tämän ominaisuuden käyttöön Release Independent ADP -palvelimissa. XSP kuitenkin tukee myös tätä ominaisuutta. Jos käytät XSP:tä, silloin kun tämä asiakirja viittaa "ADP:hen", voit korvata sanan "XSP", ellei tekstissä mainita vain ADP:tä.
Tämä ominaisuus tukee sekä Personal- että Workspace-laitteita.

Huoneen käyttöjärjestelmän käyttöönotto

Webex for Cisco BroadWorks tukee aktivointikoodin käyttöönottoa sekä jaetuille että työtilan huonekäyttöjärjestelmän laitteille.

Laitteen käyttöönotto aktivointikoodeilla

Device Onboarding aktivointikoodeilla tarjoaa yksinkertaisen ja turvallisen tavan ottaa käyttöön Room OS -laitteet. Aktivointikoodi on 16-numeroinen kertaluonteinen järjestelmän luoma salasana, joka käyttäjän on syötettävä laitteeseen päästäkseen laitteeseen. Aktivointikoodi on turvallisesti linkitetty aiottuun käyttäjätiliin ja varmistaa, että vain aiottu käyttäjä käyttää laitetta, joka on linkitetty samaan tiliin. Kun käyttäjä on syöttänyt oikean koodin, laite muodostaa yhteyden sekä Webexiin että BroadWorksiin, suorittaa rekisteröinnin, lataa määritystiedostonsa ja on valmis käytettäväksi.

Seuraavat Room OS -laitteet tukevat käyttöönottoa aktivointikoodeilla:

Webex Board -sarja (huonekäyttöjärjestelmä)
Webex Desk Series (huoneen käyttöjärjestelmä)
Webex-huonesarja (huoneen käyttöjärjestelmä)

Huonekäyttöjärjestelmän käyttöönottoprosessi

Seuraava prosessi näyttää, mitä tapahtuu, kun Room OS -laite otetaan käyttöön aktivointikoodeilla:

Kumppanin järjestelmänvalvoja määrittää ensisijaisen käyttäjän ja laitteen BroadWorksissä ja luo sitten aktivointikoodin BroadWorksissä.
Laitteen omistajalle lähetetään sähköposti, joka sisältää laitteen aktivointikoodin.
Laitteen omistaja käynnistää laitteen.
Laite kehottaa laitteen omistajaa syöttämään aktivointikoodin.
Laitteen omistaja syöttää aktivointikoodin laitteeseen.
Laite liitetään BroadWorksiin ja Webexiin seuraavan aliprosessin avulla:
- Room OS -laite lähettää aktivointipyynnön Webex-palveluihin. GDS vahvistaa aktivointikoodin ja jos koodi on oikea, laite siirtyy Webexiin. Webex palauttaa konetunnuksen laitteeseen.
- Laite lähettää aktivointipyynnön BroadWorks DM:lle koneen tunnuksen ja MAC-osoitteen kanssa.
- BroadWorks valtuuttaa ja sisällyttää laitteen.
- Laite lähettää BroadWorks DM:lle päivitetyn konfiguroinnin pyynnön. Konetunnus sisältyy valtuutusta varten.
- BroadWorks valtuuttaa tunnuksen, paikantaa päivitetyn määritystiedoston ja palauttaa päivitetyn määritystiedoston.
- Huoneen käyttöjärjestelmä yrittää paikantaa NAPTR-tietueen määritystiedostossa määritetylle toimialueelle, koska se odottaa löytävänsä SRV-merkinnän _sip._tls.<domain_in_config> Jos NAPTR-tietuetta ei ole, RoomOS yrittää sitten etsiä SRV-tietuetta, jota seuraa vastaavasti A-tietue.
  
  SRV:n tietueen tulee olla _sip._tls. koska roomOS tukee vain TLS:ää kuljetuksessa ja SRTP:tä medialle.
Laite rekisteröityy ja on käyttövalmis.

Seuraava kaavio tarjoaa yksinkertaistetun yleiskuvan käyttöönottoprosessista.

Lisätietoja huonekäyttöjärjestelmän käyttöönotosta, mukaan lukien yksityiskohtaisemmat vuokaaviot, on ominaisuuden kuvauksessa Cisco BroadWorks -parannukset Webex-Aware-laitteiden käyttöönottoon.

Laitteen todennus (OAuth Bearer Tokenien kautta)

Room OS -laitteiden laitetodennus edellyttää, että otat Cisco OAuth Bearer Tokens -tunnukset käyttöön BroadWorksissä. Käyttöönoton aikana siirtotietunnus välitetään Activate Authorization -otsikon kautta ja sitä käytetään laitteen tunnistamiseen. IdP vahvistaa siirtotietunnuksen ja palauttaa UUID:n (koneen UUID työtilan laitteille tai käyttäjän UUID henkilökohtaisille laitteille) siirtotiekohteena. BroadWorks tallentaa UUID:n laitteen nimeksi verkkopalvelimelle.

Huoneen käyttöjärjestelmän edellytykset

Huoneen vähimmäiskäyttöjärjestelmän versio

Huoneen käyttöjärjestelmä vähintään 10.13

BroadWorks Patch -vaatimukset

Tätä ominaisuutta tuetaan Release Independent (RI) ADP-palvelimen versiosta 2021.11 alkaen ilman korjauspäivitysvaatimuksia.

Muiden kuin RI-palvelimien tapauksessa sinun on oltava asennettuna seuraavat korjaustiedostot (korjaustiedostoryhmistä ap381367, ap381951, ap382198), jotta voit käyttää ominaisuutta. Asenna julkaisuasi koskevat korjaustiedostot:

R22:lle:

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.platform.22.0.1123.ap381367
AP.platform.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

R23:lle:

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

R24:lle:

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

BroadWorks-alustan vaatimukset

Tämä ominaisuus on käytettävissä:

R22: saatavilla vain XSP:lle
R23: saatavana XSP:llä tai ADP:llä (Release Independent)
R24: saatavilla ADP:ssä (Release Independent)

BroadWorks-määritysvaatimukset

Tämän ratkaisun toteuttamiseksi Flowthrough-hallinta on määritettävä siten, että Broadworks voi tarjota laitteita Webexille.

Flowthrough-hallintaa määritettäessä ei ole pakollista käyttää läpivientiä käyttäjille, eli voit jatkaa olemassa olevien hallintamenetelmien (API, luotettu/epäluotettu sähköposti, käyttäjän oma jne.) käyttöä käyttäjien hallintaan. Katso "Käyttöönottovaatimukset" kohdasta Webex for Cisco BroadWorks -ratkaisuopas.

Varmista, että Integroitu IM+P palvelu on käytössä BroadWorksissä ja osoittaa BroadWorks Provisioning Bridge -sillalle.

Provisioning Bridge -URL-osoite määritettiin, kun asiakasmallia käytettiin organisaatiossa. Tämän olisi pitänyt tehdä Webex for Cisco BroadWorks -asennuksen aikana. Jos haluat löytää nykyisen URL-osoitteen Partner Hubista, katso Määritä sovelluspalvelimen hallintapalvelun URL-osoite in Webex for Cisco BroadWorks -ratkaisuopas.
Jos sinulla on useita kumppaniorganisaatioita, tarvitset oman Device Management Service (DMS) -esiintymän kumppania kohden.

Edellytykset aktivointikoodin käyttöönotolle huoneen käyttöjärjestelmässä

Varmista, että seuraava on asetettu:

Ota laitteen aktivointipalvelu käyttöön BroadWorksissä. Katso lisätietoja Cisco BroadWorks turvaa käyttöönottoa aktivointikoodeilla.
Varmista, että BroadWorks-klusterin DAS-URL-asetus on Device Management Services (DMS) -URL-osoite. Voit tarkastella nykyistä DAS-URL-asetusta Partner Hubissa siirtymällä osoitteeseen asetukset > BroadWorks kutsuu > Näytä klusterit ja valitse sopiva klusteri. URL-osoite näkyy alla Käyttöliittymäasetukset.

Seuraavat BroadWorks-ominaisuudet on aktivoitava AS:ssa:

101377 Parannuksia Webex- ja MPP-laitteiden käyttöönottoon
25088 Tukipuhelimet DECT-laitteille
24104 Tukee monisoluketjutusta DECT-laitteille
20077 Device Management Enhancements
19559 Visual Device Management Enhancements
02283 Laiteprofiilityypin mukauttamisen parannukset

Suorita esimerkiksi seuraava komento ottaaksesi 101377 käyttöön. Muuta ominaisuuden numeroa, kun aktivoit muita ominaisuuksia: AS_CLI/System/ActivatableFeature> activate 101377

Jos kaikki luetellut korjaustiedostot on asennettu eikä aktivoitavaa ominaisuutta ole luettelossa tietylle AS-julkaisullesi, se johtuu siitä, että se sisältyy jo AS-perusjulkaisuusi eikä se vaadi aktivointia.

Suorita seuraava CLI-komento verkkopalvelimella:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Varmista, että SBC-sertifikaattisi allekirjoittanut CA on lueteltu huoneen käyttöjärjestelmän luottamusluettelossa. Voit tarkastella Room OS -luottamusluetteloa kohdasta Laitteen verkkoportaali. Valitse portaalissa Turvallisuus > Yhteistyö Edge nähdäksesi luettelon CA:ista.

Huoneen käyttöjärjestelmän käyttöönottoprosessi

Suorita seuraavat tehtävät määrittääksesi järjestelmäsi tukemaan laitteen käyttöönottoa aktivointikoodeilla seuraaville Webex Room OS -laitteille:

Webex Board -sarja
Webex-pöytäsarja
Webex Room -sarja

1	Määritä palvelut huonekäyttöjärjestelmälle Määritä BroadWorks-tuki Room OS -laitteille.
2	Varaa huoneen käyttöjärjestelmälaitteet Tarjoa uusi laite BroadWorksissä.
3	Pyydä aktivointikoodi Pyydä aktivointikoodi Laiteprofiilissa. Koodi lähetetään automaattisesti ensisijaiselle käyttäjälle sähköpostitse.

Määritä palvelut huonekäyttöjärjestelmälle

Ennen kuin voit ottaa käyttöön uusia Room OS -laitteita, ota OAuth-todennus käyttöön määrittämällä seuraavat järjestelmätason parametrit.

Tee palvelupyyntö perehdytysagentiltasi tai Cisco TAC:lta Cisco OAuth -palvelun tarjoamiseksi Cisco Identity Provider Federation -tilillesi. Nimeä palvelupyyntösi "ADP AuthService Configuration".

Jos olet jo hankkinut Cisco OAuth Identity Provider -tunnistetiedot jollakin tämän asiakirjan työnkulusta, uutta pyyntöä ei tarvitse luoda. Jos kuitenkin hankit Cisco OAuth -valtuudet käyttämällä työnkulkua, jota ei ole tässä asiakirjassa, päivitä kirjautumistietosi suorittamalla uusi palvelupyyntö.

Cisco antaa sinulle OAuth-asiakastunnuksen, asiakassalaisuuden ja päivitystunnuksen, joka on voimassa 60 päivää. Jos tunnus vanhenee ennen kuin käytät sitä ADP:n kanssa, voit esittää uuden pyynnön.

Ota OAuth käyttöön käyttämällä tätä CLI-komentoa:

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

Varmista, että OAuth-alue sisältää wideworks-connector-käyttäjä (alue on oletuksena käytössä). Suorita tämä komento tarkistaaksesi laajuutesi:

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

Määritä Cisco Identity Provider -parametrit käyttämällä alla olevia CLI-komentoja.

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

set clientId <clientId> — katso tunnuksen palvelupyyntövastaus.
set clientSecret <clientSecret> — katso salainen palvelupyyntövastaus.
set issuerName <URL> – katso URL-osoite seuraavasta taulukosta.
set issuerUrl <URL> – katso URL-osoite seuraavasta taulukosta.
set tokenInfoUrl <IdPProxy_URL> – katso URL-osoite seuraavista taulukoista.
set ciResponseBodyMaxSizeInBytes 65536

Pöytä 1. Aseta isännöitsijänimi ja isännöitsijän URL-osoite

Jos CI-klusteri on...

Aseta isännöitsijänimi ja isännöitsijän URL arvoiksi...

US-A

https://idbroker.webex.com/idb

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

US-B

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

Jos et tiedä omaasi CI-klusteri, saat tiedot Control Hubin Help Desk -näkymän Asiakastiedoista.

Jos Teams Cluster on... Aseta tokenInfoURL arvoon...(IdP-välityspalvelimen URL-osoite)

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

Jos et tiedä omaasi Teams Cluster, saat tiedot Control Hubin Help Desk -näkymän Asiakastiedoista.
Testausta varten voit varmistaa, että tokenInfoURL on kelvollinen korvaamalla " idp/authenticate" osa URL-osoitteesta " ping".

Määritä Cisco Federationin identiteetintarjoajat käyttämällä seuraavia komentoja:

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

Päivitystunnus on nyt CiscoIdentityProvider/Partners-kontekstin alla, ja CiscoIdentityProvider/Federation-kontekstin partnerName:n on vastattava CiscoIdentityProvider/Partners-kontekstiin lisättyä kumppania.

Jos käytät ADP RI -kuormaa, joka on vanhempi kuin 2022.10, R23 XSP ilman korjaustiedostoa AP.xsp.23.0.1075.ap383838 tai R22 XSP, toimi seuraavasti:

Sinun ei tarvitse määrittää kumppania kohdassa "System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>".
Päivitystunnus on asetettava alla: System/CommunicationUtility/DefaultSettings/External Authentication/CiscoIdentityProvider/Federation>

Tyhjennä kaikki olemassa olevat laajuudet alla olevissa kolmessa kontekstissa ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Scopes
Admin/RolesAllowed
Admin/ScopesAllowed

Suorita kullekin kontekstille a get hankkiaksesi nykyiset laajuudet ja poistaaksesi ne. Esimerkiksi:

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>

Varaa huoneen käyttöjärjestelmälaitteet

Varaa BroadWorksissa Room OS -laite (Webex Board Series, Webex Desk Series tai Webex Room Series).

Tarkista BroadWorks CommPilotissa Identiteetti/laiteprofiilityyppi määritykset, jotta näet, onko tälle huonekäyttöjärjestelmälaitteelle olemassa laitetyyppi. Jos laitetyyppiä ei ole BroadWorksissä, tuo laitetyyppi BroadWorksiin käyttämällä DTAF-tiedostoa, jonka lataat osoitteesta cisco.com.

Kun olet tuonut laitetyypin, varmista, että seuraavat asetukset ovat olemassa Identiteetti/laiteprofiilityyppi kokoonpano:

Tarkista Salli aktivointikoodin käyttöönotto valintaruutu
Tarkista Lähetä aktivointikoodipyyntö viestipalvelimen kautta valintaruutu.
Aseta Todennustila to Kantaja.

Tarkista, että laiteprofiilitiedostossa on SIP-asetukset, joita haluat käyttää. Vuonna Identiteetti/laiteprofiilityyppitiedosto Varmista että Todennustila On Kantaja.

Luo laiteprofiili uuden laitteen asetuksilla. Vuonna Identiteetti/laiteprofiili Lisää/muokkaa sivulla, jätä MAC-osoitekenttä tyhjäksi.

Määritä ensisijainen käyttäjä. Käytössä Käyttäjien lisäys sivu, valitse tai poista valinta isPlace sen mukaan, aiotko laitteen olla henkilökohtainen vai jaettu työtila.

Valittu — työtilalaite
Ei valittuna – henkilökohtainen laite

Jaetut työtilan laitteet edellyttävät myös ensisijaisen käyttäjän määrittämistä. Voit määrittää haluamasi ensisijaisen käyttäjän.

Täytä vaihtoehto, joka vastaa käytettävää laitetyyppiä ja hallintamenetelmää:

Laite on tarkoitettu jaettuun työtilaan – käytä Luo BroadWorks-työtila API työtilan laitteen hallintaan.
Laite on henkilökohtainen; haluat käyttää julkisia sovellusliittymiä – käytä Provision BroadWorks Subscribers API pääkäyttäjän hallintaan.
Laite on henkilökohtainen; haluat käyttäjien aktivoivan itse – välitä käyttäjän aktivointiportaalin URL-osoite käyttäjälle. Käyttäjän on vahvistettava sähköpostiosoitteensa, jotta hallinta on valmis.
Laite on henkilökohtainen; haluat käyttää läpikulkuprosessia – siirry vaiheeseen 7.

Jos laite on tarkoitettu henkilökohtaiseen käyttöön ja haluat käyttää läpikulkuprosessia, määritä ensisijaiselle käyttäjälle Integroitu IM+P palvelua. Käytössä Käyttäjä > Profiili sivu, lisää IM+P-palvelu:

alkaen Profiili sivu, napsauta Määritä palvelut.
Luettelossa Käytettävissä olevat palvelut, valitse Integroitu IM&P ja siirrä kohde nuolella kohtaan Käyttäjäpalvelut laatikko.
Klikkaus OK.
Klikkaus Profiili.
Vain luotettava sähköpostivirta. Lisää käyttäjä Sähköposti osoite. Tämä asetus toimii IM&P-sähköpostina Webex for Cisco BroadWorksin läpiviennissä. Tätä ei vaadita, jos käytät epäluotettavaa sähköpostivirtaa.

Webexin asiakasmalliin on määritettävä luotettujen tai epäluotettujen sähköpostien läpivientiasetukset. Katso lisätietoja Webex for Cisco BroadWorks -ratkaisuopas.

Mitä tehdä seuraavaksi

Pyydä aktivointikoodi Room OS -laitteelle.

Pyydä aktivointikoodi

Kun laitteesi ja käyttäjäsi on lisätty BroadWorksiin, pyydä aktivointikoodin lähettämistä käyttäjälle.

1	Vuonna Identiteetti/laiteprofiili -sivulla, etsi ja avaa uuden laitteesi laiteprofiili.
2	Klikkaa Laitteen aktivointi -välilehti.
3	Klikkaus Pyydä aktivointikoodi.

Järjestelmä luo aktivointikoodin ja (edellyttäen, että olet määrittänyt järjestelmän oikein) järjestelmä lähettää aktivointikoodin sähköpostitse ensisijaiselle käyttäjälle.

Mitä tehdä seuraavaksi

Anna laite käyttäjälle. Kun käyttäjä on liittänyt laitteen, hänen on syötettävä sähköpostissa lähetetty aktivointikoodi. Tämä liittää laitteen Webex for Cisco BroadWorksiin.

MPP:n käyttöönotto Webexiin

Tässä osiossa kuvataan joko uusien tai olemassa olevien MPP-laitteiden käyttöönotto Webex for Cisco BroadWorksille. Huomaa, että "olemassa oleva" viittaa MPP-laitteeseen, joka on olemassa BroadWorksissä, mutta jolla ei ole Webex-ominaisuutta.

MPP-laitteiden käyttöönotto (uudet laitteet)

Käyttöönoton aikana järjestelmänvalvoja päivittää BroadWorksin MPP-tuella, päivittää laitteen laiteohjelmiston ja varaa laitteen BroadWorksiin käyttöönottoa varten.

Seuraava kaavio antaa yleiskatsauksen käyttöönottoprosessista sen jälkeen, kun käyttäjän antama aktivointikoodi on vahvistettu.

MPP-laitteiden käyttöönotto (olemassa olevat laitteet)

Olemassa oleville MPP-laitteille, joissa laite on jo BroadWorksissä, mutta sitä ei ole liitetty Webexiin, päivitä BroadWorks ja laitteen laiteohjelmisto tukemaan MPP:tä Webexin käyttöönottoon. Päivitysten jälkeen laite siirtyy Webexiin automaattisesti.

Lisätietoja

Lisätietoja MPP-laitteiden käyttöönottamisesta Webexiin on ominaisuuden kuvauksessa Cisco BroadWorks DMS -parannukset Webexille, jotka mahdollistavat MPP-laitteet.

MPP-laitteen edellytykset

Minimi MPP-versio

MPP-laiteohjelmisto vähintään 11.3.7

BroadWorks Patch -vaatimukset

Tätä ominaisuutta tuetaan Release Independent (RI) ADP-palvelimen versiosta 2021.11 alkaen ilman korjauspäivitysvaatimuksia.

R22:lle:

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.platform.22.0.1123.ap381367
AP.platform.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

R23:lle:

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

R24:lle:

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

BroadWorks-alustan vaatimukset

Tämä ominaisuus on käytettävissä:

R22: saatavilla vain XSP:lle
R23: saatavana XSP:llä tai ADP:llä (Release Independent)
R24: saatavilla ADP:ssä (Release Independent)

BroadWorks-määritysvaatimukset

Tämän ratkaisun toteuttamiseksi Flowthrough-hallinta on määritettävä siten, että Broadworks voi tarjota laitteita Webexille.

Varmista, että Integroitu IM+P palvelu on käytössä BroadWorksissä ja osoittaa BroadWorks Provisioning Bridge -sillalle.

Provisioning Bridge -URL-osoite määritettiin, kun asiakasmallia käytettiin organisaatiossa. Tämän olisi pitänyt tehdä Webex for Cisco BroadWorks -asennuksen aikana. Jos haluat löytää nykyisen URL-osoitteen Partner Hubista, katso Määritä sovelluspalvelimen hallintapalvelun URL-osoite in Webex for Cisco BroadWorks -ratkaisuopas.
Jos sinulla on useita kumppaniorganisaatioita, tarvitset oman Device Management Service (DMS) -esiintymän kumppania kohden.

Sertifikaatit ja palomuurit

Varmista, että olet määrittänyt seuraavat:

Varmennevaatimukset – MPP-laitteet käyttävät mTLS-todennusta laitevarmenteen avulla. Varmenteen tarjoama laitteen MAC-osoite todentaa laitteen. Lataa tarvittavat varmenteet MPP-laitteellesi osoitteesta https://www.cisco.com/security/pki/.

Lataa sertifikaatit vahvistaaksesi luottamusta ADP:hen tai palomuuriin. Jos esimerkiksi lataat ADP:hen, käytä tätä komentoa:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
Palomuurivaatimukset – Jos ADP on palomuurin takana, palomuuriisi on määritettävä sääntö, joka poimii MAC-osoitteen laitevarmenteesta ja sijoittaa sen Authentication-otsikkoon, joka välitetään sitten ADP:lle. Esimerkiksi identiteettimalli .*([0-9a-fA-F]{12}).* voidaan käyttää MAC-osoitteen poimimiseen, joka voidaan sitten sijoittaa otsikkoon, joka käyttää kuvaavaa nimeä (esim. macaddress).

Jos ADP ei ole palomuurin takana, edeltävää vaatimusta ei ole.

Ominaisuuden aktivointi

Aktivoi seuraavat BroadWorks-ominaisuudet AS:ssa:

101377 Parannuksia Webex- ja MPP-laitteiden käyttöönottoon
25088 Tukipuhelimet DECT-laitteille
23775 Etänollaus MPP-laitteille
24104 Tukee monisoluketjutusta DECT-laitteille
20077 Device Management Enhancements
19559 Visual Device Management Enhancements
02283 Laiteprofiilityypin mukauttamisen parannukset

Suorita esimerkiksi seuraava komento ottaaksesi käyttöön 101377. Muuta ominaisuuden numero, kun aktivoit muita ominaisuuksia: AS_CLI/System/ActivatableFeature> activate 101377

Suorita seuraava CLI verkkopalvelimessa:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Aktivointikoodin vaatimukset

Valinnainen. Aktivointikoodit eivät ole pakollisia MPP-laitteen käyttöönottoon. Jos kuitenkin haluat käyttää aktivointikoodeja, katso Pyydä MPP:n aktivointikoodi lisävaatimuksia, jotka koskevat MPP-aktivointikoodeja.

MPP Device Onboarding Flow

Suorita seuraavat tehtävät määrittääksesi järjestelmäsi tukemaan MPP-laitteiden käyttöönottoa Webex for Cisco BroadWorksille.

Jos lisäät Webex-ominaisuuden MPP-laitteeseen, joka on jo olemassa BroadWorksissa, suorita vain vaiheet 1 ja 2.

1	Määritä palvelut MPP:lle (Uudet tai olemassa olevat MPP-laitteet). Määritä järjestelmätuki MPP:lle Webexissä Cisco BroadWorksille.
2	Päivitä MPP-laitteen laiteohjelmisto (Olemassa olevat MPP-laitteet). Päivitä uusimpaan laiteohjelmistoon kaikissa olemassa olevissa MPP-laitteissa, joihin haluat lisätä Webex-ominaisuuden.
3	Tarjoa MPP-laite (Vain uudet MPP-laitteet). Jos laitetta ei ole BroadWorksissä, määritä laite ja ensisijainen käyttäjä BroadWorksissä.
4	Pyydä MPP:n aktivointikoodi (Valinnainen). Jos haluat käyttää aktivointikoodeja MPP-laitteissa, pyydä aktivointikoodi.

Määritä palvelut MPP:lle

Päivitä BroadWorks-järjestelmäasetukset tukemaan MPP-laitteita (uusia tai olemassa olevia) Webex for Cisco BroadWorksissä. Suorita tämä vaihe vain kerran. Sinun ei tarvitse toistaa tätä toimenpidettä jokaiselle MPP-laitteelle.

Ennen kuin aloitat

Jos ADP on palomuurin takana, palomuurisi on määritettävä säännöllä, joka poimii MAC-osoitteen laitevarmenteesta ja sijoittaa sen Authentication-otsikkoon, joka välitetään ADP:lle. Esimerkiksi identiteettimalli .*([0-9a-fA-F]{12}).* voidaan käyttää MAC-osoitteen poimimiseen, joka voidaan sitten sijoittaa otsikkoon, joka käyttää kuvaavaa nimeä (esim. macaddress).

Katso palomuurin dokumentaatiosta ohjeita määrityksiin.

Tee palvelupyyntö perehdytysagentiltasi tai Cisco TAC:lta Cisco OAuth -palvelun tarjoamiseksi Cisco Identity Provider Federation -tilillesi. Nimeä pyyntösi "ADP AuthService Configuration" -toiminnolla.

Määritä Cisco Identity Provider -parametrit suorittamalla seuraavat CLI-komennot.

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

set clientId <clientId> — katso tunnuksen palvelupyyntövastaus.
set clientSecret <clientSecret> — katso salainen palvelupyyntövastaus.
set issuerName <URL> – katso URL-osoite seuraavasta taulukosta.
set issuerUrl <URL> – katso URL-osoite seuraavasta taulukosta.
set ciResponseBodyMaxSizeInBytes 65536

Taulukko 3. Aseta isännöitsijänimi ja isännöitsijän URL-osoite

Jos CI-klusteri on...

Aseta isännöitsijänimi ja isännöitsijän URL arvoiksi...

US-A

https://idbroker.webex.com/idb

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

US-B

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

Jos et tiedä omaasi CI-klusteri, saat tiedot Control Hubin Help Desk -näkymän Asiakastiedoista.

Aseta DM Bridgen URL käyttämällä alla olevaa CLI-komentoa. DM Bridgen URL-osoite on erilainen jokaiselle Teams-klusterille (jonka vedit vaiheessa 2).

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

Taulukko 4. DM_Sillan URL-osoite
Jos Teams Cluster on...	Aseta DM_Bridge URL kohteeseen...
ACHM	dm-bridge-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
AFRA	dm-bridge-k.wbx2.com

Ota MAC-osoitteen purkaminen ja todennus käyttöön joko Authentication-otsikon tai Authentication-varmenteen avulla. Turvallisuussyistä suosittelemme, että käytät vain yhtä seuraavista vaihtoehdoista:

Todennusotsikko – Jos ADP on palomuurin takana, käytä ADP:n CLI:tä ottaaksesi MAC-osoitteen purkamisen käyttöön todennusotsikkoa varten. Tämä kokoonpano antaa ADP:lle mahdollisuuden tunnistaa MAC-osoitteen Authentication-otsikosta. Esimerkiksi:

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}).*"

Tässä esimerkissä macaddress on määritetty nimi .*([0-9a-fA-F]{12}).* edustaa mallia, joka määritetään otsikkoon. Jos kutsut otsikkoa muuksi kuin macaddress, säädä CLI vastaavasti.
Todennusvarmenne – Jos ADP ei ole palomuurin takana, todennus tapahtuu suoraan laitteen ja ADP:n välillä. Käytä alla olevia CLI-komentoja ottaaksesi MAC-osoitteen purkamisen käyttöön laitevarmenteessa todennusta varten:

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

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

Päivitä MPP-laitteen laiteohjelmisto

Ennen kuin aloitat

Varmista, että BroadWorks on päivitetty MPP-palvelutuella.

Päivitä laitteen laiteohjelmisto uusimpaan versioon varmistaaksesi, että MPP-laite tukee Webex-ominaisuutta.

Lisätietoja laiteohjelmiston päivityksistä on puhelinmallisi laiteohjelmistojulkaisun julkaisutiedoissa.

Mitä tehdä seuraavaksi

Olemassa olevat MPP-laitteet – Päivityksen jälkeen laite siirtyy Webexiin automaattisesti. Käyttäjä voi aloittaa Webex-palvelujen käytön laitteella.
Uudet MPP-laitteet – Tarjoa uusi MPP-laite BroadWorksissä.

Tarjoa MPP-laite

Jos uutta MPP-laitetta ei ole BroadWorksissä, varaa laite BroadWorksissä.

Tarkista BroadWorks CommPilotissa Identiteetti/laiteprofiilityyppi määritykset nähdäksesi, onko tälle MPP-laitteelle olemassa laitetyyppi. Jos laitetyyppiä ei ole BroadWorksissä, tuo laitetyyppi BroadWorksiin käyttämällä DTAF-tiedostoa, joka on ladattu osoitteesta cisco.com.

Avaa BroadWorks CommPilotissa Identiteetti/laiteprofiilityyppi ja tarkista Salli aktivointikoodin käyttöönotto valintaruutu.

Luo an Identiteetti/laiteprofiilityyppi Tiedoston SIP-asetukset, joita haluat käyttää.

Luo an Identiteetti/laiteprofiili uuden laitteesi asetuksista. Vuonna Mac osoite kenttään, kirjoita laitteen MAC-osoite.

Jos käytät MPP-laitteiden aktivointikoodeja, jätä Mac osoite kenttä tyhjä.

Määritä ensisijainen käyttäjä. Käytössä Käyttäjien lisäys sivu, aseta isPlace valintaruutu sen mukaan, onko laite henkilökohtainen vai jaettuun työtilaan:

Valittu — työtilalaite
Ei valittuna – henkilökohtainen laite

Täytä vaihtoehto, joka vastaa käytettävää laitetyyppiä ja hallintamenetelmää:

Laite on tarkoitettu jaettuun työtilaan – käytä Luo BroadWorks-työtila API työtilan laitteen hallintaan.
Laite on henkilökohtainen; haluat käyttää julkisia sovellusliittymiä – käytä Provision BroadWorks Subscribers API pääkäyttäjän hallintaan.
Laite on henkilökohtainen; haluat käyttäjien aktivoivan itse – välitä käyttäjän aktivointiportaalin URL-osoite käyttäjälle. Käyttäjän on vahvistettava sähköpostiosoitteensa, jotta hallinta on valmis.
Laite on henkilökohtainen; haluat käyttää läpikulkuprosessia – siirry vaiheeseen 7.

alkaen Profiili sivu, napsauta Määritä palvelut.
Luettelossa Käytettävissä olevat palvelut, valitse Integroitu IM&P ja siirrä kohde nuolella kohtaan Käyttäjäpalvelut laatikko.
Klikkaus OK.
Klikkaus Profiili.
Vain luotettava sähköpostivirta. Lisää käyttäjä Sähköposti osoite. Tämä asetus toimii IM&P-sähköpostina Webex for Cisco BroadWorksin läpiviennissä. Tätä ei vaadita, jos käytät epäluotettavaa sähköpostivirtaa.

Webexin asiakasmalliin on määritettävä luotettujen tai epäluotettujen sähköpostien läpivientiasetukset. Katso lisätietoja Webex for Cisco BroadWorks -ratkaisuopas.

Mitä tehdä seuraavaksi

Valinnainen. Jos haluat käyttää aktivointikoodeja MPP-laitteissa, pyydä aktivointikoodi BroadWorksistä.

Pyydä MPP:n aktivointikoodi

(Valinnainen) Webex for Cisco BroadWorks ei vaadi aktivointikoodeja uusiin MPP-laitteisiin. Jos kuitenkin päätät käyttää aktivointikoodeja, täytä Pyydä aktivointikoodi pyydä aktivointikoodi uudelle laitteelle.

Edellytykset aktivointikoodien käyttämiselle MPP-laitteiden kanssa

Jos käytät MPP-laitteiden aktivointikoodia, varmista, että järjestelmäsi täyttää seuraavat aktivointikoodikohtaiset vaatimukset.

Laitteen aktivointipalvelu—Täytä seuraavat vaatimukset ottaaksesi laitteen aktivointipalvelun käyttöön:

Ota laitteen aktivointipalvelu käyttöön BroadWorksissä. Katso lisätietoja Cisco BroadWorks turvaa käyttöönottoa aktivointikoodeilla.
Osoita Device Activation Service (DAS) Device Management Services (DMS) -palveluun BroadWorks AS:ssa käyttämällä seuraavaa CLI-komentoa:

AS_CLI/Interface/DAS> set url <url_of_DMS>
Varmista, että BroadWorks-klusterin DAS-URL-asetus on Device Management Services (DMS) -URL-osoite. Voit tarkastella nykyistä DAS-URL-asetusta Partner Hubissa siirtymällä osoitteeseen asetukset > BroadWorks kutsuu > Näytä klusterit ja valitse sopiva klusteri. URL-osoite näkyy alla Käyttöliittymäasetukset.

Cisco Global Discovery Services (GDS)— GDS tarvitaan aktivointikoodin antamiseen. Ota GDS käyttöön BroadWorksissä suorittamalla molemmat alla olevat vaiheet:

Luo palvelupyyntö GDS-tilisi luomiseksi. Cisco tarjoaa sinulle asiakastunnuksen, asiakkaan salaisuuden, päivitystunnuksen ja GDS-toimialueen.

Kun GDS-tilisi on luotu, ota GDS käyttöön ADP:ssä käyttämällä seuraavaa CLI:tä:

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>

Yllä olevien aktivointikoodikohtaisten edellytysten lisäksi järjestelmäsi on täytettävä yleiset MPP-vaatimukset MPP-laitteen edellytykset.

Pyydä aktivointikoodi

Pyydä aktivointikoodi uudelle MPP-laitteelle suorittamalla seuraavat vaiheet.

Vuonna Identiteetti/laiteprofiili -sivulla, etsi ja avaa uuden laitteesi laiteprofiili.
Klikkaa Laitteen aktivointi -välilehti.
Klikkaus Pyydä aktivointikoodi.

Järjestelmä luo aktivointikoodin ja lähettää koodin sähköpostitse ensisijaiselle käyttäjälle. Käyttäjän on syötettävä koodi laitteeseen suorittaakseen käyttöönoton.

Laitteen huollettavuus

Huollettavuuden yleiskatsaus

Control Hub sisältää huollettavuusvaihtoehtoja, joiden avulla järjestelmänvalvojat voivat tarkastella laitteen tilaa, sekä joukon ylläpitovaihtoehtoja. Järjestelmänvalvojat voivat:

Näytä laitteen nykyinen tila
Käynnistä laite uudelleen etänä
Lähetä ongelmaraportti vianmääritystä varten
Poista laite

Näytä laitteen tila

Käytä tätä menettelyä tarkastellaksesi laitteen tilaraporttia Control Hubista. Tila sisältää tietoja, kuten rekisteröintitilan, MAC-osoitteen, SIP-osoitteen, IP-osoitteen ja sarjanumeron.

1	Kirjaudu sisään asiakasorganisaation Control Hub -esiintymään.
2	Klikkaus Laitteet.
3	Napsauta sopivaa laitetta.

Uudelleenkäynnistä laite

Käytä tätä menettelyä käynnistääksesi laitteen uudelleen Control Hub -liittymästä.

1	Kirjaudu sisään asiakasorganisaation Control Hub -esiintymään.
2	Klikkaus Laitteet.
3	Valitse laite.
4	alkaen Toiminnot pudotusvalikosta, valitse Käynnistä uudelleen.

Ilmoita ongelmasta

Jos kohtaat ongelmia laitteen kanssa, lähetä ongelmaraportti Cisco TAC:lle vianmääritystä varten.

1	Kirjaudu sisään asiakasorganisaation Control Hub -esiintymään.
2	Klikkaus Laitteet.
3	Napsauta sopivaa laitetta.
4	From Toiminnot, valitse Ilmoita ongelmasta.
5	Tarkista raportin yhteenveto.

Poista laite

Käytä tätä menettelyä poistaaksesi laitteen Control Hubista.

1	Kirjaudu sisään asiakasorganisaation Control Hub -esiintymään.
2	Klikkaus Laitteet.
3	Valitse sopiva laite.
4	alkaen Toiminnot pudotusvalikosta, valitse Poistaa.

Vaihda laitteen omistaja

Käytä tätä toimenpidettä siirtääksesi olemassa olevan laitteen, joka oli otettu käyttöön aktivointikoodeilla, uudelle laitteen omistajalle.

Tämä menettely olettaa, että Salli aktivointikoodin käyttöönotto vaihtoehto on käytössä Identiteetti/laiteprofiili joita tämä laite käyttää.

Poista nykyinen laitteen rekisteröinti Webexistä:

Avaa Webex Control Hubissa asiakasorganisaatio, johon nykyinen laitteen omistaja kuuluu.
Alla Hallinto, klikkaus Laitteet.
Valitse sen laitteen vieressä oleva valintaruutu, jonka haluat siirtää.
Klikkaus Poistaa.

Laitteen rekisteröinti poistetaan Webexistä.

Poista BroadWorksissä laitteen rekisteröinti käytöstä olemassa olevan käyttäjän alla:

Avaa BroadWorks CommPilotissa Identiteetti/laiteprofiili joita laite käyttää.
Klikkaa Laitteen aktivointi -välilehti.
Klikkaus Poista laite käytöstä.

Laite deaktivoituu ja rekisteröityy pois BroadWorksistä. MAC-osoite pyyhitään pois vanhasta Identiteetti/laiteprofiili kokoonpano.

Aktivoi BroadWorksissä laite käyttämällä eri aktivointikoodia Identiteetti/laiteprofiili toisen käyttäjän käyttämä:

Avaa BroadWorks CommPilotissa toinen Identiteetti/laiteprofiili konfigurointi toiselle käyttäjälle.
Varmista että Salli aktivointikoodin käyttöönotto tarkistetaan Identiteetti/laiteprofiilityyppi jota käytetään.
Vuonna Identiteetti/laiteprofiili ikkunassa, napsauta Laitteen aktivointi -välilehti.
Klikkaus Pyydä aktivointikoodi.

Uusi aktivointikoodi tulee näkyviin. Uuden käyttäjän on syötettävä tämä koodi päästäkseen laitteeseen.

Mitä tehdä seuraavaksi

Uusi laitteen omistaja syöttää aktivointikoodin laitteeseen.
Laite rekisteröityy uudelleen sekä Webexiin että BroadWorksiin käyttämällä uutta kokoonpanoa. Uusi Identiteetti/laiteprofiili BroadWorks päivittää automaattisesti laitteen MAC-osoitteella.

Suorituskyvyn seuraaminen

Tälle ominaisuudelle on olemassa seuraavat suorituskykylaskurit.

Laskuri	Kuvaus
Moduuli: companies.broadsoft.broadworks.deviceActivation.activate
bwDASActivateRequests	Vastaanotettujen aktivointipyyntöjen kokonaismäärä. Tämä sisältää BroadWorks-pyyntöjen ja Webex-pyyntöjen aktivoimisen.
bwDASActivateFailures	Niiden aktivointipyyntöjen kokonaismäärä, joiden suorittaminen epäonnistui. Tämä sisältää BroadWorks-aktivointipyynnöt, jotka epäonnistuivat, ja Webex-aktivointipyynnöt, jotka epäonnistuivat.
bwDASActivateBroadWorksRequests	Vastaanotettujen BroadWorks-aktivointipyyntöjen määrä.
bwDASActivateBroadWorksFailures	Niiden BroadWorks-aktivointipyyntöjen määrä, joiden suorittaminen epäonnistui. Tämä laskuri ei huomioi valtuutus- ja todennusvirheitä.
bwDASActivateWebexRequests	Vastaanotettujen Webex-aktivointipyyntöjen määrä.
bwDASActivateWebexFailures	Niiden Webex-aktivointipyyntöjen määrä, joiden suorittaminen epäonnistui.
Moduuli: companies.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Lähetettyjen DMBridge-pyyntöjen määrä.
bwDMBridgeFailures	Niiden DMBridge-pyyntöjen määrä, joiden suorittaminen epäonnistui.

Webexin integroitujen laitteiden loppukäyttäjäominaisuudet

Yhtenäinen puheluhistoria

Webex-tietoiset MPP-puhelimet

Webex Aware Cisco MPP Devices Webex for BroadWorks -alustalla pystyy nyt näyttämään yhtenäisen puheluhistorian käyttäjän Webex-asiakkaasta ja heidän laitteistaan soitettuista/vastaanotetuista puheluista. Tämä mahdollistaa paremman käyttökokemuksen loppukäyttäjien laitteille, koska he voivat tarkkailla ja käyttää Webex-sovelluksensa kautta soitettuja/vastaanotettuja puheluita MPP-laitteidensa puhelulokien kautta sekä kaikkia laitteellaan käsiteltyjä paikallispuheluita.

Webex Unified Call History on oletuslähde käyttäjän puheluhistorian tarkastelussa. Tämä puheluhistoria sisältää kaikista puhelimista, Webex-videolaitteista tai Webex-sovelluksesta soitetut puhelut.

Vaikuttavat IP-puhelinmallit:

MPP 68xx Sarjat 6821, 6841, 6851, 6861
MPP 78xx Sarjat 7811, 7821, 7841, 7861
MPP 88xx Sarjat 8811, 8841, 8845, 8851, 8861, 8865, 8875

Ominaisuuden käyttöönotto:

Ominaisuuden käyttöönotto edellyttää, että seuraavat ehdot täyttyvät

Webex for BroadWorks -laiteintegraatio on toteutettava ja toimiva MPP-laitteille. Lisätietoja löytyy tästä oppaasta Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Patch- ja DTAF-vaatimukset:

Broadworks - Tämä ominaisuus riippuu asiaankuuluvista BroadWorks-korjaustiedostoista, joita asennetaan. Yksityiskohdat löytyvät tässä.
Laite – Uusimmat MPP-kokoonpanot on otettava käyttöön. Tarvittavat CPE-sarjat löytyvät tässä (kirjaudu sisään CCO-tunnuksella).

Odotukset/vaikutukset/rajoitukset:

Ensisijainen linja (vain nykyinen käyttäjä)
- Yhtenäistä puheluhistoriaa tuetaan, kuten mainittiin.
- Tuki Yksityisyyden suoja - Suojaa/piilota puheluhistoria, kun käyttäjän salasana on asetettu.
- Jos puhelin ei ole Cloud Aware, vain tälle laitteelle soitettujen ja siitä lähtevien puheluiden "paikallinen historia" näytetään.
Muut rivit (jaetut tai muut)
- Vain laitteesta tulevien ja laitteesta lähtevien puheluiden paikallishistoriaa tuetaan.
Työtilan laitteet
- Yhtenäistä puheluhistoriaa ei tueta tässä tapauksessa.

Kun ominaisuus on käytössä, kaikki MPP:n paikallispuheluhistoria (johdettu BroadWorksistä) poistetaan.

Webex BroadWorksin integroiduille RoomOS-laitteille

Webex for BroadWorks -integroidut Cisco RoomOS Devices -laitteet voivat nyt näyttää yhtenäisen puheluhistorian käyttäjän Webex-asiakassovelluksesta ja heidän laitteistaan soitetuista/vastaanotetuista puheluista. Tämä mahdollistaa paremman käyttökokemuksen loppukäyttäjien laitteille, koska he voivat tarkkailla ja käyttää Webex-sovelluksensa kautta soitettuja/vastaanotettuja puheluita RoomOS-laitteidensa puhelulokien kautta sekä kaikkia laitteilla käsiteltyjä paikallispuheluita.

Saatavilla alla oleviin RoomOS-laitemalleihin:

RoomOS-laitteet
Pöytäsarja: Työpöytä, Desk Mini, Desk Pro
Huonesarja
RoomKit-sarja
Webex Board -sarja

Ominaisuuden käyttöönotto:

Webex for BroadWorks -laiteintegraatio on otettava käyttöön ja toimiva RoomOS-laitteille. Lisätietoja löytyy tästä oppaasta Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Patch- ja DTAF-vaatimukset:

Broadworks - Tämä ominaisuus riippuu asiaankuuluvista BroadWorks-korjaustiedostoista, joita asennetaan. Yksityiskohdat löytyvät tässä.

Kokoonpanovaatimukset:

Alla olevat kokoonpanot on määritettävä määritetyllä tavalla
- Bwks Config: Feature_Toggle_Webex_Soita = Kyllä

Webex for BroadWorks -integroitujen RoomOS-laitteiden hakemistohaun parannuksia

Webex for BroadWorks integroitu Cisco RoomOS Device käyttäjät voivat nyt etsiä ihmisiä, tiloja ja jopa laitteita Webex-organisaatiossaan suoraan RoomOS-laitteistaan uuden parannetun Webex Directory -palvelun avulla. Tämä palvelu tarjoaa parannetut haku- ja hakuominaisuudet Webex for BroadWorks -käyttäjille, jotta he voivat löytää käyttäjiä ja asioita (työtiloja, laitteita jne.) Webex-organisaatiostaan.

Saatavilla alla oleviin RoomOS-laitemalleihin:

RoomOS-laitteet
Pöytäsarja: Työpöytä, Desk Mini, Desk Pro
Huonesarja
RoomKit-sarja
Webex Board -sarja

Ominaisuuden käyttöönotto:

Webex for BroadWorks -laiteintegraatio on toteutettava ja toimiva MPP-laitteille. Lisätietoja löytyy tästä oppaasta Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Kokoonpanovaatimukset:

Hakemistopalvelun vaihtokytkin “xConfiguration Webex DirectoryServiceSupport” on otettava käyttöön laitteessa.

Johdanto

Tietoa tästä oppaasta

Tämä asiakirja on tarkoitettu palveluntarjoajaorganisaatioiden kumppaneiden ylläpitäjille, jotka ottavat käyttöön Webex for Cisco BroadWorks -palvelun. Oppaassa kuvataan, miten Room OS- ja MPP-laitteet otetaan käyttöön ja huolletaan Cisco BroadWorksin Webex for Webexiä varten. Opas on jaettu kahteen lukuun:

Laitteen käyttöönotto-Kuvaus siitä, miten Room OS -laitteet (Room- ja Room Kit -sarjat, Desk-sarja ja Board-sarja) ja MPP-laitteet otetaan käyttöön Webex for Cisco BroadWorksissa.
Laitteen huollettavuus- Kuvaa, miten Control Hubissa olevia laitteita hallitaan.

Asiakirjan muutoshistoria

Seuraavassa taulukossa on yhteenveto tämän asiakirjan muutoshistoriasta.

Päiväys	Asiakirjan versio	Muutoksen kuvaus
12. toukokuuta 2023	1.7	Lisätty Webex for BroadWorks integrated Cisco RoomOS Devices ja Hakemistohakua koskevat parannukset W4B Integrated RoomOS Devices kohtaan End user features for Webex integrated Devices.
27. helmikuuta 2023	1.6	Päivitetty Configure Services for Room OS vaiheet kohdassa Device Onboarding.
17. helmikuuta 2023	1.5	Lisätty Unified Call History for Webex aware MPP phones -osio osoitteeseen End user features for Webex integrated Devices.
14. lokakuuta 2022	1.4	Päivitetty Room OS:n käyttöönottoprosessi kohdassa Room OS Onboarding sisällyttämällä SRV-tietueet. Päivitetty BroadWorksin konfigurointivaatimukset kohdassa Room OS Prerequisites ja lisätty viittaus Solution Guide -ratkaisuoppaaseen läpivirtauksen käyttöönoton vaatimusten osalta.
20. kesäkuuta 2022	1.3	Päivitetty Room OS Prerequisites ja MPP Device Prerequisites viittauksella Solution Guide -ratkaisuoppaaseen läpivirtauksen käyttöönottovaatimusten osalta. Päivitetty Provision Room OS Devices ja Provision MPP Device sisältämään tietoa eri käyttöönottomenetelmistä.
kesäkuu 03, 2022	1.2	Korjattu Device Profile Type -ominaisuuden aktivointinumero (02283) osoitteessa Room OS Prerequisites ja MPP Device Prerequisites (MPP-laitteen edellytykset).
toukokuu 27, 2022	1.1	Korjattu vaatimus, jonka mukaan jokaiselle kumppaniorganisaatiolle on oltava oma DMS-instanssi. Lisätty Esipuhe luku. Päivitetty otsikko "Device Integration Guide".
20. toukokuuta 2022	1.0	Alkuperäinen julkaisu

Laiteintegraatio Webex for Cisco BroadWorks -ohjelmistoon

Laitteen käyttöönoton yleiskatsaus

Tässä luvussa kuvataan, miten laitteet liitetään Webex for Cisco BroadWorks -palveluun. Tässä luvussa käsitellään seuraavia käyttötapauksia:

Uusien Webex Room OS -laitteiden käyttöönotto (aktivointikoodien avulla)
Uudet MPP-laitteet
Webex-ominaisuuksien lisääminen olemassa oleviin MPP-laitteisiin

Suosittelemme, että otat tämän ominaisuuden käyttöön Release Independent ADP -palvelimissa. XSP tukee kuitenkin myös tätä ominaisuutta. Jos käytät XSP:tä, voit korvata "XSP:n" tässä asiakirjassa mainituilla maininnoilla "ADP", ellei tekstissä mainita vain ADP:tä.
Tämä ominaisuus tukee sekä henkilökohtaisia että työtilalaitteita.

Room OS Onboarding

Webex for Cisco BroadWorks tukee aktivointikoodien käyttöönottoa sekä jaetuille että työtilan Room OS -laitteille.

Laitteen käyttöönotto aktivointikoodien avulla

Aktivointikoodien avulla tapahtuva laitteen käyttöönotto tarjoaa yksinkertaisen ja turvallisen tavan ottaa käyttöön Room OS -laitteita. Aktivointikoodi on 16-numeroinen järjestelmän luoma kertakäyttöinen salasana, joka käyttäjän on syötettävä laitteeseen päästäkseen laitteeseen. Aktivointikoodi on turvallisesti liitetty aiottuun käyttäjätiliin, ja se varmistaa, että vain aiottu käyttäjä käyttää samaan tiliin liitettyä laitetta. Kun käyttäjä on syöttänyt oikean koodin, laite muodostaa yhteyden sekä Webexiin että BroadWorksiin, suorittaa rekisteröinnin loppuun, lataa konfigurointitiedostonsa ja on käyttövalmis.

Seuraavat Room OS -laitteet tukevat käyttöönottoa aktivointikoodien avulla:

Webex Board Series (huone OS)
Webex Desk Series (huone OS)
Webex-huonesarja (Room OS)

Huone OS:n käyttöönottoprosessi

Seuraavassa prosessissa kuvataan, mitä tapahtuu, kun Room OS -laite otetaan käyttöön aktivointikoodien avulla:

Yhteistyökumppanin järjestelmänvalvoja määrittää ensisijaisen käyttäjän ja laitteen BroadWorksissa ja luo sitten aktivointikoodin BroadWorksissa.
Laitteen omistajalle lähetetään sähköpostiviesti, joka sisältää laitteen aktivointikoodin.
Laitteen omistaja käynnistää laitteen.
Laite pyytää laitteen omistajaa syöttämään aktivointikoodin.
Laitteen omistaja syöttää laitteeseen aktivointikoodin.
Laite liitetään BroadWorksiin ja Webexiin seuraavan aliprosessin avulla:
- Room OS -laite lähettää aktivointipyynnön Webex-palveluille. GDS tarkistaa aktivointikoodin, ja jos koodi on oikea, laite liitetään Webexiin. Webex palauttaa laitteelle koneen tunnisteen.
- Laite lähettää aktivointipyynnön BroadWorks DM:lle yhdessä koneen tunnisteen ja MAC-osoitteen kanssa.
- BroadWorks valtuuttaa ja ottaa laitteen käyttöön.
- Laite lähettää BroadWorks DM:lle pyynnön päivitetystä konfiguraatiosta. Koneen tunniste on mukana valtuutusta varten.
- BroadWorks hyväksyy tunnuksen, etsii päivitetyn konfiguraatiotiedoston ja palauttaa päivitetyn konfiguraatiotiedoston.
- Room OS yrittää löytää NAPTR-tietueen konfiguraatiotiedostossa määritetylle verkkotunnukselle, koska se odottaa löytävänsä SRV-merkinnän osoitteesta _sip._tls.<domain_in_config> jos NAPTR-tietuetta ei ole, RoomOS yrittää etsiä SRV-tietuetta ja sen jälkeen A-tietuetta.
  
  SRV-tietueen on oltava _sip._tls. koska roomOS tukee vain TLS:ää siirtoa varten ja SRTP:tä mediaa varten.
Laite rekisteröityy ja on käyttövalmis.

Seuraavassa kaaviossa on yksinkertaistettu yleiskuva palvelukseenottoprosessista.

Yksityiskohtaiset tiedot Room OS -käyttöjärjestelmän käyttöönotosta, mukaan lukien tarkemmat vuokaaviot, löytyvät ominaisuuden kuvauksesta Cisco BroadWorks Enhancements for Webex-Aware Device Onboarding.

Laitteen todennus (OAuth-kantajatunnisteiden avulla)

Laitteen todennus Room OS -laitteille edellyttää, että otat BroadWorksissa käyttöön Cisco OAuth Bearer Tokens -työkalut. Käyttöönoton aikana bearer-tunniste välitetään Activate Authorization -otsikon kautta, ja sen avulla laite tunnistetaan. IdP validoi bearer-tunnisteen ja palauttaa UUID-tunnisteen (koneen UUID-tunnisteen työtilalaitteissa tai käyttäjän UUID-tunnisteen henkilökohtaisissa laitteissa) bearer-subjektina. BroadWorks tallentaa UUID-tunnuksen laitteen nimeksi verkkopalvelimeen.

Huone OS Edellytykset

Huoneen käyttöjärjestelmän vähimmäisversio

Huone OS 10.13 vähintään

BroadWorks Patch -vaatimukset

Tätä ominaisuutta tuetaan Release Independent (RI) ADP-palvelimen versiosta 2021.11 alkaen, eikä siihen tarvita korjauksia.

Muihin kuin RI-palvelimiin on asennettava seuraavat korjaukset (korjaustiedostoryhmistä ap381367, ap381951 ja ap382198), jotta voit käyttää ominaisuutta. Asenna julkaisuasi koskevat korjaukset:

R22:lle:

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.platform.22.0.1123.ap381367
AP.platform.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

R23:lle:

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

R24:lle:

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

BroadWorks-alustavaatimukset

Tämä toiminto on käytettävissä seuraavissa:

R22: saatavana vain XSP:ssä
R23: saatavilla XSP:llä tai ADP:llä (Release Independent).
R24: saatavilla ADP:ssä (Release Independent)

BroadWorksin kokoonpanovaatimukset

Tämän ratkaisun käyttöönotto edellyttää, että Flowthrough-varaus on määritetty siten, että Broadworks voi varata laitteita Webexiin.

Kun määrität Flowthrough provisioningia, ei ole pakollista käyttää Flowthrough provisioningia käyttäjien määrittämiseen, eli voit jatkaa nykyisten määritysmenetelmien käyttöä (API, luotettu/luottamuksellinen sähköposti, käyttäjän oma käyttö jne.) käyttäjien määrittämiseen. Katso "Provisioning Requirements" (Käyttöönottovaatimukset) osoitteessa Webex for Cisco BroadWorks Solution Guide.
Varmista, että Integroitu IM+P -palvelu on käytössä BroadWorksissa ja osoittaa BroadWorks Provisioning Bridgeen.

Käyttöönottosillan URL-osoite määritettiin, kun asiakasmallia sovellettiin organisaatioon. Tämä olisi pitänyt tehdä Webex for Cisco BroadWorks -ohjelman alkuasetusten yhteydessä. Löydät olemassa olevan URL-osoitteen Partner Hubista osoitteesta Configure Application Server with Provisioning Service URL osoitteessa Webex for Cisco BroadWorks Solution Guide.
Jos sinulla on useita kumppaniorganisaatioita, tarvitset oman Device Management Service (DMS) -instanssin kutakin kumppania kohden.

Edellytykset aktivointikoodin käyttöönotolle Room OS:n kanssa

Varmista, että seuraavat asetukset on asetettu:

Ota laitteen aktivointipalvelu käyttöön BroadWorksissa. Lisätietoja on osoitteessa Cisco BroadWorks Secure Onboarding Using Activation Codes.
Tarkista, että BroadWorks-klusterin DAS URL -asetukseksi on määritetty Device Management Services (DMS) URL. Jos haluat tarkastella nykyistä DAS URL -asetusta Partner Hubissa, siirry osoitteeseen Asetukset > BroadWorks Calling > View Clusters ja valitse sopiva klusteri. URL-osoite näkyy kohdassa Käyttöliittymäasetukset.

Seuraavat BroadWorks-ominaisuudet on aktivoitava liitännäisjärjestelmässä:

101377 Parannukset Webex- ja MPP-laitteiden käyttöönottoon
25088 Tukipuhelimet DECT-laitteille
24104 Monisoluisen ketjutuksen tukeminen DECT-laitteissa
20077 Laitehallinnan parannukset
19559 Visuaalisen laitehallinnan parannukset
02283 Laiteprofiilin tyypin mukauttamisen parannukset

Suorita esimerkiksi seuraava komento ottaaksesi käyttöön 101377. Vaihda ominaisuuden numero, kun aktivoit muita ominaisuuksia: AS_CLI/System/ActivatableFeature> aktivoida 101377

Jos kaikki luetellut korjaukset on asennettu, mutta aktivoitavaa ominaisuutta ei ole lueteltu AS-versiossasi, se johtuu siitä, että se sisältyy jo AS:n perusversioon eikä vaadi aktivointia.

Suorita seuraava CLI-komento verkkopalvelimella:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Varmista, että SBC-varmenteen allekirjoittanut varmentaja on listattu Room OS Trust List -luettelossa. Voit tarkastella Room OS -luottamusluetteloa osoitteessa Device Web Portal. Valitse portaalissa Security > Collaboration Edge nähdäksesi CA-luettelon.

Room OS Onboarding Flow

Suorita seuraavat tehtävät määrittääksesi järjestelmäsi tukemaan Device Onboarding -käyttöönottoa aktivointikoodeilla seuraaville Webex Room OS -laitteille:

Webex Board Series
Webex Desk Series
Webex-huonesarja

1	Palveluiden määrittäminen huoneen käyttöjärjestelmää varten Määritä BroadWorksin tuki Room OS -laitteille.
2	Huoneen OS-laitteiden käyttöönotto Ota uusi laite käyttöön BroadWorksissa.
3	Pyydä aktivointikoodi Pyydä aktivointikoodi laiteprofiilissa. Koodi lähetetään automaattisesti sähköpostitse pääkäyttäjälle.

Palveluiden määrittäminen huoneen käyttöjärjestelmää varten

Ennen kuin voit ottaa käyttöön uusia Room OS -laitteita, aseta seuraavat järjestelmätason parametrit OAuth-todennuksen ottamiseksi käyttöön.

Tee palvelupyyntö käyttöönottovirkailijallesi tai Ciscon TACille Cisco OAuthin käyttöönottamiseksi Cisco Identity Provider Federation -tilillesi. Anna palvelupyynnölle otsikko "ADP AuthService Configuration".

Jos olet jo hankkinut Cisco OAuth Identity Provider -tunnukset käyttämällä jotakin tämän asiakirjan virtaa, uutta pyyntöä ei tarvitse luoda. Jos olet kuitenkin saanut Ciscon OAuth-tunnukset käyttämällä virtaa, jota ei ole tässä asiakirjassa, tee uusi palvelupyyntö päivittääksesi tunnukset.

Cisco antaa sinulle OAuth-asiakastunnuksen, asiakassalaisuuden ja päivitystunnisteen, joka on voimassa 60 päivää. Jos tunniste vanhenee ennen kuin käytät sitä ADP:n kanssa, voit tehdä uuden pyynnön.

Ota OAuth käyttöön tällä CLI-komennolla:

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

Varmista, että OAuth-alueeseen kuuluu broadworks-connector-user (alue on oletusarvoisesti käytössä). Suorita tämä komento tarkistaaksesi laajuudet:

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

Määritä Cisco Identity Provider -parametrit alla olevien CLI-komentojen avulla.

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

set clientId - katso palvelupyynnön vastaus ID:n osalta.
set clientSecret - katso palvelupyynnön vastaus salaisuuden osalta.
set issuerName - katso URL-osoite seuraavasta taulukosta.
set issuerUrl - katso URL-osoite seuraavasta taulukosta.
set tokenInfoUrl <IdPProxy_URL>- katso URL-osoite seuraavista taulukoista.
set ciResponseBodyMaxSizeInBytes 65536

Taulukko 1. Aseta issuerName ja issuerURL.
Jos CI-klusteri on...	Aseta issuerName ja issuerURL...
US-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Jos et tiedä CI-klusteriasi, saat tiedot Control Hubin Help Desk -näkymän asiakastiedoista.

Taulukko 2. Set tokenInfoURL
Jos Teams Cluster on...	Set tokenInfoURL to...(IdP Proxy URL)
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
Jos et tiedä Teams-klusteriasi, saat tiedot Control Hubin Help Desk -näkymän asiakastiedoista. Testausta varten voit tarkistaa, että tokenInfoURL on kelvollinen, korvaamalla URL-osoitteen "`idp/authenticate`" -osion osalla "`ping`".

Määritä Cisco Federationin identiteettipalveluntarjoajat seuraavien komentojen avulla:

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

Uusi salasana:

Kirjoita uusi salasana uudelleen:

...Done

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

Yhteistyökumppanin nimi Refresh Token

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

FederationPartner ********

1 merkintä löytyi.

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

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

Päivitystunniste on nyt CiscoIdentityProvider/Partners-kontekstissa, ja CiscoIdentityProvider/Federation-kontekstin partnerName-tiedon on vastattava CiscoIdentityProvider/Partners-kontekstissa lisättyä partneria.

Jos käytössäsi on ADP RI -kuorma, joka on vanhempi kuin 2022.10, R23 XSP ilman korjausta AP.xsp.23.0.1075.ap383838 tai R22 XSP, niin:

Sinun ei tarvitse määrittää kumppania kohdassa 'System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>'.
Päivitysmerkki on asetettava kohtaan: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

Tyhjennä kaikki olemassa olevat laajuudet seuraavissa kolmessa kontekstissa: ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Laajuusalueet
Admin/RolesAllowed
Admin/ScopesAllowed

Suorita jokaisesta kontekstista get saadaksesi olemassa olevat laajuudet ja poista ne sitten. Esimerkiksi:

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>

Huoneen OS-laitteiden käyttöönotto

Määritä BroadWorksissa Room OS -laite (Webex Board Series, Webex Desk Series tai Webex Room Series).

1	Tarkista BroadWorks CommPilotissa Identity/Device Profile Type -asetuksesta, onko laitetyyppi olemassa tälle Room OS -laitteelle. Jos laitetyyppiä ei ole BroadWorksissa, tuo laitetyyppi BroadWorksiin käyttämällä DTAF-tiedostoa, jonka voit ladata osoitteesta cisco.com.
2	Kun olet tuonut laitetyypin, varmista, että seuraavat asetukset ovat olemassa Identity/Device Profile Type -määrityksessä: Valitse Allow Activation Code Onboarding -valintaruutu. Merkitse Send Activation Code Request Through Messaging Server -valintaruutu. Aseta Authentication Mode osoitteeseen Bearer.
3	Varmista, että laiteprofiilitiedostossa on haluamasi SIP-asetukset. Varmista Identity/Device Profile Type File -tiedostossa, että Authentication Mode on Bearer.
4	Luo laiteprofiili, jossa on uuden laitteen asetukset. Jätä MAC-osoitekenttä tyhjäksi Identity/Device Profile Add/Modify -sivulla.
5	Määritä ensisijainen käyttäjä. Valitse Users Add -sivulla isPlace tai poista se sen mukaan, onko laite tarkoitettu henkilökohtaiseen vai jaettuun työtilaan. Tarkistettu-työtilan laite Ei valittua - Henkilökohtainen laite Jaetun työtilan laitteet edellyttävät myös ensisijaisen käyttäjän määrittämistä. Voit määrittää haluamasi ensisijaisen käyttäjän.
6	Täytä haluamaasi laitetyyppiä ja käyttöönottomenetelmää vastaava vaihtoehto: Laite on tarkoitettu jaettua työtilaa varten - Käytä Provision a BroadWorks Workspace API:ta työtilalaitteen käyttöönoton loppuun saattamiseksi. Laite on henkilökohtainen; haluat tehdä käyttöönoton julkisten API-rajapintojen avulla - Käytä Provision BroadWorks Subscribers API -ohjelmaa, kun haluat saattaa päätökseen ensisijaisen käyttäjän käyttöönoton. Laite on henkilökohtainen; haluat, että käyttäjät käyttävät itseaktivointia Välitä käyttäjän aktivointiportaalin URL-osoite käyttäjälle. Käyttäjän on vahvistettava sähköpostiosoitteensa, jotta käyttöönotto voidaan suorittaa loppuun. Laite on henkilökohtainen; haluat käyttää läpivirtauksen käyttöönottoa - siirry vaiheeseen 7.
7	Jos laite on henkilökohtaisessa käytössä ja haluat käyttää läpivirtauksen käyttöönottoa, määritä ensisijaiselle käyttäjälle Integrated IM+P -palvelu. Lisää IM+P-palvelu sivulla User > Profile : Valitse Profiili -sivulla Assign Services. Valitse Available Services (Käytettävissä olevat palvelut) -luettelosta Integrated IM&P ja siirrä kohde nuolinäppäimellä User Services (Käyttäjäpalvelut) -laatikkoon. Napsauta OK. Valitse Profiili. Vain luotettu sähköpostivirta. Lisää käyttäjän Sähköposti osoite. Tämä asetus toimii IM&P-sähköpostina, kun Webex for Cisco BroadWorks -palveluun tehdään läpivirtausta. Tätä ei tarvita, jos käytät epäluotettavaa sähköpostivirtaa. Webexin Asiakasmalliin on määritettävä asetukset läpivirtauksen käyttöönottoa varten luotetuilla sähköposteilla tai epäluotetuilla sähköposteilla. Lisätietoja on osoitteessa Webex for Cisco BroadWorks Solution Guide.

Mitä tehdä seuraavaksi

Pyydä aktivointikoodi Room OS -laitteelle.

Pyydä aktivointikoodi

Kun laite ja käyttäjä on otettu käyttöön BroadWorksissa, pyydä, että käyttäjälle lähetetään aktivointikoodi.

1	Etsi ja avaa uuden laitteen laiteprofiili sivulla Identity/Device Profile .
2	Napsauta Device Activation -välilehteä.
3	Napsauta Pyydä aktivointikoodi.

Järjestelmä luo aktivointikoodin, ja (edellyttäen, että olet määrittänyt järjestelmän oikein) järjestelmä lähettää aktivointikoodin sähköpostitse ensisijaiselle käyttäjälle.

Mitä tehdä seuraavaksi

Anna laite käyttäjälle. Kun käyttäjä on kytkenyt laitteen, hänen on syötettävä sähköpostitse lähetetty aktivointikoodi. Tämä ottaa laitteen käyttöön Webex for Cisco BroadWorks -palvelussa.

MPP Onboarding Webexiin

Tässä osassa kuvataan joko uusien tai olemassa olevien MPP-laitteiden käyttöönottoa Webex for Cisco BroadWorks -palveluun. Huomaa, että 'olemassa oleva' tarkoittaa MPP-laitetta, joka on olemassa BroadWorksissa, mutta jossa ei ole Webex-ominaisuuksia.

MPP Device Onboarding (uudet laitteet)

Käyttöönoton aikana järjestelmänvalvoja päivittää BroadWorksin niin, että se tukee MPP:tä, päivittää laitteen laiteohjelmiston ja määrittää laitteen BroadWorksissa käyttöönoton loppuun saattamiseksi.

Seuraavassa kaaviossa on yleiskuva käyttöönottoprosessista sen jälkeen, kun käyttäjän syöttämä aktivointikoodi on vahvistettu.

MPP-laitteen käyttöönotto (olemassa olevat laitteet)

Olemassa olevien MPP-laitteiden osalta, joissa laite on jo BroadWorksissa, mutta sitä ei ole liitetty Webexiin, päivitä BroadWorks ja laitteen laiteohjelmisto tukemaan MPP:n liittämistä Webexiin. Päivitysten jälkeen laite kytkeytyy Webexiin automaattisesti.

Lisätietoja

Lisätietoja MPP-laitteiden käyttöönotosta Webexissä on ominaisuuden kuvauksessa Cisco BroadWorks DMS Enhancements for Webex Enabling MPP Devices.

MPP-laitteen edellytykset

MPP:n vähimmäisversio

MPP:n laiteohjelmisto vähintään 11.3.7

BroadWorks Patch -vaatimukset

Tätä ominaisuutta tuetaan Release Independent (RI) ADP-palvelimen versiosta 2021.11 alkaen, eikä siihen tarvita korjauksia.

Muihin kuin RI-palvelimiin on asennettava seuraavat korjaukset (korjaustiedostoryhmistä ap381367, ap381951 ja ap382198), jotta voit käyttää ominaisuutta. Asenna julkaisuasi koskevat korjaukset:

R22:lle:

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.platform.22.0.1123.ap381367
AP.platform.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

R23:lle:

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

R24:lle:

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

BroadWorks-alustavaatimukset

Tämä toiminto on käytettävissä seuraavissa:

R22: saatavana vain XSP:ssä
R23: saatavana XSP:llä tai ADP:llä (Release Independent).
R24: saatavilla ADP:ssä (Release Independent)

BroadWorksin kokoonpanovaatimukset

Tämän ratkaisun käyttöönotto edellyttää, että Flowthrough provisioning on määritetty siten, että Broadworks voi tarjota laitteita Webexille.

Kun määrität Flowthrough provisioningia, ei ole pakollista käyttää Flowthrough provisioningia käyttäjien määrittämiseen, eli voit jatkaa nykyisten määritysmenetelmien käyttöä (API, luotettu/luottamuksellinen sähköposti, käyttäjän oma käyttö jne.) käyttäjien määrittämiseen. Katso "Provisioning Requirements" (Käyttöönottovaatimukset) osoitteessa Webex for Cisco BroadWorks Solution Guide.
Varmista, että Integroitu IM+P -palvelu on käytössä BroadWorksissa ja osoittaa BroadWorks Provisioning Bridgeen.

Käyttöönottosillan URL-osoite määritettiin, kun asiakasmallia sovellettiin organisaatioon. Tämä olisi pitänyt tehdä Webex for Cisco BroadWorks -ohjelman alkuasetusten yhteydessä. Löydät olemassa olevan URL-osoitteen Partner Hubista osoitteesta Configure Application Server with Provisioning Service URL osoitteessa Webex for Cisco BroadWorks Solution Guide.
Jos sinulla on useita kumppaniorganisaatioita, tarvitset oman Device Management Service (DMS) -instanssin kutakin kumppania kohden.

Varmenteet ja palomuurit

Varmista, että olet määrittänyt seuraavat asetukset:

Varmennevaatimukset-MPP-laitteet käyttävät mTLS-todennusta laitevarmenteen avulla. Laitteen MAC-osoite, jonka varmenne antaa, todentaa laitteen. Lataa MPP-laitteesi tarvitsemat varmenteet osoitteesta https://www.cisco.com/security/pki/.

Lataa varmenteet, jotta ADP:hen tai palomuuriin voidaan luottaa. Jos esimerkiksi lataat tiedoston ADP:hen, käytä tätä komentoa:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
Palomuurivaatimukset - Jos ADP on palomuurin takana, palomuuriin on määritettävä sääntö, joka poimii MAC-osoitteen laitteen varmenteesta ja sijoittaa sen todennusotsikkoon, joka sitten välitetään ADP:lle. Esimerkiksi identiteettimallia .*([0-9a-fA-F]{12}).* voidaan käyttää MAC-osoitteen poimimiseen, joka voidaan sitten sijoittaa otsikkoon, jossa käytetään kuvaavaa nimeä (esimerkiksi macaddress).

Jos ADP ei ole palomuurin takana, edellistä vaatimusta ei ole olemassa.

Ominaisuuden aktivointi

Aktivoi seuraavat BroadWorks-ominaisuudet liitännäisjärjestelmässä:

101377 Parannukset Webex- ja MPP-laitteiden käyttöönottoon
25088 Tukipuhelimet DECT-laitteille
23775 MPP-laitteiden etäpalautus
24104 Monisoluisen ketjutuksen tuki DECT-laitteille
20077 Laitehallinnan parannukset
19559 Visuaalisen laitehallinnan parannukset
02283 Laiteprofiilin tyypin mukauttamisen parannukset

Ota esimerkiksi seuraava komento käyttöön 101377.Muuta ominaisuuden numero, kun otat käyttöön muita ominaisuuksia: AS_CLI/System/ActivatableFeature> aktivoi 101377

Jos kaikki luetellut korjaukset on asennettu, mutta aktivoitavaa ominaisuutta ei ole lueteltu AS-versiossasi, se johtuu siitä, että se sisältyy jo AS:n perusversioon eikä vaadi aktivointia.

Suorita seuraava CLI verkkopalvelimella:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Aktivointikoodin vaatimukset

Valinnainen. Aktivointikoodit eivät ole pakollisia MPP-laitteen käyttöönotossa. Jos kuitenkin haluat käyttää aktivointikoodeja, katso Request Activation Code for MPP MPP:n aktivointikoodeja koskevista lisävaatimuksista.

MPP Device Onboarding Flow

Suorita seuraavat tehtävät, jotta järjestelmäsi voidaan määrittää tukemaan MPP-laitteiden käyttöönottoa Webex for Cisco BroadWorks -palveluun.

Jos lisäät Webex-ominaisuuksia MPP-laitteeseen, joka on jo olemassa BroadWorksissa, suorita vain vaiheet 1 ja 2.

1	Määritä MPP:n palvelut (Uudet tai olemassa olevat MPP-laitteet). Määritä järjestelmän tuki MPP:lle Webex for Cisco BroadWorksissa.
2	MPP-laitteen laiteohjelmiston päivittäminen (Nykyiset MPP-laitteet). Päivitä uusimpaan laiteohjelmistoon kaikki olemassa olevat MPP-laitteet, joihin haluat lisätä Webex-ominaisuudet.
3	MPP-laitteen käyttöönotto (Vain uudet MPP-laitteet). Jos laitetta ei ole BroadWorksissa, määritä laite ja ensisijainen käyttäjä BroadWorksissa.
4	Pyydä MPP:n aktivointikoodi (Valinnainen). Jos haluat käyttää aktivointikoodeja MPP-laitteisiin, pyydä aktivointikoodi.

Määritä MPP:n palvelut

Päivitä BroadWorks-järjestelmän asetukset tukemaan MPP-laitteita (uusia tai olemassa olevia) Webex for Cisco BroadWorks -palvelussa. Suorita tämä vaihe vain kerran. Tätä menettelyä ei tarvitse toistaa jokaiselle MPP-laitteelle.

Ennen kuin aloitat

Jos ADP on palomuurin takana, palomuuriin on määritettävä sääntö, joka poimii MAC-osoitteen laitteen varmenteesta ja sijoittaa sen todennusotsikkoon, joka sitten välitetään ADP:lle. Esimerkiksi identiteettimallia .*([0-9a-fA-F]{12}).* voidaan käyttää MAC-osoitteen poimimiseen, joka voidaan sitten sijoittaa otsikkoon, jossa käytetään kuvaavaa nimeä (esimerkiksi macaddress).

Katso palomuurin dokumentaatiosta apua määritysten kanssa.

Tee palvelupyyntö käyttöönottovirkailijallesi tai Ciscon TACille Cisco OAuthin käyttöönottamiseksi Cisco Identity Provider Federation -tilillesi. Käytä "ADP AuthService Configuration" -otsikkoa pyynnön otsikkona.

Määritä Cisco Identity Provider -parametrit suorittamalla seuraavat CLI-komennot.

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

set clientId - katso palvelupyynnön vastaus ID:n osalta.
set clientSecret - katso palvelupyynnön vastaus salaisuuden osalta.
set issuerName - katso URL-osoite seuraavasta taulukosta.
set issuerUrl - katso URL-osoite seuraavasta taulukosta.
set ciResponseBodyMaxSizeInBytes 65536

Taulukko 3. Aseta issuerName ja issuerURL.
Jos CI-klusteri on...	Aseta issuerName ja issuerURL...
US-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Jos et tiedä CI-klusteriasi, saat tiedot Control Hubin Help Desk -näkymän asiakastiedoista.

Määritä DM-sillan url-osoite alla olevalla CLI-komennolla. DM Bridge URL-osoite on erilainen jokaisessa Teams-klusterissa (jonka vedit vaiheessa 2).

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

Taulukko 4. DM_Sillan URL-osoite
Jos Teams Cluster on...	Aseta DM_Bridge URL-osoite...
ACHM	dm-silta-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
AFRA	dm-silta-k.wbx2.com

Ota käyttöön MAC-osoitteen poiminta ja todennus joko todennusotsikon tai todennusvarmenteen avulla. Turvallisuussyistä suosittelemme, että käytät vain yhtä näistä vaihtoehdoista:

Todentamisotsikko - Jos ADP on palomuurin takana, voit ottaa käyttöön MAC-osoitteen poiminnan todennusotsikkoa varten ADP:n CLI:n avulla. Tämä määritys antaa ADP:lle mahdollisuuden tunnistaa MAC-osoite todennusotsakkeesta. Esimerkiksi:

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}).*"

Tässä esimerkissä macaddress on määritetty nimi, ja .*([0-9a-fA-F]{12}).* edustaa mallia, joka määritetään otsikkoon. Jos kutsut otsikkoa jollakin muulla nimellä kuin macaddress, säädä CLI:tä sen mukaisesti.
Todennussertifikaatti - Jos ADP ei ole palomuurin takana, todennus tapahtuu suoraan laitteen ja ADP:n välillä. Käytä alla olevia CLI-komentoja, kun haluat ottaa MAC-osoitteen poiminnan käyttöön laitevarmenteessa todennusta varten:

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

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

MPP-laitteen laiteohjelmiston päivittäminen

Ennen kuin aloitat

Varmista, että BroadWorks on päivitetty MPP:tä tukevilla palveluilla.

Päivitä laitteen laiteohjelmisto uusimpaan versioon varmistaaksesi, että MPP-laite tukee Webex-ominaisuuksia.

Lisätietoja laiteohjelmistopäivityksistä on puhelinmallisi laiteohjelmistoversion julkaisutiedotteessa.

Mitä tehdä seuraavaksi

Olemassa olevat MPP-laitteet - Päivityksen jälkeen laite siirtyy Webexiin automaattisesti. Käyttäjä voi aloittaa Webex-palvelujen käytön laitteella.
Uudet MPP-laitteet - Ota uusi MPP-laite käyttöön BroadWorksissa.

MPP-laitteen käyttöönotto

Jos uutta MPP-laitetta ei ole BroadWorksissa, määritä laite BroadWorksissa.

1	Tarkista BroadWorks CommPilotissa Identity/Device Profile Type -asetuksista, onko laitetyyppi olemassa tälle MPP-laitteelle. Jos laitetyyppiä ei ole BroadWorksissa, tuo laitetyyppi BroadWorksiin käyttämällä DTAF-tiedostoa, joka ladataan osoitteesta cisco.com.
2	Avaa BroadWorks CommPilotissa Identity/Device Profile Type ja tarkista Allow Activation Code Onboarding -valintaruutu.
3	Luo Identity/Device Profile Type -tiedosto, jossa on haluamasi SIP-asetukset.
4	Luo Identity/Device Profile , jossa on uuden laitteen asetukset. Kirjoita laitteen MAC-osoite MAC-osoite -kenttään. Jos käytät aktivointikoodeja MPP-laitteisiin, jätä MAC-osoite -kenttä tyhjäksi.
5	Määritä ensisijainen käyttäjä. Aseta Users Add -sivulla isPlace -valintaruutu sen mukaan, onko laite henkilökohtainen vai jaettuun työtilaan tarkoitettu: Tarkistettu-työtilan laite Ei valittuna - Henkilökohtainen laite
6	Täytä haluamaasi laitetyyppiä ja käyttöönottomenetelmää vastaava vaihtoehto: Laite on tarkoitettu jaettua työtilaa varten - Käytä Provision a BroadWorks Workspace API:ta työtilalaitteen käyttöönoton loppuun saattamiseksi. Laite on henkilökohtainen; haluat tehdä käyttöönoton julkisten API-rajapintojen avulla - Käytä Provision BroadWorks Subscribers API -ohjelmaa, kun haluat saattaa päätökseen ensisijaisen käyttäjän käyttöönoton. Laite on henkilökohtainen; haluat, että käyttäjät käyttävät itseaktivointia Välitä käyttäjän aktivointiportaalin URL-osoite käyttäjälle. Käyttäjän on vahvistettava sähköpostiosoitteensa, jotta käyttöönotto voidaan suorittaa loppuun. Laite on henkilökohtainen; haluat käyttää läpivirtauksen käyttöönottoa - siirry vaiheeseen 7.
7	Jos laite on henkilökohtaisessa käytössä ja haluat käyttää läpivirtauksen käyttöönottoa, määritä ensisijaiselle käyttäjälle Integrated IM+P -palvelu. Lisää IM+P-palvelu sivulla User > Profile : Valitse Profiili -sivulla Assign Services. Valitse Available Services (Käytettävissä olevat palvelut) -luettelosta Integrated IM&P ja siirrä kohde nuolinäppäimellä User Services (Käyttäjäpalvelut) -ruutuun. Napsauta OK. Valitse Profiili. Vain luotettu sähköpostivirta. Lisää käyttäjän Sähköposti osoite. Tämä asetus toimii IM&P-sähköpostina, kun Webex for Cisco BroadWorks -palveluun tehdään läpivirtausta. Tätä ei tarvita, jos käytät epäluotettavaa sähköpostivirtaa. Webexin Asiakasmalliin on määritettävä asetukset läpivirtauksen käyttöönottoa varten luotetuilla sähköposteilla tai epäluotetuilla sähköposteilla. Lisätietoja on osoitteessa Webex for Cisco BroadWorks Solution Guide.

Mitä tehdä seuraavaksi

Valinnainen. Jos haluat käyttää aktivointikoodeja MPP-laitteiden käyttöönottoon, pyydä aktivointikoodi BroadWorksista.

Pyydä MPP:n aktivointikoodi

(Valinnainen) Webex for Cisco BroadWorks ei vaadi aktivointikoodeja uusien MPP-laitteiden käyttöönottoa varten. Jos kuitenkin päätät käyttää aktivointikoodeja, pyydä aktivointikoodi uudelle laitteelle suorittamalla menettely Pyydä aktivointikoodi .

Edellytykset aktivointikoodien käyttämiselle MPP-laitteiden kanssa

Jos käytät aktivointikoodien käyttöönottoa MPP-laitteissa, varmista, että järjestelmäsi täyttää seuraavat aktivointikoodikohtaiset vaatimukset.

Laitteen aktivointipalvelu- Täytä seuraavat vaatimukset, jotta voit ottaa laitteen aktivointipalvelun käyttöön:

Ota laitteen aktivointipalvelu käyttöön BroadWorksissa. Lisätietoja on osoitteessa Cisco BroadWorks Secure Onboarding Using Activation Codes.
Osoita Device Activation Service (DAS) BroadWorks AS:n Device Management Services (DMS) -palveluun seuraavalla CLI-komennolla:

AS_CLI/Interface/DAS> set url <url_of_DMS>
Tarkista, että BroadWorks-klusterin DAS URL -asetukseksi on määritetty Device Management Services (DMS) URL. Jos haluat tarkastella nykyistä DAS URL -asetusta Partner Hubissa, siirry osoitteeseen Asetukset > BroadWorks Calling > View Clusters ja valitse sopiva klusteri. URL-osoite näkyy kohdassa Käyttöliittymäasetukset.

Cisco Global Discovery Services (GDS)-GDS tarvitaan aktivointikoodin määrittämiseen. Ota GDS käyttöön BroadWorksissa suorittamalla molemmat alla olevat vaiheet:

Luo palvelupyyntö GDS-tilisi käyttöönottoa varten. Cisco antaa sinulle asiakastunnuksen, asiakassalaisuuden, päivitystunnisteen ja GDS-toimialueen.

Kun GDS-tili on otettu käyttöön, ota GDS käyttöön ADP:ssä seuraavan CLI:n avulla:

ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> get set gdsDomain <gds_domain_from palvelupyyntö> esim. https://activation.webex.com set clientId <id_from_service_request> clientSecret <secret_from_service_request> refreshToken <token_from_service_request>

Edellä mainittujen aktivointikoodikohtaisten edellytysten lisäksi järjestelmän on täytettävä yleiset MPP-edellytykset, jotka on esitetty osoitteessa MPP Device Prerequisites.

Pyydä aktivointikoodi

Pyydä aktivointikoodi uudelle MPP-laitteelle suorittamalla seuraavat vaiheet.

Etsi ja avaa uuden laitteen laiteprofiili sivulla Identity/Device Profile .
Napsauta Device Activation -välilehteä.
Napsauta Pyydä aktivointikoodi.

Järjestelmä luo aktivointikoodin ja lähettää sen sähköpostitse pääkäyttäjälle. Käyttäjän on syötettävä koodi laitteeseen saadakseen käyttöönoton päätökseen.

Laitteen huollettavuus

Huollettavuuden yleiskatsaus

Control Hub sisältää huollettavuusvaihtoehdot, joiden avulla järjestelmänvalvojat voivat tarkastella laitteen tilaa, sekä joukon huoltovaihtoehtoja. Järjestelmänvalvojat voivat:

Näytä laitteen nykyinen tila
Käynnistä laite uudelleen etänä
Lähetä ongelmaraportti vianmääritystä varten
Poista laite

Näytä laitteen tila

Tällä menettelyllä voit tarkastella laitteen tilaraporttia Control Hubista. Tila sisältää tietoja, kuten rekisteröintitilan, MAC-osoitteen, SIP-osoitteen, IP-osoitteen ja sarjanumeron.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Napsauta sopivaa laitetta.

Käynnistä laite uudelleen

Käynnistä laite uudelleen Control Hub -käyttöliittymästä tämän menettelyn avulla.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Valitse laite.
4	Valitse Actions -pudotusvalikosta Reboot.

Ilmoita ongelma

Jos laitteessa ilmenee ongelmia, voit lähettää ongelmaraportin Ciscon TAC:lle vianmääritystä varten tämän menettelyn avulla.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Napsauta sovellettavaa laitetta.
4	Valitse Toiminnot, valitse Raportoi ongelmasta.
5	Tarkista raportin yhteenveto.

Poista laite

Tällä menettelyllä voit poistaa laitteen Control Hubista.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Valitse sopiva laite.
4	Valitse Toiminnot -pudotusvalikosta Poista.

Laitteen omistajan vaihtaminen

Tämän menettelyn avulla voit siirtää olemassa olevan laitteen, joka on otettu käyttöön aktivointikoodien avulla, uudelle laitteen omistajalle.

Tässä menettelyssä oletetaan, että Allow Activation Code Onboarding -vaihtoehto on käytössä tämän laitteen käyttämässä Identity/Device Profile -profiilissa.

Poista olemassa oleva laitteen rekisteröinti Webexistä:

Avaa Webex Control Hubissa asiakasorganisaatio, johon nykyinen laitteen omistaja kuuluu.
Kohdassa Management, valitse Devices.
Merkitse siirrettävän laitteen vieressä oleva valintaruutu.
Napsauta Poista.

Laitteen rekisteröinti poistetaan Webexistä.

Deaktivoi BroadWorksissa laitteen rekisteröinti nykyisen käyttäjän alla:

Avaa BroadWorks CommPilotissa laitteen käyttämä Identity/Device Profile .
Napsauta Device Activation -välilehteä.
Napsauta Deaktivoi laite.

Laite poistetaan käytöstä ja rekisteristä BroadWorksista. MAC-osoite poistetaan vanhasta Identity/Device Profile -määrityksestä.

Aktivoi laite BroadWorksissa käyttämällä eri käyttäjän käyttämän eri Identity/Device Profile aktivointikoodia:

Avaa BroadWorks CommPilotissa eri käyttäjälle eri Identity/Device Profile -määritys.
Varmista, että Allow Activation Code Onboarding on valittuna käytetyn Identity/Device Profile Type -profiilin osalta.
Napsauta Identity/Device Profile -ikkunassa Device Activation -välilehteä.
Napsauta Pyydä aktivointikoodi.

Uusi aktivointikoodi tulee näkyviin. Uuden käyttäjän on syötettävä tämä koodi päästäkseen laitteeseen.

Mitä tehdä seuraavaksi

Laitteen uusi omistaja syöttää laitteeseen aktivointikoodin.
Laite rekisteröidään uudelleen sekä Webexiin että BroadWorksiin käyttämällä uutta kokoonpanoa. BroadWorksin uusi Identity/Device Profile päivittyy automaattisesti laitteen MAC-osoitteella.

Suorituskyvyn seuranta

Tätä ominaisuutta varten on olemassa seuraavat suorituskykymittarit.

Laskuri	Kuvaus
Moduuli: enterprises.broadsoft.broadworks.deviceActivation.activate
bwDASActivateRequests	Vastaanotettujen aktivointipyyntöjen kokonaismäärä. Tämä sisältää BroadWorks-pyyntöjen ja Webex-pyyntöjen aktivoinnin.
bwDASActivateFailures	Niiden aktivointipyyntöjen kokonaismäärä, jotka eivät onnistuneet.Tämä sisältää epäonnistuneet BroadWorksin aktivointipyynnöt ja epäonnistuneet Webexin aktivointipyynnöt.
bwDASActivateBroadWorksRequests	Vastaanotettujen aktivoitujen BroadWorks-pyyntöjen määrä.
bwDASActivateBroadWorksFailures	Niiden aktivoitujen BroadWorks-pyyntöjen määrä, joiden loppuunsaattaminen epäonnistui. Tämä laskuri ei ota huomioon valtuutus- ja todennushäiriöitä.
bwDASActivateWebexRequests	Vastaanotettujen Webex-aktivointipyyntöjen määrä.
bwDASActivateWebexFailures	Niiden aktivoitujen Webex-pyyntöjen määrä, jotka eivät onnistuneet.
Moduuli: yritykset.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Lähetettyjen DMBridge-pyyntöjen määrä.
bwDMBridgeFailures	Niiden DMBridge-pyyntöjen määrä, joiden suorittaminen epäonnistui.

Webexin integroitujen laitteiden loppukäyttäjäominaisuudet

Yhtenäinen soittohistoria

Webex-tietoiset MPP-puhelimet

Webex for BroadWorks -alustalla olevat Webex Aware Cisco MPP -laitteet pystyvät nyt näyttämään yhtenäisen puhelujen historian käyttäjän Webex-asiakasohjelmasta ja laitteista soitetuista/vastaanotetuista puheluista. Tämä parantaa loppukäyttäjien käyttökokemusta, sillä he voivat tarkkailla ja käyttää Webex-sovelluksen kautta soitettuja/vastaanotettuja puheluita MPP-laitteidensa puhelinlokien kautta sekä kaikkia heidän laitteellaan käsiteltyjä paikallispuheluita.

Webex Unified Call History on oletuslähde käyttäjän puhelujen historian tarkasteluun. Tämä puheluhistoria sisältää kaikista puhelimista, Webex-videolaitteista tai Webex-sovelluksesta soitetut puhelut.

Vaikutusalaan kuuluvat IP-puhelinmallit:

MPP 68xx Sarjat 6821, 6841, 6851, 6861 ja 6861.
MPP 78xx Sarja 7811, 7821, 7841, 7861, 7861
MPP 88xx Sarja 8811, 8841, 8845, 8851, 8861, 8865, 8875, 8865, 8875

Ominaisuuksien käyttöönotto:

Ominaisuuden käyttöönotto edellyttää seuraavien kriteerien täyttymistä

Webex for BroadWorks -laiteintegraatio on otettava käyttöön ja sen on toimittava MPP-laitteissa. Lisätietoja on tässä oppaassa Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Laastari- ja DTAF-vaatimukset:

Broadworks - Tämä toiminto riippuu siitä, onko BroadWorksin korjaukset asennettu. Yksityiskohdat löytyvät täältä.
Laite - Viimeisimmät MPP-kokoonpanot on otettava käyttöön. Tarvittavat CPE-paketit löytyvät täältä (kirjaudu sisään CCO-tunnuksella).

Odotukset/vaikutukset/rajoitukset:

Ensisijainen linja (vain nykyinen käyttäjä)
- Unified Call History -palvelua tuetaan, kuten mainittu.
- Tuki yksityisyyden suojaus - Suojaa/piilota puhelutiedot, kun käyttäjän salasana on asetettu.
- Jos puhelin ei ole Cloud Aware, näytetään vain kyseiseen laitteeseen ja kyseisestä laitteesta tulevien puhelujen "paikallinen historia".
Muut linjat (yhteiset tai muut)
- Vain paikallinen historia laitteeseen tulevista ja sieltä lähtevistä puheluista tuetaan.
Työtilan laitteet
- Unified Call History -palvelua ei tueta tällä hetkellä.

Kun toiminto otetaan käyttöön, kaikki MPP:n paikallispuheluhistoria (joka on peräisin BroadWorksista) poistetaan.

Webex for BroadWorks integroituihin RoomOS-laitteisiin

Webex for BroadWorks -integroidut Cisco RoomOS -laitteet pystyvät nyt näyttämään yhtenäisen puhelujen historian käyttäjän Webex-asiakasohjelmasta ja laitteista soitetuista/vastaanotetuista puheluista. Tämä parantaa loppukäyttäjien käyttökokemusta, sillä he voivat tarkkailla ja käyttää Webex-sovelluksen kautta soitettuja/vastaanotettuja puheluita RoomOS-laitteidensa puhelinlokien kautta sekä kaikkia paikallispuheluita, jotka on käsitelty heidän laitteillaan.

Saatavana alla olevissa RoomOS-laitemalleissa:

RoomOS-laitteet
Pöytäsarja: Pöytä, Pöytä Mini, Pöytä Pro
Room-sarja
RoomKit-sarja
Webex Board Series

Ominaisuuksien käyttöönotto:

Webex for BroadWorks -laiteintegraatio on toteutettava ja sen on toimittava RoomOS-laitteissa. Lisätietoja on tässä oppaassa Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Laastari- ja DTAF-vaatimukset:

Broadworks - Tämä toiminto riippuu siitä, onko BroadWorksin korjaukset asennettu. Yksityiskohdat löytyvät täältä.

Konfiguraatiovaatimukset:

Seuraavat asetukset on asetettava määritetyllä tavalla.
- Bwks Config: Feature_Toggle_Webex_Call=Kyllä

Hakemistohakua koskevat parannukset Webex for BroadWorks -integroituihin RoomOS-laitteisiin

Webex for BroadWorksin integroitujen Cisco RoomOS -laitteiden käyttäjät voivat nyt etsiä Webex-organisaationsa henkilöitä, tiloja ja jopa laitteita suoraan RoomOS-laitteistaan uuden parannetun Webex Directory -palvelun avulla. Tämä palvelu tarjoaa parannetut haku- ja hakuominaisuudet Webexiin, jotta BroadWorks-käyttäjät voivat löytää Webex-organisaationsa käyttäjät ja asiat (työtilat, laitteet jne.).

Saatavana alla olevissa RoomOS-laitemalleissa:

RoomOS-laitteet
Pöytäsarja: Pöytä, Pöytä Mini, Pöytä Pro
Room-sarja
RoomKit-sarja
Webex Board Series

Ominaisuuksien käyttöönotto:

Webex for BroadWorks -laiteintegraatio on otettava käyttöön ja sen on toimittava MPP-laitteissa. Lisätietoja on tässä oppaassa Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Konfiguraatiovaatimukset:

Hakemistopalvelun vaihtokytkimen "xConfiguration Webex DirectoryServiceSupport" on oltava käytössä laitteessa.

Johdanto

Tietoa tästä oppaasta

Laitteen käyttöönotto-Kuvaus siitä, miten Room OS -laitteet (Room- ja Room Kit -sarjat, Desk-sarja ja Board-sarja) ja MPP-laitteet otetaan käyttöön Webex for Cisco BroadWorksissa.
Laitteen huollettavuus- Kuvaa, miten Control Hubissa olevia laitteita hallitaan.

Asiakirjan muutoshistoria

Seuraavassa taulukossa on yhteenveto tämän asiakirjan muutoshistoriasta.

Päiväys	Asiakirjan versio	Muutoksen kuvaus
12. toukokuuta 2023	1.7	Lisätty Webex for BroadWorks integrated Cisco RoomOS Devices ja Hakemistohakua koskevat parannukset W4B Integrated RoomOS Devices kohtaan End user features for Webex integrated Devices.
27. helmikuuta 2023	1.6	Päivitetty Configure Services for Room OS vaiheet kohdassa Device Onboarding.
17. helmikuuta 2023	1.5	Lisätty Unified Call History for Webex aware MPP phones -osio osoitteeseen End user features for Webex integrated Devices.
14. lokakuuta 2022	1.4	Päivitetty Room OS:n käyttöönottoprosessi kohdassa Room OS Onboarding sisällyttämällä SRV-tietueet. Päivitetty BroadWorksin konfigurointivaatimukset kohdassa Room OS Prerequisites ja lisätty viittaus Solution Guide -ratkaisuoppaaseen läpivirtauksen käyttöönoton vaatimusten osalta.
20. kesäkuuta 2022	1.3	Päivitetty Room OS Prerequisites ja MPP Device Prerequisites viittauksella Solution Guide -ratkaisuoppaaseen läpivirtauksen käyttöönottovaatimusten osalta. Päivitetty Provision Room OS Devices ja Provision MPP Device sisältämään tietoa eri käyttöönottomenetelmistä.
kesäkuu 03, 2022	1.2	Korjattu Device Profile Type -ominaisuuden aktivointinumero (02283) osoitteessa Room OS Prerequisites ja MPP Device Prerequisites (MPP-laitteen edellytykset).
toukokuu 27, 2022	1.1	Korjattu vaatimus, jonka mukaan jokaiselle kumppaniorganisaatiolle on oltava oma DMS-instanssi. Lisätty Esipuhe luku. Päivitetty otsikko "Device Integration Guide".
20. toukokuuta 2022	1.0	Alkuperäinen julkaisu

Laiteintegraatio Webex for Cisco BroadWorks -ohjelmistoon

Laitteen käyttöönoton yleiskatsaus

Tässä luvussa kuvataan, miten laitteet liitetään Webex for Cisco BroadWorks -palveluun. Tässä luvussa käsitellään seuraavia käyttötapauksia:

Uusien Webex Room OS -laitteiden käyttöönotto (aktivointikoodien avulla)
Uudet MPP-laitteet
Webex-ominaisuuksien lisääminen olemassa oleviin MPP-laitteisiin

Suosittelemme, että otat tämän ominaisuuden käyttöön Release Independent ADP -palvelimissa. XSP tukee kuitenkin myös tätä ominaisuutta. Jos käytät XSP:tä, voit korvata "XSP:n" tässä asiakirjassa mainituilla maininnoilla "ADP", ellei tekstissä mainita vain ADP:tä.
Tämä ominaisuus tukee sekä henkilökohtaisia että työtilalaitteita.

Room OS Onboarding

Webex for Cisco BroadWorks tukee aktivointikoodien käyttöönottoa sekä jaetuille että työtilan Room OS -laitteille.

Laitteen käyttöönotto aktivointikoodien avulla

Seuraavat Room OS -laitteet tukevat käyttöönottoa aktivointikoodien avulla:

Webex Board Series (huone OS)
Webex Desk Series (huone OS)
Webex-huonesarja (Room OS)

Huone OS:n käyttöönottoprosessi

Seuraavassa prosessissa kuvataan, mitä tapahtuu, kun Room OS -laite otetaan käyttöön aktivointikoodien avulla:

Yhteistyökumppanin järjestelmänvalvoja määrittää ensisijaisen käyttäjän ja laitteen BroadWorksissa ja luo sitten aktivointikoodin BroadWorksissa.
Laitteen omistajalle lähetetään sähköpostiviesti, joka sisältää laitteen aktivointikoodin.
Laitteen omistaja käynnistää laitteen.
Laite pyytää laitteen omistajaa syöttämään aktivointikoodin.
Laitteen omistaja syöttää laitteeseen aktivointikoodin.
Laite liitetään BroadWorksiin ja Webexiin seuraavan aliprosessin avulla:
- Room OS -laite lähettää aktivointipyynnön Webex-palveluille. GDS tarkistaa aktivointikoodin, ja jos koodi on oikea, laite liitetään Webexiin. Webex palauttaa laitteelle koneen tunnisteen.
- Laite lähettää aktivointipyynnön BroadWorks DM:lle yhdessä koneen tunnisteen ja MAC-osoitteen kanssa.
- BroadWorks valtuuttaa ja ottaa laitteen käyttöön.
- Laite lähettää BroadWorks DM:lle pyynnön päivitetystä konfiguraatiosta. Koneen tunniste on mukana valtuutusta varten.
- BroadWorks hyväksyy tunnisteen, etsii päivitetyn konfiguraatiotiedoston ja palauttaa päivitetyn konfiguraatiotiedoston.
- Room OS yrittää löytää NAPTR-tietueen konfiguraatiotiedostossa määritetylle verkkotunnukselle, koska se odottaa löytävänsä SRV-merkinnän osoitteesta _sip._tls.<domain_in_config> jos NAPTR-tietuetta ei ole, RoomOS yrittää etsiä SRV-tietuetta ja sen jälkeen A-tietuetta.
  
  SRV-tietueen on oltava _sip._tls. koska roomOS tukee vain TLS:ää siirtoa varten ja SRTP:tä mediaa varten.
Laite rekisteröityy ja on käyttövalmis.

Seuraavassa kaaviossa on yksinkertaistettu yleiskuva palvelukseenottoprosessista.

Laitteen todennus (OAuth-kantajatunnisteiden avulla)

Huone OS Edellytykset

Huoneen käyttöjärjestelmän vähimmäisversio

Huone OS 10.13 vähintään

BroadWorks Patch -vaatimukset

Tätä ominaisuutta tuetaan Release Independent (RI) ADP-palvelimen versiosta 2021.11 alkaen, eikä siihen tarvita korjauksia.

Muihin kuin RI-palvelimiin on asennettava seuraavat korjaukset (korjaustiedostoryhmistä ap381367, ap381951 ja ap382198), jotta voit käyttää ominaisuutta. Asenna julkaisuasi koskevat korjaukset:

R22:lle:

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.platform.22.0.1123.ap381367
AP.platform.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

R23:lle:

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

R24:lle:

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

BroadWorks-alustavaatimukset

Tämä toiminto on käytettävissä seuraavissa:

R22: saatavana vain XSP:ssä
R23: saatavana XSP:llä tai ADP:llä (Release Independent).
R24: saatavilla ADP:ssä (Release Independent)

BroadWorksin kokoonpanovaatimukset

Tämän ratkaisun käyttöönotto edellyttää, että Flowthrough-varaus on määritetty siten, että Broadworks voi varata laitteita Webexiin.

Kun määrität Flowthrough provisioningia, ei ole pakollista käyttää Flowthrough provisioningia käyttäjien määrittämiseen, eli voit jatkaa nykyisten määritysmenetelmien käyttöä (API, luotettu/luottamuksellinen sähköposti, käyttäjän oma käyttäjä jne.) käyttäjien määrittämiseen. Katso "Provisioning Requirements" (Käyttöönottovaatimukset) osoitteessa Webex for Cisco BroadWorks Solution Guide.
Varmista, että Integroitu IM+P -palvelu on käytössä BroadWorksissa ja osoittaa BroadWorks Provisioning Bridgeen.

Käyttöönottosillan URL-osoite määritettiin, kun asiakasmallia sovellettiin organisaatioon. Tämä olisi pitänyt tehdä Webex for Cisco BroadWorks -ohjelman alkuasetusten yhteydessä. Löydät olemassa olevan URL-osoitteen Partner Hubista osoitteesta Configure Application Server with Provisioning Service URL osoitteessa Webex for Cisco BroadWorks Solution Guide.
Jos sinulla on useita kumppaniorganisaatioita, tarvitset oman Device Management Service (DMS) -instanssin kutakin kumppania kohden.

Edellytykset aktivointikoodin käyttöönotolle Room OS:n kanssa

Varmista, että seuraavat asetukset on asetettu:

Ota laitteen aktivointipalvelu käyttöön BroadWorksissa. Lisätietoja on osoitteessa Cisco BroadWorks Secure Onboarding Using Activation Codes.
Tarkista, että BroadWorks-klusterin DAS URL -asetukseksi on määritetty Device Management Services (DMS) URL. Jos haluat tarkastella nykyistä DAS URL -asetusta Partner Hubissa, siirry osoitteeseen Asetukset > BroadWorks Calling > View Clusters ja valitse sopiva klusteri. URL-osoite näkyy kohdassa Käyttöliittymäasetukset.

Jos BroadWorks-klusterissa on paljon asiakkaita (>50), DAS URL-osoitteen lisääminen ei ole tuettu. Tällaisissa tapauksissa on suositeltavaa ottaa yhteyttä Ciscon TAC-tuki-insinööriin.

Seuraavat BroadWorks-ominaisuudet on aktivoitava liitännäisjärjestelmässä:

101377 Parannukset Webex- ja MPP-laitteiden käyttöönottoon
25088 Tukipuhelimet DECT-laitteille
24104 Monisoluisen ketjutuksen tukeminen DECT-laitteille
20077 Laitehallinnan parannukset
19559 Visuaalisen laitehallinnan parannukset
02283 Laiteprofiilin tyypin mukauttamisen parannukset

Suorita esimerkiksi seuraava komento ottaaksesi käyttöön 101377. Vaihda ominaisuuden numero, kun aktivoit muita ominaisuuksia: AS_CLI/System/ActivatableFeature> aktivoi 101377

Jos kaikki luetellut korjaukset on asennettu, mutta aktivoitavaa ominaisuutta ei ole lueteltu AS-julkaisussasi, se johtuu siitä, että se sisältyy jo AS:n perusjulkaisuun eikä vaadi aktivointia.

Suorita seuraava CLI-komento verkkopalvelimella:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Room OS Onboarding Flow

Suorita seuraavat tehtävät määrittääksesi järjestelmäsi tukemaan Device Onboarding -käyttöönottoa aktivointikoodeilla seuraaville Webex Room OS -laitteille:

Webex Board Series
Webex Desk Series
Webex-huonesarja

1	Palveluiden määrittäminen huoneen käyttöjärjestelmää varten Määritä BroadWorksin tuki Room OS -laitteille.
2	Huoneen OS-laitteiden käyttöönotto Ota uusi laite käyttöön BroadWorksissa.
3	Pyydä aktivointikoodi Pyydä aktivointikoodi laiteprofiilissa. Koodi lähetetään automaattisesti sähköpostitse ensisijaiselle käyttäjälle.

Palveluiden määrittäminen huoneen käyttöjärjestelmää varten

Ennen kuin voit ottaa käyttöön uusia Room OS -laitteita, aseta seuraavat järjestelmätason parametrit OAuth-todennuksen ottamiseksi käyttöön.

Ota OAuth käyttöön käyttämällä tätä CLI-komentoa:

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

Varmista, että OAuth-alue sisältää broadworks-connector-user (alue on oletusarvoisesti käytössä). Suorita tämä komento tarkistaaksesi laajuudet:

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

Määritä Cisco Identity Provider -parametrit alla olevien CLI-komentojen avulla.

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

set clientId - katso palvelupyynnön vastaus ID:n osalta.
set clientSecret - katso palvelupyynnön vastaus salaisuuden osalta.
set issuerName - katso URL-osoite seuraavasta taulukosta.
set issuerUrl - katso URL-osoite seuraavasta taulukosta.
set tokenInfoUrl <IdPProxy_URL>- katso URL-osoite seuraavista taulukoista.
set ciResponseBodyMaxSizeInBytes 65536

Taulukko 1. Aseta issuerName ja issuerURL.
Jos CI-klusteri on...	Aseta issuerName ja issuerURL...
US-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Jos et tiedä CI-klusteriasi, saat tiedot Control Hubin Help Desk -näkymän asiakastiedoista.

Taulukko 2. Set tokenInfoURL
Jos Teams Cluster on...	Set tokenInfoURL to...(IdP Proxy URL)
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
Jos et tiedä Teams-klusteriasi, saat tiedot Control Hubin Help Desk -näkymän asiakastiedoista. Testausta varten voit tarkistaa, että tokenInfoURL on kelvollinen, korvaamalla URL-osoitteen "`idp/authenticate`" -osion osalla "`ping`".

Määritä Cisco Federationin identiteettipalveluntarjoajat seuraavien komentojen avulla:

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

Uusi salasana:

Kirjoita uusi salasana uudelleen:

...Done

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

Yhteistyökumppanin nimi Refresh Token

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

FederationPartner ********

1 merkintä löytyi.

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

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

Jos käytössäsi on ADP RI -kuorma, joka on vanhempi kuin 2022.10, R23 XSP ilman korjausta AP.xsp.23.0.1075.ap383838 tai R22 XSP, niin:

Sinun ei tarvitse määrittää kumppania kohdassa 'System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>'.
Päivitysmerkki on asetettava kohtaan: System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Federation>

Tyhjennä kaikki olemassa olevat laajuudet seuraavissa kolmessa kontekstissa: ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/...

Laajuusalueet
Admin/RolesAllowed
Admin/ScopesAllowed

Suorita jokaisesta kontekstista get saadaksesi olemassa olevat laajuudet ja poista ne sitten. Esimerkiksi:

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>

Huoneen OS-laitteiden käyttöönotto

Määritä BroadWorksissa Room OS -laite (Webex Board Series, Webex Desk Series tai Webex Room Series).

1	Tarkista BroadWorks CommPilotissa Identity/Device Profile Type -asetuksesta, onko laitetyyppi olemassa tälle Room OS -laitteelle. Jos laitetyyppiä ei ole BroadWorksissa, tuo laitetyyppi BroadWorksiin käyttämällä DTAF-tiedostoa, jonka voit ladata osoitteesta cisco.com.
2	Kun olet tuonut laitetyypin, varmista, että seuraavat asetukset ovat olemassa Identity/Device Profile Type -määrityksessä: Valitse Allow Activation Code Onboarding -valintaruutu. Merkitse Send Activation Code Request Through Messaging Server -valintaruutu. Aseta Authentication Mode osoitteeseen Bearer.
3	Varmista, että laiteprofiilitiedostossa on haluamasi SIP-asetukset. Varmista Identity/Device Profile Type File -tiedostossa, että Authentication Mode on Bearer.
4	Luo laiteprofiili, jossa on uuden laitteen asetukset. Jätä MAC-osoitekenttä tyhjäksi Identity/Device Profile Add/Modify -sivulla.
5	Määritä ensisijainen käyttäjä. Valitse Users Add -sivulla isPlace tai poista se sen mukaan, onko laite tarkoitettu henkilökohtaiseen vai jaettuun työtilaan. Tarkistettu-työtilan laite Ei valittua - Henkilökohtainen laite Jaetun työtilan laitteet edellyttävät myös ensisijaisen käyttäjän määrittämistä. Voit määrittää haluamasi ensisijaisen käyttäjän.
6	Täytä haluamaasi laitetyyppiä ja käyttöönottomenetelmää vastaava vaihtoehto: Laite on tarkoitettu jaettua työtilaa varten - Käytä Provision a BroadWorks Workspace API:ta työtilalaitteen käyttöönoton loppuun saattamiseksi. Laite on henkilökohtainen; haluat tehdä käyttöönoton julkisten API-rajapintojen avulla - Käytä Provision BroadWorks Subscribers API -ohjelmaa, kun haluat saattaa päätökseen ensisijaisen käyttäjän käyttöönoton. Laite on henkilökohtainen; haluat, että käyttäjät käyttävät itseaktivointia Välitä käyttäjän aktivointiportaalin URL-osoite käyttäjälle. Käyttäjän on vahvistettava sähköpostiosoitteensa, jotta käyttöönotto voidaan suorittaa loppuun. Laite on henkilökohtainen; haluat käyttää läpivirtauksen käyttöönottoa - siirry vaiheeseen 7.
7	Jos laite on henkilökohtaisessa käytössä ja haluat käyttää läpivirtauksen käyttöönottoa, määritä ensisijaiselle käyttäjälle Integrated IM+P -palvelu. Lisää IM+P-palvelu sivulla User > Profile : Valitse Profiili -sivulla Assign Services. Valitse Available Services (Käytettävissä olevat palvelut) -luettelosta Integrated IM&P ja siirrä kohde nuolinäppäimellä User Services (Käyttäjäpalvelut) -ruutuun. Napsauta OK. Valitse Profiili. Vain luotettu sähköpostivirta. Lisää käyttäjän Sähköposti osoite. Tämä asetus toimii IM&P-sähköpostina, kun Webex for Cisco BroadWorks -palveluun tehdään läpivirtausta. Tätä ei tarvita, jos käytät epäluotettavaa sähköpostivirtaa. Webexin Asiakasmalliin on määritettävä asetukset läpivirtauksen käyttöönottoa varten luotetuilla sähköposteilla tai epäluotetuilla sähköposteilla. Lisätietoja on osoitteessa Webex for Cisco BroadWorks Solution Guide.

Mitä tehdä seuraavaksi

Pyydä aktivointikoodi Room OS -laitteelle.

Pyydä aktivointikoodi

Kun laite ja käyttäjä on otettu käyttöön BroadWorksissa, pyydä, että käyttäjälle lähetetään aktivointikoodi.

1	Etsi ja avaa uuden laitteen laiteprofiili sivulla Identity/Device Profile .
2	Napsauta Device Activation -välilehteä.
3	Napsauta Pyydä aktivointikoodi.

Järjestelmä luo aktivointikoodin, ja (edellyttäen, että olet määrittänyt järjestelmän oikein) järjestelmä lähettää aktivointikoodin sähköpostitse ensisijaiselle käyttäjälle.

Mitä tehdä seuraavaksi

Toimita laite käyttäjälle. Kun käyttäjä on kytkenyt laitteen, hänen on syötettävä sähköpostitse lähetetty aktivointikoodi. Tämä ottaa laitteen käyttöön Webex for Cisco BroadWorks -palvelussa.

MPP Onboarding Webexiin

MPP Device Onboarding (uudet laitteet)

Seuraavassa kaaviossa on yleiskuva käyttöönottoprosessista sen jälkeen, kun käyttäjän syöttämä aktivointikoodi on vahvistettu.

MPP-laitteen käyttöönotto (olemassa olevat laitteet)

Olemassa olevien MPP-laitteiden osalta, joissa laite on jo olemassa BroadWorksissa, mutta sitä ei ole liitetty Webexiin, päivitä BroadWorks ja laitteen laiteohjelmisto tukemaan MPP:n liittämistä Webexiin. Päivitysten jälkeen laite kytkeytyy Webexiin automaattisesti.

Lisätietoja

Lisätietoja MPP-laitteiden käyttöönotosta Webexissä on ominaisuuden kuvauksessa Cisco BroadWorks DMS Enhancements for Webex Enabling MPP Devices.

MPP-laitteen edellytykset

MPP:n vähimmäisversio

MPP:n laiteohjelmisto vähintään 11.3.7

BroadWorks Patch -vaatimukset

Tätä ominaisuutta tuetaan Release Independent (RI) ADP-palvelimen versiosta 2021.11 alkaen, eikä siihen tarvita korjauksia.

Muihin kuin RI-palvelimiin on asennettava seuraavat korjaukset (korjaustiedostoryhmistä ap381367, ap381951 ja ap382198), jotta voit käyttää ominaisuutta. Asenna julkaisuasi koskevat korjaukset:

R22:lle:

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.platform.22.0.1123.ap381367
AP.platform.22.0.1123.ap382198
AP.ps.22.0.1123.ap381367
AP.xsp.22.0.1123.ap381367
AP.xsp.22.0.1123.ap382198

R23:lle:

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

R24:lle:

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

BroadWorks-alustavaatimukset

Tämä toiminto on käytettävissä seuraavissa:

R22: saatavana vain XSP:ssä
R23: saatavana XSP:llä tai ADP:llä (Release Independent).
R24: saatavilla ADP:ssä (Release Independent)

BroadWorksin kokoonpanovaatimukset

Tämän ratkaisun käyttöönotto edellyttää, että Flowthrough-varaus on määritetty siten, että Broadworks voi varata laitteita Webexiin.

Kun määrität Flowthrough provisioningia, ei ole pakollista käyttää Flowthrough provisioningia käyttäjien määrittämiseen, eli voit jatkaa nykyisten määritysmenetelmien käyttöä (API, luotettu/luottamuksellinen sähköposti, käyttäjän oma käyttäjä jne.) käyttäjien määrittämiseen. Katso "Provisioning Requirements" (Käyttöönottovaatimukset) osoitteessa Webex for Cisco BroadWorks Solution Guide.
Varmista, että Integroitu IM+P -palvelu on käytössä BroadWorksissa ja osoittaa BroadWorks Provisioning Bridgeen.

Käyttöönottosillan URL-osoite määritettiin, kun asiakasmallia sovellettiin organisaatioon. Tämä olisi pitänyt tehdä Webex for Cisco BroadWorks -ohjelman alkuasetusten yhteydessä. Löydät olemassa olevan URL-osoitteen Partner Hubista osoitteesta Configure Application Server with Provisioning Service URL osoitteessa Webex for Cisco BroadWorks Solution Guide.
Jos sinulla on useita kumppaniorganisaatioita, tarvitset oman Device Management Service (DMS) -instanssin kutakin kumppania kohden.

Varmenteet ja palomuurit

Varmista, että olet määrittänyt seuraavat asetukset:

Varmennevaatimukset-MPP-laitteet käyttävät mTLS-todennusta laitevarmenteen avulla. Laitteen MAC-osoite, jonka varmenne antaa, todentaa laitteen. Lataa MPP-laitteesi tarvitsemat varmenteet osoitteesta https://www.cisco.com/security/pki/.

Lataa varmenteet, jotta ADP:hen tai palomuuriin voidaan luottaa. Jos esimerkiksi lataat tiedoston ADP:hen, käytä tätä komentoa:

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/Trusts/updateTrust> <certificate_filename>
Palomuurivaatimukset - Jos ADP on palomuurin takana, palomuuriin on määritettävä sääntö, joka poimii MAC-osoitteen laitteen varmenteesta ja sijoittaa sen todennusotsikkoon, joka sitten välitetään ADP:lle. Esimerkiksi identiteettimallia .*([0-9a-fA-F]{12}).* voidaan käyttää MAC-osoitteen poimimiseen, joka voidaan sitten sijoittaa otsikkoon, jossa käytetään kuvaavaa nimeä (esimerkiksi macaddress).

Jos ADP ei ole palomuurin takana, edellistä vaatimusta ei ole olemassa.

Ominaisuuden aktivointi

Aktivoi seuraavat BroadWorks-ominaisuudet liitännäisjärjestelmässä:

101377 Parannukset Webex- ja MPP-laitteiden käyttöönottoon
25088 Tukipuhelimet DECT-laitteille
23775 MPP-laitteiden etäpalautus
24104 Monisoluisen ketjutuksen tukeminen DECT-laitteille
20077 Laitehallinnan parannukset
19559 Visuaalisen laitehallinnan parannukset
02283 Laiteprofiilin tyypin mukauttamisen parannukset

Ota esimerkiksi seuraava komento käyttöön 101377.Muuta ominaisuuden numero, kun otat käyttöön muita ominaisuuksia: AS_CLI/System/ActivatableFeature> aktivoi 101377

Jos kaikki luetellut korjaukset on asennettu, mutta aktivoitavaa ominaisuutta ei ole lueteltu AS-julkaisussasi, se johtuu siitä, että se sisältyy jo AS:n perusjulkaisuun eikä vaadi aktivointia.

Suorita seuraava CLI verkkopalvelimella:

NS_CLI/System/DeviceManagement> asLocationLookupEnabled true

Aktivointikoodin vaatimukset

Valinnainen. Aktivointikoodit eivät ole pakollisia MPP-laitteen käyttöönotossa. Jos kuitenkin haluat käyttää aktivointikoodeja, katso Request Activation Code for MPP , jossa on MPP:n aktivointikoodeja koskevia erityisvaatimuksia.

MPP Device Onboarding Flow

Suorita seuraavat tehtävät, jotta järjestelmäsi voidaan määrittää tukemaan MPP-laitteiden käyttöönottoa Webex for Cisco BroadWorks -palveluun.

Jos lisäät Webex-ominaisuuksia MPP-laitteeseen, joka on jo olemassa BroadWorksissa, suorita vain vaiheet 1 ja 2.

1	MPP:n palvelujen määrittäminen (Uudet tai olemassa olevat MPP-laitteet). Määritä järjestelmän tuki MPP:lle Webex for Cisco BroadWorksissa.
2	MPP-laitteen laiteohjelmiston päivittäminen (Nykyiset MPP-laitteet). Päivitä uusimpaan laiteohjelmistoon kaikki olemassa olevat MPP-laitteet, joihin haluat lisätä Webex-ominaisuudet.
3	MPP-laitteen tarjoaminen (Vain uudet MPP-laitteet). Jos laitetta ei ole BroadWorksissa, määritä laite ja ensisijainen käyttäjä BroadWorksissa.
4	Pyydä MPP:n aktivointikoodi (Valinnainen). Jos haluat käyttää aktivointikoodeja MPP-laitteisiin, pyydä aktivointikoodi.

MPP:n palvelujen määrittäminen

Ennen kuin aloitat

Katso palomuurin dokumentaatiosta apua määritysten kanssa.

Määritä Cisco Identity Provider -parametrit suorittamalla seuraavat CLI-komennot.

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

set clientId - katso palvelupyynnön vastaus ID:n osalta.
set clientSecret - katso palvelupyynnön vastaus salaisuuden osalta.
set issuerName - katso URL-osoite seuraavasta taulukosta.
set issuerUrl - katso URL-osoite seuraavasta taulukosta.
set ciResponseBodyMaxSizeInBytes 65536

Taulukko 3. Aseta issuerName ja issuerURL.
Jos CI-klusteri on...	Aseta issuerName ja issuerURL...
US-A	https://idbroker.webex.com/idb
EU	https://idbroker-eu.webex.com/idb
US-B	https://idbroker-b-us.webex.com/idb
Jos et tiedä CI-klusteriasi, saat tiedot Control Hubin Help Desk -näkymän asiakastiedoista.

Määritä DM-sillan url-osoite alla olevalla CLI-komennolla. DM Bridge URL-osoite on erilainen jokaisessa Teams-klusterissa (jonka vedit vaiheessa 2).

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

Taulukko 4. DM_Sillan URL-osoite
Jos Teams Cluster on...	Aseta DM_Bridge URL-osoite...
ACHM	dm-silta-a.wbx2.com
AORE	dm-bridge-r.wbx2.com
AFRA	dm-silta-k.wbx2.com

Ota käyttöön MAC-osoitteen poiminta ja todennus joko todennusotsikon tai todennusvarmenteen avulla. Turvallisuussyistä suosittelemme, että käytät vain yhtä näistä vaihtoehdoista:

Todentamisotsikko - Jos ADP on palomuurin takana, voit ottaa käyttöön MAC-osoitteen poiminnan todennusotsikkoa varten ADP:n CLI:n avulla. Tämä määritys antaa ADP:lle mahdollisuuden tunnistaa MAC-osoite todennusotsakkeesta. Esimerkiksi:

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}).*"

Tässä esimerkissä macaddress on määritetty nimi, ja .*([0-9a-fA-F]{12}).* edustaa mallia, joka määritetään otsikkoon. Jos kutsut otsikkoa jollakin muulla nimellä kuin macaddress, säädä CLI:tä sen mukaisesti.
Todennussertifikaatti - Jos ADP ei ole palomuurin takana, todennus tapahtuu suoraan laitteen ja ADP:n välillä. Käytä alla olevia CLI-komentoja, kun haluat ottaa MAC-osoitteen poiminnan käyttöön laitevarmenteessa todennusta varten:

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

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

MPP-laitteen laiteohjelmiston päivittäminen

Ennen kuin aloitat

Varmista, että BroadWorks on päivitetty MPP:tä tukevilla palveluilla.

Päivitä laitteen laiteohjelmisto uusimpaan versioon varmistaaksesi, että MPP-laite tukee Webex-ominaisuuksia.

Lisätietoja laiteohjelmistopäivityksistä on puhelinmallisi laiteohjelmistoversion julkaisutiedotteessa.

Mitä tehdä seuraavaksi

Olemassa olevat MPP-laitteet - Päivityksen jälkeen laite siirtyy Webexiin automaattisesti. Käyttäjä voi aloittaa Webex-palvelujen käytön laitteella.
Uudet MPP-laitteet - Ota uusi MPP-laite käyttöön BroadWorksissa.

MPP-laitteen tarjoaminen

Jos uutta MPP-laitetta ei ole BroadWorksissa, määritä laite BroadWorksissa.

1	Tarkista BroadWorks CommPilotissa Identity/Device Profile Type -asetuksista, onko laitetyyppi olemassa tälle MPP-laitteelle. Jos laitetyyppiä ei ole BroadWorksissa, tuo laitetyyppi BroadWorksiin käyttämällä DTAF-tiedostoa, joka ladataan osoitteesta cisco.com.
2	Avaa BroadWorks CommPilotissa Identity/Device Profile Type ja tarkista Allow Activation Code Onboarding -valintaruutu.
3	Luo Identity/Device Profile Type -tiedosto, jossa on haluamasi SIP-asetukset.
4	Luo Identity/Device Profile , jossa on uuden laitteen asetukset. Kirjoita laitteen MAC-osoite MAC-osoite -kenttään. Jos käytät aktivointikoodeja MPP-laitteisiin, jätä MAC-osoite -kenttä tyhjäksi.
5	Määritä ensisijainen käyttäjä. Aseta Users Add -sivulla isPlace -valintaruutu sen mukaan, onko laite henkilökohtainen vai jaettuun työtilaan tarkoitettu: Tarkistettu-työtilan laite Ei valittua - Henkilökohtainen laite
6	Täytä haluamaasi laitetyyppiä ja käyttöönottomenetelmää vastaava vaihtoehto: Laite on tarkoitettu jaettua työtilaa varten - Käytä Provision a BroadWorks Workspace API:ta työtilalaitteen käyttöönoton loppuun saattamiseksi. Laite on henkilökohtainen; haluat tehdä käyttöönoton julkisten API-rajapintojen avulla - Käytä Provision BroadWorks Subscribers API -ohjelmaa, kun haluat saattaa päätökseen ensisijaisen käyttäjän käyttöönoton. Laite on henkilökohtainen; haluat, että käyttäjät käyttävät itseaktivointia Välitä käyttäjän aktivointiportaalin URL-osoite käyttäjälle. Käyttäjän on vahvistettava sähköpostiosoitteensa, jotta käyttöönotto voidaan suorittaa loppuun. Laite on henkilökohtainen; haluat käyttää läpivirtauksen käyttöönottoa - siirry vaiheeseen 7.
7	Jos laite on henkilökohtaisessa käytössä ja haluat käyttää läpivirtauksen käyttöönottoa, määritä ensisijaiselle käyttäjälle Integrated IM+P -palvelu. Lisää IM+P-palvelu sivulla User > Profile : Valitse Profiili -sivulla Assign Services. Valitse Available Services (Käytettävissä olevat palvelut) -luettelosta Integrated IM&P ja siirrä kohde nuolinäppäimellä User Services (Käyttäjäpalvelut) -ruutuun. Napsauta OK. Valitse Profiili. Vain luotettu sähköpostivirta. Lisää käyttäjän Sähköposti osoite. Tämä asetus toimii IM&P-sähköpostina, kun Webex for Cisco BroadWorks -palveluun tehdään läpivirtausta. Tätä ei tarvita, jos käytät epäluotettavaa sähköpostivirtaa. Webexin Asiakasmalliin on määritettävä asetukset läpivirtauksen käyttöönottoa varten luotetuilla sähköposteilla tai epäluotetuilla sähköposteilla. Lisätietoja on osoitteessa Webex for Cisco BroadWorks Solution Guide.

Mitä tehdä seuraavaksi

Valinnainen. Jos haluat käyttää aktivointikoodeja MPP-laitteiden käyttöönottoon, pyydä aktivointikoodi BroadWorksista.

Pyydä MPP:n aktivointikoodi

Edellytykset aktivointikoodien käyttämiselle MPP-laitteiden kanssa

Jos käytät aktivointikoodien käyttöönottoa MPP-laitteissa, varmista, että järjestelmäsi täyttää seuraavat aktivointikoodikohtaiset vaatimukset.

Laitteen aktivointipalvelu- Täytä seuraavat vaatimukset, jotta voit ottaa laitteen aktivointipalvelun käyttöön:

Ota laitteen aktivointipalvelu käyttöön BroadWorksissa. Lisätietoja on osoitteessa Cisco BroadWorks Secure Onboarding Using Activation Codes.
Osoita Device Activation Service (DAS) BroadWorks AS:n Device Management Services (DMS) -palveluun seuraavalla CLI-komennolla:

AS_CLI/Interface/DAS> set url <url_of_DMS>
Tarkista, että BroadWorks-klusterin DAS URL -asetukseksi on määritetty Device Management Services (DMS) URL. Jos haluat tarkastella nykyistä DAS URL -asetusta Partner Hubissa, siirry osoitteeseen Asetukset > BroadWorks Calling > View Clusters ja valitse sopiva klusteri. URL-osoite näkyy kohdassa Käyttöliittymäasetukset.

Jos BroadWorks-klusterissa on paljon asiakkaita (>50), DAS URL-osoitteen lisääminen ei ole tuettu. Tällaisissa tapauksissa on suositeltavaa ottaa yhteyttä Ciscon TAC-tuki-insinööriin.

Cisco Global Discovery Services (GDS)-GDS tarvitaan aktivointikoodin määrittämiseen. Ota GDS käyttöön BroadWorksissa suorittamalla molemmat alla olevat vaiheet:

Luo palvelupyyntö GDS-tilisi käyttöönottoa varten. Cisco antaa sinulle asiakastunnuksen, asiakassalaisuuden, päivitystunnisteen ja GDS-toimialueen.

Kun GDS-tili on otettu käyttöön, ota GDS käyttöön ADP:ssä seuraavan CLI:n avulla:

ADP_CLI/Applications/BroadworksDms/DeviceActivation/IdentityProviders/Cisco> get set gdsDomain <gds_domain_from palvelupyyntö> esim. https://activation.webex.com set clientId <id_from_service_request> clientSecret <secret_from_service_request> refreshToken <token_from_service_request>

Edellä mainittujen aktivointikoodikohtaisten edellytysten lisäksi järjestelmän on täytettävä yleiset MPP-edellytykset, jotka on esitetty osoitteessa MPP Device Prerequisites.

Pyydä aktivointikoodi

Pyydä aktivointikoodi uudelle MPP-laitteelle suorittamalla seuraavat vaiheet.

Etsi ja avaa uuden laitteen laiteprofiili sivulla Identity/Device Profile .
Napsauta Device Activation -välilehteä.
Napsauta Pyydä aktivointikoodi.

Järjestelmä luo aktivointikoodin ja lähettää sen sähköpostitse pääkäyttäjälle. Käyttäjän on syötettävä koodi laitteeseen saadakseen käyttöönoton päätökseen.

Laitteen huollettavuus

Huollettavuuden yleiskatsaus

Control Hub sisältää huollettavuusvaihtoehdot, joiden avulla järjestelmänvalvojat voivat tarkastella laitteen tilaa, sekä joukon huoltovaihtoehtoja. Järjestelmänvalvojat voivat:

Näytä laitteen nykyinen tila
Käynnistä laite uudelleen etänä
Lähetä ongelmaraportti vianmääritystä varten
Poista laite

Näytä laitteen tila

Tällä menettelyllä voit tarkastella laitteen tilaraporttia Control Hubista. Tila sisältää tietoja, kuten rekisteröintitilan, MAC-osoitteen, SIP-osoitteen, IP-osoitteen ja sarjanumeron.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Napsauta sopivaa laitetta.

Käynnistä laite uudelleen

Käynnistä laite uudelleen Control Hub -käyttöliittymästä tämän menettelyn avulla.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Valitse laite.
4	Valitse Actions -pudotusvalikosta Reboot.

Ilmoita ongelma

Jos laitteessa ilmenee ongelmia, voit lähettää ongelmaraportin Ciscon TAC:lle vianmääritystä varten tämän menettelyn avulla.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Napsauta sovellettavaa laitetta.
4	Valitse Toiminnot, valitse Raportoi ongelmasta.
5	Tarkista raportin yhteenveto.

Poista laite

Tällä menettelyllä voit poistaa laitteen Control Hubista.

1	Kirjaudu sisään asiakasorganisaation Control Hub -instanssiin.
2	Napsauta Devices.
3	Valitse sopiva laite.
4	Valitse Toiminnot -pudotusvalikosta Poista.

Laitteen omistajan vaihtaminen

Tämän menettelyn avulla voit siirtää olemassa olevan laitteen, joka on otettu käyttöön aktivointikoodien avulla, uudelle laitteen omistajalle.

Tässä menettelyssä oletetaan, että Allow Activation Code Onboarding -vaihtoehto on käytössä tämän laitteen käyttämässä Identity/Device Profile -profiilissa.

Poista olemassa oleva laitteen rekisteröinti Webexistä:

Avaa Webex Control Hubissa asiakasorganisaatio, johon nykyinen laitteen omistaja kuuluu.
Kohdassa Management, valitse Devices.
Merkitse siirrettävän laitteen vieressä oleva valintaruutu.
Napsauta Poista.

Laitteen rekisteröinti poistetaan Webexistä.

Deaktivoi BroadWorksissa laitteen rekisteröinti nykyisen käyttäjän alla:

Avaa BroadWorks CommPilotissa laitteen käyttämä Identity/Device Profile .
Napsauta Device Activation -välilehteä.
Napsauta Deaktivoi laite.

Laite poistetaan käytöstä ja rekisteristä BroadWorksista. MAC-osoite poistetaan vanhasta Identity/Device Profile -määrityksestä.

Aktivoi laite BroadWorksissa käyttämällä eri käyttäjän käyttämän eri Identity/Device Profile aktivointikoodia:

Avaa BroadWorks CommPilotissa eri käyttäjälle eri Identity/Device Profile -määritys.
Varmista, että Allow Activation Code Onboarding on valittuna käytetyn Identity/Device Profile Type -profiilin osalta.
Napsauta Identity/Device Profile -ikkunassa Device Activation -välilehteä.
Napsauta Pyydä aktivointikoodi.

Uusi aktivointikoodi tulee näkyviin. Uuden käyttäjän on syötettävä tämä koodi päästäkseen laitteeseen.

Mitä tehdä seuraavaksi

Laitteen uusi omistaja syöttää laitteeseen aktivointikoodin.
Laite rekisteröidään uudelleen sekä Webexiin että BroadWorksiin käyttämällä uutta kokoonpanoa. BroadWorksin uusi Identity/Device Profile päivittyy automaattisesti laitteen MAC-osoitteella.

Suorituskyvyn seuranta

Tätä ominaisuutta varten on olemassa seuraavat suorituskykymittarit.

Laskuri	Kuvaus
Moduuli: enterprises.broadsoft.broadworks.deviceActivation.activate
bwDASActivateRequests	Vastaanotettujen aktivointipyyntöjen kokonaismäärä. Tämä sisältää BroadWorks-pyyntöjen ja Webex-pyyntöjen aktivoinnin.
bwDASActivateFailures	Niiden aktivointipyyntöjen kokonaismäärä, jotka eivät onnistuneet.Tämä sisältää epäonnistuneet BroadWorksin aktivointipyynnöt ja epäonnistuneet Webexin aktivointipyynnöt.
bwDASActivateBroadWorksRequests	Vastaanotettujen aktivoitujen BroadWorks-pyyntöjen määrä.
bwDASActivateBroadWorksFailures	Niiden aktivoitujen BroadWorks-pyyntöjen määrä, joiden loppuunsaattaminen epäonnistui. Tämä laskuri ei ota huomioon valtuutus- ja todennushäiriöitä.
bwDASActivateWebexRequests	Vastaanotettujen Webex-aktivointipyyntöjen määrä.
bwDASActivateWebexFailures	Niiden aktivoitujen Webex-pyyntöjen määrä, jotka eivät onnistuneet.
Moduuli: yritykset.broadsoft.broadworks.dms.dmBridge
bwDMBridgeRequests	Lähetettyjen DMBridge-pyyntöjen määrä.
bwDMBridgeFailures	Niiden DMBridge-pyyntöjen määrä, joiden suorittaminen epäonnistui.

Webexin integroitujen laitteiden loppukäyttäjäominaisuudet

Yhtenäinen soittohistoria

Webex-tietoiset MPP-puhelimet

Vaikutusalaan kuuluvat IP-puhelinmallit:

MPP 68xx Sarjat 6821, 6841, 6851, 6861 ja 6861.
MPP 78xx Sarja 7811, 7821, 7841, 7861
MPP 88xx Sarja 8811, 8841, 8845, 8851, 8861, 8865, 8875, 8865, 8875

Ominaisuuksien käyttöönotto:

Ominaisuuden käyttöönotto edellyttää seuraavien kriteerien täyttymistä

Webex for BroadWorks -laiteintegraatio on otettava käyttöön ja sen on toimittava MPP-laitteissa. Lisätietoja on tässä oppaassa Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Laastari- ja DTAF-vaatimukset:

Broadworks - Tämä toiminto riippuu siitä, onko BroadWorksin korjaukset asennettu. Yksityiskohdat löytyvät täältä.
Laite - Viimeisimmät MPP-kokoonpanot on otettava käyttöön. Tarvittavat CPE-paketit löytyvät täältä (kirjaudu sisään CCO-tunnuksella).

Odotukset/vaikutukset/rajoitukset:

Ensisijainen linja (vain nykyinen käyttäjä)
- Unified Call History -palvelua tuetaan, kuten mainittu.
- Tuki yksityisyyden suojaus - Suojaa/piilota puhelutiedot, kun käyttäjän salasana on asetettu.
- Jos puhelin ei ole Cloud Aware, näytetään vain kyseiseen laitteeseen ja kyseisestä laitteesta tulevien puhelujen "paikallinen historia".
Muut linjat (yhteiset tai muut)
- Vain paikallinen historia laitteeseen tulevista ja sieltä lähtevistä puheluista tuetaan.
Työtilan laitteet
- Unified Call History -palvelua ei tueta tällä hetkellä.

Kun toiminto otetaan käyttöön, kaikki MPP:n paikallispuheluhistoria (joka on peräisin BroadWorksista) poistetaan.

Webex for BroadWorks integroituihin RoomOS-laitteisiin

Saatavana alla olevissa RoomOS-laitemalleissa:

RoomOS-laitteet
Pöytäsarja: Pöytä, Pöytä Mini, Pöytä Pro
Room-sarja
RoomKit-sarja
Webex Board Series

Ominaisuuksien käyttöönotto:

Webex for BroadWorks -laiteintegraatio on toteutettava ja sen on toimittava RoomOS-laitteissa. Lisätietoja on tässä oppaassa Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Laastari- ja DTAF-vaatimukset:

Broadworks - Tämä toiminto riippuu siitä, onko BroadWorksin korjaukset asennettu. Yksityiskohdat löytyvät täältä.

Konfiguraatiovaatimukset:

Seuraavat asetukset on asetettava määritetyllä tavalla.
- Bwks Config: Feature_Toggle_Webex_Call=Kyllä

Hakemistohakua koskevat parannukset Webex for BroadWorks -integroituihin RoomOS-laitteisiin

Webex for BroadWorksin integroitujen Cisco RoomOS -laitteiden käyttäjät voivat nyt etsiä Webex-organisaationsa henkilöitä, tiloja ja jopa laitteita suoraan RoomOS-laitteistaan uuden parannetun Webex Directory -palvelun avulla. Tämä palvelu tarjoaa parannetut haku- ja hakuominaisuudet Webexiin, jotta BroadWorks-käyttäjät voivat löytää käyttäjiä ja asioita (työtiloja, laitteita jne.) Webex-organisaatiossaan.

Saatavana alla olevissa RoomOS-laitemalleissa:

RoomOS-laitteet
Pöytäsarja: Pöytä, Pöytä Mini, Pöytä Pro
Room-sarja
RoomKit-sarja
Webex Board Series

Ominaisuuksien käyttöönotto:

Webex for BroadWorks -laiteintegraatio on otettava käyttöön ja sen on toimittava MPP-laitteissa. Lisätietoja on tässä oppaassa Device-Integration-Guide-for-Webex-for-Cisco-BroadWorks.

Konfiguraatiovaatimukset:

Hakemistopalvelun vaihtokytkimen "xConfiguration Webex DirectoryServiceSupport" on oltava käytössä laitteessa.

Kiitos palautteestasi.

Webex Cisco BroadWorksille -laiteintegrointiopas

Tietoja tästä oppaasta

Asiakirjan muutoshistoria

Laitteen käyttöönoton yleiskatsaus

Huoneen käyttöjärjestelmän käyttöönotto

Laitteen käyttöönotto aktivointikoodeilla

Huonekäyttöjärjestelmän käyttöönottoprosessi

Laitteen todennus (OAuth Bearer Tokenien kautta)

Huoneen käyttöjärjestelmän edellytykset

Huoneen vähimmäiskäyttöjärjestelmän versio

BroadWorks Patch -vaatimukset

BroadWorks-alustan vaatimukset

BroadWorks-määritysvaatimukset

Edellytykset aktivointikoodin käyttöönotolle huoneen käyttöjärjestelmässä

Huoneen käyttöjärjestelmän käyttöönottoprosessi

Määritä palvelut huonekäyttöjärjestelmälle

Varaa huoneen käyttöjärjestelmälaitteet

Mitä tehdä seuraavaksi

Pyydä aktivointikoodi

Mitä tehdä seuraavaksi

MPP:n käyttöönotto Webexiin

MPP-laitteiden käyttöönotto (uudet laitteet)

MPP-laitteiden käyttöönotto (olemassa olevat laitteet)

Lisätietoja

MPP-laitteen edellytykset

Minimi MPP-versio

BroadWorks Patch -vaatimukset

BroadWorks-alustan vaatimukset

BroadWorks-määritysvaatimukset

Sertifikaatit ja palomuurit

Ominaisuuden aktivointi

Aktivointikoodin vaatimukset

MPP Device Onboarding Flow

Määritä palvelut MPP:lle

Ennen kuin aloitat

Päivitä MPP-laitteen laiteohjelmisto

Ennen kuin aloitat

Mitä tehdä seuraavaksi

Tarjoa MPP-laite

Mitä tehdä seuraavaksi

Pyydä MPP:n aktivointikoodi

Edellytykset aktivointikoodien käyttämiselle MPP-laitteiden kanssa

Pyydä aktivointikoodi

Huollettavuuden yleiskatsaus

Näytä laitteen tila

Uudelleenkäynnistä laite

Ilmoita ongelmasta

Poista laite

Vaihda laitteen omistaja

Mitä tehdä seuraavaksi

Suorituskyvyn seuraaminen

Yhtenäinen puheluhistoria

Webex-tietoiset MPP-puhelimet

Webex BroadWorksin integroiduille RoomOS-laitteille

Webex for BroadWorks -integroitujen RoomOS-laitteiden hakemistohaun parannuksia

Johdanto

Tietoa tästä oppaasta

Asiakirjan muutoshistoria

Laiteintegraatio Webex for Cisco BroadWorks -ohjelmistoon

Laitteen käyttöönoton yleiskatsaus

Room OS Onboarding

Laitteen käyttöönotto aktivointikoodien avulla

Huone OS:n käyttöönottoprosessi

Laitteen todennus (OAuth-kantajatunnisteiden avulla)

Huone OS Edellytykset

Huoneen käyttöjärjestelmän vähimmäisversio

BroadWorks Patch -vaatimukset

BroadWorks-alustavaatimukset

BroadWorksin kokoonpanovaatimukset

Edellytykset aktivointikoodin käyttöönotolle Room OS:n kanssa

Room OS Onboarding Flow

Palveluiden määrittäminen huoneen käyttöjärjestelmää varten

Huoneen OS-laitteiden käyttöönotto

Pyydä aktivointikoodi

MPP Onboarding Webexiin

MPP Device Onboarding (uudet laitteet)

MPP-laitteen käyttöönotto (olemassa olevat laitteet)

Lisätietoja

MPP-laitteen edellytykset