Webex Video Integration for Microsoft Teams -integraatioviite

Yhteenveto

Webex Video Integration for Microsoft Teams mahdollistaa Ciscon ja SIP-yhteensopivien videolaitteiden liittymisen Microsoft Teamsin kokouksiin.

Näin integraatio parantaa laitteen käyttäjän kokemusta, kun hän liittyy organisaatiossasi järjestettyihin Microsoft Teams -kokouksiin:

Webex-kokouskokemus - moninäyttöinen ja joustavat asetteluvaihtoehdot
Osallistujaluettelo, jossa näkyvät sekä Microsoftin että videointegraation osallistujat.
Kaksisuuntainen sisällön jakaminen laitteen ja Microsoft Teamsin välillä
Kokouksen tilan ilmaisimet laitteessa, mukaan lukien tallennus, transkriptio ja osallistujien odottaminen aulassa.

Kun otat videointegraation käyttöön Webexin hybridikalenteripalvelun kanssa, videolaitteesi saavat myös yhden painikkeen painalluksen (One Button to Push, OBTP) yksinkertaistetun kokousliittymiskokemuksen.

Arkkitehtuurin yleiskatsaus

Microsoft Cloud Video Interop (CVI) -ohjelma antaa Ciscon kaltaisille kumppaneille mahdollisuuden tarjota palveluja, jotka yhdistävät videolaitteet Microsoft Teamsin kokouksiin.

CVI-arkkitehtuurikuva perustuu https://docs.microsoft.com/en-us/microsoftteams/cloud-video-interop — ***Ratkaisun arkkitehtuuri***

Webex Video Integration for Microsoft Teams on Microsoft Qualified kolmannen osapuolen Cloud Video Interop -ratkaisu, joka on rakennettu Webex-pilvialustalle. Webex-pilvipalvelun CVI-kumppanitoiminnot ovat käytettävissä kaikkialla, missä soittajat voivat soittaa yritysten välisiä puheluita julkiseen Internetiin. Yleiset Webex-palvelut tarjoavat hallinnan, soittoinfrastruktuurin, vuorovaikutteiset puhevastausjärjestelmät ja aulatilat. Eri puolilla maailmaa sijaitsevat Webex-mediaklusterit tarjoavat transkoodausta, protokollakäännöksiä ja Teams Bot -rooleja.

Tässä arkkitehtuurissa videolaitteet soittavat puheluita tiettyihin Webexin isännöimiin SIP URI:hin. Webex-palvelut vastaavat puheluihin ja jakavat ne Microsoft Azuressa toimiviin maantieteellisesti relevantteihin mediaklustereihin. IVR kerää tarvittaessa kokouksen tiedot, ja Webexin mediaklusterissa oleva Microsoft Teamsin Media CVI -robotti muodostaa yhteyden Microsoft Teamsin kokousinfrastruktuuriin. Mediaklusterit tarjoavat back-to-back-yhteyden Webexin kautta yhdistetyn osallistujan ja Microsoft Teamsin isännöimän muun konferenssin välillä. Koko ratkaisu toimii pilvipalveluna.

Videointegraatio mahdollistaa laitteiden liittymisen Teams-kokouksiin seuraavasti:

Jos kokous on otettu käyttöön CVI:tä varten, laite voi liittyä kokoukseen videotunnuksen ja vuokralaisen avaimen avulla.
Jos kokous ei ole käytössä CVI:tä varten, laite voi liittyä kokoukseen vieraana (cross-tenant join) kokoustunnuksen ja salasanan avulla.

Voit parantaa käyttäjäkokemusta lisäämällä muita Webex-palveluja. Hybridikalenteripalvelu esimerkiksi lähettää automaattisesti kokouksen tiedot ja yksinkertaistetut liittymispainikkeet videolaitteille, kun on aika liittyä kokoukseen.

Tietojen käsittely

Videointegraatio käyttää seuraavia tietoja laitteiden yhdistämiseen Microsoft Teams -kokouksiin ja kokouksen sisäisten ominaisuuksien tarjoamiseen:

