Integração do Exchange com Autenticação de aplicativo e gráfico do Azure

Introdução

Este guia passo a passo mostrará um método popular para criar um aplicativo Microsoft Exchange para Communications Mining™ em sua plataforma Azure Cloud. Você aprenderá a criar um aplicativo (cliente) com um ID e segredo do cliente, e a encontrar seu ID de diretório (tenant) existente. Isso permitirá que os usuários acessem as integrações de caixa de correio do Exchange no Communications Mining.

Por que uma integração bem-sucedida é importante?

A falha ao criar um aplicativo Exchange-Communications Mining™ no Azure pode levar a erros de permissões que impedem que usuários acessem suas integrações de caixa de correio. Para obter todos os benefícios do Communications Mining, siga estas etapas e conclua o processo em sua totalidade.

O processo de integração passo a passo

1. Registre um novo aplicativo Communications Mining

1. Faça login no seu portal do Azure.
2. Vá para o menu Registros de aplicativos e selecione Novo registro.
   
   
   
   
3. Preencha e configure os campos necessários:
   • Nome: por exemplo, uipath-exchange-integration.
   • Tipos de conta compatíveis: selecione a opção de tenant único.
4. Selecione Registrar, que redireciona você para uma página com detalhes do aplicativo registrado, como ID do aplicativo (cliente), ID do diretório (tenant).

2. Crie um segredo do cliente para um aplicativo Communications Mining

Para manter seu aplicativo seguro, crie um segredo do cliente da seguinte forma:

1. Selecione Certificados e segredos na lista suspensa Gerenciar .
2. Selecione Novo segredo do cliente na guia Segredos do cliente .
   
   
   
   
3. Isso abre o painel lateral Adicionar um segredo do cliente .
4. Preencha os campos obrigatórios:
   • Descrição: insira uma descrição para o segredo do cliente.
   • Expiração: selecione uma data de expiração. A opção recomendada é de 12 meses.
   
   
   
   
   
5. Selecione Adicionar.
6. O segredo do cliente é exibido na coluna Valor .
   
   
   
   

Observação: o Azure exibe o valor do Secret apenas uma vez. Portanto, certifique-se de copiá-lo e armazená-lo em um local seguro. Se você perder seu valor de segredo, crie um novo.

3. Defina permissões de API

Ao usar a API do Microsoft Graph

1. Acesse Permissões de API na lista suspensa Gerenciar .
2. Selecione Adicionar uma permissão.
   
   
   
   
3. Selecione Microsoft Graph na guia APIs da Microsoft .
   Figura 1. A guia APIs da Microsoft
   

   

   
   
4. Selecione Permissões do aplicativo.
   Figura 2. As opções de permissão do Microsoft Graph
   

   

   
   
5. Expanda a lista suspensa E-mail e selecione a permissão Mail.Read .
   Figura 3. Selecionando uma permissão
   

   

   
   
6. Selecione Adicionar permissões.
7. Selecione a permissão MailboxFolder.Read.All .
   Figura 4. Selecionando uma permissão
   

   

   
   
8. Selecione Adicionar permissões.
9. De volta ao menu de permissões de API , selecione Conceder consentimento de administrador para o Communications Mining.
10. Selecione Sim na janela pop-up de confirmação Conceder permissão de administrador .
    
    
    
    

4. Restringir o acesso à caixa de correio com uma política de acesso condicional

Neste momento, pode ser que você queira limitar as permissões do aplicativo para que ele possa acessar apenas determinadas caixas de correio dentro de sua organização. Para saber como fazer isso, verifique Limitar permissões de aplicativos a caixas de correio específicas do Exchange Online na documentação oficial da Microsoft.

5. Crie uma nova integração no Communications Mining

1. Acesse o Communications Mining™ acessando a Extração e Processamento Inteligente no Automation Cloud e selecionando Dados de comunicação.
2. Selecione a guia Integrações na opção configurações.
3. Selecione Nova integração.
   
   
   
   
4. Selecione um projeto existente, insira um nome para sua integração e, opcionalmente, um título.
5. Selecione Continuar.
   
   
   
   
6. Preencha e configure os campos necessários da seguinte maneira:
   • Autoridade OAuth: insira o ID do tenant gerado anteriormente no seguinte formato: https://login.microsoftonline.com/{tenant_id}.
   • ID do Cliente Oauth: insira o ID do cliente gerado anteriormente.
   • Segredo do cliente: insira o segredo do cliente gerado anteriormente.
7. Selecione a opção Com acesso ao aplicativo.
8. Selecione Validar e salvar credenciais para verificar se suas credenciais são válidas.
9. Selecione Continuar.
   Figura 5. A página de configuração criação de uma nova integração
   

   

   
   
10. Selecione Adicionar caixa de correio para abrir o formulário da caixa de correio.
11. Insira o endereço de e-mail para o qual você deseja copiar e-mails no Communications Mining™.
12. Selecione Adicionar caixa de correio novamente para salvar a caixa de correio.
13. Selecione Criar integração.