Intégration avec l'utilisateur du service Azure

Configurez une intégration Microsoft Exchange à l'aide d'un compte utilisateur du service Azure pour IXP sur Automation Cloud.

Avertissement :

Microsoft retirera les Web Exchange Services (EWS) pour Exchange Online le 1er octobre 2026 (annonce Microsoft). Nous vous recommandons de basculer vos intégrations Exchange vers l'API Microsoft Graph dès que possible. Pour connaître les étapes de migration, reportez-vous au guide de migration de l’API EWS vers Microsoft Graph.

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 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. Connectez-vous à Azure

Connectez-vous à votre portail Azure Cloud.

2. Enregistrer une nouvelle application pour Communications Mining

1. Accédez au menu Inscriptions d'applications et cliquez sur l'option Nouvelle inscription .

   

2. Enregistrez une nouvelle application comme suit :

   1. Saisissez un nom pour votre application, par exemple, reinfer-exchange-integration.
   2. Sous Types de compte pris en charge, sélectionnez l’option à locataire unique.
   3. Cliquez sur S’inscrire pour terminer l’enregistrement.

   

   Azure vous fournira un ID d'application (client) et un ID d'annuaire (locataire) comme illustré dans l'image suivante.

   

3. Créez une clé secrète de client pour votre application Communications Mining

Pour sécuriser votre application, vous devez créer une clé secrète de client pour vous connecter à votre application. Tout d’abord, sélectionnez Certificats et clés secrètes dans la barre latérale Gérer , puis effectuez les étapes suivantes :

1. Sélectionnez Clés secrètes du client si elle n’est pas automatiquement sélectionnée.

2. Sélectionnez Nouvelle clé secrète du client.

   

3. Dans la barre latérale, ajoutez une description facilement identifiable et sélectionnez une date d’expiration. Nous vous recommandons de définir 12 mois pour la date d’expiration.

4. Sélectionnez Ajouter pour créer une valeur secrète pour votre application Communications Mining™.

   

   

   Remarque :

   Azure ne vous affiche la valeur du secret qu’une seule fois ; assurez-vous donc de le copier. Si vous perdez votre valeur secrète, suivez à nouveau l'étape 3 pour en créer une nouvelle.

4. Définir les autorisations d'API

1. Accédez aux Autorisations d’API dans la barre latérale Gérer .

2. Sélectionnez Ajouter une autorisation.

   

3. Sélectionnez API Microsoft , puis Microsoft Graph.

   

4. Sélectionnez Autorisations déléguées.

5. Dans la zone de texte Sélectionner les autorisations , entrez EWS.Access.

6. Développez l'autorisation EWS et cochez la case EWS.AccessAsUser.All.

7. Sélectionnez Ajouter des autorisations.

   

8. Revenez dans le menu des Autorisations d'API et sélectionnez Accorder le consentement de l'administrateur pour Communications Mining.

9. Sélectionnez Oui dans la fenêtre contextuelle Accorder le consentement de l'administrateur

   

5. Accorder à l’utilisateur du service l’accès aux boîtes aux lettres partagées

Vous aurez besoin d’un compte de service avec accès aux boîtes aux lettres que vous souhaitez connecter à Communications Mining™.

1. Créez un compte de service :
   • Ajoutez un utilisateur.
   • Attribuez des licences à l'utilisateur.
2. Accordez à un compte de service l’accès aux boîtes aux lettres partagées. Il suffit d'accorder au compte de service l'accès en lecture seule. Utilisez l'une des méthodes suivantes pour ce faire :
   • Créez des boîtes aux lettres partagées et donnez accès aux utilisateurs, y compris au compte de service.
   • Accordez au compte de service l'accès aux e-mails d'un utilisateur.

6. Se connecter à Communications Mining

Connectez-vous à Communications Mining via UiPath® Automation Cloud comme d’habitude.

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

1. Accédez à la page Administration de Communications Mining.

2. Sélectionnez Nouvelle intégration.

   

3. Sur la page Créer une nouvelle intégration , sous Ajouter des informations de base, configurez les champs suivants :

   • Projet : sélectionnez un projet existant.
   • Titre : vous pouvez saisir un titre de manière facultative.
   • Nom de l'API : saisissez un nom pour votre intégration.

Remarque :

Une fois que vous avez défini le nom de l'API, vous ne pouvez pas le modifier.

4. Sélectionnez continuer (continue).

   

5. Sous Connecter avec votre application, configurez les éléments suivants :

   • Sélectionnez le type d’API : API Graph ou API EWS.

   • Sélectionnez la méthode d'authentification : Avec clé secrète du client, Avec clé privée et empreinte ou Avec NTLM.

     Remarque :

     NTLM ne prend en charge que l’accès délégué. Pour plus d'informations, consultez la documentation Microsoft sur l'accès délégué et EWS dans Exchange.

   • URL de l’autorité OAuth : saisissez l’URL de l’autorité OAuth à l’aide de l’ID de locataire de l’étape 2, lorsque vous avez enregistré une nouvelle application pour Communications Mining, au format suivant : https://login.microsoftonline.com/{tenant_id}.

   • ID de client OAuth – Saisissez l'ID client OAuth de l'étape 2.

   • Clé secrète du client : saisissez la clé secrète du client de l'étape 3.

   • Sélectionnez l'une des options suivantes :

     • Avec accès utilisateur au service - Saisissez le nom d'utilisateur et le mot de passe de votre compte de service.
     Remarque :

     L’API Graph ne prend pas en charge l’accès des utilisateurs au service.

     • Avec accès aux applications

   • Sélectionnez Valider et enregistrer les informations d’identification.