Yrityssovelluksen rekisteröinti: Käyttöönoton aikana järjestelmänvalvoja myöntää Webex Video Integration -sovelluksen avulla käyttöoikeudet organisaation Microsoft-tilaajaan, kun käytetään Microsoft Graph APIa. Lisätietoja on osoitteessa Webex Video Integration in Microsoft Entra admin center.
Webexin tarjoama "vuokralaisen avain": Tämä on asiakaskohtainen arvo, jota käytetään SIP-osoitteissa, kun laite soittaa VIMT-palveluun.
Kokouksen tunnus: Microsoft Teams määrittää tämän tunnisteen kokousta luotaessa ja sisällyttää sen kokouskutsuun.

Käyttäjät tarvitsevat kokoustunnuksen liittyäkseen kokouksiin Teams-asiakkaiden kautta, suoralla vierasliittymällä tai VIMT-palvelun kautta tapahtuvalla vuokralaisryhmien välisellä liittymisellä.

Videointegraatio käyttää tätä ID:tä Microsoft Teamsin kohdekokouksen määrittämiseen Cross-Tenant-liittymisen aikana.
Kokouskoodi: Microsoft Teams määrittää kokousta luotaessa salasanan, joka on herkkä isoille ja pienille kirjaimille, ja sisällyttää sen kokouskutsuun. Käyttäjät tarvitsevat salasanan liittyäkseen kokoukseen kokoustunnuksella.

Videointegraatio käyttää tätä salasanaa päästäkseen Microsoft Teamsin kohdekokoukseen Cross-Tenant-liittymisen aikana.
Video ID: Microsoft Teams määrittää tämän tunnisteen kokoukselle, kun CVI-käyttäjä luo sen. Microsoft Teams sisällyttää videotunnuksen kokouskutsuun.

Videointegraatio käyttää videotunnusta ja asiakkaan Microsoft-tunnusta saadakseen kokoukseen liittymis-URL:n Microsoft Graph API:sta.

(Microsoft päivitti merkinnän "Video ID" muotoon "VTC conference ID".)
Asiakkaan Microsoftin vuokralaisen tunnus: Käytetään Microsoftin kohdeorganisaation tunnistamiseen, kun kommunikoidaan Microsoft Graph API:n kanssa. Käytetään myös palvelun hallintakäyttöliittymässä tunnistamaan tarjottu Microsoft-vuokralainen.
Microsoftin vuokralaisen vahvistamat verkkotunnukset: Käytetään palvelun hallintakäyttöliittymässä merkintöinä, joilla tunnistetaan käyttöönotettu Microsoft-vuokralainen.
Kokoustiedot: Kun osallistuja pyytää liittymistä Microsoft Teams -kokoukseen videointegraation kautta, palvelu hakee kokouksen tiedot, mukaan lukien kokouksen aihe, järjestäjä, päivämäärä ja aika sekä yhteystiedot. Kun yhteys on muodostettu, palvelu hakee Microsoft Graph API:sta reaaliaikaisia tietoja, kuten osallistujatunnisteet, ominaisuudet ja Teams-kokoukseen liitettyjen osallistujien tilan, ja käyttää niitä live-kokouksen järjestämiseen.

Kun otat hybridikalenteripalvelun käyttöön postilaatikossa, kalenteripalvelu käyttää Lisätietoja -linkkiä, joka sijaitsee sen sisältävien kalenterimerkintöjen rungossa, kokouksen "vuokralaisavaimen" ja videotunnuksen tunnistamiseen.
Reaaliaikainen media ja sisältö: Kun osallistuja liittyy Microsoft Teamsin kokoukseen videointegraation kautta, Webex ja Microsoft Teams vaihtavat koodattua ääntä, videota ja korkeaa kuvataajuutta sisältävää sisältöä, jotta niiden välinen kaksisuuntainen ääni- ja videokokemus on mahdollista.

Jos otat videointegraation käyttöön hybridikalenteripalvelun kanssa, katso myös Webex Hybrid Calendar Service with Microsoft 365 Integration Reference.

Tunnistus ja valtuutus

Webex on vuorovaikutuksessa Microsoft Teams -ympäristön kanssa Microsoft Graph API:n avulla. Pilvipohjainen Microsoftin identiteettipalveluntarjoaja (IdP) hoitaa Microsoft Graph API:n todennuksen. Pyynnöt Microsoft Graph API:lle hyväksytään esittämällä Microsoft IdP:n myöntämät haltijakoodit. Kaikki viestintä Microsoft IdP:n ja Graph API:n kanssa käyttää TLS-suojattuja verkkoyhteyksiä.

