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.

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
Código de autorização do OAuth 2.0	Delegado
Credenciais do cliente OAuth 2.0	Aplicativo
Traga seu próprio aplicativo OAuth 2.0	Delegado

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 consentimento do administrador antes que os usuários possam se conectar a aplicativos externos. 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.

Se sua organização exigir o consentimento de administradores, você poderá encontrar um erro durante a criação da conexão afirmando que o aplicativo precisa de permissão para acessar recursos em sua organização e que somente um administrador pode conceder esse acesso. Este erro não é causado por um problema do produto, ele requer uma ação por parte do seu administrador do Azure.

Para obter informações em segundo plano, 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.

Solicitando aprovação do administrador

Se você encontrar o erro, envie uma solicitação de aprovação diretamente da tela de entrada da Microsoft:

1. Na tela Aprovação necessária , insira uma justificativa de negócios no campo motivo para solicitar acesso.
2. Selecione Solicitar aprovação.

Seu administrador recebe a solicitação por email e pode revisá-la no centro de administração do Microsoft Entra.

Aprovando a solicitação (administrador)

Pré-requisitos

• Você tem a função Global Administrator, Application Administrator ou Cloud Application Administrator no Microsoft Entra ID.

Para aprovar uma solicitação de consentimento de administrador pendente:

1. Faça login no Centro de administração do Microsoft Entra.
2. Navegue até ID do Entra e, em seguida, até Aplicativos empresariais.
3. Em Atividade, na navegação à esquerda, selecione Solicitações de consentimento do administrador.
4. Selecione a guia Meus Pendentes e, em seguida, selecione a solicitação pendente na lista.
5. Revise as permissões que o aplicativo está solicitando.
6. Selecione Revisar permissões e consentimento para exibir as permissões que estão sendo solicitadas e, em seguida, selecione Aceitar para conceder o consentimento.
7. Para rejeitar, selecione Negar e forneça uma justificativa.

O usuário que enviou a solicitação é notificado da decisão.

Para obter detalhes completos sobre o processo de aprovação, consulte Revisar solicitações de consentimento do administrador 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 ele tem no aplicativo fornecido. Se você compartilhar a conexão, cada alteração feita 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. Selecione Orchestrator no inicializador do produto.

2. Selecione uma pasta e navegue até a aba Conexões .

3. Selecione Adicionar conexão.

4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.

5. Selecione o tipo de autenticação Autenticação do certificado do cliente .

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

7. Select Connect.

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly. For more information, see Use credential assets for connections.

8. Autentique com seu endereço de e-mail e senha da Microsoft.

Código de autorização do OAuth 2.0

Escopos

Escopos obrigatórios: openid, offline_access, User.Read, Mail.Read, email.

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. Selecione Orchestrator no inicializador do produto.
2. Selecione uma pasta e navegue até a aba Conexões .
3. Selecione Adicionar conexão.
4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.
5. Selecione o tipo de autenticação de código de autorização OAuth 2.0 .
6. 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.

7. Select Connect.
8. 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. Selecione Orchestrator no inicializador do produto.

2. Selecione uma pasta e navegue até a aba Conexões .

3. Selecione Adicionar conexão.

4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.

5. Selecione o tipo de autenticação Credenciais do cliente OAuth 2.0 .

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

7. Select Connect.

   Where available, select the menu next to a field and choose Use credential asset or Use Orchestrator asset to reference an Orchestrator asset instead of entering the value directly. For more information, see Use credential assets for connections.

8. 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://{baseURL}/provisioning_/callback (por exemplo, https://cloud.uipath.com/provisioning_/callback para Automation Cloud).
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

• Escopos obrigatórios: openid, offline_access, User.Read, Mail.Read, email.
• 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. Selecione Orchestrator no inicializador do produto.
2. Selecione uma pasta e navegue até a aba Conexões .
3. Selecione Adicionar conexão.
4. Para abrir a página de criação de conexão, selecione o conector na lista. Você pode usar a barra de pesquisa para encontrar o conector.
5. Selecione o tipo de autenticação Trazer seu próprio aplicativo OAuth 2.0 .
6. 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.