Exchange-Integration mit Azure Application Authentication und Graph

Konfigurieren Sie eine Microsoft Exchange-Integration mit Azure Application Authentication und Microsoft Graph für IXP auf Automation Cloud.

Warnung:

Microsoft stellt Exchange Web Services (EWS) für Exchange Online am 1. Oktober 2026 ein (Ankündigung von Microsoft). Dieser Leitfaden behandelt die empfohlene Microsoft Graph API-Integrationsmethode. Wenn Sie eine vorhandene EWS-Integration migrieren, lesen Sie die Migrationsanleitung für EWS zu Microsoft Graph API.

Einleitung

Diese Schritt-für-Schritt-Anleitung zeigt Ihnen eine beliebte Methode zum Erstellen einer Microsoft Exchange-Anwendung für Communications Mining™ in Ihrer Azure Cloud-Plattform. Erfahren Sie, wie Sie eine Anwendung (Client) mit einer ID und einem geheimen Clientschlüssel erstellen und Ihre vorhandene Verzeichnis-ID (Mandanten) finden. Dadurch können Benutzer auf Exchange-Postfachintegrationen in Communications Mining zugreifen.

Warum eine erfolgreiche Integration wichtig ist

Wenn keine Exchange-Communications Mining™-Anwendung in Azure erstellt wird, kann dies zu Berechtigungsfehlern führen, die Benutzer daran hindern, auf ihre Postfachintegrationen zuzugreifen. Um die vollen Vorteile von Communications Mining auszuschöpfen, führen Sie die folgenden Schritte aus und schließen Sie den Prozess vollständig ab.

Der Integrationsprozess Schritt für Schritt

1. Registrieren Sie eine neue Communications Mining-Anwendung

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

2. Wechseln Sie zum Menü App-Registrierungen und wählen Sie Neue Registrierung aus.

   

3. Füllen Sie die erforderlichen Felder aus und konfigurieren Sie sie:

   • Name: Zum Beispiel uipath-exchange-integration.
   • Unterstützte Kontotypen: Wählen Sie die Option Einzelner Mandant aus.

4. Wählen Sie Registrieren aus, wodurch Sie zu einer Seite mit Details der registrierten Anwendung umgeleitet werden, z. B. Anwendungs- (Client)-ID, Verzeichnis- (Mandanten)-ID.

2. Erstellen Sie einen geheimen Clientschlüssel für eine Communications Mining-Anwendung

Um Ihre Anwendung sicher zu halten, erstellen Sie wie folgt einen geheimen Clientschlüssel. Alternativ können Sie sich mit einem Zertifikat authentifizieren: Überspringen Sie diesen Schritt und wählen Sie Mit privatem Schlüssel und Fingerabdruck aus, wenn Sie die Integration in Schritt 5 erstellen, und stellen Sie das PEM-codierte Zertifikat mit seinem privaten Schlüssel und dem Zertifikat-Fingerabdruck bereit. Sie können die Authentifizierungsmethode später ändern.

1. Wählen Sie Zertifikate und Geheimschlüssel unter der Dropdownliste Verwalten aus.

2. Wählen Sie Neuer geheimer Clientschlüssel unter der Registerkarte Geheime Clientschlüssel aus.

   

3. Dadurch wird der Seitenbereich Geheimen Clientschlüssel hinzufügen geöffnet.

4. Füllen Sie die erforderlichen Felder aus:

   • Beschreibung: Geben Sie eine Beschreibung für den geheimen Clientschlüssel ein.
   • Läuft ab: Wählen Sie ein Ablaufdatum aus. Die empfohlene Option ist 12 Monate. Notieren Sie das Ablaufdatum an einer Stelle, an der Sie es sehen werden: Wenn das Geheimnis abläuft, wird die E-Mail-Erfassung angehalten, bis Sie es rotieren.

   

5. Wählen Sie Hinzufügen aus.

6. Der geheime Clientschlüssel wird in der Spalte Wert angezeigt.

   

Hinweis:

Azure zeigt den geheimen Wert nur einmal an. Kopieren Sie sie daher und speichern Sie sie an einem sicheren Ort. Wenn Sie Ihren geheimen Wert jemals verlieren, erstellen Sie einen neuen.

3. Legen Sie die API-Berechtigungen fest

Bei Verwendung der Microsoft Graph-API

