Deployment del connettore Microsoft SharePoint Online

Considerazioni importanti

Impostazioni di SharePoint rispettate

Il connettore Cloud Search SharePoint Online rispetta sempre l'impostazione Visibilità nella ricerca su SharePoint, che non può essere sovrascritta. Per le bozze di documenti, le autorizzazioni dell'account utente (utilizzato dal connettore per accedere a SharePoint Online) controllano quali bozze di documenti vengono indicizzate e restituite. Se l'account dispone solo della funzionalità "Lettura completa" le autorizzazioni, il connettore rispetta la "Visibilità dell'elemento in bozza" impostazioni su SharePoint.

Inoltre, configurerai il connettore per limitare i risultati in base all'accesso all'account utente. Per applicare la limitazione della sicurezza ai contenuti di SharePoint, devi sincronizzare le seguenti identità esterne con la directory Google:

• Utenti di Office 365 / Azzurro AD
• Office 365 / Gruppi di sicurezza Azure AD
• Gruppi di SharePoint (con utenti e gruppi di Office 365 come membri)

Ottimizzazione della ricerca

Puoi migliorare le prestazioni configurando il connettore in modo che restituisca risultati di ricerca più pertinenti.

Per utilizzare l'API, imposta i valori per i parametri di generazione HTML nel file di configurazione del connettore SharePoint Online. Questi parametri ti consentono di impostare i campi che hanno un impatto maggiore o minore sulle corrispondenze.

Requisiti di sistema

Esegui il deployment del connettore

Prerequisiti

Passaggio 2: Crea il file di configurazione del connettore SharePoint Online

Passaggio 4: configura il connettore di identità SharePoint Online

Questo passaggio è necessario per applicare ACL basati sull'identità di SharePoint Online ai risultati di ricerca. Se hai configurato il connettore con ACL pubblici, puoi saltare questo passaggio.

1. Nella stessa directory dell'installazione del connettore SharePoint Online, crea un nuovo file e assegnagli il nome sharepoint-online-identity-connector.config.

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

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

   I valori sono quasi gli stessi del connettore SharePoint Online, tranne per il fatto che, invece di api.sourceId, il parametro è api.customerId. Il valore api.customerId corrisponde all'ID cliente che hai ricevuto dall'amministratore di Google Workspace.

Passaggio 5: Installare il connettore di identità Office 365

Questo passaggio è necessario per applicare ACL basati sull'identità di SharePoint Online ai risultati di ricerca. Se hai configurato il connettore con ACL pubblici, puoi saltare questo passaggio.

1. Clona il repository del connettore da GitHub.

   $ git clone https://github.com/google-cloudsearch/office-365-connector.git
   $ cd office-365-connector

2. Verifica la versione del connettore che ti interessa:

   $ git checkout tags/v1-0.0.3

3. Crea il connettore.

   $ mvn package

   Per saltare i test quando crei il connettore, esegui mvn package -DskipTests anziché mvn package.

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

   $ 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

Passaggio 6: Configurare il connettore di identità Office 365 e impostare il logging

Passaggio 7: avvia il connettore SharePoint Online

Nei passaggi successivi, mapperai le entità sia in Office 365 che nella raccolta siti di SharePoint alle identità nel servizio Cloud Identity. La sincronizzazione viene eseguita con il connettore di identità Office 365 e il connettore di identità SharePoint Online.

Dopo che il connettore di Office 365 ha sincronizzato gli utenti e i gruppi, eseguire il connettore di identità SharePoint Online per sincronizzare i gruppi di raccolta siti di SharePoint. Quindi, esegui il connettore SharePoint Online per indicizzare e fornire i risultati agli utenti di Cloud Search.

1. Esegui il connettore di identità di Office 365:

   $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-office-365-connector-v1-0.0.3.jar -Dconfig=o365-identity-connector.config

2. Esegui il connettore di identità SharePoint Online:

   $ 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

3. Esegui il connettore SharePoint Online:

   $ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-0.0.3.jar -Dconfig=sharepoint-online-connector.config

Riferimento per i parametri di configurazione

Accesso a origine dati

Accesso a SharePoint Online

Mappatura delle identità SharePoint

Generazione di contenuti HTML

Configurazione del connettore di identità Office 365