Deployment del connettore file system di Microsoft Windows

Puoi configurare Google Cloud Search in modo che restituisca risultati dalle condivisioni Microsoft Windows della tua organizzazione oltre ai contenuti di Google Workspace. Utilizzi il connettore Google Cloud Search File Systems e lo configuri per accedere alle condivisioni Windows specificate. Una singola istanza del connettore può supportare più condivisioni di Microsoft Windows.

Considerazioni importanti

Aggiornamenti automatici continui

Per impostazione predefinita, il connettore monitora continuamente i percorsi di avvio (valori di fs.src nel file di configurazione del connettore) all'avvio. Quando il file system segnala modifiche ai controlli di accesso o ai contenuti, il connettore viene attivato per eseguire nuovamente la scansione del file system. Questa nuova scansione può richiedere molte risorse. Per disattivare il monitoraggio del file system, imposta fs.monitorForUpdates su false. Riduce in modo significativo l'utilizzo delle risorse del connettore, ma ritarda il momento in cui il connettore riflette le modifiche. Scopri di più

Controllo dell'accesso DFS

Il sistema DFS applica il controllo dell'accesso ai suoi link e in genere ogni link DFS ha il proprio ACL. Uno dei meccanismi utilizzati da DFS è l'enumerazione basata sull'accesso (ABE), che può limitare i link DFS restituiti a un utente. Gli utenti potrebbero visualizzare solo un sottoinsieme dei link DFS o anche un solo link quando ABE isola le home directory ospitate. Quando il connettore attraversa un sistema DFS, rispetta l'ACL del link DFS e l'ACL di condivisione della destinazione, mentre l'ACL di condivisione eredita dall'ACL DFS.

Limitazioni note

  • File system: il connettore File system non supporta le unità mappate e le unità locali.
  • Distributed File System: un'unità mappata a un UNC DFS non funziona correttamente. Alcune ACL non vengono lette correttamente.
  • Il connettore File Systems supporta i link e gli spazi dei nomi DFS (Distributed File System). Tuttavia, il connettore supporta i link DFS solo in uno spazio dei nomi DFS, non nelle cartelle normali dello spazio dei nomi DFS.
  • I link ai file restituiti in cloudsearch.google.com non sono cliccabili. Anche i link ai file restituiti dall'API Query non sono cliccabili nella maggior parte dei browser.

Requisiti di sistema

Requisiti di sistema
Sistema operativo
  • Windows Server 2016
  • Windows Server 2012
  • Windows Server 2008 R2
Software
  • Java JRE 1.8 installato sul computer che eseguirà il connettore Google Cloud Search File Systems
Protocolli del file system
  • Server Message Block (SMB) - SMB1
  • Server Message Block (SMB) - SMB2
  • Distributed File System (DFS)

Non supportati: file system Windows locali, Sun Network File System (NFS) 2.0, Sun Network File System (NFS) 3.0 o file system Linux locale.

Esegui il deployment del connettore

Prerequisiti

Prima di eseguire il deployment del connettore Cloud Search File Systems, assicurati che il tuo ambiente disponga di tutti i seguenti componenti prerequisiti:

Autorizzazioni account Microsoft Windows richieste

L'account Microsoft Windows con cui viene eseguito il connettore deve disporre di autorizzazioni sufficienti per eseguire le seguenti azioni:

  • Elencare i contenuti delle cartelle
  • Leggere il contenuto dei documenti
  • Leggere gli attributi di file e cartelle
  • Autorizzazioni di lettura (ACL) per file e cartelle
  • Scrivere le autorizzazioni degli attributi di base

L'appartenenza a uno dei seguenti gruppi concede a un account Windows le autorizzazioni sufficienti richieste dal connettore:

  • Amministratori
  • Utenti esperti
  • Operatori di stampa
  • Operatori del server