Jos haluat olla vuorovaikutuksessa Microsoft Teamsin media palveluna -palvelun kanssa, rekisteröi Webex-videointegraatio sovelluksen isännöimänä mediabottina, joka sijaitsee Ciscon hallinnoimassa Microsoft 365 -vuokralaisessa. Teams-robotit tarvitsevat ennakkoluvan voidakseen kommunikoida organisaation Microsoft 365 -vuokralaisen kanssa.

Alkukonfiguroinnin aikana palvelu pyytää valtuutusta ennalta määritetyille käyttöoikeuksille. Järjestelmänvalvoja myöntää nämä sovellusoikeudet noudattamalla alla kuvattua suostumuksen kulkua.

Kun Webex-palvelu on hyväksytty, se voi pyytää Microsoft OAuth v2.0 IdP:ltä bearer-tunnisteita oikeilla oikeuksilla ja asiakkaan laajuudella. Palvelu käyttää bearer-tunnisteita valtuuttamaan Microsoft Graph API:lle tehtävät pyynnöt, jotka koskevat käyttöönottotietoja, terveystarkastuksia ja Teams-botin toimintaa.

Valtuutus ja Microsoftin ylläpitäjän suostumus

Organisaation ylläpitäjät, joilla on Full Administrator -rooli, voivat käyttää Control Hubia videointegraatiopalvelun määrittämiseen organisaatiolleen.

Käyttöönottoprosessi edellyttää sen Microsoft 365 -vuokralaisen, johon käyttäjät kuuluvat, globaalin järjestelmänvalvojan todennusta ja suostumusta. Teams-botin käyttämiseen tarvittavat sovellusoikeudet voi myöntää vain Microsoft-tilaajayksikön yleinen järjestelmänvalvoja seuraavan järjestelmänvalvojan suostumusvirran avulla.

Virtaukseen kuuluvat seuraavat korkean tason vaiheet:

Kirjaudu Control Hubiin, etsi ja käynnistä videointegraation asennus (yksityiskohtaiset asennusvaiheet löytyvät osoitteesta Deploy the Webex Video Integration for Microsoft Teams).

Asennusprosessin aikana selaimesi ohjaa Microsoftin pilvipalveluun todennusta ja suostumusta varten.
Kirjaudu sisään Microsoftin vuokralaisen globaalina järjestelmänvalvojana.

Sovellus pyytää lupaa:
- Kirjaudu sisään ja lue profiilisi
- Lue hakemiston RBAC-asetukset
Näin sovellus voi tarkistaa, että tilisi on valtuutettu vuokralaisessasi, jotta se voi myöntää tarvittavat käyttöoikeudet.
Merkitse rasti ruutuun Suostumus organisaatiosi puolesta ja napsauta sitten Hyväksy.

Sovellus kirjautuu sisään ja tarkistaa käyttöoikeutesi.

Kun olet saanut valtuutuksen onnistuneesti, sovellus kysyy sinulta uudelleen. Tällä kertaa kehotteessa näytetään käyttöoikeudet, joita sovellus tarvitsee, jotta videolaitteet voidaan yhdistää onnistuneesti Microsoft Teams -kokouksiin.

Kehotteessa näytetään sovelluksen nimi, myyjän toimialue ja pyydetyt käyttöoikeudet.
Napsauta Accept , jos haluat myöntää nämä oikeudet Webex Video Integration -sovellukselle.

Sinut ohjataan takaisin Control Hubiin, jossa näet räätälöidyt PowerShell-komennot, joita tarvitset Microsoft Teamsin kokoonpanon loppuunsaattamiseksi.
Viimeistele Microsoft Teamsin määritys PowerShellin avulla ja sulje Control Hub -paneeli.

Asetusprosessi testaa Microsoft Graph API -kutsun organisaatiolle. Jos asennus onnistuu, se on valmis. Jos näin ei tapahdu, järjestelmänvalvoja voi yrittää valtuutusprosessia uudelleen.

Myönnetyt luvat

Webex Video Integration for Microsoft Teams edellyttää nimenomaisia oikeuksia Microsoftin vuokralaisessasi. Näitä oikeuksia ei voi mukauttaa, ja ne määritetään automaattisesti Control Hubin asennusprosessissa.

Käytössä on kaksi erillistä käyttöoikeuskokonaisuutta:

