Migrationsanleitung: Exchange Web Services (EWS) zur Microsoft Graph-API

Migrieren Sie Exchange-Integrationen von Exchange Web Services (EWS) zur Microsoft Graph API vor der Einstellungsfrist im Oktober 2026.

Überblick

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.

Best Practices

• Behandeln Sie Produktionsintegrationen mit Vorsicht. Das Wechseln der Anmeldeinformationen wirkt sich direkt auf eine Live-Integration aus und eine Anmeldeinformationsänderung kann innerhalb der Plattform nicht rückgängig gemacht werden. Planen Sie jeden Produktionswechsel bewusst, anstatt alles auf einmal zu migrieren.
• Testen Sie zuerst mit einer separaten Integration. Erstellen Sie eine dedizierte Testintegration mit den neuen Graph API-Anmeldeinformationen, bevor Sie eine Produktionsintegration bearbeiten (siehe Schritt 3: Testen Ihrer Graph API-Anmeldeinformationen). Dadurch wird bestätigt, dass Ihre Anwendungsregistrierung, Berechtigungen und Administratorzustimmung korrekt sind, ohne ein Produktionspostfach zu verlieren.
• Planen Sie Wechsel außerhalb der Peak-Zeiten. Planen Sie jede Produktionsumstellung für einen Zeitpunkt, in dem eine Lücke akzeptabel ist, um die Auswirkungen der temporären Erfassungslücke zu begrenzen, die nach dem Wechsel der Anmeldeinformationen auftritt.

Voraussetzungen

Bevor Sie mit der Migration beginnen, stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

• Azure-Portalzugriff: Administrativer Zugriff auf das Azure-Portal Ihrer Organisation.
• Berechtigungen: Die Möglichkeit, Anwendungen zu registrieren und die Administratorzustimmung in Azure AD zu erteilen.
• Integrationszugriff: Administrativen Zugriff auf Ihre Communications Mining-Integrationen.
• Postfachinformationen: Liste aller Postfächer, die derzeit über EWS-Integrationen verbunden sind.

Migrationsprozess

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.

Warnung:

Wenn Sie die Anmeldeinformationen einer Produktionsintegration zu Graph wechseln, können Sie mit einer vorübergehenden Lücke bei der E-Mail-Erfassung rechnen, bevor die neue Integration aufholt. Dies ist eine erwartete Nebeneffekte der Unterschiede zwischen den EWS- und Graph-Integrationen, kein Fehler. Planen Sie den Wechsel außerhalb der Spitzenzeiten, wenn eine Lücke bei der Erfassung akzeptabel ist.

Schritt 1: Identifizieren Ihrer aktuellen EWS-Integrationen

1. Melden Sie sich über IXP in Automation Cloud bei Communications Mining an.
2. Navigieren Sie zu Einstellungen und dann zur Registerkarte Integrationen .
3. Dokumentieren Sie alle vorhandenen Exchange-Integrationen, einschließlich:
   • Integrationsnamen
   • Verbundene Postfächer
   • Verknüpfte Projekte

Schritt 2: Registrieren einer Azure-Anwendung

Wenn Sie noch keine Azure-Anwendung für den Graph-API-Zugriff erstellt haben, führen Sie die folgenden Schritte aus:

2.1 Erstellen Sie die Anwendungsregistrierung

1. Melden Sie sich bei Ihrem Azure-Portal an .

2. Navigieren Sie zu App-Registrierungen und wählen Sie Neue Registrierung aus.

   

3. Konfigurieren Sie die Anwendung wie folgt:

   • Name: Verwenden Sie einen beschreibenden Namen, z. B. uipath-exchange-graph-integration.
   • Unterstützte Kontotypen: Wählen Sie Nur Konten in diesem Organisationsverzeichnis aus (Einzelmandant).

4. Wählen Sie Registrieren aus.

5. Notieren Sie sich die folgenden Werte von der Seite Anwendungsübersicht:

   • Anwendungs-ID (Client).
   • Verzeichnis-ID (Mandant)

2.2 Erstellen Sie einen geheimen Clientschlüssel

1. Wählen Sie in Ihrer Anwendung im linken Menü Zertifikate und Geheimschlüssel aus.

2. Wählen Sie unter Geheime Clientschlüssel die Option Neuer geheimer Clientschlüssel aus.

   

3. Dadurch wird der Seitenbereich Geheimen Clientschlüssel hinzufügen geöffnet. Konfigurieren Sie das Geheimnis:

   • Beschreibung: Geben Sie eine aussagekräftige Beschreibung ein, z. B. 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. Wählen Sie Hinzufügen aus.

5. Kopieren Sie sofort den geheimen Wert und speichern Sie ihn sicher.

   

