Intégration avec l'authentification 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. Connectez-vous avec Azure.
   Connectez-vous à votre portail Azure Cloud.
2. Enregistrez une nouvelle application pour Communications Mining.

   Accédez au menu Inscription d’applications ( App Registrations ) et sélectionnez l’option Nouvel enregistrement (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é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 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 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 identifiable et sélectionnez une date d'expiration. Nous recommandons 12 mois.
   4. Appuyez sur Ajouter ( Add).
      
      
      
      

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

   
   

   

   
   

   Remarque : 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, répétez simplement l'étape 3 pour en créer une nouvelle.
4. Définir les autorisations d'API
   1. Accédez aux autorisations de l'API dans la barre latérale Gérer (Manage).
   2. Sélectionnez Ajouter une autorisation
      
      
      
      
   3. Sélectionnez les API utilisées par mon organisation.
      
      
      
      
   4. Recherchez et sélectionnez « Office 365 Exchange Online ».
   5. Sélectionnez « Autorisations d’application ».
      
      
      
      
   6. Sélectionnez l'option « full_access_as_app ».
   7. Cliquez sur Ajouter des autorisations ( Add permissions).
      
      
      
      
   8. De retour dans le menu des autorisations de l'API, cliquez sur Accorder le consentement de l'administrateur pour Communications Mining ( Grant admin consent for Communications Mining).
   9. Dans la fenêtre de confirmation du consentement de l'administrateur (Grant admin consent ), sélectionnez Oui(Yes).
      
      
      
      
5. Restreindre l'accès à la boîte aux lettres avec une stratégie d'accès conditionnelle.
   À ce stade, vous souhaiterez probablement limiter les autorisations des applications afin qu'elles ne puissent accéder qu'à certaines boîtes aux lettres de votre organisation. Pour savoir comment procéder, lisez l'article de Microsoft Limiter les autorisations de l'application à des boîtes aux lettres Exchange Online spécifiques (Limiting application permissions to specific Exchange Online).
6. Connectez-vous à Communications Mining.
   Connectez-vous à Communications Mining via UiPath® Automation Cloud comme d’habitude.
7. Créez une nouvelle intégration dans Communications Mining.
   1. Accédez à la page Intégrations à l'aide de l'icône d'engrenage.
   2. Sélectionnez Nouvelle intégration.
      
      
      
      
   3. Sélectionnez un projet existant, saisissez un nom pour votre intégration et ajoutez un titre si vous le souhaitez.
   4. Sélectionnez continuer (continue).
      
      
      
      
   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. Remplissez votre ID de client généré à l'étape 2.
   7. Remplissez votre clé secrète de client générée à l'étape 3.
   8. Sélectionnez l'option Avec accès à l'application.
   9. Sélectionnez Valider et enregistrer les informations d’identification pour vérifier que vos informations d’identification sont valides.
   10. Sélectionnez continuer (continue).
       
       
       
       
   11. Sélectionnez 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. Sélectionnez à nouveau Ajouter une boîte aux lettres (Add Mailbox) pour enregistrer la boîte aux lettres.
   14. 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 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 concernant le processus d’intégration, contactez le support UiPath®.