Come ONLYOFFICE gestisce i dati utente di Google
Applicazione
I portali ONLYOFFICE interagiscono con Google inviando richieste all'API ufficiale di Google tramite il protocollo di autorizzazione OAuth 2.0. Per operare secondo questo protocollo, è stata creata l'applicazione ONLYOFFICE (api-project-948651087073) nella Google API Console. A essa sono collegati i seguenti servizi: Google Drive API, People API, Contacts API.
Per l'applicazione ONLYOFFICE sono state generate chiavi di autorizzazione con l'URL di reindirizzamento https://service.onlyoffice.com/oauth2.aspx. Quando un utente accede a ONLYOFFICE con Google, viene richiesto il codice di autorizzazione e l'indirizzo della pagina corrente dell'utente viene passato nel parametro state.
Dopo il reindirizzamento all'API di Google, l'URL https://service.onlyoffice.com/oauth2.aspx reindirizza automaticamente alla pagina indicata nel parametro state. Ciò è necessario perché gli indirizzi e i domini che l'applicazione ONLYOFFICE utilizzerà non sono noti in anticipo.
Gestione dei dati utente di Google nei portali ONLYOFFICE
Accesso
Collegamento di Google a un profilo utente
Per accedere al portale ONLYOFFICE con Google tramite un profilo utente esistente, l'utente collega il proprio account Google al proprio account ONLYOFFICE.
Nella pagina del profilo utente di ONLYOFFICE, la sezione Accesso tramite social network contiene un pulsante Google:

Facendo clic su questo pulsante si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con il seguente ambito:
Con questo ambito, l'applicazione ONLYOFFICE può:
- vedere le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili;
- visualizzare il tuo indirizzo email.
Questa azione utilizza la richiesta people.get. Il database di ONLYOFFICE memorizza la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e l'identificatore del profilo utente in ONLYOFFICE.
Accesso a un portale
La pagina di autorizzazione dei portali ONLYOFFICE contiene un pulsante per accedere con Google:

Facendo clic su questo pulsante si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con il seguente ambito:
Con questo ambito, l'applicazione ONLYOFFICE può:
- vedere le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili;
- visualizzare il tuo indirizzo email.
Questa azione utilizza la richiesta people.get. ONLYOFFICE cerca nel proprio database la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e un identificatore di profilo utente in ONLYOFFICE. Se la trova, l'utente accede con quel profilo ONLYOFFICE.
Accesso al sito web di ONLYOFFICE
La pagina di accesso del sito web di ONLYOFFICE contiene un pulsante per accedere con Google:

Facendo clic su questo pulsante si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con il seguente ambito:
Con questo ambito, l'applicazione ONLYOFFICE può:
- vedere le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili;
- visualizzare il tuo indirizzo email.
Questa azione utilizza la richiesta people.get. ONLYOFFICE cerca in tutti i portali la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e un identificatore di profilo utente in ONLYOFFICE. Se la trova, l'utente accede a quel portale con quel profilo ONLYOFFICE.
Accesso a ONLYOFFICE Personal
La sezione Accesso di ONLYOFFICE Personal contiene un pulsante per accedere con Google:

Facendo clic su questo pulsante si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con il seguente ambito:
Con questo ambito, l'applicazione ONLYOFFICE può:
- vedere le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili;
- visualizzare il tuo indirizzo email.
Questa azione utilizza la richiesta people.get. ONLYOFFICE cerca nel proprio database la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e un identificatore di profilo utente in ONLYOFFICE. Se la trova, l'utente accede con quel profilo ONLYOFFICE.
Se non la trova, viene creato un nuovo profilo con il nome utente e l'indirizzo email di Google, e il database di ONLYOFFICE memorizza la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e l'identificatore del nuovo profilo in ONLYOFFICE.
Importazione di utenti
Puoi aggiungere più profili utente al tuo portale ONLYOFFICE in una sola volta importando i contatti da Google. Per sapere come fare, consulta Importare utenti da Google.
Nel modulo Persone, l'opzione Importa Persone contiene un pulsante per selezionare Google come fonte delle informazioni di contatto:

