Exchange Integration mit einem Azure-Dienstbenutzer

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.

Hinweis:

Microsoft stellt Exchange Web Services (EWS) am 1. Oktober 2026 ein. Es wird empfohlen, stattdessen die Exchange-Integration mit der Azure-Anwendungsauthentifizierung und Graph- Anleitung zu folgen.

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. Melden Sie sich bei Azure an

Melden Sie sich bei Ihrem Azure Cloud Portal an.

2. Registrieren Sie eine neue Anwendung für Communications Mining

1. Öffnen Sie das Menü App-Registrierungen und wählen Sie die Option Neue Registrierung aus.

   

2. Registrieren Sie eine neue Anwendung wie folgt:

   1. Geben Sie einen Namen für Ihre Anwendung ein, z. B. reinfer-exchange-integration.
   2. Wählen Sie unter Unterstützte Kontotypen die Option Einzelner Mandant aus.
   3. Wählen Sie Registrieren aus, um die Registrierung abzuschließen.

   

   Azure stellt Ihnen eine Anwendungs-ID (Client) und eine Verzeichnis-ID (Mandant) zur Verfügung, wie in der folgenden Abbildung gezeigt.

   

3. Erstellen Sie einen geheimen Clientschlüssel für Ihre Communications Mining-Anwendung

Um Ihre Anwendung sicher zu halten, müssen Sie einen geheimen Clientschlüssel erstellen, um sich bei Ihrer Anwendung anzumelden. Wählen Sie zuerst Zertifikate und Geheimschlüssel unter der Seitenleiste Verwalten aus und fahren Sie dann mit den folgenden Schritten fort:

1. Wählen Sie Geheime Clientschlüssel aus, wenn dies nicht automatisch ausgewählt ist.

2. Wählen Sie Neuer geheimer Clientschlüssel aus.

   

3. Fügen Sie in der Seitenleiste eine leicht erkennbare Beschreibung hinzu und wählen Sie ein Ablaufdatum aus. Wir empfehlen, als Ablaufdatum 12 Monate festzulegen.

4. Wählen Sie Hinzufügen aus , um einen geheimen Wert für Ihre Communications Mining™-Anwendung zu erstellen.

   

   

   Hinweis:

   Azure zeigt Ihnen den geheimen Wert nur einmal an, also kopieren Sie ihn. Wenn Sie Ihren geheimen Wert jemals verlieren, führen Sie Schritt 3 erneut aus, um einen neuen zu erstellen.

4. Legen Sie die API-Berechtigungen fest

1. Navigieren Sie in der Seitenleiste Verwalten zu API-Berechtigungen .

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

   

3. Wählen Sie Microsoft-APIs und dann Microsoft Graph aus.

   

4. Wählen Sie Delegierte Berechtigungen aus.

5. Geben Sie im Textfeld Berechtigungen auswählen EWS.Access ein.

6. Erweitern Sie die EWS-Berechtigung und aktivieren Sie das Kontrollkästchen für EWS.AccessAsUser.All.

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

   

8. Kehren Sie zum Menü API-Berechtigungen zurück und wählen Sie Administratorzustimmung gewähren für Communications Mining aus .

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

   

5. Gewähren Sie dem Dienstbenutzer Zugriff auf die freigegebenen Postfächer

Sie benötigen ein Dienstkonto mit Zugriff auf die Postfächer, die Sie mit Communications Mining™ verbinden möchten.

1. Erstellen Sie ein Dienstkonto:
   • Fügen Sie einen Benutzer hinzu.
   • Weisen Sie dem Benutzer Lizenzen zu.
2. Gewähren Sie einem Dienstkonto Zugriff auf freigegebene Postfächer. Es reicht, dem Dienstkonto nur schreibgeschützten Zugriff zu gewähren. Verwenden Sie dazu eine der folgenden Methoden:
   • Erstellen Sie freigegebene Postfächer und gewähren Sie Benutzern Zugriff, einschließlich des Dienstkontos.
   • Gewähren Sie dem Dienstkonto Zugriff auf die E-Mails eines Benutzers.

6. Melden Sie sich bei Communications Mining an

Melden Sie sich wie gewohnt über UiPath® Automation Cloud bei Communications Mining an.

