Riepilogo
L'integrazione Webex con Microsoft OneDrive e SharePoint Online consente agli utenti di condividere e accedere al contenuto memorizzato in Microsoft OneDrive e SharePoint Online direttamente dall'interno dell'app Webex.
Un amministratore può scegliere di eseguire il provisioning (configurare, abilitare e autorizzare) l'integrazione per la propria organizzazione. Inoltre, l'utente deve autorizzare in modo indipendente Webex per accedere a OneDrive e/o SharePoint Online per suo conto. Ciò consente a un utente di condividere un documento, visualizzare un'anteprima del documento o visualizzare un documento da Webex. Per ulteriori dettagli, vedere Connessione a Microsoft OneDrive e SharePoint Online
Autenticazione e autorizzazione
L'integrazione tra Webex e Microsoft Azure o Office 365 è interamente incentrata sull'app. Tutte le API Cloud Microsoft (OneDrive o SharePoint Online) vengono chiamate direttamente da Webex. Tali API sono risorse protette OAuth2 e richiedono un token di accesso per accedervi in modo sicuro.
Per ottenere un token di accesso, gli utenti devono prima eseguire l'autenticazione, quindi autorizzare Webex. Il token di accesso rilasciato viene quindi inviato nell'intestazione Autorizzazione per ciascuna chiamata API a Microsoft OneDrive o SharePoint Online. Tutte le chiamate API vengono effettuate utilizzando HTTPS. Per ulteriori informazioni, vedere la sezione Casi d'uso in questo articolo.
I cookie della sessione e i token di aggiornamento emessi come parte dell'autenticazione e dell'autorizzazione vengono crittografati e memorizzati in modo sicuro sul dispositivo Webex dell'utente. Nessuna informazione di autenticazione o autorizzazione relativa all'utente per OneDrive o SharePoint Online è mai esposta ai servizi cloud Webex. Per ulteriori informazioni sul caching Webex, vedere Operazioni tecniche e sicurezza - Domande frequenti .
Utilizzo dati e storage
Per condividere un documento, visualizzare l'anteprima di un documento o visualizzare in anteprima un documento da Microsoft OneDrive o SharePoint Online, Webex utilizza l'ID unità, l'ID elemento, il titolo del documento e l'URL assoluti o condivisi di un documento. Questi dati vengono memorizzati nel cloud Webex per qualsiasi documento condiviso utilizzando Webex. Il contenuto del file Microsoft OneDrive o SharePoint Online condiviso in uno spazio Webex, non viene mai memorizzato nel cloud Webex.
I dati memorizzati relativi ai documenti vengono trattati come informazioni sensibili. Webex esegue sempre la crittografia di dati sensibili (id drive, item-id, titolo del documento o collegamenti) prima di inviarli al cloud Webex. Ciò significa che solo i dati crittografati dei documenti vengono inviati o memorizzati nei servizi Webex Cloud.
Per la crittografia dei dati, Webex utilizza il servizio di crittografia del cloud Webex. La gestione delle chiavi viene fornita dal server di gestione delle chiavi (KMS) del cloud oppure, se si sceglie di distribuire la sicurezza dei dati ibridi, tramite il KMS locale. Per ulteriori informazioni, vedere il Documento sulla sicurezza dell'appWebex.
Webex memorizza nella cache i dati in locale sui dispositivi degli utenti. Questi dati vengono crittografati a riposo sul dispositivo. Per ulteriori informazioni sul caching Webex, vedere Operazioni tecniche e sicurezza - Domande frequenti .
Sebbene il tenant possa utilizzare le funzionalità multi-localizzazione in Office 365 per memorizzare i dati in una posizione specifica, Webex memorizza i dati solo nei relativi centri dati. Per ulteriori informazioni relative alle posizioni dei centri dati Webex, vedere la sezione 3 della Scheda tecnica sulla privacy del servizio CiscoWebex.
Supporto tenant Office 365
È possibile configurare un singolo tenant Office 365 per una singola organizzazione Cisco Webex. È supportare solo l'istanza governativa mondiale e moderare di Office 365. Altre istanze non supportate includono: USGovDoD, USGovGCCHigh, Cina e Germania.
Casi d'uso
Di seguito sono riportati i casi d'uso supportati con il riferimento all'integrazione online di Microsoft OneDrive e SharePoint.
Il flusso include i seguenti passaggi di alto livello.
| 1 | Webex richiede l'autorizzazione ad accedere alle risorse di contenuto. |
| 2 | Microsoft Cloud richiede all'utente di inserire le credenziali. |
| 3 | Webex richiede l'accesso e un token di aggiornamento. |
Processo di connessione dell'account Microsoft
Il flusso include i seguenti passaggi di alto livello.
| 1 | L'utente fa clic su allega file. |
| 2 | Webex apre la funzione di selezione file di Microsoft. |
| 3 | L'utente seleziona un file, le autorizzazioni, modifica o visualizza la modalità, quindi fa clic su Condividi. |
| 4 | Webex interagisce con Microsoft Cloud per creare un collegamento condiviso. |
| 5 | Webex crittografa il nuovo collegamento condiviso e lo pubblica. |
| 6 | Il servizio Di conversazione Webex memorizza e propaga il collegamento a tutti i membri dello spazio. |
Processo di condivisione di un documento
Il flusso include i seguenti passaggi di alto livello.
| 1 | Webex riceve un evento con un collegamento condiviso. |
| 2 | Webex decrittografa il collegamento condiviso e utilizza le credenziali dell'utente per richiedere le anteprime da Microsoft. |
Processo di rendering delle anteprime
Il flusso include i seguenti passaggi di alto livello.
| 1 | L'utente fa clic sul collegamento condiviso. |
| 2 | Webex utilizza i cookie di sessione per aprire il collegamento condiviso in un browser incorporato. |
Visualizzazione di un processo documento
Utilizzo API Microsoft
Webex utilizza API di Azure Active Directory (AD) v2 e Microsoft Graph. Azure AD viene utilizzato per l'autorizzazione dell'utente finale. Microsoft Graph viene utilizzato per accedere ai documenti Microsoft OneDrive e SharePoint. Sebbene queste API supportino un'ampia gamma di operazioni, viene utilizzato solo un sottogruppo di comandi.
Endpoint Azure AD v2
Azure Active Directory v2 |
Utilizzo |
|---|---|
GET /oauth2/v2.0/authorize |
GET /oauth2/v2.0/authorize |
POST /oauth2/v2.0/token |
Riscattare il codice per il token di accesso |
Endpoint Microsoft Graph
Operazione Graph |
Utilizzo |
|---|---|
GET /me/drive/root/children |
Lettura della directory radice |
GET /me/drive/items/{file_id} |
Legge i dettagli di un file |
GET /me/drive/items/{file_id}/thumbnails/0/large/content |
Legge l'anteprima di un file |
POST /items/{file_id}/preview |
Consente di leggere l'anteprima di un file |
POST /me/drive/items/{file_id}/createLink |
Crea il collegamento per un file |
GET /shares/{item}/driveItem |
Legge i metadati da un collegamento condiviso |
GET /shares/{item}/root/thumbnails/0/large/content |
Visualizza l'anteprima di un collegamento condiviso |
GET /me/drive//items/{{file_id}}/permissions |
Legge le autorizzazioni per un file |
