Guide de migration : Exchange Web Services (EWS) vers l'API Microsoft Graph

Vue d'ensemble (Overview)

Microsoft rend obsolète l’API des services Web Exchange (EWS), et sa désactivation complète est prévue en octobre 2026.

Vous devez migrer toutes les intégrations Exchange qui utilisent actuellement EWS vers l’API Microsoft Graph pour vous assurer que celles-ci continuent de fonctionner.

Prérequis

Avant de commencer la migration, assurez-vous de répondre aux exigences suivantes :

• Accès au portail Azure: accès administrateur au portail Azure de votre organisation.
• Autorisations: la possibilité d'enregistrer des applications et d'accorder le consentement de l'administrateur dans Azure AD.
• Accès à l'intégration: accès administrateur à vos intégrations Communications Mining.
• Informations sur la boîte aux lettres: la liste de toutes les boîtes aux lettres actuellement connectées via des intégrations EWS.

Processus de migration

Étape 1 : identifiez vos intégrations EWS actuelles

1. Connectez-vous à Communications Mining via IXP dans Automation Cloud.
2. Accédez à Paramètres, puis à l'onglet Intégrations .
3. Documenter toutes les intégrations Exchange existantes, notamment :
   • Noms des intégrations
   • Boîtes aux lettres connectées
   • Projets associés

Étape 2 : Enregistrer une application Azure

Si vous n'avez pas encore créé d'application Azure pour l'accès à l'API Graph, appliquez les étapes suivantes :

2.1. Créer l'enregistrement d'application.

1. Connectez-vous à votre portail Azure.

2. Accédez à Inscriptions d’applications et cliquez sur Nouvelle inscription.

   

3. Configurez l'application comme suit :

   • Nom: utilisez un nom descriptif, par exemple, uipath-exchange-graph-integration.
   • Types de comptes pris en charge: sélectionnez Comptes dans ce répertoire organisationnel uniquement (Locataire unique).

4. Sélectionnez Enregistrer (Register).

5. Notez les valeurs suivantes de la page de vue d'ensemble de l'application :

   • ID d'application (client)
   • ID de répertoire (locataire)

2.2 Créer une clé secrète de client.

1. Dans votre application, sélectionnez Certificats et clés secrètes dans le menu de gauche.

2. Sous Clés secrètes du client, sélectionnez Nouvelle clé secrète du client.

   

3. Cette action ouvre le panneau latéral Ajouter une clé secrète de client . Configurez la clé secrète :

   • Description: saisissez une description significative, par exemple, Exchange Graph Integration Secret.
   • Expire: sélectionnez une période d'expiration. L’option recommandée est de 12 ou 24 mois.

4. Sélectionnez Ajouter.

5. Copiez immédiatement la Valeur secrète et stockez-la en toute sécurité.

   

Remarque :

Azure n’affiche la valeur du secret qu’une seule fois. Si vous le perdez, vous devrez créer un nouveau secret.

2.3 Définir les autorisations d'API pour Microsoft Graph

1. Sélectionnez Autorisations d’API dans le menu de gauche.

2. Sélectionnez Ajouter une autorisation.

   

3. Sélectionnez Microsoft Graph sous l’onglet API Microsoft .

   

4. Sélectionnez Autorisations de l’application.

   

5. Développez Courrier et sélectionnez Mail.Read.

   

6. Sélectionnez Ajouter des autorisations.

7. Sélectionnez à nouveau Ajouter une autorisation , puis sélectionnez Microsoft Graph → Autorisations d’application.

8. Développez ParamètresBoîteLettres et sélectionnez MailboxFolder.Read.All.

11. Sélectionnez Ajouter des autorisations.

12. En revenant dans le menu des Autorisations d'API , sélectionnez Accorder le consentement de l'administrateur pour [Votre organisation].

13. Sélectionnez Oui dans la boîte de dialogue de confirmation.

    

Vos autorisations configurées doivent afficher :

