Autenticação Microsoft OneDrive e SharePoint

Pré-requisitos

Dependendo do tipo de autenticação selecionado, você precisa fazer uma das seguintes ações:

• O endereço de email e a senha da sua conta da Microsoft.
• Your application's Client ID and Client secret, Scopes and Tenant ID.

Além disso, você deve conceder permissões para que apps de terceiros acessem suas informações. Para qualquer erro, entre em contato com o administrador do Microsoft OneDrive & SharePoint.

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, todas as alterações feitas no Microsoft SharePoint ou OneDrive com essa conexão serão feitas em nome desse usuário.

When you first access the Authentication screen, you can select an Environment. The available options are:

Conceda permissões para aplicativos de terceiros

Antes de estabelecer a conexão, certifique-se de que as permissões sejam concedidas para aplicativos integrados do centro de administração:

1. Faça login no centro de administração do Microsoft 365.

2. Acesse Configurações e selecione Configurações da organização .

   
   

   

   
   

3. Na guia Serviços , selecione Consentimento do usuário para aplicativos.

   
   

   

   
   

4. Certifique-se de que a caixa de seleção Permitir que os usuários forneçam consentimento quando os aplicativos solicitarem acesso aos dados da sua organização em seu nome esteja habilitada e selecione Salvar.

   
   

   

   
   

Escopos

The following scopes are requested by the connector: 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.

This represents the full list of required scopes.

Observação: trabalhe com sua equipe de TI para permitir esses privilégios para seu usuário e aplicativo.

Adicionar a conexão do Microsoft OneDrive e SharePoint

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

1. Selecione o Integration Service a partir do Automation Cloud.
2. Na lista de Conectores , selecione Microsoft OneDrive e SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Adicionar conexão .
4. Agora, você é redirecionado para a página de conexão. É possível escolher entre dois tipos de autenticação: Código de autorização do OAuth 2.0 ou Traga seu próprio aplicativo do OAuth 2.0.
   • Se você selecionar o código de autorização do OAuth 2.0, clique em Conectar e, então, autentique usando seu endereço de e-mail e senha da Microsoft.
   • If you select Bring your own OAuth 2.0 app, you must provide a Client ID and Client secret, the Tenant ID, and the Scopes you may need to interact with different activities. Check out the activities' documentation to see what scopes they require.
     Note: If you are using a multitenant application, leave the Tenant ID field blank. If you are using a single tenant application, retrieve the Tenant ID from Azure.
   
   

   

   
   
5. Sua conexão foi adicionada.

Traga seu próprio aplicativo OAuth 2.0

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

• Código de autorização do OAuth 2.0 — que se conecta ao aplicativo público do UiPath.
• Traga seu próprio aplicativo OAuth 2.0 – que se conecta a um aplicativo privado que você cria.

Para saber como criar um aplicativo, acesse a documentação oficial da Microsoft e siga as etapas descritas: 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, você deve considerar os seguintes requisitos:

1. You must configure the application as a Multitenant or Single tenant application.
2. You must configure a Web Redirect URI. The Redirect URI (or callback URL) for your OAuth 2.0 application is provided in the authentication screen when creating a connection: https://cloud.uipath.com/provisioning_/callback.
3. Você deve configurar permissões delegadas. Para obter mais informações, consulte Permissões na documentação oficial da Microsoft.
   Observação: 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, acesse a documentação de atividades .

Após criar seu aplicativo, use sua ID do cliente e Segredo do cliente para criar uma conexão com os conectores 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 sobre a expiração do token.

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 sobre como criar um aplicativo OAuth 2.0, consulte a documentação da Microsoft.

Observação: esse problema afeta todos os conectores baseados no Microsoft Graph.