Damit Sie Gemini Enterprise erfolgreich mit Microsoft SharePoint verbinden können, müssen Sie die folgenden Konfigurationsschritte ausführen.
Authentifizierung und Berechtigungen einrichten
Sie müssen die Authentifizierung und Berechtigungen im Microsoft Entra Admin Center einrichten. Das ist wichtig, damit der Connector auf Daten zugreifen und sie synchronisieren kann.
Microsoft Entra-App für den Microsoft SharePoint-Connector registrieren
Bevor Sie den Microsoft SharePoint-Connector in Gemini Enterprise erstellen, registrieren Sie eine Microsoft Entra-Anwendung, um den sicheren Zugriff 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 folgende Schritte aus:
- Wählen Sie in der Plattformliste
Webaus. - Geben Sie im Feld „Weiterleitungs-URI“
https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.htmlein.
- Wählen Sie in der Plattformliste
- Klicken Sie auf Registrieren. Microsoft Entra erstellt die App und zeigt die Übersichtsseite der App an.
Klicken Sie im Navigationsmenü der App auf Authentifizierung.
Klicken Sie auf Weiterleitungs-URI hinzufügen.
Führen Sie im Bereich zur Plattformauswahl die folgenden Schritte aus:
- Wählen Sie Web aus.
- Geben Sie im Feld Weiterleitungs-URI den Wert
https://vertexaisearch.cloud.google.com/oauth-redirectein. - Klicken Sie auf Konfigurieren.
OAuth 2.0-Konfiguration erstellen
Wenn Sie eine Verbindung mit der OAuth 2.0-Authentifizierungsmethode erstellen möchten, benötigen Sie eine Client-ID, einen Clientschlüssel und Ihre Mandanten-ID von der Registrierungsseite Ihrer Microsoft Entra-Anwendung.
Client-ID und Clientschlüssel abrufen
So rufen Sie die Client-ID und das Client-Secret für die App ab:
- Rufen Sie die App-Seite auf.
- Wählen Sie im App-Navigationsmenü Zertifikate und Secrets aus.
- Klicken Sie auf Neuer geheimer 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 in der Spalte Wert (
Client Secret) angezeigten geheimen Schlüssel und die Kennung in der Spalte Geheime ID (Client ID) und speichern Sie beide sicher für die spätere Verwendung.
Instanz-URI abrufen
Der Instanz-URI hat eines der folgenden Formate:
- Für alle Websites der ersten Ebene:
https://DOMAIN_OR_SERVER.sharepoint.com– z. B.mydomain.sharepoint.com. - Für eine einzelne Website:
https://DOMAIN_OR_SERVER.sharepoint.com/sites/WEBSITE– z. B.mydomain.sharepoint.com/sites/sample-site.
Mandanten-ID abrufen
Ihre Mandanten-ID finden Sie 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 App-Navigationsmenü API-Berechtigungen aus.
Klicken Sie auf Berechtigungen hinzufügen.
Wählen Sie im Bereich API-Berechtigungen anfordern die Option Microsoft Graph aus.
Suchen Sie je nach Verbindungsmodus nach den folgenden Berechtigungen und wählen Sie sie aus:
Für den Verbindungsmodus Föderierte Suche sind keine Graph API-Berechtigungen erforderlich.
Für den Verbindungsmodus Datenaufnahme mit Föderierte Anmeldedaten:
Berechtigung Typ Beschreibung GroupMember.Read.AllAnwendung Ermöglicht dem Connector, Mitgliedschaften und grundlegende Gruppeneigenschaften für alle Gruppen ohne angemeldeten Nutzer zu lesen. User.ReadDelegiert Ermöglicht dem Connector, das Profil angemeldeter Nutzer zu lesen. Außerdem kann der Connector grundlegende Unternehmensinformationen angemeldeter Nutzer lesen. Optionen für die Website-Steuerung Option 1: Sites.FullControl.AllAnwendung Ermöglicht dem Connector die vollständige Kontrolle über alle Websitesammlungen. Option 2: Sites.SelectedAnwendung Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen. Die jeweiligen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden. Optionen zum Lesen von Profilen Option 1: User.Read.AllAnwendung Ermöglicht dem Connector, Nutzerprofile zu lesen. Option 2: User.ReadBasic.AllAnwendung Ermöglicht dem Connector, eine grundlegende Gruppe von Profileigenschaften anderer Nutzer in der Organisation zu lesen. Für den Verbindungsmodus Data ingestion (Datenerfassung) mit OAuth 2.0-Aktualisierungstoken:
Berechtigung Typ Beschreibung GroupMember.Read.AllAnwendung Ermöglicht dem Connector, Mitgliedschaften und grundlegende Gruppeneigenschaften für alle Gruppen ohne angemeldeten Nutzer zu lesen. User.ReadDelegiert Ermöglicht dem Connector, das Profil angemeldeter Nutzer zu lesen. Außerdem kann der Connector grundlegende Unternehmensinformationen angemeldeter Nutzer lesen. User.Read.AllAnwendung Ermöglicht dem Connector, Nutzerprofile zu lesen. Optionen für die Website-Steuerung Option 1: Sites.FullControl.AllAnwendung Ermöglicht dem Connector die vollständige Kontrolle über alle Websitesammlungen. Option 2: Sites.SelectedAnwendung Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen. Die jeweiligen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden. Wenn Sie Aktionen für den Verbindungsmodus Föderierte Suche oder Datenaufnahme aktivieren, wählen Sie auch die folgenden Berechtigungen aus:
Berechtigung Typ Beschreibung Sites.ReadWrite.AllDelegiert Ermöglicht dem Connector, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen zu bearbeiten oder zu löschen. Files.ReadWriteDelegiert Ermöglicht dem Connector, die Dateien des angemeldeten Nutzers zu lesen, zu erstellen, zu aktualisieren und zu löschen. Files.ReadWrite.AllDelegiert Ermöglicht dem Connector, alle Dateien zu lesen, zu erstellen, zu aktualisieren und zu löschen, auf die der angemeldete Nutzer zugreifen kann. Sites.Manage.AllDelegiert Ermöglicht dem Connector, im Namen des Nutzers Dokumentbibliotheken und Listen in allen Websitesammlungen zu erstellen oder zu löschen. Klicken Sie auf Berechtigungen hinzufügen.
Wählen Sie im Bereich API-Berechtigungen anfordern die Option Microsoft SharePoint aus.
Suchen Sie je nach Verbindungsmodus nach den folgenden Berechtigungen und wählen Sie sie aus:
Für den Verbindungsmodus Föderierte Suche:
Berechtigung Typ Beschreibung Sites.Search.AllDelegiert Ermöglicht dem Connector, Suchanfragen auszuführen und grundlegende Websiteinformationen im Namen des aktuell angemeldeten Nutzers zu lesen. Die Suchergebnisse basieren auf den Berechtigungen des Nutzers und nicht auf den Berechtigungen der App. Optionen für die Website-Steuerung Option 1: AllSites.ReadDelegiert Ermöglicht dem Connector, Dokumente und Listenelemente in allen Websitesammlungen im Namen des angemeldeten Nutzers zu lesen. Option 2: Sites.SelectedDelegiert Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die jeweiligen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden. Für den Verbindungsmodus Datenaufnahme mit Föderierte Anmeldedaten:
Berechtigung Typ Beschreibung Optionen für die Website-Steuerung Option 1: Sites.FullControl.AllAnwendung Ermöglicht dem Connector die vollständige Kontrolle über alle Websitesammlungen. Option 2: Sites.SelectedAnwendung Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die jeweiligen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden. Für den Verbindungsmodus Data ingestion (Datenerfassung) mit OAuth 2.0-Aktualisierungstoken:
Berechtigung Typ Beschreibung Optionen für die Website-Steuerung Option 1: AllSites.FullControlDelegiert Ermöglicht dem Connector, im Namen des angemeldeten Nutzers die vollständige Kontrolle über alle Websitesammlungen zu haben. Option 2: Sites.SelectedDelegiert Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die jeweiligen Websitesammlungen und die erteilten Berechtigungen können in SharePoint Online konfiguriert werden. Wenn Sie Aktionen für den Verbindungsmodus Föderierte Suche oder Datenaufnahme aktivieren, wählen Sie auch die folgenden Berechtigungen aus:
Berechtigung Typ Beschreibung AllSites.WriteDelegiert Ermöglicht dem Connector, Dokumente und Listenelemente in allen Websitesammlungen im Namen des angemeldeten Nutzers zu erstellen, zu lesen, zu aktualisieren und zu löschen. Klicken Sie auf Berechtigungen hinzufügen.