1. Wechseln Sie in der Dropdownliste Verwalten zu API-Berechtigungen .

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

   

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

   Abbildung 1. Die Registerkarte Microsoft-APIs

   

4. Wählen Sie Anwendungsberechtigungen aus.

   Abbildung 2. Die Berechtigungsoptionen von Microsoft Graph

   

5. Erweitern Sie die Dropdownliste E- Mail und wählen Sie die Berechtigung Mail.Read aus.

   Abbildung 3. Auswählen einer Berechtigung

   

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

7. Wählen Sie die Berechtigung MailboxFolder.Read.All aus.

   Abbildung 4. Auswählen einer Berechtigung

   

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

9. Wählen Sie zurück im Menü API-Berechtigungen die Option Administratorzustimmung für [Ihre Organisation] gewähren aus.

10. Wählen Sie Ja im Popup- Fenster Administratorzustimmung gewähren aus.

4. Einschränken des Postfachzugriffs mit einer Anwendungszugriffsrichtlinie

Standardmäßig gelten die von Ihnen gewährten Anwendungsberechtigungen für jedes Postfach in Ihrer Organisation. Um die Anwendung auf die Postfächer zu beschränken, die Communications Mining benötigt, bitten Sie Ihren Exchange-Administrator, eine Anwendungszugriffsrichtlinie zu erstellen. Die Schritte finden Sie unter Beschränken von Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer in der offiziellen Microsoft-Dokumentation.

Wichtig:

Vergewissern Sie sich, dass die Richtlinie jedes Postfach abdeckt, das Sie synchronisieren möchten, bevor Sie es der Integration hinzufügen. Ein Postfach, das von der Richtlinie nicht abgedeckt wird, wird mit einem ErrorAccessDenied -Fehler deaktiviert, wenn die Synchronisierung zum ersten Mal versucht, es zu lesen. Weitere Informationen finden Sie unter Fehlerbehebung bei Exchange-Integrationen.

5. Erstellen Sie eine neue Integration in Communications Mining

1. Wechseln Sie zu Communications Mining™, indem Sie in Automation Cloud auf IXP zugreifen und Kommunikationsdaten auswählen.

2. Wählen Sie die Registerkarte Integrationen unter der Einstellungsoption aus.

3. Wählen Sie Neue Integration aus.

   

4. Wählen Sie ein vorhandenes Projekt aus, geben Sie einen Namen für Ihre Integration und optional einen Titel ein.

5. Wählen Sie die Schaltfläche zum Fortfahren aus.

   

6. Wählen Sie unter Mit Ihrer Anwendung verbinden die Option Graph-API aus.

7. Wählen Sie die Option Mit Anwendungszugriff aus.

8. Füllen Sie die erforderlichen Felder wie folgt aus und konfigurieren Sie sie:

   • OAuth-Stelle: Geben Sie die zuvor generierte Mandanten-ID in folgendem Format ein: https://login.microsoftonline.com/{tenant_id}.
   • OAuth Client-ID: Geben Sie die zuvor generierte Client-ID ein.
   • Geheimer Clientschlüssel: Geben Sie den zuvor generierten geheimen Clientschlüssel ein.

9. Wählen Sie Validieren und Speichern von Anmeldeinformationen, um zu überprüfen, ob Ihre Anmeldeinformationen gültig sind.

   Hinweis:

   Das Validieren und Speichern von Anmeldeinformationen bestätigt, dass sich Ihre Mandanten-ID, Ihre Client-ID und Ihr Geheimnis authentifizieren können. Der Zugriff auf ein Postfach wird nicht überprüft: Ein Postfach außerhalb Ihrer Anwendungszugriffsrichtlinie zeigt erst dann einen Fehler an, wenn Sie es hinzufügen und die Synchronisierung versucht, es zu lesen.

10. Wählen Sie die Schaltfläche zum Fortfahren aus.

    Abbildung 5. Die Seite „Integrationskonfiguration erstellen“

    

11. Wählen Sie Postfach hinzufügen aus , um das Postfachformular zu öffnen.

12. Geben Sie die E-Mail-Adresse ein, für die Sie E-Mails in Communications Mining™ kopieren möchten.

13. Wählen Sie Postfach hinzufügen erneut aus, um das Postfach zu speichern.

14. Wählen Sie Integration erstellen aus.