Autenticação do Microsoft Outlook 365

Conecte a UiPath ao Microsoft Outlook 365 usando Certificado de Cliente, Credenciais do Cliente OAuth 2.0 ou outros métodos compatíveis no Automation Suite.

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.
• Credenciais de cliente OAuth 2.0 – usa uma conta de serviço e, opcionalmente, conecta-se à sua caixa de correio compartilhada.
• Traga seu próprio aplicativo OAuth 2.0 — conecta-se a um aplicativo privado que você cria e, opcionalmente, à sua caixa de correio compartilhada.

Ao registrar seu aplicativo no Microsoft Azure, use o tipo de permissão que corresponde ao seu método de autenticação:

Tipo de Autenticação	Tipo de permissão da Microsoft
CertificateAuthentication do Cliente	Aplicativo
Credenciais do cliente OAuth 2.0	Aplicativo
Traga seu próprio aplicativo OAuth 2.0	Delegado

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.

Consentimento do administrador

Observação:

Esta seção aplica-se apenas às opções de autenticação de aplicativo Traga seu próprio 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: Mail.Read, User.Read.All, ou User.Read.

O conector requer os seguintes escopos para que todas as atividades funcionem: User.Read, User.Read.All, 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, e offline_access.

Para adicionar permissões mais granulares, consulte a documentação das atividades.

Adicionar a conexão do Microsoft Outlook 365

Para criar uma conexão com sua instância do Microsoft Outlook 365, prossiga da seguinte maneira:

1. Na Automation Cloud, selecione Integration Service no menu trilho.
2. Na lista Conectores , selecione Microsoft Outlook 365 ou use a barra de pesquisa para encontrar o conector.
3. Selecione Conectar ao Microsoft Outlook 365, 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 o seguinte:
   • ID do cliente - O ID da seção Visão geral do registro do seu aplicativo Microsoft Azure.
   • Senha para o certificado - a senha que você define durante a criação do certificado.
   • Certificado do cliente base64 do OAuth - O certificado do cliente é gerado em um formato de arquivo .pfx , que você deve converter para o formato codificado Base64 e fornecê-lo neste campo.
   • ID do tenant - O ID do tenant do Microsoft Azure para um aplicativo da 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
     • ChinaSelecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem. 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.

Credenciais do cliente OAuth 2.0

Escopos

Os escopos mínimos necessários para criar uma conexão são os seguintes: Mail.Read e User.Read.All

O conector requer os seguintes escopos para que todas as atividades funcionem: User.Read, User.Read.All, 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, e offline_access.

Para adicionar permissões mais granulares, consulte a documentação das atividades.

Adicionar a conexão do Microsoft Outlook 365

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

1. Na Automation Cloud, selecione Integration Service no menu trilho.
2. Na lista Conectores , selecione Microsoft Outlook 365 ou use a barra de pesquisa para encontrar o conector.
3. Selecione Conectar ao Microsoft Outlook 365, que redireciona você para a página de conexão.
4. Insira as credenciais necessárias.
   Observação:

   • Você deve fornecer o seguinte: ID do cliente, segredo do cliente, ID do tenant e os escopos dos quais você pode precisar para interagir com diferentes atividades. Para obter mais detalhes, consulte a seção Escopos anterior.
   • Se você estiver usando um aplicativo com vários tenants, mantenha o valor padrão common para o campo ID do tenant .
   • Se você estiver usando 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.
5. Select Connect.
6. Autentique com seu endereço de e-mail e senha da Microsoft.

Traga seu próprio aplicativo OAuth 2.0

Visão geral

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.

Depois de criar seu aplicativo, use a ID do cliente e o 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, Mail.Read.
• Os gatilhos do Outlook exigem os seguintes escopos mínimos:
  • Para gatilhos de caixa de correio compartilhada: openid, offline_access, Mail.Read, Mail.Read.Shared.
  • Para eventos em calendários: Calendars.Read.
  • Para eventos em calendários compartilhados: Calendars.Read.Shared.

O conector requer os seguintes escopos para que todas as atividades funcionem: User.Read, User.Read.All, 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, e offline_access.

Para adicionar permissões mais granulares, consulte a documentação das atividades.

Adicionar a conexão do Microsoft Outlook 365

Para criar uma conexão com sua instância do Microsoft Outlook 365, prossiga da seguinte maneira:

1. Na Automation Cloud, selecione Integration Service no menu trilho.
2. Na lista Conectores , selecione Microsoft Outlook 365 ou use a barra de pesquisa para encontrar o conector.
3. Selecione Conectar ao Microsoft Outlook 365, 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 - O ID do cliente da seção Visão geral do registro do seu aplicativo 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.
     Observação:

     • Se você usar um aplicativo de vários tenants, mantenha o valor padrão common.
     • 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
     • ChinaSelecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem. Para obter mais detalhes sobre ambientes, consulte Pontos de extremidade raiz de serviço do Microsoft Graph e do Graph Explorer.
   • Conta - Representa a conta usada para representar um usuário. Especifique o nome principal do usuário (UPN) da conta ou caixa de correio compartilhada a ser usada 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.

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.

AVISO:

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.