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

Introduction

Ce guide étape par étape vous montrera une méthode populaire pour créer une application Microsoft Exchange pour Communications Mining™ dans votre plate-forme Azure Cloud. Vous apprendrez à créer une application (client) avec un ID et une clé secrète client, puis à trouver votre ID de répertoire (locataire) existant. Cela permettra aux utilisateurs d’accéder aux intégrations de boîtes aux lettres Exchange dans Communications Mining.

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

L’échec de la création d’une application Exchange-Communications Mining™ dans Azure peut entraîner des erreurs d’autorisation qui empêchent les utilisateurs d’accéder à leurs intégrations de boîte aux lettres. Pour profiter pleinement des avantages de Communications Mining, suivez ces étapes et suivez le processus dans son intégralité.

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. Accédez à Communications Mining™ en accédant à IXP dans Automation Cloud et en sélectionnant Données de communication.
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. Saisissez l’adresse e-mail pour laquelle vous souhaitez copier les e-mails dans 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.