Deployment del connettore Microsoft SharePoint Online

Considerazioni importanti

Impostazioni di SharePoint rispettate

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

Inoltre, puoi configurare il connettore in modo da limitare i risultati in base all'accesso all'account utente. Per applicare il taglio per la sicurezza ai contenuti di SharePoint, sincronizza le seguenti identità esterne con la directory Google:

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

Ottimizzazione per la rete di ricerca

Puoi migliorare l'esperienza degli utenti 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: Configurare il connettore di identità di SharePoint Online

Questo passaggio è necessario per applicare le ACL basate sulle identità di SharePoint Online ai risultati di ricerca. Se configuri 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, anziché api.sourceId, il parametro è api.customerId. Il valore di api.customerId è l'ID cliente che hai ricevuto dall'amministratore di Google Workspace.

Passaggio 5: Installare il connettore di identità di Office 365

Questo passaggio è necessario per applicare le ACL basate sull'identità di SharePoint Online ai risultati di ricerca. Se configuri 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. Controlla la versione del connettore che ti interessa:

   $ git checkout tags/v1-0.0.3

3. Crea il connettore.

   $ mvn package

   Per saltare i test durante la creazione del 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: Configura il connettore di identità di Office 365 e imposta la registrazione

Passaggio 7: Avvia il connettore SharePoint Online

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

Dopo che il connettore di Office 365 ha sincronizzato gli utenti e i gruppi, esegui il connettore delle identità di SharePoint Online per sincronizzare i gruppi di raccolte di siti di SharePoint. Quindi esegui il connettore SharePoint Online per indicizzare e pubblicare i risultati per gli 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à di 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 ai parametri di configurazione

Accesso a origine dati

Accesso a SharePoint Online

Mappatura delle identità di SharePoint

Generazione di contenuti HTML

Configurazione del connettore di identità di Office 365