Как ONLYOFFICE обрабатывает пользовательские данные Google

Приложение

Порталы ONLYOFFICE взаимодействуют с Google, отправляя запросы к официальному API Google по протоколу авторизации OAuth 2.0. Для работы в соответствии с этим протоколом в консоли Google API было создано приложение ONLYOFFICE (api-project-948651087073). К нему подключены следующие сервисы: Google Drive API, People API, Contacts API.

Для приложения ONLYOFFICE были сгенерированы ключи авторизации с URL-адресом перенаправления https://service.onlyoffice.com/oauth2.aspx. Когда пользователь входит в ONLYOFFICE через Google, запрашивается код авторизации, а адрес текущей страницы пользователя передается в параметре state.

После перенаправления в API Google адрес https://service.onlyoffice.com/oauth2.aspx автоматически перенаправляет на страницу, указанную в параметре state. Это необходимо, потому что адреса и домены, которые будет использовать приложение ONLYOFFICE, заранее неизвестны.

Обработка пользовательских данных Google на порталах ONLYOFFICE

Вход

Подключение Google к профилю пользователя

Чтобы входить на портал ONLYOFFICE через Google под существующим профилем, пользователь связывает свою учетную запись Google с учетной записью ONLYOFFICE.

На странице профиля пользователя ONLYOFFICE в разделе Вход через социальные сети есть кнопка Google:

Нажатие этой кнопки открывает страницу Google, которая предоставляет приложению ONLYOFFICE доступ к данным со следующей областью действия:

• https://www.googleapis.com/auth/userinfo.profile
• https://www.googleapis.com/auth/userinfo.email

С этой областью действия приложение ONLYOFFICE может:

• просматривать вашу личную информацию, в том числе ту, которую вы сделали общедоступной;
• просматривать ваш адрес электронной почты.

В этом действии используется запрос people.get. В базе данных ONLYOFFICE хранится соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором профиля пользователя в ONLYOFFICE.

Вход на портал

На странице авторизации порталов ONLYOFFICE есть кнопка входа через Google:

Нажатие этой кнопки открывает страницу Google, которая предоставляет приложению ONLYOFFICE доступ к данным со следующей областью действия:

• https://www.googleapis.com/auth/userinfo.profile
• https://www.googleapis.com/auth/userinfo.email

С этой областью действия приложение ONLYOFFICE может:

• просматривать вашу личную информацию, в том числе ту, которую вы сделали общедоступной;
• просматривать ваш адрес электронной почты.

В этом действии используется запрос people.get. ONLYOFFICE ищет в своей базе данных соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором профиля пользователя в ONLYOFFICE. Если соответствие найдено, пользователь входит под этим профилем ONLYOFFICE.

Вход на сайте ONLYOFFICE

На странице входа сайта ONLYOFFICE есть кнопка входа через Google:

Нажатие этой кнопки открывает страницу Google, которая предоставляет приложению ONLYOFFICE доступ к данным со следующей областью действия:

• https://www.googleapis.com/auth/userinfo.profile
• https://www.googleapis.com/auth/userinfo.email

С этой областью действия приложение ONLYOFFICE может:

• просматривать вашу личную информацию, в том числе ту, которую вы сделали общедоступной;
• просматривать ваш адрес электронной почты.

В этом действии используется запрос people.get. ONLYOFFICE ищет на всех порталах соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором профиля пользователя в ONLYOFFICE. Если соответствие найдено, пользователь входит на этот портал под этим профилем ONLYOFFICE.

Вход в ONLYOFFICE Personal

В разделе Вход ONLYOFFICE Personal есть кнопка входа через Google:

Нажатие этой кнопки открывает страницу Google, которая предоставляет приложению ONLYOFFICE доступ к данным со следующей областью действия:

• https://www.googleapis.com/auth/userinfo.profile
• https://www.googleapis.com/auth/userinfo.email

С этой областью действия приложение ONLYOFFICE может:

• просматривать вашу личную информацию, в том числе ту, которую вы сделали общедоступной;
• просматривать ваш адрес электронной почты.

В этом действии используется запрос people.get. ONLYOFFICE ищет в своей базе данных соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором профиля пользователя в ONLYOFFICE. Если соответствие найдено, пользователь входит под этим профилем ONLYOFFICE.

Если соответствие не найдено, создается новый профиль с именем и адресом электронной почты пользователя Google, а в базе данных ONLYOFFICE сохраняется соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором нового профиля в ONLYOFFICE.

