Neste artigo
Benefícios do calendário híbrido
Tratamento de dados
Suporte para locatários do Microsoft 365
dropdown icon
Autenticação e autorização durante a implantação
    Processo de autenticação de aplicativos corporativos
    Processo de autenticação do aplicativo do usuário
Calendário híbrido no portal do Microsoft Azure
Limitar o escopo do aplicativo a caixas de correio específicas
Provisionando o calendário híbrido com operações de API

Referência do serviço de calendário híbrido com o Microsoft 365

list-menuNeste artigo
list-menuComentários?

Você não precisa perder as reuniões porque elas foram agendadas em um aplicativo diferente. Você pode usar o calendário híbrido para fornecer uma rica experiência de colaboração para usuários e salas entre Webex Meetings e o aplicativo Webex com o Microsoft 365.

Benefícios do calendário híbrido

Atualmente, a integração oferece os seguintes recursos principais:

  1. Ofereça aos usuários finais a capacidade de agendar uma reunião de colaboração com qualquer cliente de calendário conectado ao Microsoft 365 sem precisar instalar plug-ins ou extensões. Digite uma palavra-chave no campo Local (por exemplo, @webex ou @meet) ou insira um URI de endereço de vídeo ou endereço de reunião no corpo da reunião.

  2. Mostre uma lista de reuniões nos aplicativos Webex App dos usuários — desktop, dispositivos móveis e terminais rígidos.

  3. Mostre uma notificação com um botão Join, também conhecido como One Button to Push (OBTP).

  4. Atualize o status de presença do aplicativo Webex de um usuário quando o usuário configura respostas automáticas no Microsoft 365 (às vezes chamado de status de ausência temporária).

Este artigo fornece uma visão geral de como o serviço de calendário híbrido baseado em nuvem integra a nuvem Microsoft 365 com a nuvem Webex para fornecer esses recursos.

Para obter visões gerais semelhantes das outras integrações do Hybrid Calendar Service, consulte os seguintes artigos:

Para obter as informações mais recentes sobre recursos e implantação, consulte https:/​/​www.cisco.com/​go/​hybrid-services-calendar.

Tratamento de dados

O calendário híbrido recebe detalhes da reunião do sistema de calendário e os usa da seguinte forma:

  • verifica o local e o corpo da reunião em busca de URIs e URLs para entrar na reunião
  • o título do convite como título da reunião
  • os horários de início e término para mostrar o horário da reunião na lista de reuniões no aplicativo Webex e em alguns dispositivos
  • os convidados para preencher a lista de participantes na lista de reuniões
  • os convidados devem enviar-lhes o botão Participar, quando chegar a hora de participar
  • o corpo do convite da reunião para preencher a agenda da reunião Webex

O serviço envia dados criptografados para a nuvem Webex (e armazena os dados em formato criptografado) para fornecer a lista de reuniões e o botão Entrar.

O serviço não armazena nem transmite dados não criptografados. Dados confidenciais, como descrição da reunião, corpo da reunião e endereços de e-mail dos convidados, são sempre criptografados quando armazenados e transmitidos.

O serviço de calendário híbrido retém os dados da reunião por um tempo limitado. Os dados armazenados abrangem reuniões de 7 dias no passado a 31 dias no futuro.

Para criptografia de dados, o calendário híbrido usa o mesmo serviço de criptografia em nuvem Webex que o aplicativo Webex usa. Dessa forma, o servidor de gerenciamento de chaves (KMS) na nuvem fornece gerenciamento de chaves. Se você optar por implantar o Hybrid Data Security, seu próprio KMS local fornecerá o gerenciamento de chaves. (Para obter mais detalhes, consulte o documento Webex App Security.)

Suporte para locatários do Microsoft 365

Observe as seguintes considerações para seu locatário do Microsoft 365:

  • A versão comercial do Webex suporta apenas a instância mundial do Microsoft 365. (O Webex não suporta instâncias USGovdod, USGovgCCHigh, China e Alemanha.)
  • O Webex for Government oferece suporte à instância mundial do Microsoft 365 por meio de um locatário no GCC e na instância USGovGCChigh. (O Webex for Government não oferece suporte às instâncias do governo dos EUA, China e Alemanha.)

  • O Microsoft 365 inclui recursos multigeográficos que permitem que seus inquilinos armazenem dados em uma geografia escolhida. Porém, o Webex armazena dados de acordo com suas próprias especificações de residência de dados, com base no país designado para a organização do cliente. Para obter mais informações, consulte https://www.cisco.com/go/webex-teams-locality.

Autenticação e autorização durante a implantação

O calendário híbrido usa a autorização do Microsoft Graph para acessar os calendários dos usuários em uma organização.

Há duas opções para fornecer autorização para que o Calendário Híbrido acesse o calendário de um usuário.

Em ambientes corporativos, o administrador global do locatário do Microsoft 365 concede as permissões ao calendário híbrido para todos os usuários da organização. Esse método é exclusivo para clientes corporativos.

A segunda opção é permitir que os próprios usuários autorizem o calendário híbrido usando o Connect your Microsoft 365 calendar. “Conectar seu calendário” exige uma reautorização periódica do usuário. Esse método está disponível para todos os tipos de usuários.

Processo de autenticação de aplicativos corporativos

O provisionamento concede ao calendário híbrido as seguintes permissões necessárias:

Permissão

Uso

Leia e escreva calendários em todas as caixas de correio.

  • Atualize o texto da reunião com os detalhes da participação.

Faça login e leia o perfil do usuário.

  • Obrigatório para as outras permissões listadas. O calendário híbrido não o usa diretamente.