Passaggio 1: Installare il connettore Google Cloud Search File Systems

  1. Recupera il repository del connettore da GitHub e crealo.

    Per utilizzare git sul server Windows:

    1. Clona il repository:

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

    2. Controlla la versione desiderata del connettore:

      > git checkout tags/v1-0.0.3

    Per scaricare direttamente da GitHub:

    1. Vai alla pagina https://github.com/google-cloudsearch/windows-filesystems-connector.
    2. Fai clic su Clona o scarica Scarica zip.
    3. Decomprimi il pacchetto.
    4. Passa alla nuova directory: 
      > cd windows-filesystems-connector

  2. Crea il connettore. Se necessario, installa Apache Maven.

    > mvn package

    Per ignorare i test durante la creazione del connettore, esegui mvn package -DskipTests anziché mvn package.

  3. Copia il file ZIP del connettore nella directory di installazione locale:

    > 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

Passaggio 2: Crea il file di configurazione del connettore

  1. Nella stessa directory dell'installazione del connettore, crea un file e chiamalo connector-config.properties.

  2. Aggiungi i parametri come coppie chiave/valore ai contenuti del file, come nell'esempio seguente:

    ### 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

    Per descrizioni dettagliate di ciascun parametro, consulta il riferimento ai parametri di configurazione.

  3. (Facoltativo) Configura altri parametri del connettore, se necessario. Per maggiori dettagli, vai a Parametri del connettore forniti da Google.

Passaggio 3: Abilita il logging

  1. Crea una cartella denominata logs nella directory contenente il file binario del connettore.

  2. Crea un file ASCII o UTF-8 denominato logging.properties nella directory contenente il file binario del connettore e aggiungi il seguente contenuto:

    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

Passaggio 4: (Facoltativo) Configurare i tipi di media

Per impostazione predefinita, il connettore tenta di rilevare il tipo di media per ogni file con il rilevamento del tipo di media fornito da JDK. Su Microsoft Windows, JDK si basa sul Registro di sistema di Windows per determinare i tipi di media per i file. Una voce di registro mancante può comportare un tipo di media nullo per determinati file.

Se necessario, puoi specificare un tipo di media che sovrascrive eventuali binding esistenti o impedisce un tipo di media nullo.

  1. Nella directory del connettore, crea un file criptato con codifica Latin-1 denominato mime-type.properties.

  2. Inserisci le estensioni dei file e i tipi di media corrispondenti come negli esempi seguenti:

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

Passaggio 5: esegui il connettore File Systems

Dopo aver installato e configurato il connettore File Systems, per avviarlo sulla macchina host, esegui un comando come il seguente esempio:

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

Specifica il percorso del file di configurazione se è diverso da quello predefinito (nella stessa directory del file binario con il nome connector-config.properties).

Riferimento ai parametri di configurazione

Accesso a origine dati

Impostazione Parametro
ID origine dati api.sourceId=1234567890abcdef

Obbligatorio. L'ID origine Google Cloud Search configurato dall'amministratore di Google Workspace.
Percorso del file della chiave privata del service account api.serviceAccountPrivateKeyFile=./PrivateKey.json

Obbligatorio. Il file della chiave del service account Google Cloud Search per l'accessibilità del connettore Google Cloud Search File Systems.
ID origine identità api.identitySourceId=x0987654321

Obbligatorio. L'ID origine identità Cloud Search configurato dall'amministratore di Google Workspace per la sincronizzazione delle identità di Active Directory utilizzando GCDS.

Accesso al file system

Impostazione Parametro
File system di origine fs.src=path1[,path2, ...]

Obbligatorio. Specifica i file system di origine come una o più origini UNC separate dal delimitatore configurato da fs.src.separator. Se utilizzi caratteri non presenti in Latin1, codificali con i caratteri di escape Unicode di Java.

Carattere separatore di percorso

Impostazione Parametro
Carattere separatore di percorso fs.src.separator=separator-character

Il separatore predefinito è ";". Se i percorsi di origine contengono punti e virgola, puoi impostare un delimitatore diverso, ad esempio una virgola (","), che non sia in conflitto con i caratteri nei percorsi e non sia riservato dalla sintassi del file di proprietà stesso.

