In dit artikel
Samenvatting
Overzicht van de architectuur
Gegevensverwerking
dropdown icon
Authenticatie en autorisatie
    Toestemmingen verleend
    Machtigingen met toestemming van de gebruiker
    Machtigingen voor diensten
Webex-video-integratie in het Microsoft Entra-beheercentrum
Aanvullend referentiemateriaal

Verwijzing naar Webex-video-integratie voor Microsoft Teams-integratie

list-menuIn dit artikel
list-menuFeedback?

Samenvatting

Met Webex Video Integration voor Microsoft Teams kunnen videoapparaten van Cisco en SIP deelnemen aan Microsoft Teams-vergaderingen.

Zo verbetert de integratie de gebruikerservaring van het apparaat wanneer ze deelnemen aan Microsoft Teams-vergaderingen die in uw organisatie worden georganiseerd:

  • Webex-vergaderervaring: meerdere schermen met flexibele indelingsopties

  • Deelnemerslijst met deelnemers aan zowel Microsoft- als video-integratie

  • Bidirectionele uitwisseling van inhoud tussen het apparaat en Microsoft Teams

  • Statusindicatoren van de vergadering op het apparaat, waaronder opname, transcriptie en wachtende deelnemers in de lobby

Wanneer u de video-integratie met de Webex Hybrid Calendar Service implementeert, krijgen uw videoapparaten ook de vereenvoudigde One Button to Push (OBTP) -ervaring om deel te nemen aan vergaderingen.

Overzicht van de architectuur

Het Microsoft Cloud Video Interop (CVI) -programma stelt partners zoals Cisco in staat diensten te leveren die videoapparaten koppelen aan Microsoft Teams-vergaderingen.

CVI Architecture image based on https://docs.microsoft.com/en-us/microsoftteams/cloud-video-interop
Architectuur van de oplossing

Webex Video Integration voor Microsoft Teams is een door Microsoft gekwalificeerde Cloud Video Interop-oplossing van derden, gebouwd op het Webex-cloudplatform. De CVI-partnermogelijkheden in de Webex-cloud zijn overal beschikbaar waar bellers zakelijk naar zakelijk kunnen bellen naar het openbare internet. De gebruikelijke Webex-services bieden beheer, oproepinfrastructuur, interactieve spraakresponssystemen en lobby's. Webex-mediaclusters over de hele wereld bieden transcodering, protocolvertalingen en de Teams Bot-rollen.

Met deze architectuur voeren videoapparaten gesprekken naar specifieke SIP-URI's die worden gehost door Webex. De Webex-services beantwoorden de oproepen en wijzen ze toe aan geografisch relevante mediaclusters die draaien in Microsoft Azure. De IVR verzamelt zo nodig vergadergegevens en de Media CVI-bot van Microsoft Teams in het Webex-mediacluster maakt de verbinding met de vergaderinfrastructuur van Microsoft Teams. De mediaclusters zorgen voor de back-to-back connectiviteit tussen de deelnemer die via Webex is verbonden en de rest van de conferentie die wordt georganiseerd op Microsoft Teams. De hele oplossing werkt als een cloudservice.

Dankzij de video-integratie kunnen apparaten als volgt deelnemen aan Teams-vergaderingen:

  • Als de vergadering is ingeschakeld voor CVI, kan het apparaat deelnemen met behulp van de video-ID en de tenantsleutel.

  • Als de vergadering niet is ingeschakeld voor CVI, kan het apparaat als gast deelnemen (deelname aan meerdere huurders) met behulp van de vergaderings-ID en toegangscode.

U kunt de gebruikerservaring verbeteren door andere Webex-services toe te voegen. De Hybrid Calendar Service stuurt bijvoorbeeld automatisch vergaderingsgegevens en vereenvoudigde deelknoppen naar de videoapparaten wanneer het tijd is om deel te nemen aan de vergadering.

Gegevensverwerking

