- Página inicial
- /
- Artigo
Obrigado pelos seus comentários.
Referência de integração de vídeo Webex para Microsoft Teams
Neste artigo
Comentários?Resumo
A integração de vídeo Webex para Microsoft Teams permite que dispositivos de vídeo compatíveis com Cisco e SIP participem de reuniões do Microsoft Teams.
Veja como a integração aprimora a experiência do usuário do dispositivo quando ele participa de reuniões do Microsoft Teams hospedadas em sua organização:
-
Experiência de reunião Webex — várias telas com opções de layout flexíveis
-
Lista de participantes mostrando os participantes da integração de vídeo e da Microsoft
-
Compartilhamento bidirecional de conteúdo entre o dispositivo e o Microsoft Teams
-
Indicadores de status da reunião no dispositivo, incluindo gravação, transcrição e espera do participante no lobby
Quando você implanta a integração de vídeo com o serviço de calendário híbrido Webex, seus dispositivos de vídeo também recebem a experiência simplificada de participação em reuniões com um botão para pressionar (OBTP).
Visão geral da arquitetura
O programa Microsoft Cloud Video Interop (CVI) permite que parceiros como a Cisco forneçam serviços que unem dispositivos de vídeo às reuniões do Microsoft Teams.
O Webex Video Integration for Microsoft Teams é uma solução de interoperabilidade de vídeo em nuvem de terceiros qualificada pela Microsoft, criada na plataforma de nuvem Webex. Os recursos do parceiro CVI na nuvem Webex estão disponíveis em qualquer lugar em que os chamadores possam fazer chamadas entre empresas na Internet pública. Os serviços comuns do Webex fornecem administração, infraestrutura de chamadas, sistemas interativos de resposta de voz e lobbies. Os clusters de mídia Webex localizados em todo o mundo fornecem transcodificação, traduções de protocolos e as funções do Teams Bot.
Com essa arquitetura, os dispositivos de vídeo fazem chamadas para URIs SIP específicos hospedados pelo Webex. Os serviços Webex atendem às chamadas e as atribuem a clusters de mídia geograficamente relevantes em execução no Microsoft Azure. O IVR reúne os detalhes da reunião, se necessário, e o bot Media CVI do Microsoft Teams no cluster de mídia Webex faz a conexão com a infraestrutura de reuniões do Microsoft Teams. Os clusters de mídia fornecem a conectividade consecutiva entre o participante conectado por meio do Webex e o resto da conferência hospedada no Microsoft Teams. Toda a solução funciona como um serviço em nuvem.
A integração de vídeo permite que os dispositivos participem das reuniões do Teams da seguinte forma:
-
Se a reunião estiver habilitada para CVI, o dispositivo poderá entrar usando a ID de vídeo e a chave do inquilino.
-
Se a reunião não estiver habilitada para CVI, o dispositivo poderá entrar como convidado (ingresso entre locatários) usando o ID e a senha da reunião.
Você pode aprimorar a experiência do usuário adicionando outros serviços Webex. Por exemplo, o serviço de calendário híbrido envia automaticamente os detalhes da reunião e os botões de entrada simplificados para os dispositivos de vídeo quando chega a hora de entrar na reunião.
Tratamento de dados
A integração de vídeo usa os seguintes dados para conectar dispositivos às reuniões do Microsoft Teams e fornecer recursos na reunião:
-
Registro do aplicativo corporativo: durante o provisionamento, um administrador usa o aplicativo Webex Video Integration para conceder permissões para acessar o locatário da Microsoft da organização ao usar a API do Microsoft Graph. Para obter mais informações, consulte Integração de vídeo Webex no centro de administração Microsoft Entra.
-
Uma “chave de locatário” provisionada pela Webex: esse é um valor por cliente usado em endereços SIP quando o dispositivo está ligando para o serviço VIMT.
-
ID da reunião: o Microsoft Teams atribui esse identificador ao criar a reunião e o inclui no convite da reunião.
Os usuários precisam do Meeting ID para participar de reuniões de clientes do Teams, ou pelo Direct Guest Join, ou pelo Cross-Tenant Join com o serviço VIMT.
A integração de vídeo usa essa ID para especificar a reunião de destino do Microsoft Teams durante a adesão entre locatários.
-
Senha da reunião: o Microsoft Teams atribui uma senha que diferencia maiúsculas de minúsculas ao criar a reunião e a inclui no convite da reunião. Os usuários precisam da senha para entrar em uma reunião com o ID da reunião.
A integração de vídeo usa essa senha para acessar a reunião de destino do Microsoft Teams durante a adesão entre locatários.
-
ID de vídeo: o Microsoft Teams atribui esse identificador a uma reunião quando ela é criada por um usuário habilitado para CVI. O Microsoft Teams inclui a ID de vídeo no convite da reunião.
A integração de vídeo usa a ID de vídeo e a ID de locatário da Microsoft do cliente para obter o URL de ingresso na reunião a partir da API do Microsoft Graph.
(A Microsoft atualizou o rótulo para “ID de vídeo” de “ID de conferência VTC”.)
-
ID de locatário Microsoft do cliente: usada para identificar a organização Microsoft de destino ao se comunicar com a API do Microsoft Graph. Também usado na interface administrativa do serviço para identificar o locatário provisionado da Microsoft.
-
Nomes de domínio verificados pelo locatário da Microsoft: usados como rótulos na interface administrativa do serviço para identificar o inquilino provisionado pela Microsoft.
-
Informações da reunião: quando um participante solicita a participação em uma reunião do Microsoft Teams por meio da integração de vídeo, o serviço recupera os detalhes dessa reunião, incluindo o assunto da reunião, o organizador, a data/hora e os detalhes da conexão. Uma vez conectado, o serviço recupera informações em tempo real, como rótulos dos participantes, capacidades e o status dos participantes conectados à reunião do Teams a partir da API do Microsoft Graph, e as usa para facilitar a reunião ao vivo.
Quando você ativa o serviço de calendário híbrido para uma caixa de correio, o serviço de calendário usa o link Mais informações, localizado no corpo das entradas do calendário que o incluem, para identificar a “chave do inquilino” e a ID do vídeo da reunião.
-
Mídia e conteúdo em tempo real: quando um participante entra em uma reunião do Microsoft Teams por meio da integração de vídeo, o Webex e o Microsoft Teams trocam conteúdo codificado de áudio, vídeo e alta taxa de quadros para permitir a experiência bidirecional de áudio e vídeo entre eles.
Se você implantar a integração de vídeo com o serviço de calendário híbrido, consulte também o serviço de calendário híbrido Webex com referência de integração do Microsoft 365.
Autenticação e autorização
O Webex interage com seu ambiente do Microsoft Teams usando a API do Microsoft Graph. O provedor de identidade da Microsoft (IdP) baseado em nuvem gerencia a autenticação da API do Microsoft Graph. As solicitações para a API do Microsoft Graph são autorizadas apresentando tokens portadores emitidos pelo Microsoft IdP. Toda comunicação com o Microsoft IdP e a Graph API usa conexões web protegidas por TLS.
Para interagir com a mídia do Microsoft Teams como um serviço, você registra a integração de vídeo Webex como um bot de mídia hospedado em um aplicativo hospedado em um locatário do Microsoft 365 gerenciado pela Cisco. Os bots do Teams precisam de autorização prévia para poderem se comunicar com o locatário do Microsoft 365 de uma organização.
Durante a configuração inicial, o serviço solicita autorização para um conjunto predefinido de permissões. Um administrador concede essas permissões de aplicativos seguindo o fluxo de consentimento descrito abaixo.
Depois de aprovado, o serviço Webex pode solicitar tokens portadores, com as permissões e o escopo do cliente corretos, do Microsoft OAuth v2.0 IdP. O serviço usa os tokens portadores para autorizar solicitações à API do Microsoft Graph para detalhes de provisionamento, verificações de saúde e operação do bot do Teams.
Autorização e consentimento do administrador da Microsoft
Os administradores da organização com a função de administrador completo podem usar o Control Hub para configurar o serviço de integração de vídeo para sua organização.
O processo de provisionamento exige a autenticação e o consentimento de um administrador global do locatário do Microsoft 365 ao qual seus usuários pertencem. As permissões do aplicativo necessárias para operar o bot do Teams só podem ser concedidas por um administrador global do locatário da Microsoft usando o seguinte fluxo de consentimento do administrador.
O fluxo inclui as seguintes etapas de alto nível:
-
Faça login no Control Hub, localize e inicie a configuração da integração de vídeo.
para obter etapas detalhadas de configuração, consulte Implantar a integração de vídeo Webex para Microsoft Teams).
Durante o processo de configuração, seu navegador é redirecionado para a nuvem da Microsoft para autenticação e consentimento.
-
Entre como administrador global do locatário da Microsoft.
O aplicativo solicita sua permissão para:
- Faça login e leia seu perfil
- Leia as configurações RBAC do diretório
Isso é para que o aplicativo possa verificar se sua conta está autorizada pelo seu inquilino a conceder as permissões necessárias.
-
Revise as permissões solicitadas e clique em Aceitar. Você não precisa verificar o consentimento em nome da sua organização, pois isso não é obrigatório.
O aplicativo faz login e verifica suas permissões.
Depois que você for autorizado com sucesso, o aplicativo solicitará novamente. Desta vez, o prompt mostra as permissões de que o aplicativo precisa para conectar com êxito os dispositivos de vídeo às suas reuniões do Microsoft Teams.
O prompt mostra o nome do aplicativo, o domínio do fornecedor e as permissões solicitadas.
-
Clique em Aceitar para conceder essas permissões ao aplicativo Webex Video Integration.
Você é redirecionado de volta ao Control Hub, onde pode ver os comandos personalizados do PowerShell necessários para concluir a configuração do Microsoft Teams.
-
Use o PowerShell para concluir a configuração do Microsoft Teams e, em seguida, feche o painel do Control Hub.
O processo de configuração testa uma chamada de API do Microsoft Graph para a organização. Se for bem-sucedida, a configuração será concluída. Caso contrário, o administrador poderá tentar o processo de autorização novamente.
Permissões concedidas
A integração de vídeo Webex para Microsoft Teams exige permissões explícitas em seu locatário da Microsoft. Essas permissões não são personalizáveis e são configuradas automaticamente pelo processo de configuração no Control Hub.
Há dois conjuntos separados de permissões usados:
-
Um conjunto de permissões consentidas pelo usuário usado durante a configuração para verificar as informações do inquilino de destino
-
Um conjunto de permissões concedidas pelo consentimento do administrador ao aplicativo corporativo em seu diretório Entra. Esse conjunto permite que o serviço acesse seu ambiente Microsoft Teams.
Permissões consentidas pelo usuário
Durante a configuração do serviço, solicitamos as seguintes permissões do usuário conectado. Eles permitem o acesso ao locatário da Microsoft para verificar as informações sobre o locatário alvo. Só usamos essas permissões enquanto você configura a integração; elas não são armazenadas.
Você pode revisar essas permissões consentidas pelo usuário na página Permissões do aplicativo em seu diretório Entra.
| Permissão necessária | Propósito |
|---|---|
| “Faça login e leia o perfil do usuário” (User.read) | Usado para ler o perfil do usuário conectado para identificar o inquilino do usuário. |
| “Ler configurações RBAC do diretório” (RoleManagement.read.directory) | Usado para verificar se o usuário conectado é membro dos conhecidos grupos de segurança do administrador no Entra ID. |
| “Mantenha o acesso aos dados aos quais você concedeu acesso” (offline_access) | Permite que o serviço veja os dados aos quais você deu acesso sem que os usuários estejam conectados. |
Permissões de serviço
O fluxo de consentimento do administrador da Microsoft concede as seguintes permissões ao “aplicativo de integração de Cisco Webex vídeo para MS Teams Enterprise” em seu locatário. Essas permissões permitem que o serviço Webex acesse seu ambiente Teams.
As permissões persistem com o aplicativo em seu diretório Entra até você remover o serviço Webex, que também remove o aplicativo.
|
Permissão |
Uso |
|---|---|
|
Leia domínios (Domain.Read.All) |
Permite que o serviço leia os nomes de domínio verificados do locatário. O Control Hub usa os nomes de domínio para identificar o inquilino ao qual o serviço está vinculado. |
|
Inicie chamadas de saída 1 para 1 a partir do aplicativo (Calls.Initiate.All) |
Permite a criação de chamadas pelo bot para usuários do Microsoft Teams. (Reservado para uso futuro.) |
|
Inicie chamadas de grupo de saída a partir do aplicativo (calls.initiateGroupCall.all) |
Permite a criação de chamadas pelo bot para um grupo de usuários do Microsoft Teams. (Reservado para uso futuro.) |
|
Participe de chamadas e reuniões em grupo como um aplicativo (Calls.joinGroupCall.all) |
Permite que o bot participe de chamadas em grupo e reuniões agendadas em sua organização com os privilégios de um usuário do diretório. Usado para ingressar em participantes autorizados a ignorar o lobby do Microsoft Teams. |
|
Participe de chamadas e reuniões em grupo como convidado (calls.joinGroupCallasGuest.all) |
Permite que o bot participe de chamadas em grupo e reuniões agendadas em sua organização como convidado. Usado para ingressar em participantes que não estão autorizados a ignorar o lobby do Microsoft Teams. |
|
Acesse fluxos de mídia em uma chamada como um aplicativo (calls.accessmedia.all) |
Permite que o bot tenha acesso direto aos fluxos de mídia em uma chamada, sem um usuário conectado. |
|
Leia os detalhes da reunião on-line (OnlineMeetings.read.all) |
Permite que o serviço leia os detalhes da reunião online em sua organização. Usado para pesquisar e resolver IDs de conferência VTC para reuniões do Microsoft Teams. |
|
Faça login e leia o perfil do usuário (User.read) |
Obrigatório para as outras permissões listadas. A integração não o usa diretamente. |
Referência de permissões do Microsoft Graph: https://docs.microsoft.com/en-us/graph/permissions-reference
Visão geral dos Microsoft Meeting Bots: https://docs.microsoft.com/en-us/microsoftteams/platform/bots/calls-and-meetings/calls-meetings-bots-overview
Acesso às reuniões
Os participantes que se conectam por meio da integração de vídeo normalmente são tratados como usuários convidados nas reuniões do Microsoft Teams e podem ser colocados em um saguão (sala de espera). Um usuário do Microsoft Teams deve admitir manualmente um participante que está no lobby antes que o participante possa ouvir ou ver outros participantes.
Você pode controlar o comportamento do lobby do Microsoft Teams por meio de políticas de reunião definidas por um administrador no Microsoft Teams e por meio de opções de reunião definidas pelo organizador da reunião. Por padrão, os usuários convidados do Microsoft Teams devem usar o lobby. Para obter mais informações sobre as políticas de reuniões do Teams, consulte Gerenciar políticas de reuniões no Teams.
Se usuários anônimos puderem entrar em uma reunião estiver desativada, somente participantes confiáveis que têm permissão para ignorar o lobby podem entrar na reunião usando a integração de vídeo Webex.
Os participantes que usam a participação entre locatários (inclui o uso de ID e senha da reunião) sempre ingressam como convidados. Essas tentativas de ingresso falharão se a organização que organiza a reunião tiver desativado. Usuários anônimos podem entrar em uma reunião.
Ignorar o lobby para participantes confiáveis
Os participantes que se conectam à integração de vídeo usando os métodos a seguir são tratados como participantes confiáveis e participam de reuniões do Microsoft Teams sem serem colocados em um lobby:
-
Dispositivos registrados na sua organização Webex como dispositivos registrados no Webex
-
Chamando de domínios SIP que foram adicionados e verificados como pertencentes à sua organização no Control Hub
Participantes confiáveis são tratados como participantes em sua organização. Os participantes que se conectam por esses caminhos confiáveis podem ignorar o lobby se o organizador tiver restringido as configurações do lobby da reunião do Teams. Se o Quem pode contornar o lobby? A opção de reunião está definida como “Organizadores e eu” ou “Pessoas que eu convido”, os participantes confiáveis que tentam participar são ignorados e todos os chamadores do VIMT são colocados no lobby da reunião do Teams ao entrar em uma reunião.
Os participantes que usam a participação entre locatários (inclui o uso de ID e senha da reunião) sempre ingressam como convidados. Isso significa que até mesmo participantes confiáveis que ingressam dessa forma devem esperar no saguão para serem admitidos pelo anfitrião.
Para obter mais informações sobre como adicionar e verificar domínios SIP, consulte Processo de verificação de domínio para dispositivos de vídeo SIP.
Integração de vídeo Webex no centro de administração do Microsoft Entra
Não há necessidade de manutenção para o aplicativo depois que você autorizou o serviço de integração de vídeo a acessar seu locatário do Microsoft 365. Você pode verificar sua presença e escopo na lista de aplicativos corporativos no centro de administração do Microsoft Entra.
Nenhum aplicativo ou software físico é executado em seu locatário como parte dessa integração. A entrada do aplicativo corporativo serve como definição e espaço reservado para a autorização concedida à identidade do aplicativo Webex.
Clique no nome do aplicativo e, em seguida, clique em Permissões para ver as permissões que o aplicativo tem no locatário.
