Microsoft Windows File Systems-Connector bereitstellen

Warnung :Die Cloud Search-Referenz-Connectors werden ohne Mängelgewähr zur Verfügung gestellt. als Beispielcode um eigene funktionierende Connectors zu erstellen. Dieser Beispielcode erfordert umfangreiche Anpassungen und Tests durchzuführen, bevor sie als Proof of Concept oder Produktionsumgebungen. Für den Einsatz in der Produktion empfehlen wir dringend, sich an Hilfe zu wenden. von einem unserer Cloud Search-Partner. Weitere Unterstützung bei der Suche nach einer geeigneten Cloud Wenn Sie Suchnetzwerk-Partner einbeziehen, wenden Sie sich an Ihren Google Account Manager.

Sie können Google Cloud Search so einrichten, dass Ergebnisse aus den Microsoft Windows-Freigaben werden zusätzlich zu Ihren Google Workspace-Inhalten freigegeben. Ich Verwenden Sie den File Systems-Connector für Google Cloud Search und konfigurieren Sie ihn für den Zugriff auf angegebenen Windows-Freigaben. Eine einzelne Connector-Instanz kann mehrere Microsoft Windows-Freigaben

Wichtige Aspekte

Kontinuierliche automatische Updates

Standardmäßig überwacht der Connector beim Start des Connectors kontinuierlich die Startpfade (Werte aus fs.src in der Connector-Konfigurationsdatei). Wenn das Dateisystem Änderungen an den Inhalts- oder Zugriffssteuerungen meldet, wird der Connector ausgelöst, um das Dateisystem noch einmal zu crawlen. Dieses erneute Crawling kann ressourcenintensiv sein. Wenn Sie die Dateisystemüberwachung deaktivieren möchten, setzen Sie fs.monitorForUpdates auf false. Sie reduzieren die Ressourcennutzung des Connectors erheblich. Die Änderungen werden jedoch erst später im Connector widergespiegelt. Weitere Informationen

DFS-Zugriffssteuerung

Das DFS-System wendet die Zugriffssteuerung auf Links an und normalerweise hat jeder DFS-Link eine eigene ACL. In DFS wird unter anderem die zugriffsbasierte Aufzählung (Access-based Enumeration, ABE) eingesetzt, mit der die an einen Nutzer zurückgegebenen DFS-Links eingeschränkt werden können. Wenn ABE gehostete Basisverzeichnisse isoliert, erhalten Nutzer möglicherweise nur einen Teil der DFS-Links oder auch nur einen Link. Wenn der Connector ein DFS-System durchläuft, berücksichtigt er die DFS-Link-ACL und die Freigabe-ACL des Ziels. Die Freigabe-ACL übernimmt die Einstellungen der DFS-ACL.

Bekannte Einschränkungen

• Dateisystem: Der File Systems-Connector unterstützt weder zugeordnete noch lokale Laufwerke.
• Verteiltes Dateisystem: Ein Laufwerk, das einem UNC-DFS zugeordnet ist, funktioniert nicht richtig. Einige ACLs werden nicht richtig gelesen.
• Der File Systems-Connector unterstützt DFS-Namespaces und ‐Links (Distributed File System). Der Connector unterstützt jedoch nur DFS-Links in einem DFS-Namespace, nicht die regulären Ordner im DFS-Namespace.
• Auf cloudsearch.google.com zurückgegebene Dateilinks sind nicht anklickbar. Auch die von der Query API zurückgegebenen Dateilinks sind in den meisten Browsern nicht anklickbar.

Systemanforderungen

Systemanforderungen
Betriebssystem	Windows Server 2016 Windows Server 2012 Windows Server 2008 R2
Software	Java JRE 1.8, installiert auf dem Computer, auf dem der File Systems-Connector für Google Cloud Search ausgeführt wird
Dateisystemprotokolle	Server Message Block (SMB) – SMB1 Server Message Block (SMB) – SMB2 Verteiltes Dateisystem (Distributed File System, DFS) Nicht unterstützt:Lokale Windows-Dateisysteme, Sun Network File System (NFS) 2.0, Sun Network File System (NFS) 3.0 oder ein lokales Linux-Dateisystem.

Connector bereitstellen

Vorbereitung

Stellen Sie vor der Bereitstellung des File Systems-Connectors für Cloud Search sicher, dass Ihr alle folgenden Voraussetzung:

