Microsoft SharePoint On-Premises-Connector bereitstellen

Nachrichtenverarbeitung in Microsoft Outlook

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

Mehrmandantenfähige Konfigurationen

Wenn SharePoint bei Ihnen mandantenfähig konfiguriert ist und mehrere Kundenwebsites in derselben Webanwendung gehostet werden, müssen Sie den Websitesammlungsmodus in der Konfigurationsdatei konfigurieren. Bei mandantenfähigen Bereitstellungen erhalten Sie nur Berechtigungen für die Erfassung Ihrer Website – keine umfassenden Leseberechtigungen, wie sie für den SharePoint On-Premises-Connector erforderlich sind.

So aktivieren Sie den Websitesammlungsmodus:

• Weisen Sie dem Nutzerkonto für den Connector die Berechtigung Websitesammlungsadministrator zu.
• Legen Sie sharepoint.server in der Connector-Konfigurationsdatei auf die URL für die Websitesammlung fest, z. B. http://sharepoint.example.com/sites/sitecollection. Bei der URL muss nicht unbedingt genau die gleiche Groß-/Kleinschreibung wie in SharePoint verwendet werden.
• Legen Sie sharepoint.siteCollectionOnly in der Connector-Konfigurationsdatei auf true fest.

Wenn in einer mehrinstanzenfähigen Umgebung mehrere Websitesammlungen indexiert werden sollen, müssen sie für jede eine eigene Connectorinstanz konfigurieren.

Bekannte Einschränkungen des Connectors

• Je mehr Datenbanken der Connector überwacht, desto mehr Zeit benötigt er, um Änderungen an Elementen in den Datenbanken zu erkennen.
• Der Speicherverbrauch erhöht sich mit der Anzahl der einzelnen Nutzer und Gruppen, die Sie in ACLs für die einzelnen Websitesammlungen 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 4 Stunden dauern, bis ein Connector erkennt, dass ein Nutzer Inhalte aus dem Quell-Repository gelöscht hat.

Systemanforderungen

Connector bereitstellen

Vorbereitung

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

Schritt 3: Für HTTPS SharePoint als vertrauenswürdigen Host hinzufügen

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 Warnseite, die geöffnet wird, auf I Understand the Risks (Ich kenne das Risiko) und dann auf Add Exception (Ausnahme hinzufügen). Es wird eine Meldung angezeigt, z. B. „This Connection is Untrusted“ (Dieser Verbindung wird nicht vertraut). Das passiert, weil das Zertifikat selbst signiert ist und nicht von einer vertrauenswürdigen Zertifizierungsstelle stammt.

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

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

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

6. Klicken Sie auf Close (Schließen) und anschließend auf Cancel (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 in logs) eine Latin1-codierte Datei namens 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 selben Verzeichnis wie die Installation des SharePoint Online-Connectors eine Datei und nennen Sie sie sharepoint-onprem-identity-connector.config.

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

   ### 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 die gleichen wie die des SharePoint On-Premises-Connectors, mit der Ausnahme, dass der Parameter nicht api.sourceId sondern api.customerId lautet. Der Wert von 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 aus dem lokalen Active Directory und der SharePoint-Websitesammlung den Identitäten in Cloud Identity zu. Die Synchronisierung erfolgt über Google Cloud Directory Sync (GCDS) und den SharePoint On-Premises-Identitätsconnector.

Führen Sie nach der Synchronisierung von Nutzern und Gruppen in GCDS den SharePoint On-Premises-Identitätsconnector aus, um die SharePoint-Websitesammlungsgruppen zu synchronisieren. Führen Sie abschließend den SharePoint On-Premises-Connector aus, um Ergebnisse für Ihre Cloud Search-Nutzer zu indexieren und bereitzustellen.

Zugriff auf Datenquellen

Lokaler SharePoint-Zugriff

Indexierung der Websitesammlung

SharePoint-Identitätszuordnung

Active Directory-Suche

Generierung von HTML-Inhalten