Autenticação do Microsoft OneDrive e do SharePoint

Visão geral

No Integration Service, ao criar uma conexão com um de nossos conectores baseados no Microsoft Graph, você pode escolher entre as seguintes opções de autenticação:

• Código de autorização do OAuth 2.0 – conecta-se ao aplicativo público do UiPath.
• Credenciais do cliente OAuth 2.0 - usa uma conta de serviço.
• Traga seu próprio aplicativo OAuth 2.0 – Conecta-se a um aplicativo privado que você criar.

Observação: para obter mais detalhes sobre os diferentes tipos de autenticação, consulte o guia Como conectar-se às atividades Microsoft 365 .

Consentimento do administrador

Observação: esta seção se aplica apenas ao código de autorização do OAuth 2.0 e às opções de autenticação Traga seu próprio aplicativo OAuth 2.0 .

Muitas organizações exigem o consentimento de um administrador antes de criar uma conexão com um aplicativo externo. O fluxo de trabalho com consentimento do administrador requer que um administrador aprove o registro do aplicativo para usuários ou grupos específicos antes que uma conexão seja estabelecida. Para obter mais detalhes, consulte Visão geral do fluxo de trabalho do consentimento do administrador e Consentimento do usuário e do administrador no Microsoft Entrada ID na documentação da Microsoft.

Observação: o Integration Service representa o usuário que cria a conexão. As credenciais do usuário oferecem acesso a todos os mesmos recursos que eles têm no aplicativo em questão. Se você compartilhar a conexão, cada alteração feita no Microsoft SharePoint ou OneDrive com essa conexão será feita em nome desse usuário.

Código de autorização do OAuth 2.0

Escopos

O conector solicita as seguintes permissões ou escopos: offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All ou User.Read.

Adicionando a conexão do Microsoft OneDrive e do SharePoint

Para criar uma conexão com sua instância do Microsoft OneDrive e SharePoint, execute as seguintes etapas:

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Microsoft OneDrive e SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Microsoft OneDrive e SharePoint .
4. Você será redirecionado para a página de conexão.
5. Selecione o tipo de autenticação do código de Autorização OAuth 2.0 .
6. Adicione as permissões necessárias no campo Escopo .
7. Selecione um ambiente na lista suspensa: Office 365 (padrão), US Government L4 - domínio do setor público, US Government L5 - domínio do setor público ou China.
   Observação: para obter mais detalhes sobre ambientes, consulte Pontos de extremidade da raiz do serviço do Microsoft Graph e do Graph Explorer.
8. Selecione Conectar e autentique com seu endereço de e-mail e senha da Microsoft.

Tokens de atualização para aplicativos OAuth

Os tokens de atualização para aplicativos OAuth podem ser invalidados ou revogados a qualquer momento pela Microsoft. Isso pode acontecer por diferentes motivos, como tempos limite e revogação. Para obter mais detalhes, consulte a documentação oficial da Microsoft.

Aviso: a invalidação do token resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.

Certifique-se de seguir as práticas recomendadas da Microsoft ao criar seus aplicativos OAuth. Para obter detalhes completos sobre como criar um aplicativo Microsoft OAuth, consulte a documentação da Microsoft.

Esse problema afeta não apenas o conector do OneDrive e do SharePoint, mas todos os conectores baseados no Microsoft Graph, como o Outlook ou o Teams.

Credenciais do cliente OAuth 2.0

Escopos

Escopos mínimos para criar uma conexão: User.Read.All ou User.Read, Files.Read.

Adicionando a conexão do Microsoft OneDrive e do SharePoint

Para criar uma conexão com sua instância do Microsoft OneDrive e SharePoint, execute as seguintes etapas:

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Microsoft OneDrive e SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Microsoft OneDrive e SharePoint .
4. Você será redirecionado para a página de conexão.
5. Selecione o tipo de autenticação Credenciais do cliente OAuth 2.0 .
6. Preencha e configure os seguintes campos: ID do cliente, Segredo do cliente, ID do tenant, Ambiente e Conta (forneça a conta usada para representar um usuário).
7. Selecione Conectar.

