Microsoft SharePoint On-Premises-Connector bereitstellen

Nachrichtenverarbeitung in Microsoft Outlook

Wenn der Connector bei der Indexierung von Inhalten auf Microsoft Outlook-MSG-Dateien stößt, wird der Medientyp für die Dateien überschrieben und sie werden als application/vnd.ms-outlook. indexiert

Mehrmandantenfähige Konfigurationen

Wenn es sich bei SharePoint um eine mandantenfähige Bereitstellung handelt, bei der mehrere Kundenwebsites in derselben Webanwendung gehostet werden, müssen Sie den Websitesammlungsmodus in der Konfigurationsdatei konfigurieren. Bei mehrmandantenfähigen Bereitstellungen erhalten Sie nur Berechtigungen für die Websitesammlung, keine vollständigen Leseberechtigungen, wie es für den SharePoint On-Premises-Connector erforderlich ist.

So aktivieren Sie den Websitesammlungsmodus:

• Gewähren Sie dem Nutzerkonto des Connectors die Berechtigung Websitesammlungsadministrator.
• Legen Sie sharepoint.server in der Connector-Konfigurationsdatei auf die URL der Websitesammlung fest, z. B. http://sharepoint.example.com/sites/sitecollection. Bei der URL muss nicht dieselbe Groß- und Kleinschreibung wie bei SharePoint verwendet werden.
• Legen Sie sharepoint.siteCollectionOnly in der Konfigurationsdatei des Connectors auf true fest.

Wenn Sie in einer mandantenfähigen Umgebung mehrere Websitesammlungen indexieren möchten, müssen Sie für jede dieser Sammlungen eine Connector-Instanz konfigurieren.

Bekannte Einschränkungen bei Connectors

• Je mehr Datenbanken der Connector überwacht, desto länger dauert es, bis er Änderungen an Elementen in den Datenbanken erkennt.
• Die Arbeitsspeichernutzung steigt mit der Anzahl der einzelnen Nutzer und Gruppen, die Sie in ACLs für jede Websitesammlung verwenden.
• Sie können den Connector mit Identitäten aus nur einer Active Directory-Domain konfigurieren.
• Einige gängige Active Directory- und Windows-Hauptkonten wie Everyone, BUILTIN\Users und All Authenticated Users werden nicht unterstützt.
• Löschbenachrichtigungen erfolgen nicht sofort und es kann mehr als vier Stunden dauern, bis ein Connector erkennt, dass ein Nutzer Inhalte aus dem Quell-Repository gelöscht hat.

Systemanforderungen

Connector bereitstellen

Voraussetzungen

Schritt 2: Konfigurationsdatei für den SharePoint On-Premises-Connector erstellen

Schritt 3. Fügen Sie SharePoint für HTTPS als vertrauenswürdigen Host hinzu.

Wenn SharePoint für die Verwendung von HTTPS konfiguriert ist, rufen Sie ein SharePoint-Zertifikat ab, um es als vertrauenswürdigen Host für den Connector hinzuzufügen.

1. Öffnen Sie auf dem Computer, auf dem der Connector ausgeführt wird, einen Browser und rufen Sie SharePoint auf.

2. Klicken Sie auf der angezeigten Warnmeldung auf Ich verstehe die Risiken und dann auf Ausnahme hinzufügen. Auf der Seite wird eine Meldung wie „This Connection is Untrusted“ (Diese Verbindung ist nicht vertrauenswürdig) angezeigt, da das Zertifikat selbst signiert und nicht von einer vertrauenswürdigen Zertifizierungsstelle signiert ist.

3. Klicken Sie auf die Schaltfläche Ansicht, sobald sie verfügbar ist.

4. Wechseln Sie zum Tab Details und klicken Sie auf Exportieren.

5. Speichern Sie das Zertifikat unter dem Namen sharepoint.crt im Connector-Verzeichnis.

6. Klicken Sie auf Schließen und dann auf Abbrechen, um die Fenster zu schließen.

7. Öffnen Sie eine Eingabeaufforderung und geben Sie den folgenden Befehl ein:

   $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

   Beantworten Sie die Frage „Trust this certificate?“ (Diesem Zertifikat vertrauen) mit yes (Ja).

Schritt 4. Logging einrichten

1. Erstellen Sie in dem Verzeichnis, das die Connector-Binärdatei enthält, einen Ordner mit dem Namen logs.

2. Erstellen Sie im selben Verzeichnis (nicht logs) eine Latin1-codierte Datei mit dem Namen logging.properties.

3. Fügen Sie logging.properties den folgenden Text hinzu:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = INFO
   # uncomment line below to increase logging level for SharePoint APIsa
   #com.google.enterprise.cloudsearch.sharepoint.level=FINE
   
   # uncomment line below to increase logging level to enable API trace
   #com.google.api.client.http.level = FINE
   java.util.logging.ConsoleHandler.level = INFO
   java.util.logging.FileHandler.pattern=logs/connector-sharepoint.%g.log
   java.util.logging.FileHandler.limit=10485760
   java.util.logging.FileHandler.count=10
   java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
   

Schritt 5: SharePoint On-Premises-Identitätsconnector konfigurieren

Dieser Schritt ist erforderlich, um identitätsbasierte SharePoint On-Premises-ACLs auf Suchergebnisse anzuwenden. Wenn Sie den Connector mit öffentlichen ACLs eingerichtet haben, können Sie diesen Schritt überspringen.

1. Erstellen Sie im Verzeichnis, in dem sich auch die Installation des SharePoint Online-Connectors befindet, eine Datei und nennen Sie sie sharepoint-onprem-identity-connector.config.

2. Fügen Sie dem Dateiinhalt Parameter als Schlüssel/Wert-Paare hinzu, wie im folgenden Beispiel gezeigt:

   ### SharePoint On-prem identity connector configuration ###
   
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   Die Werte sind fast dieselben wie für den SharePoint On-Premises-Connector, nur dass der Parameter statt api.sourceId api.customerId lautet. Der Wert für api.customerId ist die Kundennummer, die Sie von Ihrem Google Workspace-Administrator erhalten haben.

Schritt 6: SharePoint On-Premises-Connector starten

In den folgenden Schritten ordnen Sie die Hauptkonten im lokalen Active Directory und in der SharePoint-Websitesammlung den Identitäten im Cloud Identity-Dienst zu. Die Synchronisierung erfolgt mit Google Cloud Directory Sync (GCDS) und dem SharePoint On-Premises-Identitätsconnector.

Nachdem GCDS Nutzer und Gruppen synchronisiert hat, führen Sie den SharePoint On-Premises-Identitätsconnector aus, um die Gruppen der SharePoint-Websitesammlung zu synchronisieren. Führen Sie schließlich den lokalen SharePoing-Connector aus, um Ergebnisse zu indexieren und für Ihre Cloud Search-Nutzer bereitzustellen.

Zugriff auf Datenquellen

Lokaler SharePoint-Zugriff

Indexierung der Websitesammlung

SharePoint-Identitätszuordnung

Active Directory-Suche

Erstellung von HTML-Inhalten