Hinweis:Diese Dokumentation gilt für die Standard-, Plus-, Pay-as-you-go- und Frontline-Version von Gemini Enterprise. Die Dokumentation für die Business-Version finden Sie in der Gemini Enterprise-Hilfe für die Business-Version.

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Microsoft SharePoint-Konfiguration

Damit Sie Gemini Enterprise 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. Dies ist wichtig, damit der Connector auf Daten zugreifen und diese synchronisieren kann.

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

Bevor Sie den Microsoft SharePoint-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:

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:
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. Je nach Mandanteneinrichtung kann diese Option auch als Nur einzelner Mandant oder Nur einzelner Mandant – MSFT bezeichnet werden. Dadurch wird der Zugriff auf Nutzer und Gäste innerhalb Ihres eigenen Mandanten oder Verzeichnisses beschränkt.
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/sharepoint_oauth.html ein.
4. 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:
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:

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.com ein.
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 SharePoint-Datenspeichers im Datenbereich 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:
1. Wählen Sie im Navigationsmenü der App Übersicht aus.
2. Kopieren Sie die ID der Anwendung (Client).
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.

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

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:

Für den Verbindungsmodus Föderierte Suche sind keine Graph API-Berechtigungen erforderlich.

Für den Verbindungsmodus Datenaufnahme mit Föderierten Anmeldedaten:

Berechtigung	Typ	Beschreibung
`GroupMember.Read.All`	Anwendung	Ermöglicht dem Connector, Mitgliedschaften und grundlegende Gruppeneigenschaften für alle Gruppen ohne angemeldeten Nutzer zu lesen.
`User.Read`	Delegiert	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.All`	Anwendung	Ermöglicht dem Connector die vollständige Kontrolle über alle Websitesammlungen.
Option 2: `Sites.Selected`	Anwendung	Ermöglicht dem Connector, auf eine Teilmenge von Websitesammlungen zuzugreifen. Die spezifischen Websitesammlungen und die gewährten Berechtigungen können in SharePoint Online konfiguriert werden.
Optionen zum Lesen von Profilen
Option 1: `User.Read.All`	Anwendung	Ermöglicht dem Connector, Nutzerprofile zu lesen.
Option 2: `User.ReadBasic.All`	Anwendung	Ermöglicht dem Connector, einen grundlegenden Satz von Profileigenschaften anderer Nutzer in der Organisation zu lesen.

Für den Verbindungsmodus Datenaufnahme mit OAuth 2.0-Aktualisierungstoken:

Berechtigung	Typ	Beschreibung
`GroupMember.Read.All`	Anwendung	Ermöglicht dem Connector, Mitgliedschaften und grundlegende Gruppeneigenschaften für alle Gruppen ohne angemeldeten Nutzer zu lesen.
`User.Read`	Delegiert	Ermöglicht dem Connector, das Profil angemeldeter Nutzer zu lesen. Außerdem kann der Connector grundlegende Unternehmensinformationen angemeldeter Nutzer lesen.
`User.Read.All`	Anwendung	Ermöglicht dem Connector, Nutzerprofile zu lesen.
Optionen für die Website-Steuerung
Option 1: `Sites.FullControl.All`	Anwendung	Ermöglicht dem Connector die vollständige Kontrolle über alle Websitesammlungen.
Option 2: `Sites.Selected`	Anwendung	Ermöglicht dem Connector, auf eine Teilmenge von Websitesammlungen zuzugreifen. Die spezifischen Websitesammlungen und die gewährten 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.All`	Delegiert	Ermöglicht dem Connector, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen zu bearbeiten oder zu löschen.
`Files.ReadWrite`	Delegiert	Ermöglicht dem Connector, Dateien des angemeldeten Nutzers zu lesen (herunterzuladen), zu erstellen (hochzuladen), zu aktualisieren und zu löschen.
`Files.ReadWrite.All`	Delegiert	Ermöglicht dem Connector, alle Dateien, auf die der angemeldete Nutzer Zugriff hat, zu lesen (herunterzuladen), zu erstellen (hochzuladen), zu aktualisieren und zu löschen.
`Sites.Manage.All`	Delegiert	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 nach den folgenden Berechtigungen und wählen Sie sie aus, je nachdem, welchen Verbindungsmodus Sie verwenden:

Für den Verbindungsmodus Föderierte Suche:

Berechtigung	Typ	Beschreibung
`Sites.Search.All`	Delegiert	Ermöglicht dem Connector, im Namen des aktuell angemeldeten Nutzers Suchanfragen auszuführen und grundlegende Websiteinformationen zu lesen. Die Suchergebnisse basieren auf den Berechtigungen des Nutzers und nicht auf den Berechtigungen der App.
`AllSites.Read`	Delegiert	Ermöglicht dem Connector, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen zu lesen.

Für den Verbindungsmodus Datenaufnahme mit Föderierten Anmeldedaten:

Berechtigung	Typ	Beschreibung
Optionen für die Website-Steuerung
Option 1: `Sites.FullControl.All`	Anwendung	Ermöglicht dem Connector die vollständige Kontrolle über alle Websitesammlungen.
Option 2: `Sites.Selected`	Anwendung	Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die spezifischen Websitesammlungen und die gewährten Berechtigungen können in SharePoint Online konfiguriert werden.

Für den Verbindungsmodus Datenaufnahme mit OAuth 2.0-Aktualisierungstoken:

