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:

• Client Certificate Authentication – connects using a client certificate instead of a client secret.
• Código de autorização OAuth 2.0 – conecta-se ao aplicativo público da UiPath.
• OAuth 2.0 Client credentials - connects using a service account.
• 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

The connector requires the following minimum scopes to create a connection: Files.Read.

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint, or use the search bar to find the connector.
3. Select Connect to Microsoft OneDrive and SharePoint, which redirects you to the connection page.
4. Select the Client Certificate Authentication authentication type.
5. Configure os campos a seguir:

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Password for the certificate - The password you set during the certificate creation.

   • OAuth base64 client certificate - The client certificate is generated in a .pfx file format, which you must convert to Base64-encoded format and provide it in this field.

   • Tenant ID - You can find the Microsoft Azure tenant ID for an app in the Overview section of your Microsoft Azure application registration.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (padrão)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Observação:

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

   • Account - Enter the user principal name (UPN) of the account or shared mailbox that the system should use in the connection. This is required for the connection to be established.

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

The connector requires the following minimum scopes to create a connection: openid, offline_access, email, and Files.Read.

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. Selecione o tipo de autenticação de código de autorização OAuth 2.0 .
5. Configure o seguinte:
   • Scope - Optionally, add or remove permissions for your connector.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (padrão)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     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

The connector requires the following minimum scopes to create a connection: Files.Read.

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. Selecione o tipo de autenticação Credenciais do cliente OAuth 2.0 .
5. Configure o seguinte:

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.

   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (padrão)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     Observação:

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

   • Account - Provide the account used to impersonate a user.

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

• The connector requires the following minimum scopes to create a connection: openid, offline_access, email, and Files.Read.
• OneDrive triggers require the following minimum scopes:
  • For events on SharePoint sites: openid, offline_access, and User.Read.All or User.Read and Sites.Read.All.
  • For events on groups and calendars: Group.Read.All
  • For all the remaining event types: Files.Read.All

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. Selecione o tipo de autenticação Trazer seu próprio aplicativo OAuth 2.0 .
5. Configure o seguinte:
   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.
   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.
   • Scope - Optionally, add or remove permissions for your connector.
   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.
     Observação:

     • If you use a multi-tenant application, keep the default value common.
     • If you use a single-tenant application, retrieve the tenant ID from Azure. For more details, check How to find your Microsoft Entra tenant ID.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (padrão)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     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.