Sie können Google Cloud Search so einrichten, dass neben Ihren Google Workspace-Inhalten auch Ergebnisse aus den SharePoint Online-Inhalten Ihrer Organisation zurückgegeben werden. Sie verwenden den SharePoint Online-Connector für Google Cloud Search und konfigurieren ihn für den Zugriff auf eine bestimmte SharePoint Online-Datenquelle.
Wichtige Aspekte
Berücksichtigte SharePoint-Einstellungen
Der SharePoint Online-Connector für Cloud Search berücksichtigt immer die SharePoint-Einstellung Suchbarkeit, die nicht überschrieben werden kann. Bei Entwürfen wird über die Berechtigungen für das Nutzerkonto, mit dem der Connector auf SharePoint Online zugreift, gesteuert, welche Dokumente indexiert und zurückgegeben werden. Wenn das Konto nur eine Leseberechtigung mit vollständiger Leseberechtigung hat, übernimmt der Connector die SharePoint-Einstellung „Entwurfselementsichtbarkeit“.
Außerdem konfigurieren Sie den Connector so, dass die Ergebnisse auf Grundlage des Nutzerkontozugriffs eingeschränkt werden. Wenn Sie Sicherheits-Trimming für SharePoint-Inhalte anwenden möchten, synchronisieren Sie die folgenden externen Identitäten mit dem Google-Verzeichnis:
- Office 365-/Azure AD-Nutzer
- Office 365-/Azure AD-Sicherheitsgruppen
- SharePoint-Gruppen (mit Office 365-Nutzern und ‐Gruppen als Mitglieder)
Suchoptimierung
Sie können die Nutzererfahrung verbessern, indem Sie den Connector so konfigurieren, dass relevantere Suchergebnisse zurückgegeben werden.
Wenn Sie die API verwenden möchten, legen Sie in der Konfigurationsdatei des SharePoint Online-Connectors Werte für Parameter zur HTML-Generierung fest. Mit diesen Parametern können Sie festlegen, welche Felder mehr oder weniger Auswirkungen auf Übereinstimmungen haben.
Um ein Schema einzurichten, folgen Sie der Anleitung unter Schema erstellen und registrieren. So richten Sie ein Schema ein:
Damit die Namen von SharePoint-Inhaltstypen den entsprechenden Objektdefinitionen zugeordnet werden, normalisiert der Connector die Namen der Inhaltstypen, indem nicht unterstützte Zeichen ausgeschlossen werden. Bei Objektdefinitionen unterstützt die Cloud Search API nur A–Z, a–z und 0–9 als gültige Zeichen. Der Inhaltstyp „Ankündigungen“ ist beispielsweise der Objektdefinition „Ankündigungen“ zugeordnet. Der Inhaltstyp „Nachrichtenartikel“ ist „NewsArticle“ zugeordnet (kein Leerzeichen).
Wenn der Connector keine Objektdefinition mit einer Objektdefinition abgleichen kann, verwendet er den Fallback-Objekttyp (
itemMetadata.objectType
). Weitere Informationen zu MetadatenkonfigurationsparameternDer Connector ordnet die Namen von SharePoint-Attributen den Attributdefinitionen zu.
Wenn der Connector beim Indexieren von Inhalten auf MSG-Dateien (Microsoft Outlook) stößt, wird der Inhaltstyp der Dateien überschrieben und sie werden als
application/vnd.ms-outlook.
indexiert.
Bekannte Connector-Einschränkungen
- Jede Connector-Instanz kann nur Inhalte aus einer einzelnen Websitesammlung indexieren. Wenn Sie mehrere Websitesammlungen indexieren möchten, richten Sie zusätzliche Connector-Instanzen ein.
- Die Arbeitsspeichernutzung erhöht sich mit der Anzahl der einzelnen Nutzer und Gruppen, die Sie in ACLs für die einzelnen Websitesammlungen verwenden.
- 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
Systemanforderungen | |
---|---|
Betriebssystem |
|
Authentifizierung |
|
Software |
|
Connector bereitstellen
Voraussetzungen
Erstellen Sie einen privaten Google Workspace-Schlüssel, der Ihre Dienstkonto-ID enthält. Informationen zum Abrufen eines privaten Schlüssels finden Sie im Hilfeartikel Zugriff auf die Google Cloud Search API konfigurieren.
Ihr Google Workspace-Administrator muss eine Datenquelle für die Suche hinzufügen. Notieren Sie sich die ID der Datenquelle.
Wenn der Connector Ergebnisse basierend auf ACLs zurückgibt (die Ergebnisse sind nicht öffentlich), muss Ihr Google Workspace-Administrator zwei Identitätsquellen erstellen und Ihnen deren IDs mitteilen:
- eine für Office 365-Nutzer und -Gruppen
- eine für SharePoint-Gruppen
Außerdem muss er die Google Workspace-Kundennummer Ihrer Organisation abrufen und an Sie weitergeben.
Weitere Informationen zum Abrufen dieser Werte finden Sie unter Nutzeridentitäten in Cloud Search zuordnen.
Richten Sie ein Nutzerkonto für den Connector ein, der die Administratorberechtigungen für die SharePoint Online-Websitesammlung hat.
Wenn der Connector Ergebnisse basierend auf ACLs zurückgibt (die Ergebnisse sind nicht öffentlich), erstellen Sie Anmeldedaten, um Nutzer und Gruppen aus Ihrem Office 365-Konto zu lesen. Folgen Sie der Anleitung von Microsoft, um eine Azure Active Directory-Anwendung zu erstellen. Beim Einrichten der App:
- Geben Sie der App einen aussagekräftigen Namen, z. B. „gcs-o365-identity-connector“.
- Fügen Sie Berechtigungen hinzu. Die App benötigt „Group.Read.All“ und „User.Read.All“.
- Notieren Sie sich die folgenden Informationen, die in der Connector-Konfiguration verwendet werden sollen:
- Anwendungs-ID
- Mandant
- Clientschlüssel
Schritt 1: Installieren Sie die Software für den SharePoint Online-Connector.
Klonen Sie das Connector-Repository von GitHub.
$ git clone https://github.com/google-cloudsearch/sharepoint-connector.git $ cd sharepoint-connector
Sehen Sie sich die gewünschte Version des Connectors an:
$ git checkout tags/v1-0.0.3
Erstellen Sie den Connector.
$ mvn package
Wenn Sie beim Erstellen des Connectors Tests überspringen möchten, führen Sie
mvn package -DskipTests
anstelle vonmvn package
aus.Kopieren Sie die ZIP-Datei des Connectors in Ihr lokales Installationsverzeichnis:
$ cp target/google-cloudsearch-sharepoint-connector-v1-0.0.3.zip installation-dir $ cd installation-dir $ unzip google-cloudsearch-sharepoint-connector-v1-0.0.3.zip $ cd google-cloudsearch-sharepoint-connector-v1-0.0.3
Schritt 2: Konfigurationsdatei für den SharePoint Online-Connector erstellen
Erstellen Sie im selben Verzeichnis wie die Connector-Installation eine neue Datei und nennen Sie sie
sharepoint-online-connector.config
. Wenn Sie viele Connector-Instanzen ausführen möchten, fügen Sie dem Namen weitere Details hinzu, um sie voneinander zu unterscheiden.Fügen Sie dem Dateiinhalt Parameter als Schlüssel/Wert-Paare hinzu, wie im folgenden Beispiel:
### SharePoint Online connector configuration ### # Required parameters for data source access api.sourceId=08ef8becd116faa4546b8ca2c84b2879 api.serviceAccountPrivateKeyFile=service_account.json # Required parameters for SharePoint Online access sharepoint.server=https://mydomain.onmicrosoft.com sharepoint.siteCollectionOnly=true sharepoint.username=admin@mydomain.onmicrosoft.com sharepoint.password=pa$sw0rd sharepoint.formsAuthenticationMode=LIVE sharepoint.deploymentType=ONLINE # SharePoint identity mapping parameters api.identitySourceId=08ef8becd116faa475de26d9b291fed9 api.referenceIdentitySources=defaultIdentitySource api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa # Optional SharePoint List Item metadata parameters contentTemplate.sharepointItem.title=Title contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
Eine ausführliche Beschreibung der einzelnen Parameter finden Sie in der Referenz zu Konfigurationsparametern.
Optional: Konfigurieren Sie bei Bedarf weitere Connector-Parameter. Weitere Informationen
Schritt 3: Protokollierung für den SharePoint Online-Connector einrichten
Erstellen Sie einen Ordner mit dem Namen logs in dem Verzeichnis, in dem sich auch die Binärdatei des Connectors befindet.
Erstellen Sie im selben Verzeichnis eine Latin-1-codierte Datei namens logging.properties und fügen Sie den folgenden Inhalt 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 4: SharePoint Online-Identitätsconnector konfigurieren
Dieser Schritt ist erforderlich, um identitätsbasierte SharePoint Online-ACLs auf Suchergebnisse anzuwenden. Wenn Sie den Connector mit öffentlichen ACLs einrichten, können Sie diesen Schritt überspringen.
Erstellen Sie im selben Verzeichnis wie die Installation des SharePoint Online-Connectors eine neue Datei und nennen Sie sie
sharepoint-online-identity-connector.config
.Fügen Sie dem Dateiinhalt Parameter als Schlüssel/Wert-Paare hinzu, wie im folgenden Beispiel:
### SharePoint Online identity connector configuration ### # Required parameters for data source access api.customerId=C05d3djk8 api.serviceAccountPrivateKeyFile=service_account.json # Required parameters for SharePoint Online access sharepoint.server=https://mydomain.onmicrosoft.com sharepoint.siteCollectionOnly=true sharepoint.username=admin@mydomain.onmicrosoft.com sharepoint.password=pa$sw0rd sharepoint.formsAuthenticationMode=LIVE sharepoint.deploymentType=ONLINE # SharePoint identity mapping parameters api.identitySourceId=08ef8becd116faa475de26d9b291fed9 api.referenceIdentitySources=defaultIdentitySource api.referenceIdentitySource.defaultIdentitySource.id=08ef8becd116faa5d3783f8c5a80e5aa
Die Werte sind fast die gleichen wie die des SharePoint Online-Connectors. Der einzige Unterschied ist, dass der Parameter nicht
api.sourceId
sondernapi.customerId
lautet. Der Wert vonapi.customerId
ist die Kundennummer, die Sie von Ihrem Google Workspace-Administrator erhalten haben.
Schritt 5: Office 365-Identitäts Connector installieren
Dieser Schritt ist erforderlich, um identitätsbasierte SharePoint Online-ACLs auf Suchergebnisse anzuwenden. Wenn Sie den Connector mit öffentlichen ACLs einrichten, können Sie diesen Schritt überspringen.
Klonen Sie das Connector-Repository von GitHub.
$ git clone https://github.com/google-cloudsearch/office-365-connector.git $ cd office-365-connector
Sehen Sie sich die gewünschte Version des Connectors an:
$ git checkout tags/v1-0.0.3
Erstellen Sie den Connector.
$ mvn package
Wenn Sie beim Erstellen des Connectors Tests überspringen möchten, führen Sie
mvn package -DskipTests
anstelle vonmvn package
aus.Kopieren Sie die ZIP-Datei des Connectors in Ihr lokales Installationsverzeichnis:
$ cp target/google-cloudsearch-office-365-connector-v1-0.0.3.zip installation-dir $ cd installation-dir $ unzip google-cloudsearch-office-365-connector-v1-0.0.3.zip $ cd google-cloudsearch-office-365-connector-v1-0.0.3
Schritt 6: Office 365-Identitätsconnector konfigurieren und Logging einrichten
Erstellen Sie im selben Verzeichnis wie die Identitätsconnector-Installation eine neue Datei und nennen Sie sie
o365-identity-connector.config
.Fügen Sie dem Dateiinhalt Parameter als Schlüssel/Wert-Paare hinzu, wie im folgenden Beispiel gezeigt. Hinweis: Alle Parameter sind erforderlich.
### Office 365 Identity connector configuration ###
api.identitySourceId=12345abcde api.customerId=abcde12345 o365.clientId=a63c6eb3-29e7-486 o365.tenant=185ef9ed-29e7-486 o365.clientSecret=raHJN15vRLBKsAusführliche Beschreibungen der einzelnen Parameter finden Sie in der Konfigurationsreferenz für die Konfiguration des Identity Connectors für Office 365.
Erstellen Sie einen Ordner mit dem Namen logs in dem Verzeichnis, in dem sich auch die Binärdatei des Connectors befindet.
Erstellen Sie dort außerdem eine ASCII- oder UTF-8-Datei namens logging.properties und fügen Sie den folgenden Inhalt hinzu:
handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler # Default log level .level = INFO # uncomment line below to increase logging level for Office 365 APIs #com.google.enterprise.cloudsearch.o365.level=FINE # uncomment line below to increase logging level to enable Google API traces #com.google.api.client.http.level = FINE java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-o365.%g.log java.util.logging.FileHandler.limit=10485760 java.util.logging.FileHandler.count=10 java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
Schritt 7: SharePoint Online-Connector starten
In den folgenden Schritten ordnen Sie die Hauptkonten in Office 365 und der SharePoint-Websitesammlung den Identitäten im Cloud Identity-Dienst zu. Die Synchronisierung erfolgt über den Office 365- und den SharePoint Online-Identitätsconnector.
Nachdem der Office 365-Connector die Nutzer und Gruppen synchronisiert hat, führen Sie den SharePoint Online-Identitätsconnector aus, um die Gruppen der SharePoint-Websitesammlung zu synchronisieren. Anschließend führen Sie den SharePoint Online-Connector aus, um Ergebnisse für Cloud Search-Nutzer zu indexieren und bereitzustellen.
Führen Sie den Office 365-Identitätsconnector aus:
$ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-office-365-connector-v1-0.0.3.jar -Dconfig=o365-identity-connector.config
Führen Sie den SharePoint Online-Identitätsconnector aus:
$ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-v1-0.0.3.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-online-identity-connector.config
Führen Sie den SharePoint Online-Connector aus:
$ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -Dconfig=sharepoint-online-connector.config
Konfigurationsparameter
Zugriff auf Datenquellen
Einstellung | Parameter |
Datenquellen-ID | api.sourceId=1234567890abcdef
Erforderlich. Die ID der Google Cloud Search-Datenquelle, die vom Google Workspace-Administrator eingerichtet wurde. |
Pfad zur privaten Schlüsseldatei des Dienstkontos | api.serviceAccountPrivateKeyFile=PrivateKey.json
Erforderlich. Der Pfad zur Schlüsseldatei des Google Cloud Search-Dienstkontos. |
SharePoint Online-Zugriff
Einstellung | Parameter |
Voll qualifizierter Domainname für die SharePoint-Websitesammlung | sharepoint.server= http://yoursharepoint.example.com/
Erforderlich. Wenn der Domainname nicht vollständig qualifiziert ist, richten Sie die DNS-Überschreibung auf dem Connectorhost ein. |
Modus „Nur Websitesammlung“ | sharepoint.siteCollectionOnly=true
Erforderlich. Legen Sie für SharePoint Online den Wert |
SharePoint-Nutzername | sharepoint.username=username
Erforderlich. Der Nutzername für das Konto, mit dem auf SharePoint Online zugegriffen wird. |
SharePoint-Passwort | sharepoint.password=user_password
Erforderlich. Das Passwort für das Konto, mit dem auf SharePoint Online zugegriffen wird. |
Authentifizierungsmodus | sharepoint.formsAuthenticationMode=LIVE
Erforderlich. Bei SharePoint Online ist der Wert immer „LIVE“. |
Deployment-Typ | sharepoint.deploymentType=ONLINE
Erforderlich. Bei SharePoint Online ist der Wert immer „ONLINE“. |
SharePoint-Identitätszuordnung
Einstellung | Parameter |
ID der Identitätsquelle | api.identitySourceId=1234567890abcdef
Erforderlich. Die ID der Cloud Search-Identitätsquelle für die Identitätsquelle der SharePoint-Gruppen. |
Auf Identitätsquellen verweisen | api.referenceIdentitySources=defaultIdentitySource
Erforderlich. Für SharePoint Online ist der Wert immer „defaultIdentitySource“. |
IDs der Identitätsquellen Referenz | api.referenceIdentitySource.defaultIdentitySource.id=112233abcd
Erforderlich. Die ID der Cloud Search-Identitätsquelle für die Identitätsquelle „Nutzer und Gruppen“ in Office 365. |
Generieren von HTML-Inhalten
Einstellung | Parameter |
Titelfeld für HTML-Vorlage | contentTemplate.sharePointItem.title=Title
Das SharePoint-Feld, das als Titel der HTML-Vorlage für den generierten HTML-Code verwendet werden soll. |
Felder für HTML-Inhalte mit hoher Suchqualität | contentTemplate.sharePointItem.quality.high=highField1[,highField2,...]
Eine durch Kommas getrennte Liste von Feldern, die im generierten HTML-Code als Felder mit hoher Qualität enthalten sein sollen. Wenn die Suchbegriffe mit diesen Feldern übereinstimmen, erhalten die Ergebnisse ein höheres Ranking. |
Felder für HTML-Inhalte mit mittlerer Suchqualität | contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...]
Eine durch Kommas getrennte Liste von Feldern, die im generierten HTML-Code als Felder mit mittlerer Qualität enthalten sein sollen. |
Felder mit geringer Suchqualität im HTML-Inhalt | contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...]
Eine durch Kommas getrennte Liste von Feldern, die im generierten HTML-Code als Felder von geringer Qualität enthalten sein sollen. |
Nicht zugeordnete Spalten im HTML-Inhalt | contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
Vorgehensweise des Connectors bei nicht zugeordneten Spalten. Der Wert ist APPEND (Standardeinstellung) oder IGNORE.
|
Konfiguration des Office 365-Identitätsconnectors
Einstellung | Parameter |
ID der Identitätsquelle | api.identitySourceId=1234567890abcdef
Erforderlich. Die ID der Office 365-Identitätsquelle. Dieser Wert sollte mit dem Wert von „api.referenceIdentitySource.defaultIdentitySource.id“ in der Konfiguration des SharePoint Online-Connectors übereinstimmen. |
Google-Kundennummer | api.customerId=c1b1d1e1
Erforderlich. Die Google Workspace-Kundennummer Ihrer Organisation. |
Office 365-Anwendungs-ID | o365.clientId=a63c6eb3-29e7-486
Erforderlich. Die Anwendungs-ID aus der Einrichtung der Office 365-Anwendung. |
Office 365-Mandant | o365.tenant=185ef9ed-29e7-486
Erforderlich. Der Mandant für Ihr Office 365-Konto (Ihre Azure Activity Directory App) |
Office 365-Clientschlüssel | o365.clientSecret=raHJN15vRLBKs
Erforderlich. Anmeldedaten-Secret aus der Einrichtung der Office 365-Anwendung |