Microsoft OneDrive konfigurieren

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

Authentifizierung und Berechtigungen einrichten

Sie müssen die Authentifizierung und Berechtigungen in Microsoft 365 einrichten. Dies ist wichtig, damit der Connector auf Daten zugreifen und diese synchronisieren kann. Der OneDrive-Connector unterstützt verschiedene Authentifizierungsmethoden, z. B. OAuth-Clientanmeldedaten oder API-Tokens.

Microsoft Entra-Anwendung für Microsoft OneDrive-Connector registrieren

Bevor Sie den Connector in Gemini Enterprise erstellen können, müssen Sie eine Entra-Anwendungsregistrierung einrichten, um den sicheren Zugriff auf Microsoft OneDrive 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.
    4. Klicken Sie auf Registrieren. Microsoft Entra erstellt Ihre Anwendung und zeigt die Übersichtsseite Ihrer 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 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 der Google Cloud Console erhalten. Dieser Wert wird während der Erstellung des Microsoft OneDrive-Datenspeichers im Abschnitt „Daten“ 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 OAuth 2.0-Authentifizierungsmethode 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. Rufen Sie die App-Seite auf.
  2. Wählen Sie im Navigationsmenü der App API-Berechtigungen aus.

  3. Klicken Sie auf Berechtigungen hinzufügen.

  4. Wählen Sie im Bereich API-Berechtigungen anfordern die Option Microsoft Graph aus.

  5. Suchen Sie nach den folgenden Berechtigungen und wählen Sie sie aus, je nachdem, welchen Verbindungsmodus Sie verwenden:

Verbindungsmodus Typ Bereich Purpose
Föderierte Suche Delegiert Files.Read.All Ermöglicht dem Datenspeicher, alle Dateien zu lesen, auf die der Nutzer zugreifen kann.
Delegiert Sites.Read.All Ermöglicht dem Datenspeicher, Dokumente und Listenelemente in allen Websitesammlungen zu lesen, auf die der Nutzer zugreifen kann.
Delegiert User.Read.All Ermöglicht dem Datenspeicher, die Drive-Speicherorte von Nutzern für die Inhaltserkennung aufzulösen.
Datenaufnahme Anwendung Files.Read.All Ermöglicht dem Datenspeicher, Dateien in der gesamten Organisation zu lesen und zu synchronisieren, ohne dass ein Nutzer angemeldet sein muss.
Anwendung Group.Read.All Ermöglicht dem Datenspeicher, Attribute und Mitgliedschaften aller Gruppen zu lesen.
Anwendung GroupMember.Read.All Ermöglicht dem Datenspeicher, Mitgliedschaften für alle Gruppen zu lesen, um die Synchronisierung der Zugriffssteuerung (ACL) zu verwalten.
Delegiert User.Read Ermöglicht dem Datenspeicher, das Profil und die grundlegenden Unternehmensinformationen angemeldeter Nutzer zu lesen.
Anwendung Sites.FullControl.All Ermöglicht die vollständige Kontrolle über alle Websitesammlungen.
Anwendung Sites.Selected Ermöglicht den Zugriff auf eine bestimmte Teilmenge von Websitesammlungen.
Nur föderierte Anmeldedaten User.Read.All Ermöglicht dem Datenspeicher, Nutzerprofile zu lesen.
Delegiert User.ReadBasic.All Ermöglicht das Lesen einer Reihe grundlegender Profileigenschaften für Nutzer in der Organisation.
Aktionen Delegiert Files.ReadWrite.AppFolder Ermöglicht dem Datenspeicher, Dateien im Microsoft OneDrive-Ordner zu lesen, zu erstellen, zu aktualisieren und zu löschen.
Delegiert Files.ReadWrite Ermöglicht dem Datenspeicher, die Dateien, auf die der Nutzer zugreifen kann, zu lesen, herunterzuladen, zu erstellen, hochzuladen, zu aktualisieren und zu löschen.
Delegiert Files.ReadWrite.All Ermöglicht dem Datenspeicher, Dateien auf allen Laufwerken zu lesen und zu aktualisieren, auf die der Nutzer Zugriff hat. Erforderlich für die Aktionen zum Ändern von Dateien und Ordnern (Kopieren, Verschieben, Umbenennen, Freigeben, Aktualisieren von Eigenschaften), die für Dateien in anderen Ablagen als dem Microsoft OneDrive des Nutzers ausgeführt werden.
  1. Klicken Sie auf Berechtigungen hinzufügen.
  2. Erteilen Sie die Einwilligung des Administrators. Informationen zum Erteilen der Einwilligung finden Sie in der Microsoft Entra-Dokumentation unter Einer Anwendung Administratoreinwilligung auf Mandantenebene erteilen.

Fehlerbehebung

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

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 OneDrive herstellen, wird möglicherweise der Microsoft-Bildschirm Administratorgenehmigung erforderlich angezeigt. 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 OneDrive 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, die Verbindung noch einmal herzustellen.

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