7. Erstellen Sie eine neue Integration in Communications Mining

1. Navigieren Sie von Communications Mining zur Seite Administration .

2. Wählen Sie Neue Integration aus.

   

3. Konfigurieren Sie auf der Seite Neue Integration erstellen unter Grundlegende Informationen hinzufügen die folgenden Felder:

   • Projekt – Wählen Sie ein vorhandenes Projekt aus.
   • Titel – Geben Sie optional einen Titel ein.
   • API-Name – Geben Sie einen Namen für Ihre Integration ein.

Hinweis:

Sobald Sie den API-Namen festgelegt haben, können Sie ihn nicht mehr ändern.

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

   

5. Konfigurieren Sie unter Verbindung mit Ihrer Anwendung herstellen Folgendes:

   • Wählen Sie den API-Typ aus: Graph-API oder EWS-API.

   • Wählen Sie die Authentifizierungsmethode aus: Mit geheimem Clientschlüssel, Mit privatem Schlüssel und Fingerabdruck oder Mit NTLM.

     Hinweis:

     NTLM unterstützt nur Delegiertenzugriff. Weitere Informationen finden Sie in der Microsoft-Dokumentation zu Delegiertenzugriff und EWS in Exchange.

   • URL der OAuth-Stelle – Geben Sie die URL der OAuth-Stelle mithilfe der Mandanten-ID aus Schritt 2 ein, wenn Sie eine neue Anwendung für Communications Mining registriert haben, und zwar im folgenden Format: https://login.microsoftonline.com/{tenant_id}.

   • OAuth-Client-ID – Geben Sie die OAuth-Client-ID aus Schritt 2 ein.

   • Geheimer Clientschlüssel – Geben Sie den geheimen Clientschlüssel aus Schritt 3 ein.

   • Wählen Sie eine der folgenden Optionen aus:

     • Mit Dienstbenutzerzugriff – Geben Sie den Benutzernamen und das Kennwort Ihres Dienstkontos ein.
     Hinweis:

     Die Graph-API unterstützt keinen Dienstbenutzerzugriff.

     • Mit Anwendungszugriff

   • Wählen Sie Anmeldeinformationen validieren und speichern aus.

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

   