De video-integratie gebruikt de volgende gegevens om apparaten te verbinden met Microsoft Teams-vergaderingen en om functies voor vergaderingen tijdens vergaderingen te bieden:

  • Registratie van Enterprise-apps: Tijdens de inrichting gebruikt een beheerder de Webex Video Integration-applicatie om machtigingen te verlenen voor toegang tot de Microsoft-tenant van de organisatie wanneer hij de Microsoft Graph API gebruikt. Zie Webex Video Integration in het Microsoft Entra-beheercentrum voor meer informatie.

  • Een door WebEx geleverde „tenantsleutel”: dit is een waarde per klant die wordt gebruikt in SIP-adressen wanneer het apparaat de VIMT-service aanroept.

  • Vergader-ID: Microsoft Teams kent deze ID toe bij het aanmaken van de vergadering en neemt deze op in de uitnodiging voor de vergadering.

    Gebruikers hebben de Meeting ID nodig om deel te nemen aan vergaderingen van Teams-klanten, of via Direct Guest Join, of via Cross-Tenant via de VIMT-service.

    De video-integratie gebruikt deze ID om de doelvergadering van Microsoft Teams te specificeren tijdens de deelname aan de Cross-Tenant.

  • Toegangscode voor de vergadering: Microsoft Teams kent een hoofdlettergevoelige toegangscode toe bij het aanmaken van de vergadering en neemt deze op in de uitnodiging voor de vergadering. Gebruikers hebben de toegangscode nodig om deel te nemen aan een vergadering met de Meeting ID.

    De video-integratie gebruikt deze toegangscode om toegang te krijgen tot de doelvergadering van Microsoft Teams tijdens de deelname aan de Cross-Tenant.

  • Video-ID: Microsoft Teams wijst deze ID toe aan een vergadering wanneer deze wordt aangemaakt door een gebruiker die geschikt is voor CVI. Microsoft Teams neemt de video-ID op in de uitnodiging voor de vergadering.

    De video-integratie maakt gebruik van de video-ID en de Microsoft tenant-ID van de klant om de URL voor de vergadering op te halen via de Microsoft Graph API.

    (Microsoft heeft het label bijgewerkt naar „Video-ID” in plaats van „VTC-conferentie-ID”.)

  • Microsoft tenant-ID van de klant: wordt gebruikt om de doelorganisatie van Microsoft te identificeren bij communicatie met de Microsoft Graph API. Wordt ook gebruikt in de beheerinterface van de service om de ingerichte Microsoft-tenant te identificeren.

  • Door een Microsoft tenant geverifieerde domeinnamen: worden gebruikt als labels in de beheerinterface van de service om de ingerichte Microsoft-tenant te identificeren.

  • Vergaderinformatie: Wanneer een deelnemer via de video-integratie een verzoek indient om deel te nemen aan een Microsoft Teams-vergadering, haalt de service gegevens voor die vergadering op, waaronder het onderwerp van de vergadering, de organisator, de datum/tijd en verbindingsgegevens. Eenmaal verbonden, haalt de service realtime informatie op, zoals de labels van deelnemers, de mogelijkheden en de status van de deelnemers die verbonden zijn met de Teams-vergadering via de Microsoft Graph API en gebruikt deze om de live vergadering mogelijk te maken.

    Wanneer u de Hybrid Calendar Service inschakelt voor een mailbox, gebruikt de agendaservice de link Meer info, die zich bevindt in de hoofdtekst van agenda-items die deze bevatten, om de „tenantsleutel” van de vergadering en de video-ID te identificeren.

  • Media en inhoud in realtime: Wanneer een deelnemer via de video-integratie deelneemt aan een Microsoft Teams-vergadering, wisselen Webex en Microsoft Teams gecodeerde audio, video en content met een hoge framesnelheid uit om de audio- en video-ervaring in twee richtingen mogelijk te maken.

Als u de video-integratie met de Hybrid Calendar Service implementeert, zie dan ook de Webex Hybrid Calendar Service met Microsoft 365 Integration Reference.

Authenticatie en autorisatie

Webex communiceert met uw Microsoft Teams-omgeving via de Microsoft Graph API. De Microsoft Identity Provider (IdP) in de cloud verzorgt de authenticatie voor de Microsoft Graph API. Aanvragen aan de Microsoft Graph API worden geautoriseerd op vertoon van tokens aan toonder die zijn uitgegeven door de Microsoft IdP. Alle communicatie met de Microsoft IdP en Graph API maakt gebruik van TLS-beveiligde webverbindingen.

