Microsoft 365-Konfiguration

Auf dieser Seite wird beschrieben, wie Sie eine Drittanbieteranwendung einrichten und konfigurieren, bevor Sie den Microsoft 365-Datenspeicher erstellen.

Authentifizierung und Berechtigungen einrichten

Der Microsoft 365-Connector meldet sich als Endnutzer über den OAuth 2.0-Autorisierungscode-Vorgang bei der Microsoft Identity Platform an. Alle Microsoft Graph-Berechtigungen werden delegiert, sodass der Connector nur auf die Daten zugreifen kann, auf die der angemeldete Nutzer bereits Zugriff hat. Sie können die Authentifizierung auf zwei Arten konfigurieren:

  • VonGoogleverwaltetes OAuth (OAuth 2.0 (von Google verwaltet), Standard): Der Connector verwendet eine mandantenfähige Microsoft Entra-Anwendung, die vonGoogle registriert und verwaltet wird. Sie müssen keine Anwendung registrieren und keine Mandanten-ID, Client-ID oder keinen Clientschlüssel eingeben. Weitere Informationen finden Sie unter Von Googleverwaltetes OAuth verwenden.
  • Eigene App verwenden (OAuth 2.0 (Eigene App verwenden)): Sie registrieren Ihre eigene Microsoft Entra-Anwendung, gewähren ihr die Microsoft Graph-Berechtigungen für die Aktionen, die Sie aktivieren möchten, und geben die Mandanten-ID, die Client-ID und den Clientschlüssel in Gemini Enterprise ein. Wählen Sie diese Option aus, wenn Ihre Organisation die Anwendung und ihre Berechtigungen direkt steuern muss, wenn Sie ausgehenden Traffic mit statischer IP-Adresse benötigen oder wenn sich Ihr Mandant in einer US-Government-Cloud befindet. Weitere Informationen finden Sie unter Microsoft Entra-Anwendung registrieren.

Von Googleverwaltetes OAuth verwenden

Bei OAuth 2.0 (von Google verwaltet) erstellen Sie nichts in Microsoft Entra, bevor Sie den Datenspeicher erstellen. Wenn ein Nutzer den Connector autorisiert, bittet Microsoft ihn, den Microsoft Graph-Berechtigungen zuzustimmen, die für die aktivierten Aktionen erforderlich sind. Eine vollständige Liste finden Sie unter Microsoft API-Berechtigungen konfigurieren.

Für einige dieser Berechtigungen und einige Richtlinien zur Einwilligung von Mandanten ist die Einwilligung eines Microsoft Entra-Administrators im Namen der Organisation erforderlich. Wenn Nutzer bei der Autorisierung des Connectors die Meldung Administratorgenehmigung erforderlich sehen, muss ein Administrator die mandantenweite Einwilligung für die von Googleverwaltete Anwendung erteilen. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Einer Anwendung Administratoreinwilligung auf Mandantenebene erteilen.

Beachten Sie bei der Verwendung von von Googleverwaltetem OAuth Folgendes:

  • Die von Googleverwaltete Anwendung ist in der kommerziellen Microsoft-Cloud registriert. Belassen Sie daher den Microsoft 365-Umgebungstyp auf Standard. Verwenden Sie für Mandanten in GCC High oder DoD OAuth 2.0 (Bring Your Own App).
  • Ausgehender Traffic über statische IP-Adressen ist nicht verfügbar, da die freigegebene Anwendung keine kundenspezifische IP-Zulassungsliste enthalten kann.

Der Rest dieses Abschnitts gilt nur für OAuth 2.0 (Bring Your Own App).

Microsoft Entra-Anwendung für den Microsoft 365-Connector registrieren

So registrieren Sie Gemini Enterprise als OAuth 2.0-Anwendung in Microsoft 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/oauth-redirect ein.
    4. Klicken Sie auf Registrieren. Microsoft Entra erstellt Ihre Anwendung und zeigt die Übersichtsseite Ihrer Anwendung an.

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

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

Microsoft API-Berechtigungen konfigurieren

Wenn Sie OAuth 2.0 (Bring Your Own App) verwenden, gewähren Sie Ihrer App die delegierten Microsoft Graph-Berechtigungen für die Aktionen, die Sie aktivieren möchten. Wenn Sie OAuth 2.0 (von Google verwaltet) verwenden, fügen Sie diese Berechtigungen nicht selbst hinzu. Nutzer werden aufgefordert, ihnen zuzustimmen, wenn sie den Connector autorisieren.

Die für jede Aktion erforderlichen Berechtigungen sind in der Spalte Erforderliche Berechtigungen der Tabellen mit den unterstützten Aktionen aufgeführt. Für jede Verbindung sind außerdem User.Read und offline_access erforderlich.

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

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

  2. Klicken Sie auf Berechtigung hinzufügen.

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

  4. Suchen Sie nach User.Read, offline_access und den Berechtigungen, die für jede Aktion aufgeführt sind, die Sie aktivieren möchten, und wählen Sie sie aus.

  5. Klicken Sie auf Berechtigungen hinzufügen.

Sovereign und Government Clouds

Wenn sich Ihr Mandant nicht in der Standard-Microsoft-Cloud befindet, legen Sie beim Erstellen des Datenspeichers die beiden folgenden Einstellungen fest. Für die Anmeldung über US Government ist OAuth 2.0 (Bring Your Own App) mit einer in dieser Cloud registrierten App erforderlich.

  • Microsoft 365-Umgebungstyp im Abschnitt Authentifizierungseinstellungen wählt den Anmeldeendpunkt aus: Standard verwendet login.microsoftonline.com und US Government verwendet login.microsoftonline.us.

  • Microsoft 365-Cloud-Umgebung: Wählen Sie im Abschnitt Erweiterte Optionen den Microsoft Graph-Endpunkt aus: Standard / GCC verwendet https://graph.microsoft.com, GCC High verwendet https://graph.microsoft.us und DoD verwendet https://dod-graph.microsoft.us.

Fehlerbehebung

In diesem Abschnitt werden Fehler beschrieben, die nach der Konfiguration der Microsoft Entra-Anwendung auftreten können, und wie Sie sie beheben.

Aktionen schlagen mit HTTP 403 fehl

Bei einer Aktion, die HTTP 403 zurückgibt, fehlt normalerweise eine Berechtigung. Prüfen Sie, ob die für die Aktion erforderliche Berechtigung erteilt wurde, ob die Administratorzustimmung gegebenenfalls erteilt wurde und ob die Verbindung nach der Aktivierung der Aktion neu autorisiert wurde. Prüfen Sie bei OAuth 2.0 (Bring Your Own App) auch, ob die Berechtigung in Ihrer Microsoft Entra-App-Registrierung gewährt wird. Ein vorhandenes Aktualisierungstoken enthält nur die Bereiche, denen bei der Ausstellung zugestimmt wurde.

E‑Mail-Suche gibt MailboxNotEnabledForRESTAPI zurück

Dieser Fehler bedeutet, dass die Mailbox über Microsoft Graph nicht erreichbar ist. Er tritt auf, wenn das Postfach lokal in einer hybriden Exchange-Bereitstellung gehostet wird, wenn das Postfach inaktiv oder vorläufig gelöscht ist oder wenn ein Mandanten- oder Verzeichniskonflikt vorliegt. Achten Sie darauf, dass das Postfach in Exchange Online gehostet wird. Weitere Informationen finden Sie in der Microsoft-Dokumentation unter Problemlösung: MailboxNotEnabledForRESTAPI.