7. Wählen Sie unter Ihre Eingabedaten auswählen die Option Postfach hinzufügen aus und konfigurieren Sie die folgenden Felder:

   Postfachname

   • E-Mail – Geben Sie die E-Mail-Adresse ein.

   Bucket

   • Neuer Bucket – Wählen Sie eine der folgenden Optionen aus:
     • Neuen Bucket erstellen – Erstellen Sie automatisch einen Bucket für das Postfach.
     • Benutzerdefinierter neuer Bucket – Definieren Sie einen benutzerdefinierten Bucket, indem Sie ein Projekt, einen Namen und einen Titel angeben.
   • Vorhandener Bucket – Wählen Sie einen vorhandenen Orchestrator-Bucket aus.

   Zeitfilter

   Hinweis:

   Wählen Sie ein Datum aus, ab dem synchronisiert werden soll. Sie können dies bei Bedarf für weitere Synchronisierung aktualisieren. Bereits synchronisierte Daten sind davon nicht betroffen. Wenn die Gesamtvolumen unbekannt sind, empfehlen wir, die Volumen zu messen, indem Sie zuerst einen kürzeren Zeitraum synchronisieren. AI Units werden beim Hochladen in Rechnung gestellt.

   • Von Zeitstempel – Konfigurieren Sie das folgende Feld:
     • Synchronisierung über Zeitstempel – Geben Sie ein Datum ein, ab dem synchronisiert werden soll. In der Regel wird empfohlen, die Daten von mindestens 6 bis 12 Monaten zu synchronisieren.
   • Gesamte Zeit – Synchronisiert alle verfügbaren Daten.
   Wichtig:

   Diese Option kann mehr AI Units als erwartet verbrauchen.

   Ordnerfilter

   Hinweis:

   Beim Anwenden von Ordnerfiltern:

   • Geschachtelte Ordner werden durch einen Schrägstrich / getrennt.
   • In Outlook sichtbare Ordner haben normalerweise das Präfix root/Top of Information Store/.
   • Das Zulassen von Ordnern bedeutet, dass nicht explizit zulässige Ordner verweigert werden.
   • Sie können einen Ordner innerhalb eines zulässigen Ordners verweigern.
   • Sie können einen Ordner innerhalb eines verweigerten Ordners nicht zulassen.
   • Zulässige Ordner – Geben Sie die zulässigen Ordner ein.
   • Verweigerte Ordner – Geben Sie die verweigerten Ordner ein.
   Hinweis:

   Stellen Sie sicher, dass Sie den Ordnerspeicherort in diesem Format eingeben: root/Top of Information Store/.

   Tipp:

   Beschränken Sie den Ordnerfilter-Scope auf die Mindestanforderungen für Ihren Anwendungsfall. Wenn Sie Zulässige Ordner leer lassen, wird die Integration kontinuierlich mit jedem Ordner im Postfach synchronisiert – einschließlich Archivieren und wiederherstellbaren Elementen (Bereinigungen) –, was die Synchronisierung erheblich verlangsamt. Lassen Sie für die meisten BAU-Verarbeitungen nur Folgendes zu:

   • root/Top of Information Store/Inbox
   • root/Top of Information Store/Sent Items

   Teilnehmerfilter

   Hinweis:

   Beim Anwenden von Teilnehmerfiltern:

   • Das Zulassen von Teilnehmern bedeutet, dass nicht explizit zulässige Teilnehmer verweigert werden.
   • Jeder verweigerte Teilnehmer wird verweigert, auch wenn er ebenfalls in der Zulassungsliste angezeigt wird.
   • * Bei Teilnehmerfiltern wird die Groß-/Kleinschreibung nicht berücksichtigt.
   • Zulässige Teilnehmer – Geben Sie die E-Mail-Adressen der zulässigen Teilnehmer ein.
   • Verweigerte Teilnehmer – Geben Sie die E-Mail-Adressen der verweigerten Teilnehmer ein.

   Teilnehmerdomänenfilter

   Hinweis:

   Beim Anwenden von Teilnehmerdomänenfiltern:

   • Das Zulassen von Domänen bedeutet, dass nicht explizit zulässige Teilnehmer verweigert werden.
   • Jede verweigerte Teilnehmerdomäne wird verweigert, auch wenn sie ebenfalls in der Zulassungsliste angezeigt wird.
   • Dabei können Sie die Domäne der obersten Ebene mit einem Platzhalter versehen. reinfer.* stimmt beispielsweise reinfer.dev und reinfer.com überein.
   • * Bei Teilnehmerdomänenfiltern wird die Groß-/Kleinschreibung nicht berücksichtigt.
   • Zulässige Teilnehmerdomänen – Geben Sie die Domänen der zulässigen Teilnehmer ein, z. B. gmail.com.
   • Domänen verweigerter Teilnehmer – Geben Sie die Domänen der verweigerten Teilnehmer ein, z. B. gmail.com.

   Anhänge (Attachments)

   • Anhangsinhalte synchronisieren – Aktivieren Sie diese Option, um auch E-Mail-Anhänge zu synchronisieren.
   8. Wählen Sie eine der folgenden Optionen aus:
      • Postfach hinzufügen
      • Neues Postfach verwerfen
   9. Wählen Sie Integration erstellen aus.

Letzte Schritte

Sie haben nun erfolgreich eine Integration zwischen Communications Mining™ und Microsoft Exchange über Azure erstellt. Sie können die Integration mit dem Umschalter deaktivieren, wie in der folgenden Abbildung gezeigt. Um sie zu löschen, wählen Sie das Papierkorbsymbol aus.

Sie können die Synchronisierung von Anhängen auch auf Postfachebene auf einer Exchange-Integration aktivieren. Die Streams-API macht die Anhänge dann über eine Anhangsreferenz abrufbar. Weitere Informationen zum Synchronisieren von Anhängen finden Sie auf den Seiten Anhänge und Verwenden von Exchange-Integrationen .

Wenn Sie Fragen haben oder Unterstützung bei der Integration benötigen, wenden Sie sich an den UiPath®-Support.