PREVIEW

Intégration d’Exchange avec l’authentification et le graphique d’application Azure

Introduction

This step-by-step guide will show you a popular method for creating a Microsoft Exchange application for Communications Mining™ in your Azure Cloud Platform. You'll learn how to create an Application (client) with an ID and Client Secret, and find your existing Directory (tenant) ID. This will allow users to access Exchange mailbox integrations in Communications Mining.

Pourquoi une intégration réussie est-elle importante ?

Failure to create an Exchange-Communications Mining™ application in Azure can lead to permissions errors that prevent users from accessing their mailbox integrations. To gain the full benefits of Communications Mining, follow these steps and complete the process in its entirety.

Le processus d'intégration étape par étape

1. Enregistrer une nouvelle application Communications Mining

1. Connectez-vous à votre portail Azure.
2. Accédez au menu Inscription d’applications (App Registrations) et sélectionnez Nouvel enregistrement (New Registration).
   
   
   
   
3. Remplissez et configurez les champs requis :
   • Nom: par exemple, uipath-exchange-integration.
   • Types de compte pris en charge: sélectionnez l'option de locataire unique.
4. Sélectionnez Enregistrer (Register), qui vous redirige vers une page contenant les détails de l'application enregistrée, par exemple ID de l'application (client) (Application (client) ID), ID du répertoire (locataire) (Directory (tenant) ID).

2. Créer une clé secrète de client pour une application Communications Mining

Pour sécuriser votre application, créez une clé secrète de client comme suit :

1. Sélectionnez Certificats et clés secrètes (Certificates and secrets) dans la liste déroulante Gérer (Manage) .
2. Sélectionnez Nouvelle clé secrète du client (New client secret) sous l'onglet Clés secrètes du client (Client secrets) .
   
   
   
   
3. Le panneau latéral Ajouter une clé secrète de client (Add a client secret ) s'ouvre.
4. Remplissez les champs requis :
   • Description : saisissez une description de la clé secrète du client.
   • Expire le : sélectionnez une date d'expiration. L’option recommandée est de 12 mois.
   
   
   
   
   
5. Sélectionnez Ajouter (Add).
6. La clé secrète du client est affichée sous la colonne Valeur .
   
   
   
   

Remarque : Azure affiche la valeur secrète une seule fois. Par conséquent, assurez-vous de le copier et de le stocker dans un endroit sûr. Si jamais vous perdez votre valeur secrète, créez-en une nouvelle.

3. Définir les autorisations d'API

Lorsque vous utilisez l'API Microsoft Graph

1. Accédez aux autorisations de l'API (API permissions) dans la liste déroulante Gérer (Manage) .
2. Sélectionnez Ajouter une autorisation (Add a permission).
   
   
   
   
3. Sélectionnez Microsoft Graph sous l'onglet API Microsoft .
   Figure 1. L'onglet API Microsoft
   

   

   
   
4. Sélectionnez Autorisations de l'application (Application permissions).
   Figure 2. Les options d’autorisation de Microsoft Graph
   

   

   
   
5. Développez la liste déroulante Courrier (Mail) et sélectionnez l'autorisation Courrier.Lecture (Mail.Read).
   Figure 3. Sélection d'une autorisation.
   

   

   
   
6. Sélectionnez Ajouter des autorisations (Add permissions).
7. Sélectionnez l'autorisation MailboxFolder.Read.All .
   Figure 4. Sélection d'une autorisation.
   

   

   
   
8. Sélectionnez Ajouter des autorisations (Add permissions).
9. De retour dans le menu des autorisations de l'API , sélectionnez Accorder le consentement de l'administrateur pour Communications Mining (Grant admin consent for Communications Mining).
10. Sélectionnez Oui (Yes) dans la fenêtre de confirmation du consentement de l'administrateur .
    
    
    
    

4. Restreindre l'accès aux boîtes aux lettres avec une stratégie d'accès conditionnelle

À ce stade, vous souhaiterez peut-être limiter les autorisations de l'application afin qu'elle ne puisse accéder qu'à certaines boîtes aux lettres de votre organisation. Pour savoir comment procéder, consultez la section Limitation des autorisations de l'application à des boîtes aux lettres Exchange Online spécifiques dans la documentation officielle de Microsoft.

5. Créer une nouvelle intégration dans Communications Mining

1. Go to Communications Mining™ by accessing IXP in Automation Cloud and selecting Communication Data.
2. Sélectionnez l'onglet Intégrations (Integrations) sous l'option des paramètres.
3. Sélectionnez Nouvelle intégration.
   
   
   
   
4. Sélectionnez un projet existant, saisissez un nom pour votre intégration et, éventuellement, un titre.
5. Sélectionnez continuer (continue).
   
   
   
   
6. Remplissez et configurez les champs requis comme suit :
   • Autorité OAuth (OAuth Authority) : saisissez l'ID de locataire précédemment généré au format suivant : https://login.microsoftonline.com/{tenant_id}.
   • ID de client OAuth (OAuth Client Id) : saisissez l'ID de client précédemment généré.
   • Clé secrète du client (Client Secret) : saisissez la clé secrète du client précédemment générée.
7. Sélectionnez l'option Avec accès à l'application.
8. Sélectionnez Valider et enregistrer les informations d’identification pour vérifier que vos informations d’identification sont valides.
9. Sélectionnez continuer (continue).
   Graphique 5. Créer une nouvelle page de configuration d'intégration
   

   

   
   
10. Sélectionnez Ajouter une boîte aux lettres (Add Mailbox) pour ouvrir le formulaire de boîte aux lettres.
11. Enter the email address for which you want to copy emails into Communications Mining™.
12. Sélectionnez à nouveau Ajouter une boîte aux lettres (Add Mailbox) pour enregistrer la boîte aux lettres.
13. Sélectionnez Créer une intégration.