Como o ONLYOFFICE lida com os dados de usuário do Google
Aplicativo
Os portais do ONLYOFFICE interagem com o Google enviando solicitações à Google API oficial por meio do protocolo de autorização OAuth 2.0. Para funcionar de acordo com esse protocolo, o aplicativo ONLYOFFICE (api-project-948651087073) foi criado no Google API Console. Os seguintes serviços estão conectados a ele: Google Drive API, People API, Contacts API.
Para o aplicativo ONLYOFFICE, foram geradas chaves de autorização com a URL de redirecionamento https://service.onlyoffice.com/oauth2.aspx. Quando um usuário entra no ONLYOFFICE com o Google, o código de autorização é solicitado e o endereço da página atual do usuário é passado no parâmetro state.
Após o redirecionamento para a Google API, a URL https://service.onlyoffice.com/oauth2.aspx redireciona automaticamente para a página especificada no parâmetro state. Isso é necessário porque os endereços e domínios que o aplicativo ONLYOFFICE usará não são conhecidos de antemão.
Tratamento dos dados de usuário do Google nos portais do ONLYOFFICE
Login
Conectando o Google a um perfil de usuário
Para entrar no portal do ONLYOFFICE com o Google usando um perfil de usuário existente, o usuário vincula sua conta do Google à sua conta do ONLYOFFICE.
Na página de perfil de usuário do ONLYOFFICE, a seção Login via Redes Sociais tem um botão do Google:
Ao clicar nesse botão, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o seguinte escopo:
Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver suas informações pessoais, incluindo as informações pessoais que você tornou públicas;
- ver seu endereço de e-mail.
Essa ação usa a solicitação people.get. O banco de dados do ONLYOFFICE armazena a correspondência entre o identificador e o endereço de e-mail do usuário no Google e o identificador do perfil de usuário no ONLYOFFICE.
Entrando em um portal
A página de autorização dos portais do ONLYOFFICE tem um botão para entrar com o Google:
Ao clicar nesse botão, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o seguinte escopo:
Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver suas informações pessoais, incluindo as informações pessoais que você tornou públicas;
- ver seu endereço de e-mail.
Essa ação usa a solicitação people.get. O ONLYOFFICE procura em seu banco de dados a correspondência entre o identificador e o endereço de e-mail do usuário no Google e um identificador de perfil de usuário no ONLYOFFICE. Se encontrar, o usuário entra com esse perfil do ONLYOFFICE.
Entrando no site do ONLYOFFICE
A página de login do site do ONLYOFFICE tem um botão para entrar com o Google:
Ao clicar nesse botão, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o seguinte escopo:
Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver suas informações pessoais, incluindo as informações pessoais que você tornou públicas;
- ver seu endereço de e-mail.
Essa ação usa a solicitação people.get. O ONLYOFFICE procura em todos os portais a correspondência entre o identificador e o endereço de e-mail do usuário no Google e um identificador de perfil de usuário no ONLYOFFICE. Se encontrar, o usuário entra nesse portal com esse perfil do ONLYOFFICE.
Entrando no ONLYOFFICE Personal
A seção Login do ONLYOFFICE Personal tem um botão para entrar com o Google:
Ao clicar nesse botão, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o seguinte escopo:
Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver suas informações pessoais, incluindo as informações pessoais que você tornou públicas;
- ver seu endereço de e-mail.
Essa ação usa a solicitação people.get. O ONLYOFFICE procura em seu banco de dados a correspondência entre o identificador e o endereço de e-mail do usuário no Google e um identificador de perfil de usuário no ONLYOFFICE. Se encontrar, o usuário entra com esse perfil do ONLYOFFICE.
Se não encontrar, um novo perfil é criado com o nome de usuário e o endereço de e-mail do Google, e o banco de dados do ONLYOFFICE armazena a correspondência entre o identificador e o endereço de e-mail do usuário no Google e o identificador do novo perfil no ONLYOFFICE.
Importação de usuários
Você pode adicionar vários perfis de usuário ao seu portal do ONLYOFFICE de uma só vez importando contatos do Google. Para saber como, consulte Importando usuários do Google.
No módulo Pessoas, a opção Importar Pessoas tem um botão para selecionar o Google como fonte das informações de contato:
Ao clicar nesse botão, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o escopo https://www.googleapis.com/auth/contacts.readonly. Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver e baixar seus contatos.
Essa ação usa a solicitação Recuperação de todos os contatos. O ONLYOFFICE cria novos perfis de usuário no portal a partir dos nomes e endereços de e-mail dos seus contatos do Google.
Google Drive
Você pode conectar sua conta do Google Drive ao módulo Documentos para gerenciar e editar os documentos armazenados no Google Drive com os editores do ONLYOFFICE. Para saber como, consulte Conectando serviços de terceiros.
No módulo Documentos, a legenda Adicionar conta tem um botão para selecionar o Google Drive:
Ao clicar nesse botão, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o escopo https://www.googleapis.com/auth/drive. Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver, editar, criar e excluir todos os seus arquivos do Google Drive.
O banco de dados do ONLYOFFICE armazena apenas a chave de autorização recebida, necessária para solicitações posteriores. As ações são realizadas com a Google APIs Client Library.
Os seguintes métodos são usados:
- obter a lista de arquivos;
- criar um arquivo;
- excluir um arquivo;
- atualizar, renomear e mover um arquivo;
- copiar um arquivo;
- obter o tamanho máximo de arquivo para upload.
Outros casos de uso dos dados de usuário do Google no ONLYOFFICE
Os usuários podem abrir e editar documentos com os editores online do ONLYOFFICE diretamente no Google Drive usando o aplicativo ONLYOFFICE Personal. Para isso, foi criado o aplicativo ONLYOFFICE Personal (api-project-438840568076).
No Google Drive, conecte o aplicativo ONLYOFFICE Personal pelo botão Novo (Novo > Mais > Conectar mais apps) ou pelo menu de contexto do arquivo (Abrir com > Conectar mais apps):
Depois que o aplicativo ONLYOFFICE Personal é conectado ao Google Drive, uma opção de criação de arquivos é adicionada à lista (Novo > Mais > ONLYOFFICE Personal):
A opção também é adicionada ao menu de contexto do arquivo (Abrir com > ONLYOFFICE Personal):
A opção está disponível para os seguintes formatos:
- os arquivos docx, pptx, xlsx, ppsx são abertos com o ONLYOFFICE Personal por padrão ao clicar no nome do arquivo;
- os arquivos 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 são abertos com o ONLYOFFICE Personal pelo menu de contexto.
Tanto ao criar um novo arquivo quanto ao abrir um arquivo existente com o aplicativo ONLYOFFICE Personal, abre-se uma página do Google que concede ao aplicativo ONLYOFFICE acesso aos dados com o seguinte escopo:
- https://www.googleapis.com/auth/drive
- https://www.googleapis.com/auth/userinfo.profile
- https://www.googleapis.com/auth/userinfo.email
Com esse escopo, o aplicativo ONLYOFFICE pode:
- ver, criar, editar e excluir todos os arquivos do Google Drive;
- ver suas informações pessoais, incluindo as informações pessoais que você tornou públicas;
- ver seu endereço de e-mail.
O aplicativo ONLYOFFICE Personal solicita os dados do usuário com a solicitação people.get. O ONLYOFFICE Personal procura em seu banco de dados a correspondência entre o identificador e o endereço de e-mail do usuário no Google e um identificador de perfil de usuário no ONLYOFFICE. Se encontrar, o usuário entra com esse perfil do ONLYOFFICE Personal.
Se não encontrar, um novo perfil é criado com o nome de usuário e o endereço de e-mail do Google, e o banco de dados do ONLYOFFICE Personal armazena a correspondência entre o identificador e o endereço de e-mail do usuário no Google e o identificador do novo perfil no ONLYOFFICE. O banco de dados do ONLYOFFICE também armazena a chave de autorização recebida, necessária para solicitações posteriores à Drive API. Os seguintes métodos são usados:
- criar um arquivo;
- baixar um arquivo;
- atualizar um arquivo.
Política de Privacidade
O documento a seguir descreve como o aplicativo ONLYOFFICE solicita, usa e armazena seus dados de usuário do Google.