Facendo clic su questo pulsante si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con l'ambito https://www.googleapis.com/auth/contacts.readonly. Con questo ambito, l'applicazione ONLYOFFICE può:
- vedere e scaricare i tuoi contatti.
Questa azione utilizza la richiesta Retrieving all contacts. ONLYOFFICE crea nuovi profili utente nel portale a partire dai nomi e dagli indirizzi email dei tuoi contatti Google.
Google Drive
Puoi collegare il tuo account Google Drive al modulo Documenti per gestire e modificare con gli editor ONLYOFFICE i documenti archiviati in Google Drive. Per sapere come fare, consulta Connessione di servizi di terze parti.
Nel modulo Documenti, la voce Aggiungi account contiene un pulsante per selezionare Google Drive:

Facendo clic su questo pulsante si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con l'ambito https://www.googleapis.com/auth/drive. Con questo ambito, l'applicazione ONLYOFFICE può:
- vedere, modificare, creare ed eliminare tutti i tuoi file di Google Drive.
Il database di ONLYOFFICE memorizza solo la chiave di autorizzazione ricevuta, necessaria per le richieste successive. Le azioni vengono eseguite con la Google APIs Client Library.
Vengono utilizzati i seguenti metodi:
- ottenere l'elenco dei file;
- creare un file;
- eliminare un file;
- aggiornare, rinominare e spostare un file;
- copiare un file;
- ottenere la dimensione massima dei file da caricare.
Altri casi di utilizzo dei dati utente di Google in ONLYOFFICE
Gli utenti possono aprire e modificare i documenti con gli editor online di ONLYOFFICE direttamente in Google Drive tramite l'app ONLYOFFICE Personal. A questo scopo è stata creata l'applicazione ONLYOFFICE Personal (api-project-438840568076).
In Google Drive, collega l'applicazione ONLYOFFICE Personal con il pulsante Nuovo (Nuovo > Altro > Collega altre app) o dal menu contestuale del file (Apri con > Collega altre app):

Dopo aver collegato l'applicazione ONLYOFFICE Personal a Google Drive, all'elenco viene aggiunta un'opzione per creare file (Nuovo > Altro > ONLYOFFICE Personal):

L'opzione viene aggiunta anche al menu contestuale del file (Apri con > ONLYOFFICE Personal):

L'opzione è disponibile per i seguenti formati:
- i file docx, pptx, xlsx, ppsx si aprono con ONLYOFFICE Personal per impostazione predefinita quando fai clic sul nome del file;
- i file ppt, pps, odp, doc, odt, rtf, mht, html, htm, fb2, epub, txt, pdf, djvu, xps, xls, csv, ods, fods, fodt, pptm, potx, potm, pot, xlsm, xlt, xltx, xltm, docm, dotx, dotm, ots, otp, ott si aprono con ONLYOFFICE Personal dal menu contestuale.
Sia quando crei un nuovo file sia quando apri un file esistente con l'applicazione ONLYOFFICE Personal, si apre una pagina di Google che concede all'applicazione ONLYOFFICE l'accesso ai dati con il seguente ambito:
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/userinfo.profile
- https://www.googleapis.com/auth/userinfo.email
Con questo ambito, l'applicazione ONLYOFFICE può:
- visualizzare, creare, modificare ed eliminare tutti i file su Google Drive;
- vedere le tue informazioni personali, incluse quelle che hai reso pubblicamente disponibili;
- visualizzare il tuo indirizzo email.
L'applicazione ONLYOFFICE Personal richiede i dati utente con la richiesta people.get. ONLYOFFICE Personal cerca nel proprio database la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e un identificatore di profilo utente in ONLYOFFICE. Se la trova, l'utente accede con quel profilo ONLYOFFICE Personal.
Se non la trova, viene creato un nuovo profilo con il nome utente e l'indirizzo email di Google, e il database di ONLYOFFICE Personal memorizza la corrispondenza tra l'identificatore e l'indirizzo email dell'utente in Google e l'identificatore del nuovo profilo in ONLYOFFICE. Il database di ONLYOFFICE memorizza inoltre la chiave di autorizzazione ricevuta, necessaria per le richieste successive alla Drive API. Vengono utilizzati i seguenti metodi:
- creare un file;
- scaricare un file;
- aggiornare un file.
Informativa sulla privacy
Il seguente documento descrive come l'applicazione ONLYOFFICE richiede, utilizza e memorizza i tuoi dati utente di Google.