Autenticação do Microsoft 365

Pré-requisitos

Para criar uma conexão, você precisa do seguinte:

• ID do Cliente
• Segredo do Cliente
• ID do Tenant
• Email
• Escopos

Registro de aplicativo

Esse conector sempre requer seu próprio Registro de Aplicativo do Microsoft Azure. A UiPath não fornece um aplicativo compartilhado para este conector.

Para criar e configurar um registro de aplicativo:

1. No Centro de administração do Microsoft Entra, registre um novo aplicativo. Para obter instruções completas, consulte Registrar um aplicativo com a plataforma de identidade da Microsoft.
2. Defina o aplicativo como um aplicativo da Web .
3. Adicione um URI de redirecionamento da Web . Defina-o como: https://{baseURL}/provisioning_/callback (por exemplo, https://cloud.uipath.com/provisioning_/callback para Automation Cloud).
4. Adicione Permissões delegadas . Para obter a lista completa de escopos exigidos, consulte a seção Escopos .
5. Gere um segredo do cliente em Certificados e segredos.

Após configurar o registro do aplicativo, use o ID do cliente, Segredo do cliente e ID do tenant do aplicativo para criar uma conexão.

Escopos

Escopos padrão configurados: 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 e User.Read.

Por design, a API do Microsoft Graph requer pelo menos as permissões User.Read e offline_access para criar uma conexão. As permissões profile, openid, email, offline_access e User.Read são descritas da seguinte maneira:

• profile - Inclui informações de perfil básicas em tokens.
• openid - Permite que você habilite recursos de Logon Único para a conexão.
• email - Inclui o endereço de email principal do usuário como uma declaração no token de ID.
• offline_access - Responsável por criar e conceder tokens de atualização.
• User.Read - Permite que você leia informações do usuário, como o e-mail do usuário, detalhes básicos do perfil, que serão usados como a identidade da conexão.

Para obter mais detalhes sobre autenticação, consulte Solicitação HTTP do Microsoft 365.

Observação:

Todas as permissões do Microsoft Graph listadas são permissões delegadas. Isso significa que a conexão opera em nome do usuário conectado e o acesso concedido é limitado ao que esse usuário tem permissão para fazer no Microsoft 365.

Adicionando a autenticação do Microsoft 365

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

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

6. Select Connect.

   Para qualquer campo do tipo secreto, você pode selecionar o menu ao lado do campo e escolher Usar ativo de credencial para fazer referência a um ativo de credencial do Orchestrator vinculado a um cofre externo em vez de inserir o valor diretamente. Para obter mais informações, consulte Usar ativos de credenciais para conexões.