Permissões de autorização do agendador Webex para administradores de locatários

Quando você adiciona uma autorização do Webex a um locatário da Microsoft, solicitamos as seguintes permissões:

Microsoft tenant authorization permissions

A tabela a seguir descreve cada permissão e por que ela é necessária.

Nome da permissão

Valor de reivindicação

Tipo de permissão

A quais informações isso dá acesso ao Webex?

Como essa permissão é usada para o Webex Meetings?

Leitura e gravação de calendários em todas as caixas de correio.

Calendários.ReadWrite

Aplicativo

Complemento do Microsoft 365 para agendar uma reunião, agendamento/lista de aplicativos Webex, integração do Microsoft Teams e agendamento de serviços de calendário (@webex).

  • Acesso de leitura e gravação para criar, atualizar e excluir calendários associados ao Webex Meetings.

  • Permite o agendamento do Microsoft Teams e adicionar, atualizar e remover entradas de calendário correspondentes.

Leia os dados do diretório.

Diretório.Ler.Todos

Aplicativo

Necessário para o recurso do People Insights e integração do Microsoft Teams.

  • Permite que o People Insights preencha os perfis dos participantes da reunião no Webex Meetings e nos perfis de People Insights dos usuários no Webex no diretório.

  • Permite que a integração do Microsoft Teams preencha a aparência dos e-mails dos convidados ao agendar uma reunião Webex.

Início de sessão e leitura do perfil do usuário.

openid

Delegado

Permissão incluída automaticamente necessária para que a integração do Webex Meetings funcione corretamente.

  • Permite que o Webex identifique usuários ao longo do tempo e acesse informações básicas.

Visualizar o perfil básico dos usuários

perfil

Delegado

Permissão incluída automaticamente necessária para que a integração do Webex Meetings funcione corretamente.

  • Significa que o usuário não precisa iniciar sessão na conta da Microsoft para usar o Agendador Webex.

Leia os perfis completos de todos os usuários.

Usuário.Lido.Todos

Aplicativo

Necessário para o recurso do People Insights e integração do Microsoft Teams.

  • Permite o People Insights para Webex Meetings e usuários Webex.

  • Identifica os usuários e seus endereços de e-mail para que possamos corresponder às contas Webex dos usuários na integração de bot e guia do Cisco Webex Meetings no Microsoft Teams.

Permissões de autorização do agendador Webex para contas individuais do Microsoft 365

Quando você autoriza o Webex para uma conta individual do Microsoft 365, solicitamos as seguintes permissões:

Individual authorization permissions

A tabela a seguir descreve cada permissão e por que ela é necessária.

Permissão

Valor de reivindicação

A quais informações isso dá acesso ao Webex?

Como essa permissão é usada para o Webex Meetings?

Mantenha o acesso aos dados aos quais você concedeu acesso.

offline_access

Permite que o Webex acesse as informações dos usuários na Microsoft sem pedir a mesma permissão sempre que um usuário executa uma ação com a integração do Webex Meetings na Microsoft.

  • Se seu aplicativo não solicitar explicitamente esse escopo, ele não receberá tokens de atualização. Manter o acesso é necessário.

    Por exemplo, o Webex ligará para as APIs da Microsoft para recuperar informações como convites de calendário sempre que um usuário estiver visualizando seu calendário.

Tenha acesso total aos calendários.

Calendários.ReadWrite

Leia eventos nos calendários de usuários.

Leia os eventos do calendário associados ao Webex Meetings, bem como as propriedades do evento, como tempo, convidados, assunto e opções de reunião Webex.

Inicie sessão e leia seu perfil.

User.Read

Permissão incluída automaticamente necessária para que a integração do Webex Meetings funcione corretamente.

  • Permite que o Webex identifique usuários ao longo do tempo e acesse informações básicas.

Visão geral da arquitetura do agendador Webex

O diagrama acima mostra os cenários de autorização individual e de administração do site do Webex Meetings do Microsoft 365.

  1. O administrador do site autoriza o Webex a acessar os dados de locatário do administrador do Microsoft 365 da Administração do site Cisco Webex ou do Control Hub (opcional).

  2. Um indivíduo autoriza a permissão do Webex (se o administrador não autorizar) e conecta a conta da Microsoft à conta Webex.

  3. O Webex se inscreve nas alterações do calendário da Microsoft.

  4. Um usuário adiciona uma reunião Webex a um evento do Microsoft Calendar, atualiza a hora ou o tópico ou copia um evento para outra data e hora.

  5. O serviço de complemento Webex recebe notificações do Microsoft Calendar e sincroniza dados com o Webex.

APIs usadas pelo agendador Webex

A lista abaixo fornece informações sobre o arquivo de origem e a URL de algumas das APIs usadas pelo Agendador Webex.

Operação de gráfico

Uso

POST /{version}/assinaturas

Crie uma assinatura para que um usuário específico ouça e receba notificações de alteração quando o recurso de calendário for alterado no Microsoft Graph.

EXCLUIR /{version}/assinaturas/{subscriptionId}

Exclua uma assinatura quando o usuário finalizar a sessão ou exceder o tempo de expiração.

POST /{tenantId}/oauth2/{version}/token

Obtenha o token de acesso da ID de locatário específica com o certificado de complemento como uma credencial ( no modo de autorização do administrador ).

POST /common/oauth2/{version}/token

Obtenha o token de acesso de um usuário específico com o token de atualização ( no modo de autorização do administrador ).

OBTER /{version}/users/{user}/events/{id}

Obtenha propriedades do evento gráfico por ID do evento.

OBTER /{version}/users/{user}/events/{id}/instâncias

Obtenha ocorrências/exceções por ID de evento com determinado intervalo de tempo.

OBTER /{version}/usuários?$select=e-mail

Obtenha o endereço de e-mail do proxy para um usuário específico.

OBTER /{version}/assinaturas/{subscriptionId}

Obtenha as propriedades da assinatura por ID.

OBTER /{version}/me

Obtenha o endereço de proxy do usuário ( no modo de autorização individual ).

OBTER /{version}/users/{user}/events

Liste eventos de um usuário específico.

PATCH /{version}/inscrições/{subscriptionId}

Renove a assinatura para um usuário específico ampliando o tempo de expiração.

OBTER /{version}/users/{email}

Recupere o Microsoft UPN para manter o mapeamento de usuários no Webex.

OBTER /{version}/organização

Para identificar se o endereço de e-mail do usuário atual do cliente pertence à organização autorizada.