Leia e grave todas as configurações da caixa de correio do usuário.

  • Determine o idioma do usuário para fins de localização.

  • Leia o status de ausência temporária.

  • Defina o status de ausência temporária (reservado para uso futuro).

Leia domínios.

  • Usado para direcionar usuários com eficiência para o locatário adequado do Microsoft 365

Leia as configurações RBAC do diretório

Para determinar se esse usuário é um administrador global no inquilino solicitado

No Control Hub, somente administradores com acesso privilegiado podem configurar o calendário híbrido para a organização de um cliente. O processo de provisionamento exige autenticação de um administrador e consentimento de um administrador global para o locatário do Microsoft 365 ao qual seus usuários pertencem.

O fluxo inclui as seguintes etapas de alto nível:

  1. O administrador da organização entra no Control Hub e inicia o calendário híbrido com a configuração do Microsoft 365.

    O calendário híbrido redireciona o navegador para a nuvem Microsoft 365 para autenticação e consentimento.

  2. O Microsoft 365 solicita que o administrador entre no locatário do Microsoft 365. O administrador faz login com a conta de administrador global.

    O administrador deve consentir que o Webex verifique se ele é um administrador global neste inquilino.

    O Webex faz essa verificação com o Microsoft 365. Se for bem-sucedido, o Webex solicita permissões de calendário .

  3. O Microsoft 365 solicita que o administrador entre no locatário do Microsoft 365. O administrador faz login com a conta de administrador global.

    O administrador deve consentir que o Webex acesse os dados do calendário. O serviço de calendário retorna uma solicitação para uma conta de e-mail de teste.

  4. O administrador insere um endereço de e-mail de teste e o Webex tenta criar um evento no calendário da conta de teste.

    Dependendo dos resultados do teste, o administrador recebe uma indicação atualizada de sucesso ou falha.

Diagrama de sequência do processo de provisionamento corporativo

Processo de autenticação do aplicativo do usuário

O provisionamento de usuários concede ao calendário híbrido as seguintes permissões necessárias:

Permissão

Uso

Leia e escreva calendários.

  • Atualize o texto da reunião com os detalhes da participação.

Acesso off-line.

  • Concede ao Webex um token de atualização que limita as solicitações de reautorização do usuário final a cada 30 dias.

Leia e grave todas as configurações da caixa de correio do usuário.

  • Determine o idioma do usuário para fins de localização.

  • Leia o status de ausência temporária.

  • Defina o status de ausência temporária (reservado para uso futuro).

Faça login e leia o perfil do usuário.

  • Obrigatório para as outras permissões listadas. O calendário híbrido não o usa diretamente.

Calendário híbrido no portal do Microsoft Azure

Depois de autorizar o serviço Webex Calendar a acessar seu locatário do Microsoft 365 para a empresa, o centro de Active Directory administração do Microsoft Azure exibe o serviço na lista de aplicativos corporativos.

Clique no nome do serviço, Cisco Webex ConnectSeu calendário, e abra a página Permissões para ver as permissões que você concedeu ao serviço.

Limitar o escopo do aplicativo a caixas de correio específicas

Quando você configura o calendário híbrido para a empresa, solicitamos autorização para toda a organização. O Microsoft Azure permite que você limite o escopo a caixas de correio específicas antes ou depois do provisionamento.

Use a documentação da Microsoft para limitar o escopo. Por exemplo, consulte https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access para ver as etapas para limitar o escopo antes de provisionar o calendário híbrido.

Provisionando o calendário híbrido com operações de API

O calendário híbrido usa a API do Microsoft Graph para acessar os eventos do calendário do Microsoft 365. Essa API oferece suporte a uma ampla variedade de operações com o Microsoft 365. No entanto, o calendário híbrido usa apenas um subconjunto de comandos relacionados aos casos de uso do calendário.

Tabela 1. Operações usadas atualmente pelo calendário híbrido

Operação gráfica

Uso

POST /users/ {id | userPrincipalName} /calendário/eventos

Adicione um evento ou reunião ao calendário de um usuário.

GET /users/ {id | userPrincipalName} /events/ {id}

Recupere detalhes sobre um único evento no calendário de um usuário.

GET /users/ {id | userPrincipalName} /calendar/events/ {id} /instances? StartDateTime= {start_datetime} &endDateTime= {end_datetime}

Obtenha as ocorrências de uma reunião recorrente em um intervalo de tempo especificado.

GET /users/ {id | userPrincipalName} /calendar/eventos

Recupere detalhes sobre eventos na pasta de calendário de um usuário.

POST /assinaturas

Inscreva-se para receber notificações sobre alterações no calendário de um usuário.

GET /users/ {id|userPrincipalName} /MailboxSettings

Obtenha a localização e o status de ausência do escritório de um usuário.

EXCLUIR /subscriptions/ {id}

Cancele a assinatura de notificações sobre alterações no calendário de um usuário.

PATCH /users/ {id | userPrincipalName} /calendário/events/ {id}

Atualize as propriedades dos eventos do calendário (incluindo informações de união e propriedades estendidas), além de outros campos relacionados à reunião.

POST /users/ {id|userPrincipalName} /calendar/getSchedule

Exibe a disponibilidade do usuário e o status livre/ocupado em um intervalo de tempo especificado.

EXCLUIR /users/ {id | userPrincipalName} /calendar/events/ {id}

Exclui um evento de um calendário.

POST /users/ {id | userPrincipalName} /calendar/events/ {id}/{accept | recusar | TentativelyAccept}

Permite que o usuário aceite/recuse/aceite provisoriamente o status de uma reunião.

GET /Gerenciamento de funções/diretório/atribuições de função

Recupere as funções atribuídas ao usuário que solicita o consentimento.

Este artigo foi útil?
Este artigo foi útil?