Se il valore di fs.src.separator è una stringa vuota, il valore di fs.src viene trattato come un singolo percorso.

Comportamento del connettore

Impostazione Parametro
Dominio Windows fs.supportedDomain=domain

Necessario per consentire agli utenti configurati con GCDS di accedere ai documenti tramite Cloud Search. Specifica un singolo nome di dominio NetBIOS di Active Directory.
Includere gli account negli ACL fs.supportedAccounts=account-1[, account-2,...]

Un elenco separato da virgole di account da includere negli ACL, indipendentemente dal fatto che siano account integrati.

Il valore predefinito è BUILTIN\\Administrators,Everyone,BUILTIN\\Users, BUILTIN\\Guest,NT AUTHORITY\\INTERACTIVE, NT AUTHORITY\\Authenticated Users
Escludere gli account integrati dagli elenchi di controllo dell'accesso fs.builtinGroupPrefix=prefix

Specifica il prefisso degli account integrati. Un account che inizia con questo prefisso è considerato un account integrato e verrà escluso dagli ACL.

Il valore predefinito è BUILTIN\\
Consenti l'indicizzazione di file e cartelle nascosti fs.crawlHiddenFiles=boolean

Imposta true per consentire al connettore di eseguire la scansione di file e cartelle nascosti (nei file system Windows, un file o una cartella viene considerato nascosto se è impostato l'attributo nascosto DOS). Il valore predefinito è false.
Consenti l'indicizzazione degli elenchi delle cartelle sottoposte a scansione e delle enumerazioni dello spazio dei nomi DFS fs.indexFolders=boolean

Se impostato su true (impostazione predefinita), quando il connettore esegue la scansione di una cartella, crea un oggetto CONTAINER_ITEM. Se impostato su false, il connettore crea invece un oggetto VIRTUAL_CONTAINER_ITEM.
Abilita il monitoraggio delle modifiche al file system fs.monitorForUpdates=boolean

Se impostato su true (impostazione predefinita), le modifiche ai contenuti o ai controlli dell'accesso attivano la nuova scansione del connettore. Quando disattivi il monitoraggio (impostato su false), riduci significativamente l'utilizzo delle risorse del connettore, ma ritardi il momento in cui il connettore riflette le modifiche.
Imposta la dimensione massima della cache delle directory fs.directoryCacheSize=number-of-entries

La dimensione massima della cache della directory. Il connettore utilizza la cache per identificare le cartelle nascoste ed evitare di indicizzare file e cartelle nelle cartelle nascoste.

Il valore predefinito è 50.000 voci, che in genere consumano 10-15 megabyte di RAM.

Conservazione dei timestamp e controllo della scansione

Impostazione Parametro
Preserva il timestamp dell'ultimo accesso fs.preserveLastAccessTime=value

Quando il connettore esegue la scansione di file e cartelle, può modificare il timestamp dell'ultimo accesso di file e cartelle in base all'ora della scansione. Quando gli orari dell'ultimo accesso non vengono conservati, i sistemi di backup e archiviazione potrebbero non spostare i file e le cartelle appropriati nello spazio di archiviazione secondario a causa della visita del connettore.

Per impostazione predefinita, il connettore tenta di conservare l'ultima ora di accesso (fs.preserveLastAccessTime impostato su ALWAYS). Il connettore potrebbe non essere in grado di ripristinare l'ultima ora di accesso al file quando l'utente di attraversamento non dispone di privilegi sufficienti per scrivere gli attributi del file. Se impostato su ALWAYS, il connettore rifiuta le richieste di scansione per il file system in modo da non alterare i timestamp dell'ultimo accesso ai file.

Valori possibili:

  • ALWAYS: il connettore tenta di conservare l'ultima ora di accesso durante la scansione di file e cartelle. La prima volta che il connettore non riesce a conservare l'ultima ora di accesso, rifiuta tutte le successive richieste di scansione per il file system per impedire l'alterazione dei timestamp dell'ultimo accesso.
  • IF_ALLOWED: il connettore tenta di conservare l'ultima ora di accesso durante la scansione di file e cartelle. Continua a eseguire la scansione anche se alcuni timestamp potrebbero non essere conservati.
  • NEVER: il connettore non tenta di conservare l'ultima ora di accesso durante la scansione di file e cartelle.
Eseguire la scansione solo dei file a cui è stato eseguito l'accesso dopo una determinata data fs.lastAccessedDate=YYYY-MM-DD

Esegui la scansione dei contenuti solo se l'ultimo accesso è successivo alla data specificata. Il valore predefinito è disabled.

Specifica la data nel formato ISO8601: AAAA-MM-GG. Ad esempio, se il valore è 2010-01-01, il connettore esegue la scansione solo dei contenuti a cui è stato eseguito l'accesso dopo l'inizio del 2010.

Se specifichi fs.lastAccessedDate, non puoi impostare anche un valore per fs.lastAccessedDays.
Esegui la scansione solo dei file a cui è stato eseguito l'accesso negli ultimi giorni fs.lastAccessedDays=number-of-days

Esegui la scansione dei contenuti solo se l'ultimo accesso è avvenuto entro il numero di giorni precedenti la data attuale. Il valore predefinito è disabled.

Utilizza questa proprietà per far scadere i contenuti indicizzati in precedenza a cui non è stato eseguito l'accesso da un po' di tempo. Ad esempio, imposta il valore su 365 per eseguire la scansione dei contenuti solo se sono stati consultati nell'ultimo anno.

Se specifichi fs.lastAccessedDays, non puoi impostare anche un valore per fs.lastAccessedDate.
Eseguire la scansione solo dei file modificati dopo una determinata data fs.lastModifiedDate=YYYY-MM-DD

Esegui la scansione dei contenuti solo se l'ora dell'ultima modifica è successiva alla data specificata. Il valore predefinito è disabled.

Specifica la data nel formato ISO8601: AAAA-MM-GG. Ad esempio, se il valore è 2010-01-01, il connettore esegue la scansione solo dei contenuti modificati dopo l'inizio del 2010.

Se specifichi fs.lastModifiedDate, non puoi impostare anche un valore per fs.lastModifiedDays.
Esegui la scansione solo dei file modificati negli ultimi giorni fs.lastModifiedDays=number-of-days

Esegui la scansione dei contenuti solo se l'ultima ora di modifica rientra nel numero di giorni precedenti la data attuale. Il valore predefinito è disabled.

Utilizza questa proprietà per far scadere i contenuti indicizzati in precedenza che non sono stati modificati da un po' di tempo. Ad esempio, imposta il valore su 365 per eseguire la scansione dei contenuti solo se sono stati modificati nell'ultimo anno.

Se specifichi fs.lastModifiedDays, non puoi impostare anche un valore per fs.lastModifiedDate.

Ignorare il controllo dell'accesso alla condivisione dei file

Per impostazione predefinita, il connettore mantiene l'integrità del controllo dell'accesso quando invia gli elenchi di controllo dell'accesso (ACL) all'API Indexing, inclusi gli ACL sulla condivisione file. Tuttavia, in alcune configurazioni, il connettore potrebbe non disporre di autorizzazioni sufficienti per leggere l'ACL di condivisione. In questi casi, il connettore non restituisce alcun file gestito nella condivisione file nei risultati di ricerca.

Puoi impostare il connettore in modo che ignori l'ACL di condivisione, in modo che i contenuti vengano sempre restituiti nei risultati di ricerca. In questo caso, l'API Indexing riceve un ACL di condivisione completamente permissivo, anziché l'ACL di condivisione effettivo.

Impostazione Parametro
Ignorare il controllo dell'accesso alla condivisione dei file fs.skipShareAccessControl=boolean

Imposta false (impostazione predefinita) per applicare gli ACL di condivisione. Imposta il valore su true per ignorare le ACL di condivisione.