6. Sélectionnez continuer (continue).

   

7. Sous Sélectionner vos données d'entrée, sélectionnez Ajouter une boîte aux lettres et configurez les champs suivants :

   Nom de la boîte aux lettres

   • E-mail : saisissez l’adresse e-mail.

   Compartiment

   • Nouveau compartiment : sélectionnez l'un des éléments suivants :
     • Créer un nouveau compartiment : créez automatiquement un compartiment pour la boîte aux lettres.
     • Définir un nouveau compartiment par l'utilisateur : définissez un compartiment personnalisé en spécifiant un Projet, un Nom et un Titre.
   • Compartiment existant : sélectionnez un compartiment Orchestrator existant.

   Filtres d'heure

   Remarque :

   Choisissez une date de synchronisation. Vous pouvez mettre à jour cette date afin de le synchroniser ultérieurement si nécessaire. Les données déjà synchronisées ne seront pas affectées. Si les volumes totaux sont inconnus, il est recommandé de mesurer les volumes en synchronisant d'abord une période plus courte. Les AI Unit sont facturées lors du chargement.

   • À partir de l’horodatage : configurez le champ suivant :
     • Synchroniser à partir de l'horodatage : saisissez une date à partir de laquelle synchroniser. Il est généralement recommandé de synchroniser au moins 6 à 12 mois de données.
   • Tout le temps : synchronise toutes les données disponibles.
   Important :

   Cette option peut consommer davantage d’AI Units que prévu.

   Filtres de dossier

   Remarque :

   Lors de l'application de filtres de dossier :

   • Les dossiers imbriqués sont séparés par une barre oblique /.
   • Les dossiers visibles dans Outlook sont normalement précédés de root/Top of Information Store/.
   • L’autorisation des dossiers signifie que les dossiers non explicitement autorisés sont refusés.
   • Vous pouvez refuser l'accès à un dossier dans un dossier autorisé.
   • Vous ne pouvez pas autoriser l'accès à un dossier dans un dossier refusé.
   • Dossiers autorisés - saisissez les dossiers autorisés.
   • Dossiers refusés : saisissez les dossiers refusés.
   Remarque :

   Assurez-vous de saisir l'emplacement du dossier dans ce format : root/Top of Information Store/.

   Astuce :

   Limitez l’étendue du filtre de dossier au minimum dont vous avez besoin. Si vous laissez les Dossiers autorisés vides, l'intégration se synchronise en permanence à partir de chaque dossier de la boîte aux lettres, y compris les archives et les éléments récupérables, ce qui ralentit considérablement la synchronisation. Pour la plupart des traitement Bau, autorisez uniquement :

   • root/Top of Information Store/Inbox
   • root/Top of Information Store/Sent Items

   Filtres de participants

   Remarque :

   Lors de l’application de filtres de participant :

   • L’autorisation de participants signifie que les participants qui n’ont pas été explicitement autorisés sont refusés.
   • Tout participant refusé est refusé même s’il apparaît également dans la liste « autorisé ».
   • Les filtres des participants sont insensibles à la casse.
   • Participants autorisés - Saisissez les adresses e-mail des participants autorisés.
   • Participants refusés : saisissez les adresses e-mail des participants refusés.

   Filtres de domaines de participants

   Remarque :

   Lors de l’application de filtres de domaine de participant :

   • L’autorisation des domaines signifie que les participants non explicitement autorisés sont refusés.
   • Tout domaine de participant refusé est refusé même s’il apparaît également dans la liste « autorisé ».
   • Vous pouvez saisir génériquement le domaine de premier niveau. Par exemple, reinfer.* correspond à reinfer.dev et reinfer.com.
   • Les filtres de domaine du participant ne sont pas sensibles à la casse.
   • Domaines de participants autorisés : saisissez les domaines des participants autorisés, par exemple, gmail.com.
   • Domaines de participants refusés : saisissez les domaines des participants refusés, par exemple, gmail.com.

   Pièces jointes (Attachments)

   • Synchroniser les contenus des pièces jointes : Activez cette option pour synchroniser également les pièces jointes des e-mails.
   8. Sélectionnez l'une des options suivantes :
      • Ajouter une boîte aux lettres
      • Ignorer la nouvelle boîte aux lettres.
   9. Sélectionnez Créer une intégration.

Étapes finales

Vous avez maintenant créé avec succès une intégration entre Communications Mining™ et Microsoft Exchange via Azure. Vous pouvez désactiver l'intégration à l'aide du bouton bascule, comme illustré dans l'image suivante. Pour le supprimer, sélectionnez l’icône de corbeille.

Vous pouvez également activer la synchronisation des pièces jointes au niveau de la boîte aux lettres sur une intégration Exchange. L’API de flux rend ensuite les pièces jointes récupérables via une référence de pièce jointe. Apprenez-en davantage sur la synchronisation des pièces jointes dans les pages Pièces jointes et Utilisation des intégrations Exchange .

Si vous avez des questions ou avez besoin d’aide concernant le processus d’intégration, contactez le support UiPath®.