Hinweis:

Azure zeigt den geheimen Wert nur einmal an. Wenn Sie es verlieren, müssen Sie ein neues Geheimnis erstellen.

2.3 API-Berechtigungen für Microsoft Graph festlegen

1. Wählen Sie API-Berechtigungen im linken Menü aus.

2. Wählen Sie Berechtigung hinzufügen aus.

   

3. Wählen Sie Microsoft Graph unter der Registerkarte Microsoft-APIs aus.

   

4. Wählen Sie Anwendungsberechtigungen aus.

   

5. Erweitern Sie Mail und wählen Sie Mail.Read aus.

   

6. Wählen Sie Berechtigungen hinzufügen aus.

7. Wählen Sie erneut Berechtigung hinzufügen und dann Microsoft Graph → Anwendungsberechtigungen.

8. Search for and select MailboxFolder.Read.All.

   

9. Wählen Sie Berechtigungen hinzufügen aus.

10. Kehren Sie zum Menü API-Berechtigungen zurück und wählen Sie Administratorzustimmung gewähren für [Ihre Organisation] aus.

11. Wählen Sie im Bestätigungsdialogfeld Ja aus.

    

Ihre konfigurierten Berechtigungen sollten Folgendes anzeigen:

• Mail.Read (Anwendung) – grünes Häkchen unter Status.
• MailboxFolder.Read.All (Anwendung) – grünes Häkchen unter Status.

2.4. Postfachzugriff einschränken (empfohlen)

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.

Schritt 3: Testen Sie Ihre Graph-API-Anmeldeinformationen

Bevor Sie Ihre Produktionsintegrationen aktualisieren, testen Sie zuerst die neuen Graph API-Anmeldeinformationen in einer separaten Testintegration.

1. Wechseln Sie zu Communications Mining in IXP in Automation Cloud.
2. Navigieren Sie zu Einstellungen → Registerkarte Integrationen .
3. Wählen Sie Neue Integration aus.
4. Konfigurieren Sie die Testintegration:
   • Wählen Sie ein Testprojekt aus.
   • Geben Sie einen eindeutigen Testnamen ein, z. B. Exchange Graph Test oder [Production Name] - Test.
5. Under Connect with your application, select Graph API.
6. Select With application access.
7. Füllen Sie die Anmeldeinformationen aus Schritt 2 aus:
   • OAuth-Stelle: https://login.microsoftonline.com/{tenant_id}
   • OAuth-Client-ID: Ihre Anwendungs-ID (Client).
   • Geheimer Clientschlüssel: Der Wert Ihres geheimen Clientschlüssels.
8. Wählen Sie Anmeldeinformationen validieren und speichern aus.
9. Fügen Sie die Postfächer hinzu, die in Ihrer Produktionsintegration verwendet werden. Verwenden Sie einen aktuellen Startzeitstempel, um die Datenmenge zu begrenzen, die anfänglich synchronisiert wird.
10. Wählen Sie Integration erstellen aus.
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.

Nach der Bestätigung aktualisieren Sie Ihre Produktionsintegrationen.

Schritt 4: Sichern Ihrer aktuellen EWS-Konfiguration

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.

Schritt 5: Aktualisieren Ihrer Produktionsintegration

Hinweis:

Wenn Sie rückgängig machen müssen, bearbeiten Sie die Integration und ändern Sie die Anmeldeinformationen wieder zu Ihren EWS-Details.

1. Wechseln Sie zu Communications Mining in IXP in Automation Cloud.

2. Navigieren Sie zu Einstellungen und dann zur Registerkarte Integrationen .

3. Suchen Sie die Produktionsintegration, die Sie migrieren möchten, und öffnen Sie ihre Einstellungen.

4. Wählen Sie die Registerkarte Anmeldeinformationen und dann Anmeldeinformationen ändern.

5. Under Connect with your application, select Graph API.

6. Select With application access.

7. Aktualisieren Sie die folgenden Felder:

   • OAuth-Stelle: https://login.microsoftonline.com/{tenant_id} – Ersetzen Sie {tenant_id} durch Ihre Azure Directory-ID (Mandanten).
   • OAuth-Client-ID: Ihre Anwendungs-ID (Client).
   • Geheimer Clientschlüssel: Der Wert Ihres geheimen Clientschlüssels.

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

   Hinweis:

   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. Wählen Sie Speichern oder Weiter aus , um die aktualisierte Konfiguration zu übernehmen.

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.

Schritt 6: Verbleibende Integrationen aktualisieren

Wiederholen Sie die Schritte 3–5 für jede verbleibende EWS-Integration in Ihrer Organisation.