Om te communiceren met Microsoft Teams media as a service, registreert u de Webex-video-integratie als een mediabot die wordt gehost in een Microsoft 365-tenant die wordt beheerd door Cisco. Teams-bots hebben voorafgaande toestemming nodig om te kunnen communiceren met de Microsoft 365-tenant van een organisatie.

Tijdens de eerste configuratie vraagt de service om autorisatie voor een vooraf gedefinieerde set machtigingen. Een beheerder verleent deze toepassingsrechten door de hieronder beschreven toestemmingsprocedure te volgen.

Na goedkeuring kan de Webex-service tokendragers, met de juiste machtigingen en klantenbereik, aanvragen bij de Microsoft OAuth v2.0 IdP. De service gebruikt de tokens aan de drager om aanvragen aan de Microsoft Graph API te autoriseren voor het verstrekken van gegevens, gezondheidscontroles en de werking van de Teams-bot.

Autorisatie en toestemming van de Microsoft-beheerder

Organisatiebeheerders met de volledige beheerdersrol kunnen Control Hub gebruiken om de video-integratieservice voor hun organisatie op te zetten.

Het inrichtingsproces vereist authenticatie en toestemming van een wereldwijde beheerder van de Microsoft 365-tenant waartoe uw gebruikers behoren. De toepassingsrechten die nodig zijn om de Teams-bot te gebruiken, kunnen alleen worden verleend door een wereldwijde beheerder van de Microsoft-tenant met behulp van de volgende toestemmingsstroom van de beheerder.

De flow omvat de volgende stappen op hoog niveau:

  1. Meld u aan bij Control Hub en zoek en start de installatie van de video-integratie.

    voor gedetailleerde installatiestappen, zie Webex video-integratie implementeren voor Microsoft Teams).

    Tijdens het installatieproces wordt uw browser doorverwezen naar de Microsoft cloud voor authenticatie en toestemming.

  2. Meld u aan als wereldwijde beheerder voor de Microsoft tenant.

    De aanvraag vraagt om uw toestemming om:

    • Meld u aan en lees uw profiel
    • De RBAC-instellingen van het adresboek lezen

    Dit is zodat de applicatie kan verifiëren dat uw account binnen uw huurder gemachtigd is om de nodige machtigingen te verlenen.

  3. Controleer de aangevraagde machtigingen en klik op Accepteren. U hoeft de toestemming niet namens uw organisatie te controleren, want dat is niet vereist.

    De applicatie meldt u aan en controleert uw toestemmingen.

    Nadat u met succes bent geautoriseerd, wordt u opnieuw gevraagd in de aanvraag. Deze keer ziet u in de prompt de machtigingen die de toepassing nodig heeft om videoapparaten met succes te verbinden met uw Microsoft Teams-vergaderingen.

    De prompt toont de naam van de toepassing, het domein van de leverancier en de gevraagde machtigingen.

  4. Klik op Accepteren om deze machtigingen te verlenen aan de Webex Video Integration-applicatie.

    U wordt teruggeleid naar de Control Hub, waar u PowerShell-opdrachten op maat kunt zien die u nodig hebt om de Microsoft Teams-configuratie te voltooien.

  5. Gebruik PowerShell om de Microsoft Teams-configuratie te voltooien en sluit vervolgens het Control Hub-paneel.

    Tijdens het installatieproces wordt een Microsoft Graph API-aanroep voor de organisatie getest. Als dat lukt, is de installatie voltooid. Zo niet, dan kan de beheerder het autorisatieproces opnieuw proberen.

Toestemmingen verleend

Voor Webex-video-integratie voor Microsoft Teams zijn expliciete machtigingen vereist in uw Microsoft-tenant. Deze machtigingen kunnen niet worden aangepast en worden automatisch geconfigureerd tijdens het installatieproces in Control Hub.

Er worden twee verschillende soorten machtigingen gebruikt:

  • Een set machtigingen met toestemming van de gebruiker die tijdens de installatie werd gebruikt om de informatie van de doelhuurder te verifiëren

  • Een reeks machtigingen die met toestemming van de beheerder zijn verleend aan de Enterprise-applicatie in uw Entra-adresboek. Met deze set heeft de service toegang tot uw Microsoft Teams-omgeving

