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

Migrez les intégrations Exchange depuis Exchange Web Services vers l’API Microsoft Graph avant la date d’obsolescence d’octobre 2026.

Vue d'ensemble (Overview)

Microsoft is retiring the Exchange Web Services (EWS) API for Exchange Online, with full disablement on October 1, 2026. The retirement applies to Exchange Online only: on-premises Exchange Server is not affected.

You must migrate all Exchange Online integrations that currently use EWS to the Microsoft Graph API to make sure that these continue to function.

Meilleures pratiques

• Traitez les intégrations de production avec soin. Le changement d’informations d’identification affecte directement une intégration en production, et une modification d’informations d’identification ne peut pas être annulée sur la plate-forme. Planifiez délibérément chaque basculement de production au lieu de tout migrer en même temps.
• Testez d'abord avec une intégration distincte. Créez une intégration de test dédiée avec les nouvelles informations d'identification de l'API Graph avant de touchez une intégration de production (voir Étape 3: Testez vos informations d'identification de l'API Graph). Cela confirme l'enregistrement de votre application, les autorisations et le consentement de l'administrateur sont corrects sans risque d'une boîte aux lettres de production.
• Planifiez des basculements en dehors des heures de pointe. Planifiez chaque basculement de production pendant une période où un écart est acceptable, afin de limiter l’impact de l’écart d’ingestion temporaire qui survient après le changement d’informations d’identification.

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

After you switch an integration's credentials, the Graph integration resumes from the earliest point that any folder in the mailbox had reached over EWS, and re-checks emails from there onward, skipping anything already synced. Nothing is imported twice as a result.

Avertissement :

Lorsque vous basculez les informations d’identification d’une intégration de production vers Graph, attendez-vous à un écart temporaire dans l’ingestion des e-mails avant que la nouvelle intégration ne se rattrape. Il s'agit d'un effet latéral attendu des différences entre les intégrations EWS et Graph, et non d'une erreur. Planifiez le basculement pour des heures en dehors des heures de pointe, lorsqu’un écart d’ingestion est acceptable.

É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.
   • Expires: Select an expiration period. The recommended option is 12 or 24 months. Note the expiry date somewhere you will see it: when the secret expires, email ingestion stops until you rotate it.

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. Search for and select MailboxFolder.Read.All.

   

9. Sélectionnez Ajouter des autorisations.

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

11. 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é)

For enhanced security, your Exchange administrator can limit the application to access only the required mailboxes by creating an application access policy. Make sure you follow the Microsoft guide: Limiting application permissions to specific Exchange Online mailboxes.

Before you migrate a production integration, verify that the policy covers every mailbox you plan to sync. A mailbox outside the policy is disabled with an ErrorAccessDenied error the first time the sync attempts to read it. For details, check Troubleshooting Exchange integrations.

Étape 3: testez vos informations d'identification d'API Graph

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. Under Connect with your application, select Graph API.
6. Select With application access.
7. 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.
8. Sélectionnez Valider et enregistrer les informations d’identification.
9. 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.
10. Sélectionnez Créer une intégration.
11. Wait for the first sync to complete.

Verify that emails are syncing successfully and that no error messages appear on the integration status page. The mailbox starts syncing within minutes; catching up takes longer when a large amount of email falls after the chosen start timestamp. If no emails have arrived after an hour, check Troubleshooting Exchange integrations.

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

Étape 4 : sauvegardez votre configuration EWS actuelle

Before modifying your production integration, record your current EWS connection details, and confirm that you still hold a copy of the EWS client secret, for example in your organization's secret store. The platform does not display saved credentials back to you, so you can only revert to EWS if you kept the secret elsewhere.

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

Remarque :

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. Under Connect with your application, select Graph API.

6. Select With application access.

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

8. Select Validate & save credentials to verify your configuration.

   Remarque :

   If validation fails, double-check your tenant ID, client ID, and client secret. Ensure admin consent was granted for the API permissions. Note that successful validation confirms authentication only: it does not check access to any mailbox.

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

10. Monitor the integration for at least one hour to confirm stable operation and successful email sync. If the integration or a mailbox shows an error, check Troubleshooting Exchange integrations.

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

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