Guide du développeur Communications Mining

Dernière mise à jour 20 déc. 2024

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 cloud Azure. Vous apprendrez à créer une application (client) avec un ID et une clé secrète de client, et à 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

Connectez-vous avec Azure.
Connectez-vous à votre portail Azure Cloud.
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).
Créez une clé secrète de client pour votre application Communications Mining.
Pour que votre application soit sécurisée, 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) dans 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 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.
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).
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).
Connectez-vous à Communications Mining.
Connectez-vous à Communications Mining via UiPath Automation Cloud comme d'habitude.
Créez une nouvelle intégration dans Communications Mining.
1. Accédez à la page Intégrations via la roue dentée des paramètres en haut à droite.
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. Cliquez sur 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. Cliquez sur Valider et enregistrer les informations d’identification pour vérifier que vos informations d’identification sont valides.
10. Cliquez sur Continuer (Continue).
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 pour enregistrer la boîte aux lettres.
14. Cliquez sur Créer une intégration (Create Integration).

É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.

Sommaire de la page