Wie ONLYOFFICE mit Google-Benutzerdaten umgeht
Anwendung
ONLYOFFICE-Portale kommunizieren mit Google über Anfragen an die offizielle Google API mithilfe des Autorisierungsprotokolls OAuth 2.0. Um gemäß diesem Protokoll zu arbeiten, wurde in der Google API Console die ONLYOFFICE-Anwendung (api-project-948651087073) erstellt. Mit ihr sind die folgenden Dienste verbunden: Google Drive API, People API, Contacts API.
Für die ONLYOFFICE-Anwendung wurden Autorisierungsschlüssel mit der Weiterleitungs-URL https://service.onlyoffice.com/oauth2.aspx generiert. Wenn sich ein Benutzer mit Google bei ONLYOFFICE anmeldet, wird der Autorisierungscode angefordert und die Adresse der aktuellen Seite des Benutzers im Parameter state übergeben.
Nach der Weiterleitung an die Google API leitet die URL https://service.onlyoffice.com/oauth2.aspx automatisch auf die im Parameter state angegebene Seite weiter. Dies ist erforderlich, da die Adressen und Domains, die die ONLYOFFICE-Anwendung verwenden wird, nicht im Voraus bekannt sind.
Umgang mit Google-Benutzerdaten in ONLYOFFICE-Portalen
Anmeldung
Google mit einem Benutzerprofil verbinden
Um sich mit Google unter einem bestehenden Benutzerprofil beim ONLYOFFICE-Portal anzumelden, verknüpft der Benutzer sein Google-Konto mit seinem ONLYOFFICE-Konto.
Auf der Seite des ONLYOFFICE-Benutzerprofils enthält der Abschnitt Anmeldung über soziale Netzwerke eine Google-Schaltfläche:
Ein Klick auf diese Schaltfläche öffnet eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem folgenden Bereich gewährt:
Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- Ihre personenbezogenen Daten sehen, einschließlich aller personenbezogenen Daten, die Sie öffentlich zugänglich gemacht haben;
- Ihre E-Mail-Adresse anzeigen.
Diese Aktion verwendet die Anfrage people.get. Die ONLYOFFICE-Datenbank speichert die Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und der Kennung des Benutzerprofils in ONLYOFFICE.
Anmeldung bei einem Portal
Die Autorisierungsseite von ONLYOFFICE-Portalen enthält eine Schaltfläche zur Anmeldung mit Google:
Ein Klick auf diese Schaltfläche öffnet eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem folgenden Bereich gewährt:
Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- Ihre personenbezogenen Daten sehen, einschließlich aller personenbezogenen Daten, die Sie öffentlich zugänglich gemacht haben;
- Ihre E-Mail-Adresse anzeigen.
Diese Aktion verwendet die Anfrage people.get. ONLYOFFICE sucht in seiner Datenbank nach einer Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und einer Benutzerprofilkennung in ONLYOFFICE. Wird eine gefunden, wird der Benutzer unter diesem ONLYOFFICE-Profil angemeldet.
Anmeldung auf der ONLYOFFICE-Website
Die Anmeldeseite auf der ONLYOFFICE-Website enthält eine Schaltfläche zur Anmeldung mit Google:
Ein Klick auf diese Schaltfläche öffnet eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem folgenden Bereich gewährt:
Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- Ihre personenbezogenen Daten sehen, einschließlich aller personenbezogenen Daten, die Sie öffentlich zugänglich gemacht haben;
- Ihre E-Mail-Adresse anzeigen.
Diese Aktion verwendet die Anfrage people.get. ONLYOFFICE durchsucht alle Portale nach einer Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und einer Benutzerprofilkennung in ONLYOFFICE. Wird eine gefunden, wird der Benutzer unter diesem ONLYOFFICE-Profil bei dem entsprechenden Portal angemeldet.
Anmeldung bei ONLYOFFICE Personal
Der Abschnitt Anmelden von ONLYOFFICE Personal enthält eine Schaltfläche zur Anmeldung mit Google:
Ein Klick auf diese Schaltfläche öffnet eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem folgenden Bereich gewährt:
Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- Ihre personenbezogenen Daten sehen, einschließlich aller personenbezogenen Daten, die Sie öffentlich zugänglich gemacht haben;
- Ihre E-Mail-Adresse anzeigen.
Diese Aktion verwendet die Anfrage people.get. ONLYOFFICE sucht in seiner Datenbank nach einer Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und einer Benutzerprofilkennung in ONLYOFFICE. Wird eine gefunden, wird der Benutzer unter diesem ONLYOFFICE-Profil angemeldet.
Wird keine gefunden, wird ein neues Profil mit dem Google-Benutzernamen und der E-Mail-Adresse erstellt, und die ONLYOFFICE-Datenbank speichert die Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und der neuen Profilkennung in ONLYOFFICE.
Benutzerimport
Sie können mehrere Benutzerprofile gleichzeitig zu Ihrem ONLYOFFICE-Portal hinzufügen, indem Sie Kontakte von Google importieren. Wie das geht, erfahren Sie unter Importieren von Benutzern von Google.
Im Modul Personen enthält die Option Personen importieren eine Schaltfläche, mit der Sie Google als Quelle der Kontaktinformationen auswählen:
Ein Klick auf diese Schaltfläche öffnet eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem Bereich https://www.googleapis.com/auth/contacts.readonly gewährt. Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- Ihre Kontakte sehen und herunterladen.
Diese Aktion verwendet die Anfrage Retrieving all contacts. ONLYOFFICE erstellt aus den Namen und E-Mail-Adressen Ihrer Google-Kontakte neue Benutzerprofile im Portal.
Google Drive
Sie können Ihr Google Drive-Konto mit dem Modul Dokumente verbinden, um die in Google Drive gespeicherten Dokumente mit den ONLYOFFICE-Editoren zu verwalten und zu bearbeiten. Wie das geht, erfahren Sie unter Anbindung von Drittanbieterdiensten.
Im Modul Dokumente enthält die Beschriftung Konto hinzufügen eine Schaltfläche zur Auswahl von Google Drive:
Ein Klick auf diese Schaltfläche öffnet eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem Bereich https://www.googleapis.com/auth/drive gewährt. Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- alle Ihre Google Drive-Dateien sehen, bearbeiten, erstellen und löschen.
Die ONLYOFFICE-Datenbank speichert nur den erhaltenen Autorisierungsschlüssel, der für weitere Anfragen benötigt wird. Die Aktionen werden mit der Google APIs Client Library ausgeführt.
Die folgenden Methoden werden verwendet:
- Dateiliste abrufen;
- Datei erstellen;
- Datei löschen;
- Datei aktualisieren, umbenennen und verschieben;
- Datei kopieren;
- maximale Dateigröße für das Hochladen abrufen.
Weitere Fälle der Verwendung von Google-Benutzerdaten in ONLYOFFICE
Benutzer können Dokumente mit den ONLYOFFICE-Online-Editoren direkt in ihrem Google Drive öffnen und bearbeiten, indem sie die App ONLYOFFICE Personal verwenden. Zu diesem Zweck wurde die Anwendung ONLYOFFICE Personal (api-project-438840568076) erstellt.
Verbinden Sie die Anwendung ONLYOFFICE Personal in Google Drive über die Schaltfläche Neu (Neu > Mehr > Weitere Apps verbinden) oder über das Kontextmenü einer Datei (Öffnen mit > Weitere Apps verbinden):
Sobald die Anwendung ONLYOFFICE Personal mit Google Drive verbunden ist, wird der Liste eine Option zum Erstellen von Dateien hinzugefügt (Neu > Mehr > ONLYOFFICE Personal):
Die Option wird auch dem Kontextmenü einer Datei hinzugefügt (Öffnen mit > ONLYOFFICE Personal):
Die Option ist für die folgenden Formate verfügbar:
- docx-, pptx-, xlsx- und ppsx-Dateien werden standardmäßig mit ONLYOFFICE Personal geöffnet, wenn Sie auf den Dateinamen klicken;
- 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- und ott-Dateien werden über das Kontextmenü mit ONLYOFFICE Personal geöffnet.
Sowohl beim Erstellen einer neuen Datei als auch beim Öffnen einer vorhandenen Datei mit der Anwendung ONLYOFFICE Personal öffnet sich eine Google-Seite, die der ONLYOFFICE-Anwendung Zugriff auf Daten mit dem folgenden Bereich gewährt:
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/userinfo.profile
- https://www.googleapis.com/auth/userinfo.email
Mit diesem Bereich kann die ONLYOFFICE-Anwendung:
- alle Dateien in Google Drive anzeigen, erstellen, bearbeiten und löschen;
- Ihre personenbezogenen Daten sehen, einschließlich aller personenbezogenen Daten, die Sie öffentlich zugänglich gemacht haben;
- Ihre E-Mail-Adresse anzeigen.
Die Anwendung ONLYOFFICE Personal fordert Benutzerdaten mit der Anfrage people.get an. ONLYOFFICE Personal sucht in seiner Datenbank nach einer Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und einer Benutzerprofilkennung in ONLYOFFICE. Wird eine gefunden, wird der Benutzer unter diesem ONLYOFFICE Personal-Profil angemeldet.
Wird keine gefunden, wird ein neues Profil mit dem Google-Benutzernamen und der E-Mail-Adresse erstellt, und die Datenbank von ONLYOFFICE Personal speichert die Zuordnung zwischen der Kennung und E-Mail-Adresse des Benutzers bei Google und der neuen Profilkennung in ONLYOFFICE. Die ONLYOFFICE-Datenbank speichert außerdem den erhaltenen Autorisierungsschlüssel, der für weitere Anfragen an die Drive API benötigt wird. Die folgenden Methoden werden verwendet:
- Datei erstellen;
- Datei herunterladen;
- Datei aktualisieren.
Datenschutzrichtlinie
Das folgende Dokument legt offen, wie die ONLYOFFICE-Anwendung Ihre Google-Benutzerdaten anfordert, verwendet und speichert.