Импорт пользователей

Вы можете добавить сразу несколько профилей пользователей на портал ONLYOFFICE, импортировав контакты из Google. Подробнее читайте в статье Импорт контактов из интернета.

В модуле Люди в опции Импорт людей есть кнопка для выбора Google в качестве источника контактной информации:

Нажатие этой кнопки открывает страницу Google, которая предоставляет приложению ONLYOFFICE доступ к данным с областью действия https://www.googleapis.com/auth/contacts.readonly. С этой областью действия приложение ONLYOFFICE может:

• просматривать и скачивать ваши контакты.

В этом действии используется запрос Retrieving all contacts. ONLYOFFICE создает на портале новые профили пользователей из имен и адресов электронной почты ваших контактов Google.

Google Drive

Вы можете подключить свою учетную запись Google Drive к модулю Документы, чтобы управлять документами, хранящимися в Google Drive, и редактировать их в редакторах ONLYOFFICE. Подробнее читайте в статье Подключение сторонних сервисов.

В модуле Документы у подписи Добавить аккаунт есть кнопка для выбора Google Drive:

Нажатие этой кнопки открывает страницу Google, которая предоставляет приложению ONLYOFFICE доступ к данным с областью действия https://www.googleapis.com/auth/drive. С этой областью действия приложение ONLYOFFICE может:

• просматривать, редактировать, создавать и удалять все ваши файлы на Google Drive.

В базе данных ONLYOFFICE хранится только полученный ключ авторизации, необходимый для дальнейших запросов. Действия выполняются с помощью клиентской библиотеки Google APIs.

Используются следующие методы:

• получение списка файлов;
• создание файла;
• удаление файла;
• обновление, переименование и перемещение файла;
• копирование файла;
• получение максимального размера файла для загрузки.

Другие случаи использования пользовательских данных Google в ONLYOFFICE

Пользователи могут открывать и редактировать документы в онлайн-редакторах ONLYOFFICE прямо в своем Google Drive с помощью приложения ONLYOFFICE Personal. Для этого было создано приложение ONLYOFFICE Personal (api-project-438840568076).

В Google Drive подключите приложение ONLYOFFICE Personal с помощью кнопки Создать (Создать > Ещё > Подключить другие приложения) или из контекстного меню файла (Открыть с помощью > Подключить другие приложения):

После подключения приложения ONLYOFFICE Personal к Google Drive в список добавляется опция создания файла (Создать > Ещё > ONLYOFFICE Personal):

Эта опция также добавляется в контекстное меню файла (Открыть с помощью > ONLYOFFICE Personal):

Опция доступна для следующих форматов:

• файлы docx, pptx, xlsx, ppsx по умолчанию открываются в ONLYOFFICE Personal при нажатии на имя файла;
• файлы 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 открываются в ONLYOFFICE Personal из контекстного меню.

Как при создании нового файла, так и при открытии существующего файла в приложении ONLYOFFICE Personal открывается страница Google, которая предоставляет приложению ONLYOFFICE доступ к данным со следующей областью действия:

• https://www.googleapis.com/auth/drive
• https://www.googleapis.com/auth/userinfo.profile
• https://www.googleapis.com/auth/userinfo.email

С этой областью действия приложение ONLYOFFICE может:

• просматривать, создавать, редактировать и удалять все файлы на Google Drive;
• просматривать вашу личную информацию, в том числе ту, которую вы сделали общедоступной;
• просматривать ваш адрес электронной почты.

Приложение ONLYOFFICE Personal запрашивает данные пользователя с помощью запроса people.get. ONLYOFFICE Personal ищет в своей базе данных соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором профиля пользователя в ONLYOFFICE. Если соответствие найдено, пользователь входит под этим профилем ONLYOFFICE Personal.

Если соответствие не найдено, создается новый профиль с именем и адресом электронной почты пользователя Google, а в базе данных ONLYOFFICE Personal сохраняется соответствие между идентификатором и адресом электронной почты пользователя в Google и идентификатором нового профиля в ONLYOFFICE. В базе данных ONLYOFFICE также хранится полученный ключ авторизации, необходимый для дальнейших запросов к Drive API. Используются следующие методы:

• создание файла;
• скачивание файла;
• обновление файла.

Политика конфиденциальности

В следующем документе описано, как приложение ONLYOFFICE запрашивает, использует и хранит ваши пользовательские данные Google.

Открыть документ с политикой конфиденциальности