Traga seu próprio aplicativo OAuth 2.0

Visão geral

Para saber como criar um aplicativo, consulte a documentação oficial da Microsoft: Registre um aplicativo com a plataforma de identidade da Microsoft.

Observação: esta é uma funcionalidade avançada e requer privilégios de administrador no aplicativo de destino. Trabalhe com seu administrador de TI para configurar seu aplicativo com sucesso.

Requisitos

Ao criar seu próprio aplicativo para usar com o Integration Service, certifique-se de atender aos seguintes requisitos:

1. Configure o aplicativo como um aplicativo de vários tenants ou de tenant único .
2. Configure um aplicativo da Web .
3. Configure um URI de redirecionamento da Web . O URI de redirecionamento (ou URL de retorno de chamada) para seu aplicativo OAuth 2.0 é fornecido na tela de autenticação ao criar uma conexão: https://cloud.uipath.com/provisioning_/callback.
4. Você deve configurar permissões delegadas. Para obter mais informações, consulte Permissões na documentação oficial da Microsoft.
5. Gere um segredo do cliente para seu aplicativo.

Importante: a vantagem de usar seu aplicativo OAuth privado é que você pode personalizar as permissões dependendo de suas necessidades reais. Para saber quais escopos são necessários para cada atividade no pacote Microsoft 365, consulte Trabalhar com escopos e verifique a documentação das atividades .

O conector usa a API do Microsoft Graph. Consulte a página de referência de permissões do Microsoft Graph para obter detalhes sobre todas as permissões.

Após criar seu aplicativo, use sua ID do cliente e Segredo do cliente para criar uma conexão com os conectores da Microsoft.

Escopos

• Escopos mínimos para criar uma conexão: openid, offline_access, User.Read.All ou User.Read, Files.Read.
• Lista mínima de escopos necessários para gatilhos do OneDrive:
  • openid, offline_access, User.Read.All ou User.Read, Sites.Read.All – para eventos em sites do SharePoint.
  • Group.Read.All – para eventos em grupos e calendários.
  • Files.Read.All – para todos os tipos de eventos restantes.

Adicionando a conexão do Microsoft OneDrive e do SharePoint

Para criar uma conexão com sua instância do Microsoft OneDrive e SharePoint, execute as seguintes etapas:

1. Selecione Integration Service no menu de navegação esquerdo.
2. Na lista Conectores , selecione Microsoft OneDrive e SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Microsoft OneDrive e SharePoint .
4. Você será redirecionado para a página de conexão.
5. Selecione o tipo de autenticação Traga seu próprio aplicativo OAuth 2.0 .
6. Preencha e configure os seguintes campos: ID do Cliente, Segredo do Cliente, Escopo, ID do Tenant e Ambiente.
   Observação:

   • Para Escopo, adicione as permissões que você pode precisar para interagir com diferentes atividades. Confira a documentação das atividades para saber quais escopos elas exigem.
   • Se você estiver usando um aplicativo de vários tenants, mantenha o valor padrão para o ID do tenant (common). Se você estiver usando um aplicativo de tenant único, recupere a ID do tenant do Azure. Consulte Como localizar seu ID de tenant do Microsoft Entrada.
7. Selecione Conectar.

Tokens de atualização para aplicativos OAuth

Os tokens de atualização para aplicativos OAuth podem ser invalidados ou revogados a qualquer momento pela Microsoft. Isso pode acontecer por diferentes motivos, como tempos limite e revogação. Para obter mais detalhes, consulte a documentação oficial da Microsoft.

Aviso: a invalidação do token resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.

Certifique-se de seguir as práticas recomendadas da Microsoft ao criar seus aplicativos OAuth. Para obter detalhes completos sobre como criar um aplicativo Microsoft OAuth, consulte a documentação da Microsoft.

Esse problema afeta não apenas o conector do OneDrive e do SharePoint, mas todos os conectores baseados no Microsoft Graph, como o Outlook ou o Teams.