Joukko käyttäjän antamia käyttöoikeuksia, joita käytetään asennuksen aikana vuokralaisen kohdetietojen tarkistamiseen.
Järjestelmänvalvojan suostumuksella Entra-hakemistossasi olevalle yrityssovellukselle myönnetyt käyttöoikeudet. Tämän setin avulla palvelu voi käyttää Microsoft Teams -ympäristöäsi.

Käyttäjän antamat käyttöoikeudet

Palvelun asennuksen aikana pyydämme kirjautuneelta käyttäjältä seuraavat oikeudet. Ne sallivat pääsyn Microsoftin vuokralaiselle, jotta se voi tarkistaa kohdevuokralaisen tiedot. Käytämme näitä oikeuksia vain integraation määrityksen aikana; niitä ei tallenneta.

Voit tarkastella näitä Käyttäjän antamia oikeuksia sovelluksen Käyttöoikeudet -sivulla Entra-hakemistossa.

Taulukko 1. Käyttäjän antamat käyttöoikeudet ja miksi asennusprosessi tarvitsee niitä.
Lupa vaaditaan	Käyttötarkoitus
"Kirjaudu sisään ja lue käyttäjäprofiili" (User.read)	Käytetään kirjautuneen käyttäjän profiilin lukemiseen käyttäjän vuokralaisen tunnistamiseksi.
"Lue hakemiston RBAC-asetukset" (RoleManagement.Read.Directory)	Tarkistetaan, kuuluuko kirjautunut käyttäjä Entra ID:n tunnettuihin järjestelmänvalvojien suojausryhmiin.
"Säilytä pääsy tietoihin, joihin olet antanut sille pääsyn" (offline_access).	Sallii palvelun nähdä sille antamasi tiedot ilman, että käyttäjät ovat kirjautuneet sisään.

Palvelun käyttöoikeudet

Microsoftin järjestelmänvalvojan suostumusvirta myöntää seuraavat käyttöoikeudet vuokralaisesi "Cisco Webex Video Integration for MS Teams Enterprise Application" -sovellukselle. Näiden käyttöoikeuksien avulla Webex-palvelu voi käyttää Teams-ympäristöäsi.

Käyttöoikeudet säilyvät sovelluksen kanssa Entra-hakemistossa, kunnes poistat Webex-palvelun, jolloin myös sovellus poistetaan.

Taulukko 2. Järjestelmänvalvojan myöntämät käyttöoikeudet ja miksi Webex-palvelu tarvitsee niitä.
Lupa	Käyttö
Lue verkkotunnuksia (Domain.Read.All)	Sallii palvelun lukea vuokralaisen todennetut verkkotunnukset. Control Hub käyttää verkkotunnuksia tunnistamaan vuokralaisen, johon palvelu on liitetty.
Lähtevien 1-to-1-puhelujen käynnistäminen sovelluksesta (Calls.Initiate.All).	Mahdollistaa puheluiden luomisen Microsoft Teamsin käyttäjille. (Varattu tulevaa käyttöä varten.)
Lähtevien ryhmäpuhelujen käynnistäminen sovelluksesta (Calls.InitiateGroupCall.All).	Mahdollistaa puheluiden luomisen botilla Microsoft Teams -käyttäjäryhmälle. (Varattu tulevaa käyttöä varten.)
Liity ryhmäpuheluihin ja kokouksiin sovelluksena (Calls.JoinGroupCall.All).	Sallii botin liittyä ryhmäpuheluihin ja aikataulutettuihin kokouksiin organisaatiossasi hakemistokäyttäjän oikeuksilla. Käytetään sellaisten osallistujien liittymiseen, joilla on oikeus ohittaa Microsoft Teamsin aula.
Liity ryhmäpuheluihin ja kokouksiin vieraana (Calls.JoinGroupCallAsGuest.All).	Mahdollistaa botin osallistumisen organisaatiosi ryhmäpuheluihin ja aikataulutettuihin kokouksiin vieraana. Käytetään sellaisten osallistujien liittymiseen, joilla ei ole valtuuksia ohittaa Microsoft Teamsin aulaa.
Pääsy mediavirtoihin puhelun aikana sovelluksena (Calls.AccessMedia.All)	Mahdollistaa botille suoran pääsyn puhelun mediavirtoihin ilman kirjautunutta käyttäjää.
Lue verkkokokouksen tiedot (OnlineMeetings.Read.All)	Sallii palvelun lukea organisaatiosi verkkokokoustietoja. Käytetään VTC-konferenssitunnusten etsimiseen ja ratkaisemiseen Microsoft Teams -kokouksiin.
Kirjaudu sisään ja lue käyttäjäprofiili (User.read)	Vaaditaan muita lueteltuja oikeuksia varten. Integrointi ei käytä sitä suoraan.

