Autenticação do Microsoft OneDrive e do SharePoint

Conecte a UiPath ao Microsoft OneDrive e SharePoint usando Certificado de Cliente, Credenciais do Cliente OAuth 2.0 ou outros métodos compatíveis no Automation Suite.

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:

• Autenticação de Certificado do Cliente – conecta-se usando um certificado do cliente em vez de um segredo do cliente.
• 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ê cria.

Ao registrar seu aplicativo no Microsoft Azure, use o tipo de permissão que corresponde ao seu método de autenticação:

Tipo de Autenticação	Tipo de permissão da Microsoft
CertificateAuthentication do Cliente	Aplicativo
Credenciais do cliente OAuth 2.0	Aplicativo
Traga seu próprio aplicativo OAuth 2.0	Delegado

Consentimento do administrador

Observação:

Esta seção aplica-se apenas às opções de autenticação de aplicativo Traga seu próprio 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 de 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 de consentimento do administrador e Consentimento de usuários e administradores no Microsoft Entra 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 ele tem no aplicativo fornecido. Se você compartilhar a conexão, todas as alterações feitas no Microsoft SharePoint ou OneDrive com essa conexão serão feitas em nome desse usuário.

CertificateAuthentication do Cliente

Escopos

O conector requer os seguintes escopos mínimos para criar uma conexão: User.Read.All ou User.Read, Files.Read.

O conector requer o seguinte conjunto completo de escopos para que todas as atividades funcionem: 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 e User.Read.

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

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. Na Automation Cloud, selecione Integration Service no trilho.
2. Na lista Conectores , selecione Microsoft OneDrive e SharePoint ou use a barra de pesquisa para encontrar o conector.
3. Selecione Conectar ao Microsoft OneDrive e SharePoint, que redireciona você para a página de conexão.
4. Selecione o tipo de autenticação Autenticação do certificado do cliente .
5. Configure os campos a seguir:
   • ID do cliente - O ID na seção Visão geral do seu registro de aplicativo do Microsoft Azure.
   • Senha para o certificado - a senha que você define durante a criação do certificado.
   • Certificado do cliente base64 do OAuth - O certificado do cliente é gerado em um formato de arquivo .pfx , que você deve converter para o formato codificado Base64 e fornecê-lo neste campo.
   • ID do tenant - O ID do tenant do Microsoft Azure para um aplicativo na seção Visão geral do registro do seu aplicativo Microsoft Azure.
   • Ambiente - opcionalmente, selecione um ambiente na lista suspensa:
     • Office 365 (padrão)
     • Governo dos EUA L4 - Domínio do Setor público
     • Governo dos EUA L5 - Domínio do Setor público
     • ChinaSelecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem. Para obter mais detalhes sobre ambientes, consulte Pontos de extremidade raiz de serviço do Microsoft Graph e do Graph Explorer.
   • Conta - Insira o nome principal do usuário (UPN) da conta ou caixa de correio compartilhada que o sistema deve usar na conexão. Isso é necessário para que a conexão seja estabelecida.
6. Select Connect.
7. Autentique com seu endereço de e-mail e senha da Microsoft.

Credenciais do cliente OAuth 2.0

Escopos

O conector requer os seguintes escopos mínimos para criar uma conexão: Files.Read.

O conector requer o seguinte conjunto completo de escopos para que todas as atividades funcionem: 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 e User.Read.

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

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. Na Automation Cloud, selecione Integration Service no trilho.
2. Na lista Conectores , selecione Microsoft OneDrive e SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione Conectar ao Microsoft OneDrive e SharePoint, que redireciona você para a página de conexão.
4. Insira as credenciais necessárias. Você deve fornecer um ID do cliente e Segredo do cliente, o ID do tenant e os Escopos de que pode precisar para interagir com diferentes atividades. Verifique a documentação de atividades para saber quais escopos elas exigem. Se você estiver usando um aplicativo com vários tenants, mantenha o valor padrão para o ID do tenant (common). Se você estiver usando um aplicativo de tenant único, recupere o ID do tenant do Azure. Consulte Como encontrar seu ID de tenant do Microsoft Entra.

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:

Essa é 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://{yourDomain}/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 permissões dependendo de suas necessidades reais. Para saber quais escopos são necessários para cada atividade no pacote Microsoft 365, consulte Trabalhando 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

• O conector requer os seguintes escopos mínimos para criar uma conexão: openid, offline_access, User.Read.All ou User.Read, Files.Read.
• Os gatilhos do OneDrive exigem os seguintes escopos mínimos:
  • 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.

O conector requer o seguinte conjunto completo de escopos para que todas as atividades funcionem: 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 e User.Read.

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

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. Na Automation Cloud, selecione Integration Service no trilho.
2. Na lista Conectores , selecione Microsoft OneDrive e SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione Conectar ao Microsoft OneDrive e SharePoint, que redireciona você para a página de conexão.
4. Insira as credenciais necessárias. Você deve fornecer um ID do cliente e Segredo do cliente, o ID do tenant e os Escopos de que pode precisar para interagir com diferentes atividades. Verifique a documentação de atividades para saber quais escopos elas exigem. Se você estiver usando um aplicativo com vários tenants, mantenha o valor padrão para o ID do tenant (common). Se você estiver usando um aplicativo de tenant único, recupere o ID do tenant do Azure. Consulte Como encontrar seu ID de tenant do Microsoft Entra.

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 detalhes, consulte a documentação oficial da Microsoft.

AVISO:

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.

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.