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:
- Rufen Sie das Microsoft Entra Admin Center auf.
- Maximieren Sie im Navigationsmenü Entra ID und wählen Sie App-Registrierungen aus.
- Klicken Sie auf der Seite App-Registrierungen auf Neue Registrierung.
Führen Sie auf der Seite Anwendung registrieren die folgenden Schritte aus:
- Geben Sie im Feld Name einen Namen für Ihre App ein.
- Wählen Sie im Bereich Unterstützte Kontotypen die Option Nur Konten in diesem Organisationsverzeichnis aus.
- Führen Sie im Abschnitt Weiterleitungs-URI die folgenden Schritte aus:
- Wählen Sie in der Plattformliste
Webaus. - Geben Sie im Feld „Weiterleitungs-URI“
https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.htmlein.
- Wählen Sie in der Plattformliste
- Klicken Sie auf Registrieren. Microsoft Entra erstellt Ihre Anwendung und zeigt die Übersichtsseite Ihrer Anwendung an.
Klicken Sie im Navigationsmenü der App auf Authentifizierung.
Klicken Sie auf Weiterleitungs-URI hinzufügen.
Führen Sie im Bereich für die Plattformauswahl die folgenden Schritte aus:
- Wählen Sie Web aus.
- Geben Sie im Feld Weiterleitungs-URI
https://vertexaisearch.cloud.google.com/oauth-redirectein. - 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:
- Klicken Sie im Navigationsmenü der App auf Zertifikate und Secrets.
- Wählen Sie den Tab Föderierte Anmeldedaten aus.
- Klicken Sie auf Anmeldedaten hinzufügen.
- Wählen Sie in der Liste Szenario der föderierten Anmeldedaten die Option Anderer Aussteller aus.
- Geben Sie im Feld Aussteller den Wert
https://accounts.google.comein. - 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.
- Geben Sie im Feld Name ein eindeutiges Label für die föderierten Anmeldedaten ein.
- 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
So rufen Sie die Client-ID ab:
- Wählen Sie im Navigationsmenü der App Übersicht aus.
- Kopieren Sie die ID der Anwendung (Client).
So rufen Sie den Clientschlüssel für die App ab:
- Wählen Sie im Navigationsmenü der App Zertifikate und Secrets aus.
- Klicken Sie auf Neuer Clientschlüssel.
- Gehen Sie im Bereich „Clientschlüssel“ so vor:
- Geben Sie im Feld Beschreibung eine Beschreibung für das Secret ein.
- Wählen Sie in der Liste Läuft ab eine Ablaufdauer aus.
- Klicken Sie auf Hinzufügen.
- 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:
- Rufen Sie die App-Seite auf.
Wählen Sie im Navigationsmenü der App API-Berechtigungen aus.
Klicken Sie auf Berechtigungen hinzufügen.
Wählen Sie im Bereich API-Berechtigungen anfordern die Option Microsoft Graph aus.
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. |
- Klicken Sie auf Berechtigungen hinzufügen.
- 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.
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.
Auf dem Bildschirm mit den Berechtigungen muss der Administrator Einwilligung im Namen Ihrer Organisation auswählen und dann auf Akzeptieren klicken.
Bitte die Nutzer, die Verbindung noch einmal herzustellen.
Weitere Informationen finden Sie in der Microsoft Entra-Dokumentation unter Administratoreinwilligung auf Mandantenebene erteilen.