Intégration avec l'utilisateur du service 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 CloudPlatform Azure. Vous apprendrez à créer une application (client) avec un ID et une clé secrète de client, puis à trouver votre ID de répertoire (locataire) existant. Cela permettra aux utilisateurs d'accéder aux intégrations de boîte 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'autorisations qui empêchent les utilisateurs d'accéder à leurs intégrations de boîte aux lettres. Pour tirer tous les avantages de Communications Mining, suivez les étapes suivantes et terminez le processus dans son intégralité.

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

1. Se connecter à Azure

   Connectez-vous à votre portail Azure Cloud.

2. Enregistrer une nouvelle application pour Communications Mining

   Accédez au menu Inscriptions d'applications ( App Registrations ) et sélectionnez l'option Nouvelle inscription (New Registration ).

   
   

   

   
   

   Enregistrer une nouvelle application :

   1. Saisissez un nom d'application — par exemple 'reinfer-exchange- integration'
   2. Sous Types de compte pris en charge ( Supported account types), sélectionnez l’option de locataire unique
   3. Cliquez sur Enregistrer pour terminer l’inscription
      
      

      

      
      

      Azure vous fournira un ID d' application (client) et un ID d' annuaire (locataire).

      
      

      

      
      
3. Créer 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, cliquez sur Certificats et clés secrètes (Certificates & Secrets) sous la barre latérale Gérer (Manage), puis suivez les étapes ci-dessous :

   1. Sélectionnez l'option Clés secrètes du client ( Client secrets ) si elle n'est pas déjà sélectionnée
   2. Sélectionnez Nouvelle clé secrète du client
      
      

      

      
      
   3. Dans la barre latérale, ajoutez une description facilement reconnaissable et sélectionnez une date d'expiration. Nous recommandons 12 mois
   4. Appuyez sur Ajouter
      
      

      

      
      

      Vous avez maintenant créé une valeur secrète pour votre application Communications Mining.

      
      

      

      
      
      Remarque : veuillez noter qu'Azure n'affichera cette valeur secrète qu'une seule fois. Assurez-vous donc de la copier. Si jamais vous perdez votre valeur secrète, terminez simplement l'étape 3 à nouveau pour en créer une nouvelle.
4. Définir les autorisations d'API
   1. Accédez aux autorisations API (API permissions) sous la barre latérale Gérer (Manage)
   2. Sélectionnez Ajouter une autorisation
      
      

      

      
      
   3. Sélectionnez API Microsoft (Microsoft APIs) et choisissez l'option Microsoft Graph (Microsoft Graph )
      
      

      

      
      
   4. Choisir les autorisations déléguées
   5. Dans la zone de texte Sélectionner les autorisations , saisissez « EDS.Access »
   6. Développez l'autorisation EWS et cochez la case EWS.AccessAsUser.All
   7. Cliquer sur Ajouter des autorisations
      
      

      

      
      
   8. De retour dans le menu des autorisations d'API, cliquez sur Accorder le consentement de l'administrateur pour Communications Mining ( Grant admin consent for Communications Mining )
   9. Sélectionnez Oui dans la fenêtre de confirmation du 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 :
      • Ajouter un utilisateur —découvrez comment.
      • Attribuez des licences à l'utilisateur —découvrez comment.
   2. Accorder à un compte de service l'accès aux boîtes aux lettres partagées (il suffit de donner au compte de service un accès en lecture seule). Vous pouvez utiliser deux méthodes principales pour ce faire :
      • Créez des boîtes aux lettres partagées et accordez l'accès aux utilisateurs (y compris le compte de service) —découvrez comment.
      • Accorder au compte de service l'accès aux e-mails d'un utilisateur —découvrez comment.
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 Intégrations via les paramètres en haut à droite
   2. Sélectionnez une nouvelle intégration
      
      

      

      
      
   3. Sélectionnez un projet existant et saisissez un nom pour votre intégration, et ajoutez un titre si vous le souhaitez
   4. Cliquez sur Continuer
      
      

      

      
      
   5. Renseignez votre autorité oauth à l'aide de l'ID de locataire généré à l'étape 2, au format suivant : https://login.microsoftonline.com/{tenant_id}
   6. Renseigner le nom d'utilisateur et le mot de passe de votre compte de service
   7. Renseignez votre ID client généré à l'étape 2
   8. Remplissez votre clé secrète client générée à l'étape 3
   9. Cliquer sur Valider et enregistrer les informations d’identification
   10. Cliquez sur Continuer
       
       

       

       
       
   11. Cliquez sur Ajouter une boîte aux lettres (Add Mailbox) pour ouvrir le formulaire de boîte aux lettres
   12. Saisissez l'adresse e-mail pour laquelle vous souhaitez copier les e-mails dans Communications Mining
   13. Cliquez à nouveau sur Ajouter une boîte aux lettres (Add Mailbox ) pour enregistrer la boîte aux lettres

       Cliquez sur 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 en cliquant sur le bouton en haut à droite de la page Intégrations. Pour le supprimer, sélectionnez l'icône de la 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 des flux rend ensuite les pièces jointes récupérables via une référence de pièce jointe. Pour en savoir plus sur la synchronisation des pièces jointes, consultez les pages Pièces jointes ( Attachments ) et Utilisation des intégrations d'Exchange (Using Exchange Integrations) .

Si vous avez des questions ou avez besoin d'aide pour le processus d'intégration, veuillez contacter l'assistance UiPath.