• Mail.Read (Application) — coche verte sous Statut.
• MailboxFolder.Read.All (Application) — coche verte sous Statut.

2.4 Restreindre l'accès aux boîtes aux lettres (recommandé)

Pour une sécurité améliorée, limitez l’application à accéder uniquement aux boîtes aux lettres requises. Assurez-vous de suivre le guide Microsoft : Limiter les autorisations des applications à des boîtes aux lettres Exchange Online spécifiques.

Étape 3 : tester vos informations d’identification de l’API Graph (recommandé)

Avant de mettre à jour vos intégrations de production, testez d’abord les nouvelles informations d’identification de l’API Graph dans une intégration de test distincte.

1. Accédez à Communications Mining dans IXP dans Automation Cloud.
2. Accédez à l'onglet Paramètres → Intégrations .
3. Sélectionnez Nouvelle intégration.
4. Configurez l'intégration de test :
   • Sélectionnez un projet de test.
   • Saisissez un nom de test clair, par exemple, Exchange Graph Test ou [Production Name] - Test.
5. Remplissez les informations d’identification de l’ étape 2 :
   • Autorité OAuth: https://login.microsoftonline.com/{tenant_id}
   • ID client OAuth: l'ID de votre application (client).
   • Clé secrète du client: la valeur de votre clé secrète du client.
   • Méthode d'authentification: sélectionnez Avec accès à l'application.
   • Version de l'API: sélectionnez Microsoft Graph.
6. Sélectionnez Valider et enregistrer les informations d'identification.
7. Ajoutez les boîtes aux lettres utilisées dans votre intégration de production. Utilisez un horodatage de début récent pour limiter la quantité de données synchronisées initialement.
8. Sélectionnez Créer une intégration.
9. Attendez 15 à 30 minutes que la première synchronisation se termine, puis vérifiez que les e-mails se synchronisent avec succès et qu'aucun message d'erreur ne s'affiche sur la page de statut de l'intégration.

Une fois confirmées, mettez à jour vos intégrations de production.

Étape 4 : sauvegardez votre configuration EWS actuelle

Avant de modifier votre intégration de production, enregistrez vos informations d’identification EWS actuelles et les détails de votre connexion. Cela vous permet de revenir en arrière si nécessaire, car les modifications d'informations d'identification ne peuvent pas être annulées dans la plate-forme.

Étape 5 : mettre à jour votre intégration de production

Information :

Si vous devez revenir en arrière, modifiez l'intégration et basculez les informations d'identification vers vos détails EWS.

1. Accédez à Communications Mining dans IXP dans Automation Cloud.

2. Accédez à Paramètres, puis à l'onglet Intégrations .

3. Localisez l'intégration de production que vous souhaitez migrer et ouvrez ses paramètres.

4. Sélectionnez l'onglet Informations d'identification , puis sélectionnez Modifier les informations d'identification.

5. Mettez à jour les champs suivants :

   • Autorité OAuth: https://login.microsoftonline.com/{tenant_id} — remplacez {tenant_id} par votre ID Azure Directory (locataire).
   • ID client OAuth: l'ID de votre application (client).
   • Clé secrète du client: la valeur de votre clé secrète du client.
   • Méthode d'authentification: sélectionnez Avec accès à l'application.
   • Version de l'API: sélectionnez Microsoft Graph.

6. Sélectionnez Valider et enregistrer les informations d’identification pour vérifier votre configuration.

   Remarque :

   Si la validation échoue, vérifiez votre ID de locataire, votre ID de client et la clé secrète du client. Assurez-vous que le consentement de l'administrateur a été accordé pour les autorisations de l'API.

7. Sélectionnez Enregistrer ou Continuer pour appliquer la configuration mise à jour.

8. Surveillez l’intégration pendant au moins une heure afin de confirmer le fonctionnement stable et la synchronisation réussie des e-mails.

Étape 6 : mettre à jour les intégrations restantes

Répétez les étapes 3 à 5 pour chaque intégration EWS restante dans votre organisation.