Machtigingen met toestemming van de gebruiker

Tijdens de installatie van de service vragen we de volgende machtigingen van de aangemelde gebruiker. Ze bieden toegang tot de Microsoft-tenant om informatie over de doeltenant te verifiëren. We gebruiken deze machtigingen alleen wanneer u de integratie instelt; ze worden niet opgeslagen.

U kunt deze door de gebruiker goedgekeurde machtigingen bekijken op de pagina Machtigingen van de toepassing in uw Entra-adresboek.

Tabel 1. Machtigingen met toestemming van de gebruiker en waarom ze nodig zijn voor het installatieproces
Toestemming vereistDoel
„Aanmelden en gebruikersprofiel lezen” (User.read)Wordt gebruikt om het ingelogde gebruikersprofiel te lezen om de huurder van de gebruiker te identificeren.
„De RBAC-instellingen van het adresboek lezen” (RoleManagement.read.Directory)Wordt gebruikt om te controleren of de aangemelde gebruiker lid is van de bekende beveiligingsgroepen voor beheerders in Entra ID.
„Behoud toegang tot gegevens waartoe u ze toegang hebt gegeven” (offline_access)Hiermee kan de dienst de gegevens zien waartoe u toegang hebt gegeven zonder dat gebruikers zich hoeven aan te melden.

Machtigingen voor diensten

De toestemmingsstroom van Microsoft Admin verleent de volgende machtigingen voor de "Cisco WebexVideo-integratie voor MS Teams Enterprise Application” in uw tenant. Met deze machtigingen heeft de Webex-service toegang tot uw Teams-omgeving.

De machtigingen blijven bestaan voor de toepassing in uw Entra-directory totdat u de Webex-service verwijdert, waarbij ook de toepassing wordt verwijderd.

Tabel 2. De beheerder heeft machtigingen verleend en waarom de Webex-service ze nodig heeft

Toestemming

Gebruik

Domeinen lezen (Domain.Read.All)

Hiermee kan de service de geverifieerde domeinnamen van de huurder lezen. Control Hub gebruikt de domeinnamen om de tenant te identificeren waaraan de service is gekoppeld.

Uitgaande 1-op-1-gesprekken starten via de app (Calls.Initiate.All)

Maakt het mogelijk om door de bot gesprekken aan te maken naar gebruikers van Microsoft Teams. (Gereserveerd voor toekomstig gebruik.)

Uitgaande groepsoproepen starten vanuit de app (Calls.InitiateGroupCall.all)

Maakt het mogelijk om door de bot gesprekken aan te maken naar een groep gebruikers van Microsoft Teams. (Gereserveerd voor toekomstig gebruik.)

Neem deel aan groepsgesprekken en vergaderingen als een app (Calls.JoinGroupCall.all)

Hiermee kan de bot deelnemen aan groepsgesprekken en geplande vergaderingen in uw organisatie met de rechten van een telefoonboekgebruiker. Wordt gebruikt om u aan te sluiten bij deelnemers die gemachtigd zijn om de Microsoft Teams-lobby te omzeilen.

Als gast deelnemen aan groepsgesprekken en vergaderingen (Calls.JoinGroupCallasGuest.all)

Hiermee kan de bot als gast deelnemen aan groepsgesprekken en geplande vergaderingen in uw organisatie. Wordt gebruikt om deel te nemen aan deelnemers die niet bevoegd zijn om de Microsoft Teams-lobby te omzeilen.

Mediastreams openen in een gesprek als app (Calls.AccessMedia.ALL)

Geeft de bot tijdens een gesprek rechtstreeks toegang tot mediastreams, zonder een ingelogde gebruiker.

Lees de gegevens van de online vergadering (OnlineMeetings.read.all)

Stelt de dienst in staat om de gegevens van online vergaderingen in uw organisatie te lezen. Wordt gebruikt om VTC-conferentie-ID's op te zoeken en op te lossen voor Microsoft Teams-vergaderingen.

Meld u aan en lees het gebruikersprofiel (User.read)

