Neste artigo
Resumo
Autenticação e autorização
Uso de dados e armazenamento
Suporte ao locatário do Office 365
Casos de uso
Uso da API da Microsoft

Aplicativo Webex | Referência de integração do Microsoft OneDrive e SharePoint Online

list-menuNeste artigo
list-menuComentários?

Resumo

A integração do Webex App com o Microsoft OneDrive e o SharePoint Online permite que os usuários compartilhem e acessem conteúdo armazenado no Microsoft OneDrive e no SharePoint Online diretamente do Webex App.

Um administrador pode optar por provisionar (configurar, habilitar e autorizar) a integração para sua organização. Consulte Provisionar gerenciamento de conteúdo.

Após concluir a etapa de provisionamento para a organização, cada usuário deve autorizar individualmente o aplicativo Webex para acessar o OneDrive. and/or SharePoint Online em nome deles.

Isso permite ao usuário trabalhar com conteúdo do Microsoft OneDrive e do SharePoint Online diretamente do aplicativo Webex. Os usuários devem ler Aplicativo Webex | Microsoft OneDrive e SharePoint Online.

Autenticação e autorização

A integração entre o aplicativo Webex e o Microsoft Azure ou o Office 365 é totalmente centrada no aplicativo. Todas as APIs da Microsoft Cloud (OneDrive ou SharePoint Online) são chamadas diretamente do aplicativo Webex. Essas API são recursos protegidos pelo OAuth2 e requerem um token de acesso para acessá-los com segurança.

Para obter um token de acesso, os usuários devem primeiro se autenticar e depois autorizar o aplicativo Webex. O token de acesso emitido é então enviado no título Autorização para cada chamada API para o Microsoft OneDrive ou SharePoint Online. Todas as chamadas API são feitas usando HTTPS. Para obter mais informações, consulte a seção Casos de uso neste artigo.

Os cookies de sessão e os tokens de atualização emitidos como parte da autenticação e autorização são criptografados e armazenados com segurança no dispositivo do usuário com o aplicativo Webex. Nenhuma informação de autenticação ou autorização relacionada ao usuário do OneDrive ou do SharePoint Online é exposta aos serviços do Webex Cloud. Para obter mais informações sobre o cache do Webex App, consulte Tech Ops and Security - Perguntas frequentes .

Uso e armazenamento de dados

Para compartilhar um documento, exibir uma miniatura do documento ou visualizar um documento do Microsoft OneDrive ou SharePoint Online, o Webex App usa o ID da unidade, o ID do item, o título do documento e o URL absoluto ou compartilhado do documento. Esses dados são armazenados na Nuvem Webex para qualquer documento compartilhado usando o aplicativo Webex. O conteúdo do arquivo do Microsoft OneDrive ou do SharePoint Online compartilhado em um espaço do Webex App nunca é armazenado na nuvem do Webex.

Os dados que armazenamos relacionados a documentos são tratados como informações confidenciais. O aplicativo Webex sempre criptografa dados confidenciais (como ID da unidade, ID do item, título do documento ou links) antes de enviá-los para a Nuvem Webex. Isso significa que apenas dados de documentos criptografados são enviados ou armazenados nos serviços Webex Cloud.

Para criptografia de dados, o aplicativo Webex utiliza o serviço de criptografia Webex Cloud. O gerenciamento de chaves é fornecido pelo KMS (Servidor de gerenciamento em nuvem) ou, se você optar por implantar a Segurança de dados híbridos, pelo seu próprio KMS no local. Para obter mais informações, consulte o Documento de segurança do aplicativo Webex.

O aplicativo Webex armazena dados em cache de forma independente, localmente, nos dispositivos dos usuários. Esses dados são criptografados em repouso no dispositivo. Para obter mais informações sobre o cache do Webex App, consulte Tech Ops and Security - Perguntas frequentes .

Embora seu locatário possa usar os recursos Multi-Geo do Office 365 para armazenar dados em um local específico, o Webex App armazena dados somente em seus data centers. Para obter mais informações relativas aos locais dos centro de dados Webex, consulte a seção 3 da Folha de dados de privacidade do serviço CiscoWebex.

Suporte ao locatário do Office 365

Um único locatário do Office 365 pode ser configurado para uma única organização Cisco Webex. Suportamos apenas a ocorrência de governo mundial e moderado do Office 365. Outras ocorrências que não suportamos incluem: USGovDoD, USGovGCCHigh, China e Alemanha.

Casos de uso

A seguir estão os casos de uso suportados com a referência de integração on-line do Microsoft OneDrive e do SharePoint.

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

1

O aplicativo Webex solicita autorização para acessar recursos de conteúdo.

2

O Microsoft Cloud solicita que o usuário insira suas credenciais.

3

O aplicativo Webex solicita um token de acesso e um token de atualização.

Processo de conexão de conta da Microsoft

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

1

O usuário clica em anexar arquivo.

2

O aplicativo Webex abre o Seletor de Arquivos da Microsoft.

3

O usuário seleciona um arquivo, permissões, edita ou visualiza o modo de exibição e depois clica em compartilhar.

4

O aplicativo Webex interage com a Nuvem Microsoft para criar um link compartilhado.

5

O aplicativo Webex criptografa o novo link compartilhado e o publica.

6

O serviço de Conversação Webex armazena e propaga o link a todos os membros do espaço.

Compartilhar um processo de documento

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

1

O aplicativo Webex recebe um evento de mensagem com um link compartilhado.

2

O aplicativo Webex descriptografa o link compartilhado e usa as credenciais do usuário para solicitar as miniaturas da Microsoft.

Processo de renderização de miniaturas

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

1

O usuário clica no link compartilhado.

2

O aplicativo Webex usa cookies de sessão para abrir o link compartilhado em um navegador incorporado.

Visualizando um processo de documento

Uso da API da Microsoft

O aplicativo Webex usa APIs do Azure Active Directory (AD) v2 e do Microsoft Graph. O Azure AD é usado para autorização do usuário final. O Microsoft Graph é usado para acessar documentos do Microsoft OneDrive e do SharePoint. Embora estas APIs tenham suporte para uma ampla variedade de operações, apenas um subconjunto de comandos é usado.

Terminais do Azure AD v2

Diretório Ativo Azure v2

Uso

GET /oauth2/v2.0/authorize

GET /oauth2/v2.0/authorize

POST /oauth2/v2.0/token

Resgate o código para o token de acesso

Terminais do Microsoft Graph

Operação de gráfico

Uso

OBTER /eu/drive/root/children

Lê o diretório raiz

PEGAR /me/drive/items/{file_id}

Lê detalhes de um arquivo

PEGAR /me/drive/items/{file_id}/thumbnails/0/large/content

Lê a miniatura de um arquivo

PUBLICAR /items/{file_id}/preview

Lê a pré-visualização de um arquivo

PUBLICAR /me/drive/items/{file_id}/createLink

Cria um link para um arquivo

OBTER /compartilha/{item}/driveItem

Lê metadados de um link compartilhado

OBTER /compartilha/{item}/root/thumbnails/0/large/content

Lê a miniatura de um link compartilhado

PEGAR /me/drive//items/{{file_id}}/permissions

Lê permissões para um arquivo

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