Berechtigung	Typ	Beschreibung
Optionen für die Website-Steuerung
Option 1: `AllSites.FullControl`	Delegiert	Ermöglicht dem Connector, im Namen des angemeldeten Nutzers die volle Kontrolle über alle Websitesammlungen zu haben.
Option 2: `Sites.Selected`	Delegiert	Ermöglicht dem Connector den Zugriff auf eine Teilmenge von Websitesammlungen mit einem angemeldeten Nutzer. Die spezifischen Websitesammlungen und die gewährten 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.Write`	Delegiert	Ermöglicht dem Connector, im Namen des angemeldeten Nutzers Dokumente und Listenelemente in allen Websitesammlungen zu erstellen, zu lesen, zu aktualisieren, zu löschen, hochzuladen und herunterzuladen.

Klicken Sie auf Berechtigungen hinzufügen.
Hinweis: Wenn Sie Sites.Selected verwenden, müssen Sie den ausgewählten Websites die Berechtigung fullcontrol erteilen. Damit diese Berechtigung wirksam wird, müssen Sie außerdem mindestens eine der folgenden Aktionen ausführen, wenn Sie den SharePoint-Datenspeicher in Gemini Enterprise erstellen:
- Verwenden Sie eine bestimmte Website-URL als URL für die SharePoint-Connector-Instanz, z. B. mydomain.sharepoint.com/sites/sample-site.
- Geben Sie beim Einrichten des Gemini Enterprise-Datenspeichers genaue siteName-Filter an.
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.
Achtung:
- Administratoreinwilligung auf Mandantenebene (WICHTIG): Sie müssen in Microsoft Entra ID die Administratoreinwilligung auf Mandantenebene für die registrierte Anwendung erteilen. Eine fehlende Einwilligung des Administrators ist ein häufiger Fehler, der die Authentifizierung des Connectors verhindert.
- Zwei App-IDs: Gemini Enterprise verwendet für verschiedene Funktionen unterschiedliche Microsoft Entra-App-IDs. Sie benötigen eine App-ID für die Backend-Verbindung „Datenspeicher“ und eine separate App-ID, um die Schaltfläche „Aus OneDrive/SharePoint hochladen“ in der Chat-Oberfläche zu aktivieren. Für beide Anwendungen ist die Einwilligung eines Administrators erforderlich.

`fullcontrol` Berechtigung für ausgewählte Websites erteilen

Wenn Sie die Option Sites.Selected auswählen, um die Kontrolle über ausgewählte Websites in Microsoft Graph zu gewähren, müssen Sie der Gemini Enterprise-Anwendung die Berechtigung fullcontrol erteilen. Dazu haben Sie folgende Möglichkeiten:

PowerShell
Microsoft Graph

PowerShell

Eine allgemeine Syntax zum Erteilen von Berechtigungen mit PnP PowerShell finden Sie unter Berechtigungen über PnP PowerShell erteilen.

Führen Sie den folgenden Befehl in PowerShell aus, um die Berechtigung FullControl zu gewähren :
```
Grant-PnPAzureADAppSitePermission -AppId CLIENT_ID -DisplayName DISPLAY_NAME -Permissions FullControl -Site SITE_URL
```
Ersetzen Sie Folgendes:
- CLIENT_ID: Client-ID der Microsoft Entra-Anwendung.
- SITE_URL: Website-URL für Ihre SharePoint-Website, z. B. https://example.sharepoint.com/sites/ExampleSite1.
- DISPLAY_NAME: der Anzeigename für die Microsoft Entra-Anwendung.

Microsoft Graph

Informationen zum allgemeinen Verfahren zum Erteilen von Berechtigungen über Microsoft Graph finden Sie unter Berechtigungen über Microsoft Graph erteilen.

Verwenden Sie den Microsoft Graph Explorer, um die folgenden Methoden aufzurufen. Diese Methoden können nur von einem Websiteinhaber aufgerufen werden.

Website-ID abrufen:
```
GET `https://graph.microsoft.com/v1.0/sites/HOSTNAME:SITE_PATH`
```
Ersetzen Sie Folgendes:
- HOSTNAME: Hostname der SharePoint-Website, z. B. example.sharepoint.com.
- SITE_PATH: Pfad der SharePoint-Website, z. B. /sites/ExampleSite1 oder /teams/ExampleSite2.
Gewähren Sie fullcontrol Zugriff auf die Website, deren ID Sie im vorherigen Schritt abgerufen haben.
- Senden Sie die folgende POST-Anfrage:
```
   POST `https://graph.microsoft.com/v1.0/sites/SITE_ID/permissions`
```
- Verwenden Sie den folgenden Anfragetext:
```
{
  "roles": ["fullControl"],
  "grantedToIdentities": [{
    "application": {
      "id": "CLIENT_ID",
      "displayName": "DISPLAY_NAME"
    }
  }]
}
```
  Ersetzen Sie Folgendes:
  - SITE_ID: Website-ID für Ihre SharePoint-Website, die Sie im vorherigen Schritt erhalten haben. Das Format sieht folgendermaßen aus: example.sharepoint.com,48332b69-85ab-0000-0000-dbb7132863e7,2d165439-0000-0000-b0fe-030b976868a0.
  - CLIENT_ID: Client-ID der Microsoft Entra-Anwendung.
  - DISPLAY_NAME: der Anzeigename für die Microsoft Entra-Anwendung.

Fehlerbehebung

In diesem Abschnitt wird beschrieben, wie Sie häufige Probleme mit dem Microsoft SharePoint-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 SharePoint herstellen, wird in Microsoft möglicherweise der Bildschirm Genehmigung durch Administrator 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 SharePoint 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.