Exchange-Integration mit der Azure-Anwendungsauthentifizierung

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.

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

   

   Registrieren Sie eine neue Anwendung:

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

   

   Azure gibt Ihnen eine Anwendungs-ID (Client) und eine Verzeichnis-ID (Mandant).

   

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 die Option Geheime Clientschlüssel aus, wenn sie nicht bereits 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 12 Monate.
   4. Klicken Sie auf Hinzufügen.

   

   Sie haben jetzt einen geheimen Wert für Ihre Communications Mining™-Anwendung erstellt.

   

   Hinweis:

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

4. Legen Sie 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 APIs aus, die meine Organisation verwendet.

   

   4. Suchen Sie nach „Office 365 Exchange Online“ und wählen Sie es aus.
   5. Wählen Sie „Anwendungsberechtigungen“ aus.

   

   6. Wählen Sie die Option „full_access_as_app“ aus.
   7. Klicken Sie auf Berechtigungen hinzufügen.

   

   8. Klicken Sie zurück im Menü API-Berechtigungen auf Administratorzustimmung gewähren für Communications Mining.
   9. Wählen Sie im Popup- Fenster Administratorzustimmung gewähren die Option Ja aus.

   

5. Beschränken Sie den Zugriff auf das Postfach mit einer Richtlinie für den bedingten Zugriff.

   Zu diesem Zeitpunkt werden Sie wahrscheinlich die Anwendungsberechtigungen einschränken wollen, sodass nur auf bestimmte Postfächer in Ihrer Organisation zugegriffen werden kann. Weitere Informationen dazu finden Sie im Artikel Einschränken von Anwendungsberechtigungen auf bestimmte Exchange Online-Postfächer von Microsoft.

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.