• Google Workspace-Informationen, die erforderlich sind, um Beziehungen zwischen Google Cloud Search und der Datenquelle herzustellen:

  • Privater Google Workspace-Schlüssel, der die Dienstkonto-ID enthält. Für Informationen zum Abrufen eines privaten Schlüssels finden Sie unter Konfigurieren Sie den Zugriff auf die Google Cloud Search REST API.
  • ID der Google Workspace-Datenquelle. Informationen zum Abrufen einer Datenquellen-ID gehe zu Fügen Sie eine Datenquelle für die Suche hinzu.
  • Eine Identitätsquellen-ID. Informationen zum Abrufen einer Identitätsquelle ID, gehe zu Identitätsquelle erstellen Wenn Sie Ihr Google Workspace-Verzeichnis mit Active Directory synchronisieren, richten Sie die Identitätsquelle mit GCDS ein.

  Diese Anmeldedaten erhalten Sie in der Regel vom Google Workspace-Administrator Ihrer Organisation.

• Stellen Sie sicher, dass das Windows-Konto über ausreichende Berechtigungen verfügt, wie unter im folgenden Abschnitt an.

Erforderliche Berechtigungen für Microsoft Windows-Konten

Das Microsoft Windows-Konto, unter dem der Connector ausgeführt wird, muss Ausreichende Berechtigungen zum Ausführen der folgenden Aktionen:

• Inhalt von Ordnern auflisten
• Inhalt von Dokumenten lesen
• Attribute von Dateien und Ordnern lesen
• Leseberechtigungen (ACLs) für Dateien und Ordner
• Berechtigungen für grundlegende Attribute schreiben

Durch die Mitgliedschaft in einer der folgenden Gruppen erhält ein Windows-Konto die erforderlichen Berechtigungen, die der Connector benötigt:

• Administratoren
• Poweruser
• Druckoperatoren
• Serveroperatoren

Hinweis: Es reicht nicht aus, dass der Nutzer Mitglied einer dieser Gruppen bei Domain-Ebene. Der Nutzer muss Mitglied einer dieser Gruppen auf dem lokalen der die Windows-Freigabe exportiert. Weitere Informationen finden Sie in der Dokumentation zum Funktion „NetShareGetinfo“.

Schritt 1: File Systems-Connector für Google Cloud Search installieren

1. Rufen Sie das Connector-Repository von GitHub ab und erstellen Sie es.

   So verwenden Sie Git auf dem Windows-Server:

   1. Klonen Sie das Repository:

      > git clone https://github.com/google-cloudsearch/windows-filesystems-connector.git
      > cd windows-filesystems-connector

   2. Prüfen Sie die gewünschte Version des Connectors:

      > git checkout tags/v1-0.0.3

   So laden Sie Dateien direkt von GitHub herunter:

   1. Rufen Sie https://github.com/google-cloudsearch/windows-filesystems-connector auf.
   2. Klicken Sie auf Klonen oder herunterladen ZIP-Datei herunterladen.
   3. Entpacken Sie das Paket.
   4. Wechseln Sie in das neue Verzeichnis:

      > cd windows-filesystems-connector

2. Erstellen Sie den Connector. Installieren Sie bei Bedarf Apache Maven.

   > mvn package

   Wenn Sie beim Erstellen des Connectors Tests überspringen möchten, führen Sie mvn package -DskipTests anstelle von mvn package aus.

3. Kopieren Sie die ZIP-Datei des Connectors in Ihr lokales Installationsverzeichnis:

   > cp target/google-cloudsearch-windows-filesystems-connector-v1-0.0.3.zip installation-dir
   > cd installation-dir
   > unzip google-cloudsearch-windows-filesystems-connector-v1-0.0.3.zip
   > cd google-cloudsearch-windows-filesystems-connector-v1-0.0.3

Schritt 2: Konfigurationsdatei für Connector erstellen

1. Erstellen Sie im selben Verzeichnis wie die Connector-Installation eine Datei und nennen Sie sie connector-config.properties.

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

   ### File system connector configuration ###
   
   # Required parameters for Cloud Search data source and identity source access
   api.serviceAccountPrivateKeyFile=/path/to/file.json
   api.sourceId=0123456789abcde
   api.identitySourceId=a1b1c1234567
   
   # Required parameters for file system access
   fs.src=\\\\host\\share;\\\\dfshost\\dfsnamespace;\\\\dfshost\\dfsnamespace\\link
   
   # Optional parameters for file system monitoring
   traverse.abortAfterExceptions=500
   fs.monitorForUpdates = true
   fs.preserveLastAccessTime = IF_ALLOWED
   

   Ausführliche Beschreibungen der einzelnen Parameter finden Sie in der Referenz zu Konfigurationsparametern.

