Autenticação do Microsoft Outlook 365

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.
• O ID do Cliente do seu aplicativo e Segredo do cliente, Escopos e ID do Tenant.

Além disso, você deve conceder permissões para aplicativos de terceiros acessarem suas informações. Para qualquer erro, entre em contato com o administrador do Microsoft Outlook 365.

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 Outlook com essa conexão é feita em nome desse usuário.

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

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, conforme explicado na documentação oficial da Microsoft: Definir configurações de consentimento do usuário.

Escopos

Os seguintes escopos são solicitados pelo conector: Mail.Read, Mail.Read.Shared, Mail.ReadWrite, Mail.ReadWrite.Shared, Mail.Send, Mail.Send.Shared, MailboxSettings.ReadWrite, Calendars.Read, Calendars.Read.Shared, Calendars.ReadWrite, Calendars.ReadWrite.Shared, profile, openid, email, offline_access, User.Read.

Isso representa a lista completa de escopos exigidos.

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 Outlook 365

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

1. Selecione Integration Service no Automation Cloud^TM Public Sector.

2. Na lista Conectores , selecione Microsoft Outlook 365. Você também pode usar a barra de pesquisa para encontrar o conector.

3. Selecione o botão Conectar ao Microsoft Outlook 365 .
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.
   • Se você selecionar Traga seu próprio aplicativo OAuth 2.0, você deve fornecer um ID do cliente e Segredo do cliente, o ID do Tenant e os Escopos que você pode precisar para interagir com diferentes atividades. Verifique a documentação das atividades para ver quais escopos elas exigem.
     Observação: se você estiver usando um aplicativo multitenant, mantenha o valor padrão para o ID do Tenant (common). Se você estiver usando um aplicativo de tenant único, recupere a ID de Tenant do Azure. Consulte Como localizar seu ID de tenant do Microsoft Entrada.
5. Sua conexão foi adicionada.

Caso você encontre algum erro durante o processo de entrada, é recomendável entrar em contato com o administrador do Microsoft Outlook 365.

Para obter mais informações, consulte a documentação do Conector do Outlook do Office 365.

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. Você deve configurar o aplicativo como um aplicativo de vários tenants ou de tenant único .
2. Você precisa 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://govcloud.uipath.us/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 .

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

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 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.