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

Überblick

Microsoft stellt die Exchange Web Services (EWS)-API ein, die vollständige Deaktivierung ist für Oktober 2026 geplant.

Sie müssen alle Exchange-Integrationen, die derzeit EWS verwenden, in die Microsoft Graph-API migrieren, um sicherzustellen, dass diese weiterhin funktionieren.

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

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.
   • Läuft ab: Wählen Sie einen Ablaufzeitraum aus. Die empfohlene Option ist 12 oder 24 Monate.

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. Erweitern Sie MailboxSettings und wählen Sie MailboxFolder.Read.All aus.

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

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

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

Für erhöhte Sicherheit beschränken Sie die Anwendung auf den Zugriff auf die erforderlichen Postfächer. Stellen Sie sicher, dass Sie den Microsoft-Leitfaden befolgen: Einschränken von Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer.

Schritt 3: Testen der Graph-API-Anmeldeinformationen (empfohlen)

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. 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.
   • Authentifizierungsmethode: Wählen Sie Mit Anwendungszugriff aus.
   • API-Version: Wählen Sie Microsoft Graph aus.
6. Wählen Sie Anmeldeinformationen validieren und speichern aus.
7. 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.
8. Wählen Sie Integration erstellen aus.
9. Warten Sie 15–30 Minuten, bis die erste Synchronisierung abgeschlossen ist, und stellen Sie dann sicher, dass E-Mails erfolgreich synchronisiert werden und dass auf der Integrationsstatusseite keine Fehlermeldungen angezeigt werden.

Nach der Bestätigung aktualisieren Sie Ihre Produktionsintegrationen.

Schritt 4: Sichern Ihrer aktuellen EWS-Konfiguration

Bevor Sie Ihre Produktionsintegration ändern, zeichnen Sie Ihre aktuellen EWS-Anmeldeinformationen und Verbindungsdetails auf. Dadurch können Sie bei Bedarf rückgängig machen, da Änderungen an den Anmeldeinformationen innerhalb der Plattform nicht rückgängig gemacht werden können.

Schritt 5: Aktualisieren Ihrer Produktionsintegration

Info:

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. 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.
   • Authentifizierungsmethode: Wählen Sie Mit Anwendungszugriff aus.
   • API-Version: Wählen Sie Microsoft Graph aus.

6. Wählen Sie Anmeldeinformationen validieren und speichern aus, um Ihre Konfiguration zu verifizieren.

   Hinweis:

   Wenn die Validierung fehlschlägt, überprüfen Sie Ihre Mandanten-ID, Client-ID und den geheimen Clientschlüssel. Stellen Sie sicher, dass die Administratorzustimmung für die API-Berechtigungen erteilt wurde.

7. Wählen Sie Speichern oder Weiter aus , um die aktualisierte Konfiguration zu übernehmen.

8. Überwachen Sie die Integration für mindestens eine Stunde, um einen stabilen Betrieb und eine erfolgreiche E-Mail-Synchronisierung zu bestätigen.

Schritt 6: Verbleibende Integrationen aktualisieren

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