Autenticação do Microsoft Outlook 365

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.
• Código de autorização do OAuth 2.0 — conecta-se ao aplicativo público da UiPath com suas credenciais de conta da Microsoft.
• Credenciais do cliente OAuth 2.0 – conecta-se usando uma conta de serviço.
• 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 Como se conectar às atividades do Microsoft 365.

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

O conector requer os seguintes escopos mínimos para criar uma conexão: 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. Selecione o tipo de autenticação Autenticação do certificado do cliente .
5. Configure os campos a seguir:

   • ID do cliente - Você pode encontrar o ID na seção Visão geral do seu registro de aplicativo do Microsoft Azure.

   • Senha para o certificado - a senha que você define durante a criação do certificado.

   • Certificado de cliente OAuth base64 - O certificado do cliente é gerado em um arquivo .pfx .ssp, que você deve converter para o formato codificado em Base64 e fornecê-lo neste campo.

   • ID do tenant - Você pode encontrar o ID do tenant do Microsoft Azure para um aplicativo na 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

     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. Selecione Conectar.
7. Autentique com seu endereço de e-mail e senha da Microsoft.

Código de autorização do OAuth 2.0

Escopos

O conector requer os seguintes escopos mínimos para criar uma conexão: openid, offline_access, User.Read, Mail.Read e email.

O conector requer o seguinte conjunto completo de 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. No Automation Cloud, selecione Microsoft Outlook 365 no menu de trilhos.
2. Na lista Conectores , selecione Microsoft Outlook 365. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Microsoft Outlook 365 , que redireciona você para a página de conexão.
4. Selecione o tipo de autenticação de código de autorização OAuth 2.0 .
5. Configure o seguinte:
   • Escopo - Adicione ou remova permissões para seu conector.
   • 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

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

   • Caixa de correio compartilhada - opcionalmente, insira sua caixa de correio compartilhada.
   Observação:

   Todas as atividades do Outlook herdam a caixa de correio compartilhada depois que você se conecta.

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

O conector requer os seguintes escopos mínimos para criar uma conexão: Mail.Read e User.Read.All.

O conector requer o seguinte conjunto completo de 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. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão Conectar ao Microsoft Outlook 365 , que redireciona você para a página de conexão.
4. Selecione o tipo de autenticação Credenciais do cliente OAuth 2.0 .
5. Configure o seguinte:

   • ID do cliente - Você pode encontrar o ID na seção Visão geral do seu registro de aplicativo do 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.

   • 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

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

   • Conta - Forneça a conta usada para representar um usuário. Especifique 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.

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

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, User.Read, Mail.Read e email.
• 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 o seguinte conjunto completo de 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. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione o botão 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 - Você pode encontrar o ID na seção Visão geral do seu registro de aplicativo do 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 comum.
     • 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.
   • Escopo - Adicione ou remova permissões para seu conector.
   • 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
     • China Selecione Office 365 (padrão) para todas as regiões e mude apenas para Governo ou China para implantações em nuvem.
     Observação:

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

   • Caixa de correio compartilhada - adicione ou remova permissões para seu conector.

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.