Autenticação do Google Drive

Pré-requisitos

Dependendo do tipo de autenticação selecionado, você precisará de uma das seguintes credenciais:

• Código de autorização do OAuth 2.0 - conecta-se ao aplicativo público da UiPath com seu endereço de e-mail do Google e a senha associada à sua conta do Google.
• Traga seu próprio aplicativo OAuth 2.0 — conecta-se a um aplicativo privado que você cria.
• Conta de serviço do Google - conecta-se usando a chave da conta de serviço e o e-mail da conta.

Observação:

Para obter mais detalhes sobre os diferentes tipos de autenticação, consulte Como se conectar às atividades do Google Workspace 365.

Depois de autenticado, você pode usar a conexão para acessar as diferentes funcionalidades que o Google Drive oferece.

Se o Google não tiver habilitado sua conta:

• Entre em contato com o administrador para obter aprovações sobre a criação de conexões.
• Habilite a permissão marcando as opções disponíveis para permitir a criação de uma conexão.

Para obter mais detalhes sobre o Google Drive, consulte a documentação do desenvolvedor do Google Drive.

Código de autorização do OAuth 2.0

Escopos

• Escopos obrigatórios: openid e https://www.googleapis.com/auth/drive.
• Escopos padrão: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/userinfo.profile, e https://www.googleapis.com/auth/drive.

Para adicionar permissões mais granulares, consulte a documentação de atividades do Google.

A conexão permite que os produtos da UiPath interajam com os dados do Google Drive em seu nome. Isso pode incluir dados de leitura, gravação, modificação e exclusão, dependendo das permissões do seu Google Drive. Você sempre pode remover qualquer acesso em sua Conta do Google.

Como adicionar a conexão do Google Drive

Para criar uma conexão com seu Google Drive, execute as seguintes etapas:

1. Na Automation Cloud, selecione Integration Service no menu trilho.
2. Na lista Conectores , selecione Google Drive. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Google Drive , que redireciona você para a página de conexão.
4. No menu suspenso Tipo de autenticação , selecione Código de autorização do OAuth 2.0.
5. Select Connect.

Traga seu próprio aplicativo OAuth 2.0

O tipo de autenticação Traga seu próprio aplicativo OAuth 2.0 permite que você conecte a UiPath ao Google Drive usando um aplicativo OAuth personalizado. Você pode criar e gerenciar esse aplicativo personalizado no Console do Google Cloud, em vez do aplicativo público padrão da UiPath. Isso dá a você maior controle sobre consentimento, escopos e políticas de segurança e ajuda a evitar limites de token de atualização associados a IDs do cliente do OAuth compartilhados.

Observação:

Ao registrar seu aplicativo OAuth no Google, certifique-se de definir o URL de retorno de chamada com o valor exibido na página de criação da conexão, como por exemplo, https://cloud.uipath.com/provisioning_/callback para o Automation Cloud.

Escopos

Escopos obrigatórios: openid e https://www.googleapis.com/auth/drive.

Observação:

Se você se autenticar usando seu próprio aplicativo OAuth 2.0, você se beneficiará, por padrão, dos escopos configurados na criação do aplicativo. Se você quiser usar as permissões de aplicativo padrão, você pode declarar um escopo common . Isso significa que você usa apenas as permissões configuradas para esse aplicativo. Você também pode declarar escopos adicionais na criação de conexão, usando o campo Escopos . Em seguida, você precisará conceder o consentimento adicional durante o login.

Para adicionar permissões mais granulares, consulte a documentação de atividades do Google.

A conexão permite que os produtos da UiPath interajam com os dados do Google Drive em seu nome. Isso pode incluir dados de leitura, gravação, modificação e exclusão, dependendo das permissões do seu Google Drive. Você sempre pode remover qualquer acesso em sua Conta do Google.

Como adicionar a conexão do Google Drive

Para criar uma conexão com seu Google Drive, execute as seguintes etapas:

1. Na Automation Cloud, selecione Integration Service no menu trilho.

2. Na lista Conectores , selecione Google Drive. Você também pode usar a barra de pesquisa para restringir o conector.

3. Selecione o botão Conectar ao Google Drive , que redireciona você para a página de conexão.

4. No menu suspenso Tipo de autenticação , selecione Trazer seu próprio aplicativo OAuth 2.0.

