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 aplicativo empresarial
    Processo de autenticação de aplicativo
Calendário híbrido no portal Do Microsoft Azure
Limite o escopo do aplicativo a caixas de correio específicas
Provisionando o calendário híbrido com operações de API

Referência de integração do Serviço de Calendário Híbrido com o Microsoft 365

list-menuNeste artigo
list-menuComentários?

Você não precisa perder reuniões porque elas foram agendadas em outro aplicativo. Você pode usar o Calendário Híbrido para proporcionar uma experiência de colaboração completa para usuários e salas entre o Webex Meetings e o Webex App com o Microsoft 365.

Benefícios do calendário híbrido

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

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

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

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

  4. Atualize o status de presença do usuário no aplicativo Webex quando ele configurar respostas automáticas no Microsoft 365 (às vezes chamado de status de ausência do escritório).

Este artigo oferece uma visão geral de como o Serviço de Calendário Híbrido baseado em nuvem integra a nuvem do Microsoft 365 com a nuvem do Webex para fornecer esses recursos.

Para obter visões gerais semelhantes das outras integrações do serviço de calendário híbrido, 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 os detalhes das reuniões do sistema de calendário e os utiliza da seguinte forma:

  • Verifica a localização da reunião e o corpo da mensagem em busca de URIs e URLs para participar da reunião.
  • o título do convite como título da reunião
  • Os horários de início e término para exibir 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
  • enviar aos convidados o botão "Participar" quando chegar a hora de participar.
  • o corpo do convite para a reunião para preencher a agenda da reunião do Webex

O serviço envia dados criptografados para a nuvem Webex (e armazena os dados de forma criptografada) para fornecer a lista de reuniões e o botão "Participar".

O serviço não armazena nem transmite dados não criptografados. Dados sensíveis, como descrição da reunião, conteúdo 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 das reuniões por um período limitado. Os dados armazenados abrangem reuniões realizadas desde 7 dias atrás até 31 dias no futuro.

Para criptografia de dados, o Calendário Híbrido utiliza o mesmo serviço de criptografia em nuvem do Webex que o aplicativo Webex. Dessa forma, o servidor de gerenciamento de chaves (KMS) na nuvem fornece o gerenciamento de chaves. Se optar por implementar a Segurança de Dados Híbrida, o seu próprio sistema KMS local fornecerá a gestão de chaves. (Para mais detalhes, consulte o Documento de segurança do aplicativo Webex.)

Suporte para locatários do Microsoft 365

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

  • A versão comercial do Webex suporta apenas a instância global do Microsoft 365. (O Webex não é compatível com instâncias USGovDoD, USGovGCCHigh, China e Alemanha.)
  • O Webex for Government oferece suporte à instância global do Microsoft 365 por meio de um locatário no GCC e da instância USGovGCCHigh. (O Webex para Governo não é compatível com as instâncias do Departamento de Defesa dos EUA, China e Alemanha.)

  • O Microsoft 365 inclui recursos multigeográficos que permitem que seus locatários armazenem dados em uma região geográfica escolhida. No entanto, a 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 serviço de calendário híbrido usa a autorização do Microsoft Graph para acessar calendários de usuários dentro de uma organização.

Existem duas opções para conceder autorização ao Hybrid Calendar para acessar 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 usuários autorizem o Calendário Híbrido por conta própria usando Conecte seu calendário do Microsoft 365. A opção "Conectar seu calendário" requer uma reautorização periódica do usuário. Este método está disponível para todos os tipos de usuários.

Processo de autenticação de aplicativo empresarial

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

Permissão

Uso

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

  • Atualização do texto da reunião com os detalhes de entrada.

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

  • Necessário para as outras permissões listadas. O Calendário Híbrido não o utiliza diretamente.

Leitura e gravação de 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 fora do escritório.

  • Definir status de ausência do escritório (reservado para uso futuro).

Leitura de domínios.

  • Utilizado para direcionar usuários de forma eficiente para o locatário correto do Microsoft 365.

Configurações RBAC de leitura de diretório

Para determinar se este usuário é um Administrador Global no locatário solicitado.

No Cisco Webex Control Hub, apenas os administradores com acesso privilegiado podem configurar o serviço de calendário híbrido na organização de um cliente. O processo de provisionamento requer autenticação por 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 a configuração do Calendário Híbrido com o Microsoft 365.

    O Calendário Híbrido redireciona o navegador para a nuvem do Microsoft 365 para autenticação e consentimento.

  2. O Microsoft 365 solicita que o administrador faça login no locatário do Microsoft 365. O administrador inicia sessão com a conta de administrador global.

    O administrador deve autorizar o Webex a verificar se ele é um Administrador Global neste locatário.

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

  3. O Microsoft 365 solicita que o administrador faça login no locatário do Microsoft 365. O administrador inicia sessão com a conta de administrador global.

    O administrador deve autorizar o Webex a acessar 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 obtém uma indicação atualizada de sucesso ou falha.

Diagrama de sequência do processo de provisionamento empresarial

Processo de autenticação de aplicativo

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

Permissão

Uso

Leitura e gravação de calendários.

  • Atualização do texto da reunião com os detalhes de entrada.

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.

Leitura e gravação de 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 fora do escritório.

  • Definir status de ausência do escritório (reservado para uso futuro).

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

  • Necessário para as outras permissões listadas. O Calendário Híbrido não o utiliza diretamente.

Calendário híbrido no portal Do Microsoft Azure

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

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

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

Quando você configurar 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 para caixas de correio específicas antes ou após o provisionamento.

Use a documentação da Microsoft para limitar o escopo. Por exemplo, consulte para ver https://learn.microsoft.com/en-us/graph/auth-limit-mailbox-access 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 eventos do calendário do Microsoft 365. Esta API oferece suporte a uma ampla gama de operações com o Microsoft 365. No entanto, o calendário híbrido usa apenas um subconjunto de comandos relacionados a casos de uso de calendário.

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

Operação de gráfico

Uso

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

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

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

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

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

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

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

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

POST /subscriptions

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

PEGAR /users/{id|userPrincipalName}/mailboxSettings

Obtenha o status de ausência temporária e localidade de um usuário.

DELETE /subscriptions/{id}

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

CORREÇÃO /users/{id | userPrincipalName}/calendar/events/{id}

Atualize as propriedades de eventos de calendário (incluindo informações de entrar e propriedades estendidas) além de outros campos pertencentes à reunião.

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

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

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

Exclui um evento de um calendário.

PUBLICAR /users/{id | userPrincipalName}/calendar/events/{id}/{accept | recusar | aceitar provisoriamente}

Permite que o usuário aceite/re recusar/aceite tentativamente o status para uma reunião.

PEGAR /roleManagement/directory/roleAssignments

Recuperar funções atribuídas ao usuário que solicitou o consentimento.

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