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 supprime l’API des services Web Exchange (EWS) pour Exchange Online, avec une désactivation complète le 1er octobre 2026. Le retrait s’applique uniquement à Exchange Online: le Exchange Server local n’est pas affecté.

Vous devez migrer toutes les intégrations Exchange Online qui utilisent actuellement EWS vers l'API Microsoft Graph pour vous assurer qu'elles continuent de fonctionner.

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

Après avoir changé les informations d'identification d'une intégration, l'intégration de Graph reprend depuis le point le plus ancien où un dossier de la boîte aux lettres avait atteint EWS et revérifie les e-mails à partir de là, en ignorant tout ce qui est déjà synchronisé. Rien n’est importé deux fois par conséquent.

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.
   • Expire: sélectionnez une période d'expiration. L’option recommandée est de 12 ou 24 mois. Notez la date d’expiration à un endroit où vous la verrez: lorsque la clé secrète expire, l’ingestion des e-mails s’arrête jusqu’à ce que vous la rotation.

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. Recherchez et sélectionnez 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é)

Pour renforcer la sécurité, votre administrateur Exchange peut limiter l'accès à l'application uniquement aux boîtes aux lettres requises en créant une stratégie d'accès à l'application. Assurez-vous de suivre le guide Microsoft: Limitation des autorisations de l’application à des boîtes aux lettres Exchange Online spécifiques.

Avant de migrer une intégration de production, vérifiez que la stratégie couvre chaque boîte aux lettres que vous prévoyez de synchroniser. Une boîte aux lettres en dehors de la stratégie est désactivée avec une Error ErrorAccessDenied la première fois que la synchronisation tente de la lire. Pour plus de détails, consultez la section Résolution des problèmes d’intégrations Exchange.

É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. Sous Se connecter à votre application, sélectionnez API Graph.
6. Sélectionnez Avec accès à l'application.
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. Attendez la fin de la première synchronisation.

Vérifiez que les e-mails se synchronisent avec succès et qu'aucun message d'erreur ne s'affiche sur la page du statut de l'intégration. La boîte aux lettres commence à se synchroniser en quelques minutes; la capture prend plus de temps lorsqu'une grande quantité d'e-mails se situe après l'horodatage de début choisi. Si aucun e-mail n'est arrivé depuis une heure, vérifiez Résolution des problèmes d'intégrations Exchange.

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 les détails de vos connexions EWS actuelles et confirmez que vous conservez toujours une copie de la clé secrète du client EWS, par exemple dans le magasin secret de votre organisation. La plate-forme n’affiche pas les informations d’identification enregistrées. Vous ne pouvez donc revenir à EWS que si vous avez conservé le secret à un autre endroit.

É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. Sous Se connecter à votre application, sélectionnez API Graph.

6. Sélectionnez Avec accès à l'application.

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. Sélectionnez Valider et enregistrer les informations d’identification pour vérifier votre configuration.

   Remarque :

   Si la validation échoue, vérifiez à nouveau 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 d’API. Notez qu'une validation réussie confirme uniquement l'authentification: elle ne vérifie l'accès à aucune boîte aux lettres.

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

10. Surveillez l’intégration pendant au moins une heure pour confirmer un fonctionnement stable et une synchronisation réussie des e-mails. Si l’intégration ou une boîte aux lettres affiche une erreur, vérifiez Résolution des problèmes d’intégrations Exchange.

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

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