Autenticação Microsoft OneDrive e SharePoint

Pré-requisitos

Você precisa das seguintes credenciais:

• Traga seu próprio aplicativo OAuth 2.0: ID do cliente do aplicativo e segredo do cliente, escopos e ID do tenant

Ambiente

Quando você acessa pela primeira vez a tela Autenticação, você pode selecionar um Ambiente. As opções disponíveis são:

• Office 365 (padrão)
• Governança dos EUA L4 — Domínio do setor público
• Governador dos EUA L5 - Domínio do setor público
• China

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

Consentimento do administrador

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

Escopos

O conector solicita as seguintes permissões/escopos:

• Traga seu próprio aplicativo OAuth 2.0:
  • Escopos mínimos para criar uma conexão: openid, offline_access, User.Read.All, Files.Read.
  • Lista mínima de escopos necessários para gatilhos do OneDrive:
    • openid, offline_access, User.Read.All, 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.

Observação:

Se você se autenticar usando seu próprio aplicativo OAuth 2.0, você se beneficiará, por padrão, dos escopos configurados na criação do aplicativo. Se você quiser usar as permissões de aplicativo padrão, você pode declarar um escopo common . Isso significa que você usa apenas as permissões configuradas para esse aplicativo no Azure. Você também pode declarar escopos adicionais na criação de conexão, usando o campo Escopos . Em seguida, você precisará conceder o consentimento adicional durante o login.

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 Integration Service do Automation Suite.

2. Na lista Conectores , selecione Microsoft OneDrive & SharePoint. Você também pode usar a barra de pesquisa para restringir o conector.

3. Selecione o botão Conectar ao Microsoft OneDrive & SharePoint.

4. Você será redirecionado para a página de conexão.

   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 você pode precisar para interagir com diferentes atividades. Verifique a documentação das atividades para ver quais escopos elas exigem. Se você estiver usando um aplicativo multitenant, mantenha o valor padrão para o ID do tenant (common). Se você estiver usando um único aplicativo de tenant, recupere o ID do Tenant a partir do Azure. Consulte Como encontrar seu ID de tenant do Microsoft Entra.

5. Sua conexão foi adicionada.

Traga seu próprio aplicativo OAuth 2.0

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

1. Você deve configurar o aplicativo como um aplicativo de Multitenant ou Tenant único .
2. Você deve configurar um aplicativo da Web .
3. Você deve configurar 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.

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.

Importante:

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 melhores práticas 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.