- Start
- /
- Artikel
Webex videointegration för Microsoft Teams integrationsreferens
Sammanfattning
Webex videointegration för Microsoft Teams gör det möjligt för Cisco- och SIP-kompatibla videoenheter att delta i Microsoft Teams-möten.
Så här förbättrar integrationen enhetsanvändarens upplevelse när de ansluter sig till Microsoft Teams-möten som hålls i organisationen:
-
Webex-mötesupplevelse — flera skärmar med flexibla layoutalternativ
-
Deltagarlista som visar både Microsoft- och videointegrationsdeltagare
-
Dubbelriktad innehållsdelning mellan enheten och Microsoft Teams
-
Mötesstatusindikatorer på enheten, inklusive inspelning, transkription och deltagare som väntar i lobbyn
När du distribuerar videointegrationen med Webex Hybrid Calendar Service får dina video enheter också den förenklade upplevelsen med en knapp till tryck (OBTP) förenklad mötesanslutning.
Arkitekturöversikt
Programmet Microsoft Cloud Video Interop (CVI) gör det möjligt för partners som Cisco att leverera tjänster som ansluter videoenheter till Microsoft Teams-möten.

Webex Video Integration for Microsoft Teams är en Microsoft-kvalificerad molnvideointerop-lösning från tredje part byggd på Webex molnplattform. CVI-partnerfunktionerna i Webex-molnet är tillgängliga överallt där uppringare kan ringa samtal mellan företag till företag till det offentliga Internet. De vanliga Webex-tjänsterna tillhandahåller administration, samtalsinfrastruktur, interaktiva röstsvarssystem och lobbyer. Webex mediekluster runt om i världen tillhandahåller omkodning, protokollöversättningar och Teams Bot-rollerna.
Med den här arkitekturen ringer videoenheter till specifika SIP-URI: er som är värd för Webex. Webex-tjänster svarar på samtalen och tilldelar dem till geografiskt relevanta mediekluster som körs i Microsoft Azure. IVR samlar mötesinformation om det behövs, och Microsoft Teams Media CVI-bot i Webex mediekluster gör anslutningen till Microsoft Teams-mötesinfrastrukturen. Mediaklusterna ger back-to-back-anslutningen mellan deltagaren ansluten via Webex och resten av konferensen som är värd på Microsoft Teams. Hela lösningen fungerar som en molntjänst.
Videointegrationen gör det möjligt för enheter att delta i Teams-möten enligt följande:
-
Om mötet är aktiverat för CVI kan enheten ansluta med hjälp av Video-ID och klientnyckeln.
-
Om mötet inte är aktiverat för CVI kan enheten gå med som gäst (anslutning mellan klienter) med hjälp av mötes-ID och lösenord.
Du kan förbättra användarupplevelsen genom att lägga till andra Webex-tjänster. Hybrid Calendar Service skickar till exempel automatiskt mötesinformation och förenklade anslutningsknappar till videoenheterna när det är dags att gå med i mötet.
Datahantering
Videointegreringen använder följande data för att ansluta enheter till Microsoft Teams-möten och tillhandahålla funktioner i mötet:
-
Registrering av företagsappar: Under etableringen använder en administratör programmet Webex Video Integration för att ge behörighet att komma åt organisationens Microsoft-klientorganisation när Microsoft Graph API används. Mer information finns i Webex videointegration i Microsoft Entra administr ationscenter.
-
En ”klientnyckel” som tillhandahålls av We bex: Detta är ett värde per kund som används i SIP-adresser när enheten anropar till VIMT-tjänsten.
-
Mötes-ID: Microsoft Teams tilldelar den här identifieraren när mötet skapas och inkluderar den i mötesinbjudan.
Användare behöver mötes-ID:t för att delta i möten från Teams-klienter, eller genom direkt gästanslutning eller genom att ansluta mellan hyresgäster med VIMT-tjänsten.
Videointegreringen använder det här ID:t för att ange målmötet i Microsoft Teams under anslutningen mellan hyresgäster.
-
Lösen@@ kod för möte: Microsoft Teams tilldelar ett skiftlägeskänsligt lösenord när mötet skapas och inkluderar det i mötesinbjudan. Användare behöver lösenkoden för att ansluta till ett möte med mötes-ID.
Videointegrationen använder det här lösenordet för att komma åt Microsoft Teams-målmötet under anslutningen mellan hyresgäster.
-
Video-ID: Microsoft Teams tilldelar denna identifierare till ett möte när det skapas av en CVI-aktiverad användare. Microsoft Teams inkluderar video-ID:t i mötesinbjudan.
Videointegreringen använder Video-ID och kundens Microsoft-klientorganisations-ID för att hämta mötesanslutningsadressen från Microsoft Graph API.
(Microsoft uppdaterade etiketten till ”Video ID” från ”VTC-konferens-ID”.)
-
Kundens Microsoft-klientorganisations-ID: Används för att identifiera målorganisationen från Microsoft när den kommunicerar till Microsoft Graph API. Används även i tjänstens administrativa gränssnitt för att identifiera den etablerade Microsoft-klientorganisationen.
-
Microsoft-hyresgästverifierade domännamn: Används som etiketter i tjänstens administrativa gränssnitt för att identifiera den etablerade Microsoft-klientorganisationen.
-
Mötesinformation: När en deltagare begär att delta i ett Microsoft Teams-möte via videointegrationen hämtar tjänsten information för mötet inklusive mötesämne, arrangör, datum/tid och anslutningsinformation. När tjänsten är ansluten hämtar tjänsten realtidsinformation som deltagaretiketter, funktioner och status för deltagare som är anslutna till Teams-mötet från Microsoft Graph API och använder dem för att underlätta live-mötet.
När du aktiverar Hybrid Calendar Service för en postlåda använder kalendertjänsten länken Mer info, som finns i brödtexten för kalenderposter som innehåller den, för att identifiera mötets ”klientnyckel” och video-ID.
-
Medier och innehåll i realtid: När en deltagare ansluter sig till ett Microsoft Teams-möte via videointegrationen utbyter Webex och Microsoft Teams kodat ljud-, video- och högbildningsinnehåll för att möjliggöra tvåvägs ljud- och videoupplevelsen mellan dem.
Om du distribuerar videointegrationen med Hybrid Calendar Service, se även Webex Hybrid Calendar Service med Microsoft 365 Integration Reference.
Autentisering och auktorisering
Webex interagerar med din Microsoft Teams-miljö med hjälp av Microsoft Graph API. Den molnbaserade Microsoft-identitetsleverantören (IdP) hanterar autentisering för Microsoft Graph API. Begäran till Microsoft Graph API godkänns genom att visa innehavartokens utfärdade av Microsoft IdP. All kommunikation till Microsoft IdP och Graph API använder TLS-säkrade webbanslutningar.
Om du vill interagera med Microsoft Teams media som en tjänst registrerar du Webex-videointegreringen som en programvärd mediebot som är hemplacerad i en Microsoft 365-klient som hanteras av Cisco. Teams-bots kräver förhandstillstånd för att kunna kommunicera med en organisations Microsoft 365-klient.
Under den första konfigurationen begär tjänsten auktorisering för en fördefinierad uppsättning behörigheter. En administratör beviljar dessa applikationsbehörigheter genom att följa samtyc kesflödet som beskrivs nedan.
När Webex-tjänsten har godkänts kan den begära bärartokens, med rätt behörighet och kundomfång, från Microsoft OAuth v2.0 IdP. Tjänsten använder bärartokens för att auktorisera förfrågningar till Microsoft Graph API för etableringsdetaljer, hälsokontroller och drift av Teams-boten.
Auktorisering och Microsoft-administratörsgodkännande
Organisationsadministratörer med rollen Fullständig administratör kan använda Control Hub för att konfigurera videointegreringstjänsten för sin organisation.
Provisionsprocessen kräver autentisering av och samtycke från en global administratör för Microsoft 365-klientorganisationen som användarna tillhör. De program behörigheter som krävs för att använda Teams-boten kan endast beviljas av en global administratör för Microsoft-klientorganisationen med hjälp av följande administratörsgodkännandeflöde.
Flödet innehåller följande steg på hög nivå:
-
Logga in på Control Hub, hitta och starta sedan inställningen för videointegrering.
För detaljerade installationssteg, se Distribuera Webex videointegration för Microsoft Teams).
Under installationsprocessen omdirigeras webbläsaren till Microsofts moln för autentisering och samtycke.
-
Logga in som global administratör för Microsoft-klientorganisationen.
Applikationen ber om ditt tillstånd att:
- Logga in och läs din profil
- Läs kataloginställningar för RBAC
Detta är så att applikationen kan verifiera att ditt konto är auktoriserat inom din hyresgäst att bevilja nödvändiga behörigheter.
-
Granska de begärda behörigheterna och klicka på Acceptera. Du behöver inte kontrollera Samty cke på uppdrag av din organisation, eftersom det inte krävs.
Programmet loggar in dig och kontrollerar dina behörigheter.
När du har godkänts uppmanas programmet dig igen. Den här gången visar prompten behörigheter som programmet behöver för att framgångsrikt ansluta videoenheter till dina Microsoft Teams-möten.
Ledtexten visar programnamn, leverantörsdomän och begärda behörigheter.
-
Klicka på Accep tera för att ge dessa behörigheter till programmet Webex Video Integration.
Du omdirigeras tillbaka till Control Hub, där du kan se skräddarsydda PowerShell-kommandon som du behöver för att slutföra Microsoft Teams-konfigurationen.
-
Använd PowerShell för att slutföra Microsoft Teams-konfigurationen och stäng sedan panelen Control Hub.
Installationsprocessen testar ett Microsoft Graph API-anrop för organisationen. Om det lyckas är installationen klar. Om inte, kan administratören försöka auktoriseringsprocessen igen.
Behörigheter beviljade
Webex videointegration för Microsoft Teams kräver uttryckliga behörigheter i din Microsoft-klientorganisation. Dessa behörigheter kan inte anpassas och konfigureras automatiskt av installationsprocessen i Control Hub.
Det finns två separata uppsättningar behörigheter som används:
-
En uppsättning användargodkända behörigheter som används under installationen för att verifiera målklientinformationen
-
En uppsättning behörigheter som beviljats av administratörens samtycke till Enterprise-programmet i din Entra-katalog. Den här uppsättningen gör det möjligt för tjänsten att komma åt din Microsoft Teams-miljö
Användarsamtyckta behörigheter
Under installationen av tjänsten begär vi följande behörigheter från den inloggade användaren. De ger åtkomst till Microsoft-klientorganisationen för att verifiera information om mål klienten. Vi använder endast dessa behörigheter medan du ställer in integrationen; de lagras inte.
Du kan granska dessa användarsamtyckta behörigheter på programmets sida Behö righeter i din Entra-katalog.
| Tillstånd krävs | Syfte |
|---|---|
| ”Logga in och läs användarprofil” (User.read) | Används för att läsa den inloggade användarens profil för att identifiera användarens hyresgäst. |
| ”Läs kataloginställningar för RBAC” (RoleManagement.READ.directory) | Används för att kontrollera om den inloggade användaren är medlem i de välkända administratörs säkerhetsgrupperna i Entra ID. |
| ”Behåll åtkomst till data som du har gett den åtkomst till” (offline_access) | Tillåter tjänsten att se de data du gav den åtkomst till utan att användare är inloggade. |
Tjänstbehörigheter
Flödet för Microsoft-administratörssamtycke ger följande behörigheter till "Cisco WebexVideointegration för MS Teams Enterprise-applikation” i din klientorganisation. Dessa behörigheter gör det möjligt för Webex-tjänsten att komma åt din Teams-miljö.
Behörigheterna kvarstår med programmet i din Entra-katalog tills du tar bort Webex-tjänsten, vilket också tar bort programmet.
|
Tillstånd |
Användning |
|---|---|
|
Läs domäner (Domain.Read.All) |
Tillåter tjänsten att läsa hyresgästens verifierade domännamn. Control Hub använder domännamnen för att identifiera klientorganisationen som tjänsten är länkad till. |
|
Initiera utgående 1-till-1-samtal från appen (Calls.Initiate.All) |
Tillåter skapande av samtal av boten till Microsoft Teams-användare. (Reserverad för framtida bruk.) |
|
Initiera utgående gruppsamtal från appen (Calls.InitiateGroupCall.all) |
Tillåter skapande av samtal av boten till en grupp Microsoft Teams-användare. (Reserverad för framtida bruk.) |
|
Gå med i gruppsamtal och möten som en app (Calls.JoinGroupCall.all) |
Tillåter att boten ansluter sig till gruppsamtal och schemalagda möten i organisationen med behörigheterna för en kataloganvändare. Används för att ansluta deltagare som har behörighet att kringgå Microsoft Teams-lobbyn. |
|
Gå med i gruppsamtal och möten som gäst (Calls.JoinGroupCallasGuest.all) |
Tillåter att boten ansluter sig till gruppsamtal och schemalagda möten i organisationen som gäst. Används för att ansluta deltagare som inte har behörighet att kringgå Microsoft Teams-lobbyn. |
|
Få åtkomst till medieströmmar i ett samtal som en app (Calls.accessMedia.all) |
Tillåter boten att få direkt åtkomst till medieströmmar i ett samtal, utan en inloggad användare. |
|
Läs information om onlinemöte (OnlineMeetings.read.all) |
Tillåter tjänsten att läsa information om onlinemöte i organisationen. Används för att slå upp och lösa VTC-konferens-ID:n till Microsoft Teams-möten. |
|
Logga in och läs användarprofil (User.read) |
Krävs för de andra behörigheterna som anges. Integrationen använder den inte direkt. |
Microsoft Graph-behörighetsreferens: https://docs.microsoft.com/en-us/graph/permissions-reference
Översikt över Microsoft Meeting Bots: https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview
Tillgång till möten
Deltagare som ansluter via videointegrationen behandlas normalt som gästanvändare till Microsoft Teams-möten och kan placeras i en lobby (väntrum). En Microsoft Teams-användare måste manuellt tillåta en deltagare som befinner sig i lobbyn innan deltagaren kan höra eller se andra deltagare.
Du kan styra beteendet i Microsoft Teams lobby genom mötesprinciper som ställts in av en administratör i Microsoft Teams och genom mötesalternativ som ställts in av mötesorganisatören. Som standard måste Microsoft Teams gästanvändare använda lobbyn. Mer information om Teams-mötespolicyer finns i Hantera mötespolicyer i Teams.
Om anonyma användare kan gå med i ett möte är avstängt kan endast betrodda deltagare som tillåts förbikoppla lobbyn gå med i mötet med hjälp av Webex-videointegreringen.
Deltagare som använder anslutning mellan klienter (inklusive att använda mötes-ID och lösenord) går alltid med som gäster. Dessa anslutningsförsök misslyckas om organisationen som är värd för mötet har inaktiverat Anonyma användare kan gå med i ett möte.
Lobbybypass för betrodda deltagare
Deltagare som ansluter till videointegrationen med följande metoder behandlas som betrodda deltagare och går med i Microsoft Teams-möten utan att placeras i en lobby:
-
Enheter registrerade i din Webex-organisation som Webex-registrerade enheter
-
Ringa från SIP-domäner som har lagts till och verifierats som ägda av organisationen i Control Hub
Betrodda deltagare behandlas som deltagare i organisationen. Deltagare som ansluter via dessa betrodda vägar kan kringgå lobbyn om arrangören har begränsat inställningarna för Teams-möteslobbyn. Om vem kan kringgå lobbyn? mötesalternativet är inställt på ”Arrangörer och jag” eller ”Personer jag bjuder in”, betrodda deltagare som försöker gå med ignoreras och alla VIMT-uppringare placeras i Teams-möteslobbyn när de går med i ett möte.
Deltagare som använder anslutning mellan klienter (inklusive att använda mötes-ID och lösenord) går alltid med som gäster. Detta innebär att även betrodda deltagare som går med på detta sätt måste vänta i lobbyn för att bli antagen av värden.
Mer information om hur du lägger till och verifierar SIP-domäner finns i Domänverifieringsprocess för SIP-videoenheter.
Webex videointegration i Microsoft Entra administrationscenter
Det finns inget underhållskrav för programmet efter att du har auktoriserat video integrationstjänsten för åtkomst till din Microsoft 365-klientorganisation. Du kan verifiera dess närvaro och omfattning i listan Enterprise-program i Microsoft Entra administrationscenter.
Ingen fysisk applikation eller programvara körs i din hyresgäst som en del av denna integration. Företagsapplikationsposten fungerar som definition och platshållare för den auktorisation som beviljats Webex-applikationsidentiteten.
Klicka på programnamnet och klicka sedan på Beh örigheter för att se de behörigheter som programmet har i klientorganisationen.