Microsoft Graph Permissions Reference: https://docs.microsoft.com/en-us/graph/permissions-reference

Microsoftin kokousbotit Yleiskatsaus: https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview

Pääsy kokouksiin

Osallistujia, jotka ovat yhteydessä videointegraation kautta, kohdellaan yleensä Microsoft Teams -kokousten vieraskäyttäjinä, ja heidät voidaan sijoittaa aulaan (odotushuoneeseen). Microsoft Teams -käyttäjän on hyväksyttävä aulassa oleva osallistuja manuaalisesti, ennen kuin osallistuja voi kuulla tai nähdä muita osallistujia.

Voit hallita Microsoft Teamsin aulakäyttäytymistä Microsoft Teamsin järjestelmänvalvojan määrittämien kokouskäytäntöjen ja kokousjärjestäjän määrittämien kokousasetusten avulla. Oletusarvoisesti Microsoft Teamsin vieraskäyttäjien on käytettävä aulaa. Lisätietoja Teamsin kokouskäytännöistä on osoitteessa Manage meeting policies in Teams.

Jos Anonyymit käyttäjät voivat osallistua kokoukseen on pois päältä: vain luotetut osallistujat, joilla on lupa ohittaa aulakäytävä, voivat liittyä kokoukseen Webex-videointegraation avulla.

Osallistujat, jotka käyttävät vuokralaisen välistä liittymistä (mukaan lukien kokoustunnuksen ja salasanan käyttö), liittyvät aina vieraina. Nämä liittymisyritykset epäonnistuvat, jos kokousta isännöivä organisaatio on poistanut käytöstä Anonyymit käyttäjät voivat liittyä kokoukseen.

Luotettujen osallistujien aulan ohitus

Osallistujia, jotka muodostavat yhteyden videointegraatioon seuraavilla menetelmillä, kohdellaan luotettavina osallistujina, ja he voivat liittyä Microsoft Teams -kokouksiin ilman, että heitä sijoitetaan aulaan:

Laitteet, jotka on rekisteröity Webex-organisaatioon Webex-rekisteröityinä laitteina.
Soittaminen SIP-verkkotunnuksista, jotka on lisätty ja todennettu organisaatiosi omistamiksi Control Hubissa.

Luotettuja osallistujia kohdellaan kuin organisaatiosi osallistujia. Osallistujat, jotka muodostavat yhteyden näiden luotettavien polkujen kautta, voivat ohittaa aulan, jos järjestäjä on rajoittanut Teams-kokouksen aula-asetuksia. Jos Kuka voi ohittaa aulan? kokousvaihtoehto on asetettu arvoon "Järjestäjät ja minä" tai "Kutsumani henkilöt", liittymistä yrittävät luotetut osallistujat jätetään huomiotta ja kaikki VIMT-soittajat sijoitetaan Teams-kokouksen aulaan, kun he liittyvät kokoukseen.

Osallistujat, jotka käyttävät vuokralaisen välistä liittymistä (mukaan lukien kokoustunnuksen ja salasanan käyttö), liittyvät aina vieraina. Tämä tarkoittaa, että jopa luotettavien osallistujien, jotka liittyvät tällä tavoin, on odotettava aulassa, että isäntä päästää heidät sisään.

Lisätietoja SIP-verkkotunnusten lisäämisestä ja tarkistamisesta on osoitteessa SIP-videolaitteiden verkkotunnuksen tarkistusprosessi.

Webex Video -integraatio Microsoft Entra -hallintakeskuksessa

Sovellusta ei tarvitse ylläpitää sen jälkeen, kun olet valtuuttanut videointegraatiopalvelun käyttämään Microsoft 365 -tiliäsi. Voit tarkistaa sen läsnäolon ja laajuuden Microsoft Entra -hallintakeskuksen yrityssovellusluettelosta.

Tämän integraation yhteydessä vuokralaisessasi ei toimi mitään fyysistä sovellusta tai ohjelmistoa. Yrityssovellusmerkintä toimii Webex-sovellusidentiteetille myönnetyn valtuutuksen määrittelynä ja sijoituspaikkana.