3. Optional: Konfigurieren Sie nach Bedarf weitere Connector-Parameter. Weitere Informationen finden Sie unter Von Google bereitgestellte Connector-Parameter.

Schritt 3: Logging aktivieren

1. Erstellen Sie in dem Verzeichnis, das den Connector enthält, einen Ordner mit dem Namen logs binär.

2. Erstellen Sie eine ASCII- oder UTF-8-Datei mit dem Namen logging.properties im das Binärprogramm des Connectors enthält, und fügen Sie den folgenden Inhalt hinzu:

   handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler
   # Default log level
   .level = WARNING
   com.google.enterprise.cloudsearch.level = INFO
   com.google.enterprise.cloudsearch.fs.level = INFO
   
   # 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-fs.%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: Optional: Medientypen konfigurieren

Standardmäßig versucht der Connector, den Medientyp für jede Datei mit Von JDK bereitgestellt die Erkennung von Medientypen. Unter Microsoft Windows nutzt das JDK die Windows-Registrierung, Medientypen für Dateien bestimmen. Ein fehlender Registrierungseintrag kann zu einem NULL-Wert führen. Medientyp bestimmter Dateien.

Bei Bedarf können Sie einen Medientyp angeben, mit dem vorhandene Bindungen überschrieben oder ein Null-Medientyp verhindert werden.

1. Erstellen Sie im Connector-Verzeichnis eine Latin-1-verschlüsselte Datei mit dem Namen mime-type.properties.

2. Geben Sie die Dateiendungen und die entsprechenden Medientypen wie in den folgenden Beispielen ein:

   xlsx=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
   one=application/msonenote
   txt=text/plain
   pdf=application/pdf
   

Schritt 5: File Systems-Connector ausführen

Nachdem Sie den File Systems-Connector installiert und konfiguriert haben, starten Sie ihn auf dem Hostcomputer ausführen, führen Sie einen Befehl wie im folgenden Beispiel aus:

> java -jar google-cloudsearch-windows-filesystems-connector-v1-0.0.3.jar -Djava.util.logging.config.file=logging.properties[ -Dconfig=my.config]

Geben Sie den Konfigurationsdateipfad an, wenn er vom Standard abweicht (im selben Verzeichnis wie die Binärdatei mit dem Namen connector-config.properties).

Referenz zu Konfigurationsparametern

Zugriff auf Datenquellen

Einstellung	Parameter
ID der Datenquelle	api.sourceId=1234567890abcdef Erforderlich. Die ID der Google Cloud Search-Quelle, die vom Google Workspace-Administrator eingerichtet wurde.
Pfad zur privaten Schlüsseldatei des Dienstkontos	api.serviceAccountPrivateKeyFile=./PrivateKey.json Erforderlich. Die Schlüsseldatei des Google Cloud Search-Dienstkontos für den Zugriff des File Systems-Connectors auf Google Cloud Search.
ID der Identitätsquelle	api.identitySourceId=x0987654321 Erforderlich. Die ID der Cloud Search-Identitätsquelle, die vom Google Workspace-Administrator eingerichtet wurde, um Active Directory-Identitäten mithilfe von GCDS zu synchronisieren.

Dateisystemzugriff

Einstellung	Parameter
Quelldateisysteme	fs.src=path1[,path2, ...] Erforderlich. Geben Sie Quelldateisysteme als eine oder mehrere UNC-Quellen an, die durch das mit fs.src.separator konfigurierte Trennzeichen getrennt sind. Falls Sie Zeichen verwenden, die nicht in Latin1 enthalten sind, codieren Sie sie mit Java-Unicode-Escape-Zeichen.

Pfadtrennzeichen

Einstellung

Parameter

Pfadtrennzeichen

fs.src.separator=separator-character Das Standardtrennzeichen ist „;“. Wenn Ihre Quellpfade Semikolons enthalten, können Sie ein anderes Trennzeichen festlegen, z. B. ein Komma („,“), das nicht mit den Zeichen in Ihren Pfaden in Konflikt steht und nicht durch die Syntax der Property-Dateien selbst reserviert ist. Wenn der Wert fs.src.separator ein leerer String ist, wird der Wert fs.src als einzelner Pfad behandelt.

Connector-Verhalten

