Microsoft Outlook-Konfiguration

Auf dieser Seite wird beschrieben, wie Sie eine Drittanbieterkonfiguration einrichten und konfigurieren, bevor Sie den Outlook-Datenspeicher erstellen.

Authentifizierung und Berechtigungen einrichten

Sie müssen die Authentifizierung und Berechtigungen im Microsoft Entra Admin Center einrichten. Dies ist entscheidend, damit der Connector auf Daten zugreifen und diese synchronisieren kann.

Entra-Anwendung für Microsoft Outlook-Connector registrieren

Bevor Sie den Microsoft Outlook-Connector in Gemini Enterprise erstellen, müssen Sie eine Microsoft Entra-Anwendung registrieren, um den sicheren Zugriff zu ermöglichen.

So registrieren Sie Gemini Enterprise als OAuth 2.0-Anwendung in Entra:

  1. Rufen Sie das Microsoft Entra Admin Center auf.
  2. Maximieren Sie im Navigationsmenü Entra ID und wählen Sie App-Registrierungen aus.
  3. Klicken Sie auf der Seite App-Registrierungen auf Neue Registrierung.
  4. Führen Sie auf der Seite Anwendung registrieren die folgenden Schritte aus:

    1. Geben Sie im Feld Name einen Namen für Ihre App ein.
    2. Wählen Sie im Bereich Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis aus.
    3. Führen Sie im Abschnitt Weiterleitungs-URI die folgenden Schritte aus:
      1. Wählen Sie in der Plattformliste Web aus.
      2. Geben Sie im Feld „Weiterleitungs-URI“ https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html ein.
        1. Klicken Sie auf Registrieren. Microsoft Entra erstellt die Anwendung und zeigt die Übersichtsseite der Anwendung an.
  5. Klicken Sie im Navigationsmenü der App auf Authentifizierung.

  6. Klicken Sie auf Weiterleitungs-URI hinzufügen.

  7. Führen Sie im Bereich für die Plattformauswahl die folgenden Schritte aus:

    1. Wählen Sie Web aus.
    2. Geben Sie im Feld Weiterleitungs-URI den Wert https://vertexaisearch.cloud.google.com/oauth-redirect ein.
    3. Klicken Sie auf Konfigurieren.

Föderierte Anmeldedaten für die Datenaufnahme hinzufügen

Wenn Sie Datenaufnahme als Verbindungsmodus und Föderierte Anmeldedaten als Authentifizierungsmethode verwenden, gehen Sie so vor:

  1. Klicken Sie im Navigationsmenü der App auf Zertifikate und Secrets.
  2. Wählen Sie den Tab Föderierte Anmeldedaten aus.
  3. Klicken Sie auf Anmeldedaten hinzufügen.
  4. Wählen Sie in der Liste Szenario der föderierten Anmeldedaten die Option Anderer Aussteller aus.
  5. Geben Sie im Feld Aussteller den Wert https://accounts.google.com ein.
  6. Geben Sie im Feld Subjekt-ID den Wert ein, den Sie in derGoogle Cloud Console erhalten. Dieser Wert wird während der Erstellung des Microsoft Outlook-Datenspeichers im Datenbereich generiert.
  7. Geben Sie im Feld Name ein eindeutiges Label für die föderierten Anmeldedaten ein.
  8. Klicken Sie auf Hinzufügen, um Zugriff zu gewähren.

OAuth 2.0-Konfiguration erstellen

Wenn Sie eine Verbindung mit der Authentifizierungsmethode OAuth 2.0 erstellen möchten, müssen Sie auf der Registrierungsseite Ihrer Microsoft Entra-Anwendung eine Client-ID, einen Clientschlüssel und Ihre Mandanten-ID abrufen.

Client-ID und Clientschlüssel abrufen

  1. So rufen Sie die Client-ID ab:

    1. Wählen Sie im Navigationsmenü der App Übersicht aus.
    2. Kopieren Sie die ID der Anwendung (Client).
  2. So rufen Sie den Clientschlüssel für die App ab:

    1. Wählen Sie im Navigationsmenü der App Zertifikate und Secrets aus.
    2. Klicken Sie auf Neuer Clientschlüssel.
    3. Gehen Sie im Bereich „Clientschlüssel“ so vor:
      1. Geben Sie im Feld Beschreibung eine Beschreibung für das Secret ein.
      2. Wählen Sie in der Liste Läuft ab eine Ablaufdauer aus.
      3. Klicken Sie auf Hinzufügen.
    4. Kopieren Sie den Clientschlüssel aus der Spalte Wert.