5. Configure o seguinte:

   • ID do cliente - O ID do cliente da seção IDs do cliente do OAuth 2.0 em suas credenciais do Console do Google Cloud.
   • Segredo do cliente - O segredo do cliente de suas credenciais do Console do Google Cloud.

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

6. Select Connect.

Conta de Serviço do Google

Escopos

• Escopos obrigatórios: https://www.googleapis.com/auth/drive
• Escopos padrão: https://www.googleapis.com/auth/drive

Para adicionar permissões mais granulares, consulte a documentação de atividades do Google.

A conexão permite que os produtos da UiPath interajam com os dados do Google Drive em seu nome. Isso pode incluir dados de leitura, gravação, modificação e exclusão, dependendo das permissões do seu Google Drive. Você sempre pode remover qualquer acesso em sua Conta do Google.

Como adicionar a conexão do Google Drive

Para criar uma conexão com seu Google Drive, execute as seguintes etapas:

1. Na Automation Cloud, selecione Integration Service no menu trilho.

2. Na lista Conectores , selecione Google Drive. Você também pode usar a barra de pesquisa para restringir o conector.

3. Selecione o botão Conectar ao Google Drive , que redireciona você para a página de conexão.

4. No menu suspenso Tipo de autenticação , selecione Conta de serviço do Google.

5. Configure o seguinte:

   • Chave da conta de serviço – Cole o arquivo completo da chave JSON baixada do Console do Google Cloud para sua conta de serviço. Para obter mais detalhes, consulte Criar uma chave de conta de serviço na documentação oficial do Google.
   • E-mail da conta - O e-mail da conta de serviço, por exemplo, [e-mail].
     Observação:

     Se você representar um usuário usando a delegação de todo o domínio, forneça o e-mail do usuário para representar e certifique-se de que a delegação de todo o domínio esteja configurada no Console do administrador.

   For any secret-type field, you can select the menu next to the field and choose Use credential asset to reference an Orchestrator credential asset linked to an external vault instead of entering the value directly. For more information, see Use credential assets for connections.

6. Select Connect.

Tokens de atualização para aplicativos OAuth

O Google tem limitações de token de atualização para IDs individuais do cliente do OAuth 2.0. Se o limite for atingido, a criação de um novo token de atualização invalidará automaticamente o token de atualização mais antigo sem aviso. Esse limite não se aplica a contas de serviço. Para obter mais detalhes, consulte Uso do OAuth 2.0 para aplicativos de servidor para servidor e a documentação oficial do Google.

Uma lista de motivos que podem causar a expiração do token:

• Você revogou o acesso do seu aplicativo.
• O token de atualização não é usado há seis meses.
• Você precisa alterar senhas e o token de atualização contém escopos do Gmail.
• Sua conta excedeu o número máximo de tokens de atualização (ativos) concedidos.
  • Se você solicitar um novo token depois que o limite for excedido, sua conexão antiga, com base em um token concedido anteriormente, expirará. Apenas a nova conexão ou a conexão mais recente editada ou reautenticada (com o token mais recente) funcionará.
• Um administrador definiu qualquer um dos serviços solicitados nos escopos do seu aplicativo como Restrito (o erro é admin_policy_enforced).
• Para APIs do Google Cloud Platform, a duração da sessão que o conjunto do administrador pode ter sido excedido.

Observação:

O limite está atualmente definido como 100 tokens de atualização por conta do Google por ID do cliente do OAuth 2.0. Este número pode estar sujeito a alterações. Para obter as informações mais recentes, sempre verifique a documentação oficial do Google.

Há um limite maior para o número total de tokens de atualização que uma conta de usuário ou conta de serviço pode ter em todos os clientes. Usuários regulares não excederão esse limite, mas uma conta de desenvolvedor usada para testar uma implementação pode.

Para garantir que esse limite não seja excedido, a UiPath oferece aos usuários a capacidade de criar seus próprios aplicativos OAuth e se conectar usando o tipo de autenticação Traga seu próprio aplicativo. Certifique-se de seguir as práticas recomendadas do Google ao criar seu aplicativo OAuth. Para obter detalhes sobre como criar um aplicativo OAuth, consulte a documentação oficial do Google.

Observação:

A invalidação de tokens resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.