Einstellung	Parameter
Windows-Domain	fs.supportedDomain=domain Erforderlich, damit Nutzer, für die GCDS eingerichtet ist, über Cloud Search auf Dokumente zugreifen können. Geben Sie diesen als einzelnen NetBIOS-Domainnamen des Active Directory an.
Konten in ACLS einschließen	fs.supportedAccounts=account-1[, account-2,...] Eine durch Kommas getrennte Liste der Konten, die in ACLs enthalten sein sollen, unabhängig davon, ob es sich um integrierte Konten handelt. Der Standardwert ist BUILTIN\\Administrators,Everyone,BUILTIN\\Users, BUILTIN\\Guest,NT AUTHORITY\\INTERACTIVE, NT AUTHORITY\\Authenticated Users.
Integrierte Konten von ACLs ausschließen	fs.builtinGroupPrefix=prefix Geben Sie das Präfix für integrierte Konten an. Konten, die mit diesem Präfix beginnen, gelten als integrierte Konten und werden von den ACLs ausgeschlossen. Der Standardwert ist BUILTIN\\.
Indexierung versteckter Dateien und Ordner zulassen	fs.crawlHiddenFiles=boolean Legen Sie true fest, damit der Connector versteckte Dateien und Ordner crawlen kann. Unter Windows-Dateisystemen gilt eine Datei oder ein Ordner als versteckt, wenn das DOS-Attribut „Versteckt“ festgelegt ist. Der Standardwert ist false.
Indexierung von gecrawlten Ordnerlisten und Aufzählungen von DFS-Namespaces zulassen	fs.indexFolders=boolean Wenn true (Standardeinstellung) festgelegt ist, erstellt der Connector beim Crawlen eines Ordners ein CONTAINER_ITEM-Objekt. Wenn dieser Wert auf „false“ gesetzt ist, erstellt der Connector stattdessen ein VIRTUAL_CONTAINER_ITEM-Objekt.
Änderungsmonitoring für Dateisysteme aktivieren	fs.monitorForUpdates=boolean Wenn die Richtlinie auf true gesetzt ist (Standardeinstellung), wird bei Änderungen an der Inhalts- oder Zugriffssteuerung der Connector neu gecrawlt. Wenn Sie das Monitoring deaktivieren (auf false gesetzt), verringern Sie die Ressourcennutzung des Connectors erheblich. Die Änderungen werden jedoch erst später im Connector widergespiegelt.
Maximale Größe des Verzeichniscaches festlegen	fs.directoryCacheSize=number-of-entries Die maximale Größe des Verzeichnis-Cache. Der Connector verwendet den Cache, um versteckte Ordner zu identifizieren, damit Dateien und Ordner in versteckten Ordnern nicht indexiert werden. Der Standardwert ist 50.000 Einträge, die normalerweise 10 bis 15 Megabyte RAM belegen.

Zeitstempelaufbewahrung und Crawling-Steuerung