Mandanten-ID abrufen

Sie finden Ihre Mandanten-ID im Microsoft Entra Admin Center auf der Übersichtsseite im Feld Mandanten-ID.

Microsoft API-Berechtigungen konfigurieren

So konfigurieren Sie die erforderlichen API-Berechtigungen für die App:

  1. Wählen Sie auf der App-Seite API-Berechtigungen aus.

  2. Klicken Sie auf Berechtigungen hinzufügen.

  3. Wählen Sie auf der Seite API-Berechtigungen anfordern die Option Microsoft Graph aus.

  4. Suchen Sie nach den folgenden Berechtigungen und wählen Sie sie je nach Verbindungsmodus aus:

    Verbindungsmodus Berechtigung Purpose
    Föderierte Suche Mail.Read
    Mail.Read.Shared
    Calendars.Read
    Contacts.Read
    (Delegiert) Ermöglicht dem Datenspeicher, das Postfach des angemeldeten Nutzers, E‑Mails aus freigegebenen Postfächern, Kalendertermine und Kontakte zu lesen.
    Datenaufnahme Calendars.Read (Anwendung) Ermöglicht dem Datenspeicher, Termine aller Kalender zu lesen.
    Calendars.ReadBasic.All (Anwendung) Ermöglicht dem Datenspeicher, Termine aller Kalender zu lesen, mit Ausnahme von Eigenschaften wie Text, Anhängen und Erweiterungen.
    Contacts.Read (Anwendung) Ermöglicht dem Datenspeicher, alle Kontakte in allen Postfächern zu lesen.
    Mail.Read (Anwendung) Ermöglicht dem Datenspeicher, E‑Mails in allen Postfächern zu lesen.
    Mail.ReadBasic (Anwendung) Ermöglicht dem Datenspeicher, grundlegende E‑Mail-Eigenschaften in allen Postfächern zu lesen. Enthält alle Properties außer „body“, „previewBody“, „attachments“ und alle erweiterten Properties.
    Mail.ReadBasic.All (Anwendung) Ermöglicht dem Datenspeicher, grundlegende E‑Mail-Eigenschaften in allen Postfächern zu lesen. Enthält alle Properties außer „body“, „previewBody“, „attachments“ und alle erweiterten Properties.
    User.Read (Delegiert) Ermöglicht dem Datenspeicher, das Profil angemeldeter Nutzer zu lesen.
    User.Read.All (Anwendung) Ermöglicht dem Datenspeicher, alle Profileigenschaften, Berichte und Manager anderer Nutzer in Ihrer Organisation zu lesen.
    User.ReadBasic.All (Anwendung) Ermöglicht dem Datenspeicher, einen grundlegenden Satz von Profileigenschaften anderer Nutzer in Ihrer Organisation zu lesen.
    Aktionen Mail.Send (Delegiert) Ermöglicht dem Datenspeicher, E‑Mails im Namen von Nutzern in der Organisation zu senden.
    Mail.ReadWrite (Delegiert) Erforderlich für die Aktionen **Anhänge hinzufügen**, **Nachricht erstellen**, **Nachricht aktualisieren** und **E‑Mail verschieben**.
    Calendars.ReadWrite (Delegiert) Ermöglicht dem Datenspeicher, Termine in Nutzerkalendern zu erstellen, zu lesen, zu aktualisieren und zu löschen.
    Contacts.ReadWrite (Delegiert) Ermöglicht dem Datenspeicher, Nutzerkontakte zu erstellen, zu lesen, zu aktualisieren und zu löschen.
    User.Read (Delegiert) Ermöglicht dem Datenspeicher, das Profil angemeldeter Nutzer zu lesen.
    Produktivität (Excel, Word, PowerPoint) Files.Read.All (Delegiert) Nur ausreichend für Tools, die Dateimetadaten lesen oder Dateiinhalte herunterladen: Auflisten von Excel-Arbeitsmappen, Lesen von Metadaten von Excel-Arbeitsmappen und Konvertieren von Word- (.docx) oder PowerPoint-Dokumenten (.pptx) in PDF. Nicht ausreichend für Vorgänge mit Inhalten von Excel-Arbeitsmappen (siehe nächste Zeile).
    Files.ReadWrite.All (Delegiert) Erforderlich für alle Vorgänge mit Excel-Arbeitsmappeninhalten (Lesen und Schreiben), einschließlich Arbeitsblätter abrufen, Tabellen abrufen, Zeilen abrufen, Zeile abrufen, Arbeitsblätter und Tabellen erstellen, Zeilen hinzufügen und aktualisieren sowie Schlüsselspalten hinzufügen. Gemäß der Microsoft Graph API-Referenz für diese Endpunkte (z. B. worksheet-list, table-list, tablerow-list) ist die akzeptierte delegierte Berechtigung Files.ReadWrite. Files.ReadWrite.All gewährt dieselbe Funktion für alle Laufwerke, auf die der Nutzer zugreifen kann. Auch erforderlich, um Word- und PowerPoint-Dokumente im OneDrive des Nutzers zu erstellen.
    User.Read (Delegiert) Erforderlich, um den OneDrive-Speicherort des angemeldeten Nutzers für Dateioperationen aufzulösen.
    Aufgaben (Outlook-To-do-Listen und -Aufgaben) Tasks.Read (Delegiert) Erforderlich für Lesevorgänge in den Outlook-Aufgabenlisten und ‑Aufgaben des angemeldeten Nutzers (Aufgabenlisten auflisten, Aufgaben auflisten, Aufgabe abrufen).
    Tasks.ReadWrite (Delegiert) Erforderlich für Schreibvorgänge: Erstellen, Aktualisieren und Löschen von Aufgaben in den Outlook-Aufgabenlisten des angemeldeten Nutzers.
    Nutzer und Verzeichnis (delegierte Aufzählung) User.ReadBasic.All (Delegiert) Erforderlich für Tools, die Profile anderer Nutzer in der Organisation auflisten oder suchen (Nutzer abrufen, Nutzer auflisten und Tools, die auf Postfächer oder Kalender anderer Nutzer zugreifen).
  5. Klicken Sie auf Berechtigungen hinzufügen.

Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie häufige Probleme mit dem Microsoft Outlook-Connector beheben.