Vereist voor de andere vermelde machtigingen. De integratie maakt er niet rechtstreeks gebruik van.

Referentie voor machtigingen voor Microsoft Graph: https://docs.microsoft.com/en-us/graph/permissions-reference

Overzicht van Microsoft Meeting Bots: https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview

Toegang tot vergaderingen

Deelnemers die via de video-integratie verbinding maken, worden normaal gesproken behandeld als gastgebruikers voor Microsoft Teams-vergaderingen en kunnen in een lobby (wachtkamer) worden geplaatst. Een gebruiker van Microsoft Teams moet een deelnemer die zich in de lobby bevindt handmatig toelaten voordat de deelnemer andere deelnemers kan horen of zien.

U kunt het lobbygedrag van Microsoft Teams controleren via het vergaderbeleid dat is ingesteld door een beheerder in Microsoft Teams en via de vergaderopties die zijn ingesteld door de organisator van de vergadering. Gastgebruikers van Microsoft Teams moeten standaard de lobby gebruiken. Voor meer informatie over het vergaderingsbeleid van Teams, zie Vergaderbeleid beheren in Teams.

Als anonieme gebruikers kunnen deelnemen aan een vergadering is uitgeschakeld, kunnen alleen vertrouwde deelnemers aan wie de lobby mag worden omzeild, deelnemen aan de vergadering met behulp van de Webex-video-integratie.

Deelnemers die gebruikmaken van cross-tenant join (inclusief het gebruik van Meeting ID en toegangscode) nemen altijd deel als gasten. Deze pogingen om deel te nemen mislukken als de organisatie die de vergadering organiseert, heeft uitgeschakeld dat anonieme gebruikers kunnen deelnemen aan een vergadering.

Lobbybypass voor betrouwbare deelnemers

Deelnemers die op de volgende manieren verbinding maken met de video-integratie, worden behandeld als betrouwbare deelnemers en nemen deel aan Microsoft Teams-vergaderingen zonder dat ze in een lobby worden geplaatst:

  • Apparaten die bij uw Webex-organisatie zijn geregistreerd als Webex-geregistreerde apparaten

  • Bellen vanuit SIP-domeinen die zijn toegevoegd en waarvan is geverifieerd dat ze eigendom zijn van uw organisatie in Control Hub

Vertrouwde deelnemers worden binnen uw organisatie behandeld als deelnemers. Deelnemers die via deze vertrouwde paden verbinding maken, kunnen de lobby omzeilen als de organisator de lobbyinstellingen van de Teams-vergadering heeft beperkt. Als de Wie kan de lobby omzeilen? De vergaderoptie is ingesteld op 'Organisatoren en ik' of 'Mensen die ik uitnodig', vertrouwde deelnemers die proberen deel te nemen, worden genegeerd en alle VIMT-bellers worden in de vergaderlobby van Teams geplaatst wanneer ze deelnemen aan een vergadering.

Deelnemers die gebruikmaken van cross-tenant join (inclusief het gebruik van Meeting ID en toegangscode) nemen altijd deel als gasten. Dit betekent dat zelfs betrouwbare deelnemers die op deze manier deelnemen, in de lobby moeten wachten tot ze door de gastheer worden toegelaten.

Voor meer informatie over het toevoegen en verifiëren van SIP-domeinen, zie Domeinverificatieproces voor SIP-videoapparaten.

Webex-video-integratie in het Microsoft Entra-beheercentrum

De toepassing hoeft niet te worden onderhouden nadat u de video-integratieservice hebt geautoriseerd voor toegang tot uw Microsoft 365-tenant. U kunt de aanwezigheid en reikwijdte ervan verifiëren in de lijst met Enterprise-toepassingen in het Microsoft Entra-beheercentrum.

Als onderdeel van deze integratie draait er geen fysieke applicatie of software in uw tenant. De vermelding van de bedrijfstoepassing dient als definitie en tijdelijke aanduiding voor de autorisatie die wordt verleend aan de identiteit van de Webex-toepassing.

Klik op de naam van de toepassing en vervolgens op Machtigingen om te zien welke machtigingen de toepassing heeft in de tenant.

Vond u dit artikel nuttig?
Vond u dit artikel nuttig?