Einstellung	Parameter
Zeitstempel des letzten Zugriffs beibehalten	fs.preserveLastAccessTime=value Wenn der Connector Dateien und Ordner crawlt, kann er den Zeitstempel des letzten Zugriffs der Dateien und Ordner in den Zeitpunkt des Crawlings ändern. Wenn die Zeiten des letzten Zugriffs nicht beibehalten werden, verschieben Sicherungs- und Archivierungssysteme die entsprechenden Dateien und Ordner aufgrund des Connector-Aufrufs möglicherweise nicht in den sekundären Speicher. Standardmäßig versucht der Connector, den Zeitpunkt des letzten Zugriffs beizubehalten (fs.preserveLastAccessTime auf ALWAYS gesetzt). Der Connector kann den Zeitpunkt des letzten Zugriffs auf die Datei möglicherweise nicht wiederherstellen, wenn der Durchlaufnutzer nicht die erforderlichen Berechtigungen zum Schreiben von Dateiattributen hat. Wenn ALWAYS festgelegt ist, lehnt der Connector Crawling-Anfragen für das Dateisystem ab, sodass der Zeitstempel des letzten Zugriffs der Dateien nicht geändert wird. Mögliche Werte: ALWAYS: Der Connector versucht, beim Crawlen von Dateien und Ordnern den Zeitpunkt des letzten Zugriffs beizubehalten. Wenn der Connector den Zeitpunkt des letzten Zugriffs zum ersten Mal nicht beibehalten kann, lehnt er alle nachfolgenden Crawling-Anfragen für das Dateisystem ab, um zu verhindern, dass der Zeitstempel des letzten Zugriffs geändert wird. IF_ALLOWED: Der Connector versucht, beim Crawlen von Dateien und Ordnern den Zeitpunkt des letzten Zugriffs beizubehalten. Das Crawling wird auch dann fortgesetzt, wenn einige Zeitstempel nicht beibehalten werden. NEVER: Der Connector versucht nicht, beim Crawlen von Dateien und Ordnern den Zeitpunkt des letzten Zugriffs zu speichern.
Nur Dateien crawlen, auf die nach einem bestimmten Datum zugegriffen wurde	fs.lastAccessedDate=YYYY-MM-DD Inhalte werden nur gecrawlt, wenn der Zeitpunkt des letzten Zugriffs nach dem angegebenen Datum liegt. Der Standardwert ist disabled. Geben Sie das Datum im ISO8601-Datumsformat an: JJJJ-MM-TT. Wenn der Wert beispielsweise 2010-01-01 lautet, crawlt der Connector nur Inhalte, auf die nach Anfang 2010 zugegriffen wurde. Wenn Sie fs.lastAccessedDate angeben, können Sie keinen Wert für fs.lastAccessedDays festlegen.
Nur Dateien crawlen, auf die innerhalb der vergangenen Anzahl von Tagen zugegriffen wurde	fs.lastAccessedDays=number-of-days Inhalte werden nur gecrawlt, wenn der Zeitpunkt des letzten Zugriffs innerhalb der Anzahl der Tage vor dem aktuellen Zeitpunkt liegt. Der Standardwert ist disabled. Mit dieser Eigenschaft können Sie zuvor indexierte Inhalte ablaufen lassen, auf die seit einiger Zeit nicht mehr zugegriffen wurde. Legen Sie beispielsweise 365 fest, damit Inhalte nur dann gecrawlt werden, wenn im letzten Jahr darauf zugegriffen wurde. Wenn Sie fs.lastAccessedDays angeben, können Sie keinen Wert für fs.lastAccessedDate festlegen.
Nur Dateien crawlen, die nach einem bestimmten Datum geändert wurden	fs.lastModifiedDate=YYYY-MM-DD Inhalte werden nur gecrawlt, wenn der Zeitpunkt der letzten Änderung nach dem angegebenen Datum liegt. Der Standardwert ist disabled. Geben Sie das Datum im ISO8601-Datumsformat an: JJJJ-MM-TT. Wenn der Wert beispielsweise „2010-01-01“ lautet, crawlt der Connector nur Inhalte, die nach Anfang 2010 geändert wurden. Wenn Sie fs.lastModifiedDate angeben, können Sie keinen Wert für fs.lastModifiedDays festlegen.
Nur Dateien crawlen, die innerhalb der letzten Anzahl von Tagen geändert wurden	fs.lastModifiedDays=number-of-days Inhalte werden nur gecrawlt, wenn der Zeitpunkt der letzten Änderung innerhalb der Anzahl der Tage vor dem aktuellen Zeitpunkt liegt. Der Standardwert ist disabled. Mit dieser Eigenschaft können Sie zuvor indexierte Inhalte ablaufen lassen, die seit einiger Zeit nicht mehr geändert wurden. Legen Sie beispielsweise 365 fest, damit Inhalte nur gecrawlt werden, wenn sie im letzten Jahr geändert wurden. Wenn Sie fs.lastModifiedDays angeben, können Sie keinen Wert für fs.lastModifiedDate festlegen.

Zugriffssteuerung für Dateifreigaben überspringen

Standardmäßig behält der Connector die Integrität der Zugriffssteuerung bei, wenn er ACLs (Access Control Lists) an die Indexierungs-API sendet, einschließlich der ACLs für die Dateifreigabe. In einigen Konfigurationen hat der Connector jedoch möglicherweise nicht die erforderlichen Berechtigungen zum Lesen der Freigabe-ACL. In diesen Fällen gibt der Connector in den Suchergebnissen keine Dateien zurück, die in dieser Dateifreigabe verwaltet werden.

Sie können den Connector so konfigurieren, dass die Freigabe-ACL ignoriert wird, damit Inhalte immer in den Suchergebnissen zurückgegeben werden. In diesem Fall erhält die Indexierungs-API statt der tatsächlichen Freigabe-ACL eine vollständig zulässige Freigabe-ACL.

Warnung :Das Umgehen der Zugriffssteuerung für Dateifreigaben entspricht möglicherweise nicht den Sicherheitsrichtlinien Ihres Unternehmens. Mit dieser Einstellung können Nutzer ohne Berechtigung für die Dateifreigabe möglicherweise in der Suche auf Dokumente zugreifen, die von dieser Dateifreigabe gehostet werden Ergebnisse.

Einstellung	Parameter
Zugriffssteuerung für Dateifreigaben überspringen	fs.skipShareAccessControl=boolean Legen Sie false fest (Standardeinstellung), um Freigabe-ACLs zu erzwingen. Legen Sie true fest, um die Freigabe-ACLs zu ignorieren.