Probleme mit der REST API und der Nachrichtensuche beheben

Wenn der Gemini Enterprise-Assistent meldet, dass die Nachrichtensuche nicht funktioniert oder die REST API für das Postfach eines Nutzers nicht aktiviert ist (entspricht einem MailboxNotEnabledForRESTAPI-Fehler von Microsoft Graph), können Sie das Problem in Ihrer Microsoft-Umgebung beheben.

Dieser Fehler tritt aus folgenden Gründen auf:

  • Das Postfach wird lokal gehostet (in einer hybriden Exchange-Bereitstellung) und wurde nicht für den REST API-Zugriff aktiviert.

  • Das Postfach ist inaktiv oder wurde vorläufig gelöscht.

  • Der Mandant oder das Verzeichnis stimmt nicht überein.

Prüfen Sie, ob das Postfach in Exchange Online gehostet wird, oder konfigurieren Sie den REST API-Zugriff für Hybridpostfächer, um dieses Problem zu beheben. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter How to fix MailboxNotEnabledForRESTAPI.

Nutzer sehen beim Herstellen einer Verbindung die Meldung „Administratorgenehmigung erforderlich“

Wenn Nutzer zum ersten Mal über die Gemini Enterprise-Web-App eine Verbindung zu Microsoft Outlook herstellen, zeigt Microsoft möglicherweise den Bildschirm Administratorgenehmigung erforderlich an. Das passiert, wenn Gemini Enterprise Berechtigungen auf Administratorebene anfordert oder wenn Ihr Microsoft Entra-Mandant Nutzern verbietet, Drittanbieter-Apps ohne vorherige mandantenweite Zustimmung des Administrators zu autorisieren.

Um dieses Problem zu beheben, muss ein Administrator die erste Autorisierung durchführen. Danach können andere Nutzer in Ihrem Mandanten eine Verbindung herstellen, ohne dass der Genehmigungsbildschirm angezeigt wird.

  1. Bitten Sie einen Microsoft Entra ID-Administrator, der eine mandantenweite Einwilligung erteilen kann, sich in der Gemini Enterprise-Web-App anzumelden und eine Verbindung zu Microsoft Outlook herzustellen.

  2. Auf dem Bildschirm mit den Berechtigungen muss der Administrator Einwilligung im Namen Ihrer Organisation auswählen und dann auf Akzeptieren klicken.

  3. Bitte die Nutzer, es noch einmal zu versuchen.

Weitere Informationen finden Sie in der Microsoft Entra-Dokumentation unter Administratoreinwilligung auf Mandantenebene erteilen.