Integração do Exchange com Autenticação de Aplicativo do Azure

Introdução

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

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

A falha ao criar um aplicativo do Exchange-Communications Mining no Azure pode levar a erros de permissão que impedem os usuários de acessar 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 .
    
    
    
    

Ao usar a API EWS

1. Acesse as permissões da API na lista suspensa Gerenciar .
2. Selecione Adicionar uma permissão
   
   
   
   
3. Selecione as APIs que minha organização usa.
   
   
   
   
4. Pesquise pelo Office 365 Exchange Online e selecione-o.
5. Selecione Permissões do aplicativo.
   
   
   
   
6. Selecione a permissão full_access_as_app .
7. Selecione Adicionar permissões.
   
   
   
   
8. De volta ao menu de permissões de API , selecione Conceder consentimento de administrador para o Communications Mining.
9. 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 o IXP 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 os e-mails no Communications Mining.
12. Selecione Adicionar caixa de correio novamente para salvar a caixa de correio.
13. Selecione Criar integração.
    
    
    
    

Etapas finais

Você criou com sucesso uma integração entre o Communications Mining e o Microsoft Exchange através do Azure. Você pode desabilitar a integração pressionando o botão de alternância no canto superior direito da página Integrações. Para excluí-lo, selecione o ícone de lixeira.

Você também pode habilitar a sincronização de anexos no nível da caixa de correio em uma integração do Exchange. Então, a API de streams torna os anexos recuperáveis por meio de uma referência de anexo. Verifique mais sobre a sincronização de anexos nas páginas Anexos e Usando integrações do Exchange .

Se você tiver dúvidas ou precisar de ajuda com o processo de integração, entre em contato com o suporte da UiPath.