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:

• Autenticação de Certificado do Cliente – conecta-se usando um certificado do cliente em vez de um segredo do cliente.
• Código de autorização OAuth 2.0 – conecta-se ao aplicativo público da UiPath.
• Credenciais do cliente OAuth 2.0 - conecta-se usando uma conta de serviço.
• Traga seu próprio aplicativo OAuth 2.0 — conecta-se a um aplicativo privado que você cria.

Observação:

Para obter mais detalhes sobre os diferentes tipos de autenticação, consulte o guia Como se conectar às atividades do 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 que traz 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 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 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.

CertificateAuthentication do Cliente

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, 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 menu 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 - Você pode encontrar 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 de cliente OAuth base64 - O certificado do cliente é gerado em um arquivo .pfx .ssp, que você deve converter para o formato codificado em Base64 e fornecê-lo neste campo.

   • ID do tenant - Você pode encontrar 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

     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.

Código de autorização do OAuth 2.0

Escopos

O conector requer os seguintes escopos mínimos para criar uma conexão: openid, offline_access, email, e 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, 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 menu 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 o botão Conectar ao Microsoft OneDrive e SharePoint , que redireciona você para a página de conexão.
4. Selecione o tipo de autenticação de código de autorização OAuth 2.0 .
5. Configure o seguinte:
   • Escopo - Opcionalmente, adicione ou remova permissões para seu conector.
   • 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

     Para obter mais detalhes sobre ambientes, consulte Pontos de extremidade raiz de serviço do Microsoft Graph e do Graph Explorer.

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

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.

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

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, 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 menu 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 o botão Conectar ao Microsoft OneDrive e SharePoint , que redireciona você para a página de conexão.
4. Selecione o tipo de autenticação Credenciais do cliente OAuth 2.0 .
5. Configure o seguinte:

   • ID do cliente - Você pode encontrar o ID na seção Visão geral do seu registro de aplicativo do Microsoft Azure.

   • Segredo do cliente - O segredo do cliente da seção Certificados e segredos de seu aplicativo Microsoft Azure.

   • ID do tenant - O ID do tenant do Microsoft Azure para um aplicativo da seção Visão geral.

   • 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

     Para obter mais detalhes sobre ambientes, consulte Pontos de extremidade raiz de serviço do Microsoft Graph e do Graph Explorer.

   • Conta - Forneça a conta usada para representar um usuário.

6. Select Connect.

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://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 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, email, e Files.Read.
• Os gatilhos do OneDrive exigem os seguintes escopos mínimos:
  • Para eventos em sites do SharePoint: openid, offline_access e User.Read.All ou User.Read e Sites.Read.All.
  • Para eventos em grupos e calendários: Group.Read.All
  • Para todos os tipos de eventos restantes: Files.Read.All

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, 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 menu 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 o botão Conectar ao Microsoft OneDrive e SharePoint , que redireciona você para a página de conexão.
4. Selecione o tipo de autenticação Trazer seu próprio aplicativo OAuth 2.0 .
5. Configure o seguinte:
   • ID do cliente - Você pode encontrar o ID na seção Visão geral do seu registro de aplicativo do Microsoft Azure.
   • Segredo do cliente - O segredo do cliente da seção Certificados e segredos de seu aplicativo Microsoft Azure.
   • Escopo - Opcionalmente, adicione ou remova permissões para seu conector.
   • ID do tenant - O ID do tenant do Microsoft Azure para um aplicativo da seção Visão geral.
     Observação:

     • Se você usar um aplicativo de vários tenants, mantenha o valor padrão comum.
     • Se você usar um aplicativo de tenant único, recupere o ID do tenant do Azure. Para obter mais detalhes, consulte Como encontrar seu ID de tenant do Microsoft Entra.
   • 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

     Para obter mais detalhes sobre ambientes, consulte Pontos de extremidade raiz de serviço do Microsoft Graph e do Graph Explorer.

6. Select Connect.

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.

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.

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.