- Página inicial
- /
- Artigo
Aplicativo Webex | Referência de integração do Microsoft OneDrive e do SharePoint Online
Resumo
A integração do aplicativo Webex com o Microsoft OneDrive e o SharePoint Online oferece aos usuários a capacidade de compartilhar e acessar o conteúdo armazenado no Microsoft OneDrive e no SharePoint Online diretamente do aplicativo Webex.
Um administrador pode optar por provisionar (configurar, ativar e autorizar) a integração para sua organização. Consulte Provisionar gerenciamento de conteúdo.
Depois de executar a etapa de provisionamento para a organização, cada usuário deve autorizar de forma independente o Webex App a acessar o OneDrive e/ou o SharePoint Online em seu nome.
Isso permite que o usuário trabalhe com o conteúdo do Microsoft OneDrive e do SharePoint Online a partir do aplicativo Webex. Os usuários devem ler o 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 do Microsoft Cloud (OneDrive ou SharePoint Online) são chamadas diretamente do aplicativo Webex. Essas APIs são recursos protegidos pelo OAuth2 e exigem um token de acesso para acessá-los com segurança.
Para obter um token de acesso, os usuários devem primeiro autenticar e depois autorizar o aplicativo Webex. O token de acesso emitido é então enviado no cabeçalho de autorização para cada chamada de API para o Microsoft OneDrive ou o SharePoint Online. Todas as chamadas de 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 aplicativo Webex do usuário. Nenhuma informação de autenticação ou autorização relacionada ao usuário do OneDrive ou do SharePoint Online é exposta aos serviços Webex Cloud. Para obter mais informações sobre o cache do aplicativo Webex, consulte Operações técnicas e segurança - perguntas frequentes.
Uso e armazenamento de dados
Para compartilhar um documento, exibir uma miniatura de documento ou visualizar um documento do Microsoft OneDrive ou do SharePoint Online, o aplicativo Webex usa o drive-id, item-id, título do documento e URL absoluta ou compartilhada para um documento. Esses dados são armazenados na Webex Cloud para qualquer documento compartilhado usando o aplicativo Webex. O conteúdo do arquivo Microsoft OneDrive ou SharePoint Online compartilhado em um espaço do aplicativo Webex nunca é armazenado na nuvem 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 Webex Cloud. Isso significa que somente dados de documentos criptografados são enviados ou armazenados nos serviços Webex Cloud.
Para criptografia de dados, o aplicativo Webex usa o serviço de criptografia Webex Cloud. O gerenciamento de chaves é fornecido pelo Key Management Server (KMS) na nuvem ou, se você optar por implantar o Hybrid Data Security, pelo seu próprio KMS local. Para obter mais informações, consulte o documento Webex App Security.
O aplicativo Webex armazena dados em cache de forma independente localmente nos dispositivos do usuário. Esses dados são criptografados quando estão em repouso no dispositivo. Para obter mais informações sobre o cache do aplicativo Webex, consulte Operações técnicas e segurança - perguntas frequentes.
Embora seu inquilino possa usar recursos multigeográficos no Office 365 para armazenar dados em um local específico, o aplicativo Webex armazena dados somente em seus data centers. Para obter mais informações relacionadas às localizações do Webex Data Center, consulte a seção 3 da Folha de dados de privacidade do Cisco Webex serviço.
Suporte para locatários do Office 365
Um único locatário do Office 365 pode ser configurado para uma única Cisco Webex organização. Só oferecemos suporte à instância governamental mundial e moderada do Office 365. Outras instâncias para as quais não oferecemos suporte incluem: USGovdod, USGovgCCHigh, China e Alemanha.
Casos de uso
A seguir estão os casos de uso compatíveis com o Microsoft OneDrive e o SharePoint Online Integration Reference.
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 acesso e um token de atualização. |
Processo de conexão da conta 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, modo de edição ou visualização e, em seguida, clica em compartilhar. |
| 4 |
O aplicativo Webex interage com o Microsoft Cloud para criar um link compartilhado. |
| 5 |
O aplicativo Webex criptografa o novo link compartilhado e o publica. |
| 6 |
O serviço Webex Conversation armazena e propaga o link para todos os membros do espaço. |
Compartilhando 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 os cookies de sessão para abrir o link compartilhado em um navegador incorporado. |
Exibindo 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 essas APIs suportem uma ampla variedade de operações, somente um subconjunto de comandos é usado.
Endpoints do Azure AD v2
|
Azure Active Directory v2 |
Uso |
|---|---|
|
OBTENHA /oauth2/v2.0/authorize |
OBTENHA /oauth2/v2.0/authorize |
|
POST /oauth2/v2.0/token |
Resgate o código do token de acesso |
Endpoints do Microsoft Graph
|
Operação gráfica |
Uso |
|---|---|
|
GET /me/drive/root/children |
Lê o diretório raiz |
|
OBTENHA /me/drive/items/ {file_id} |
Lê os detalhes de um arquivo |
|
OBTENHA /me/drive/items/ {file_id} /thumbnails/0/large/content |
Lê a miniatura de um arquivo |
|
POST /items/ {file_id} /pré-visualização |
Lê a pré-visualização de um arquivo |
|
POST /me/drive/items/ {file_id} /createLink |
Cria link para um arquivo |
|
OBTENHA /shares/ {item} /driveItem |
Lê metadados de um link compartilhado |
|
OBTENHA /shares/ {item} /root/thumbnails/0/large/content |
Lê a miniatura de um link compartilhado |
|
OBTENHA /me/drive//items/ {{file_id}} /permissões |
Lê as permissões de um arquivo |