Melakukan Deployment Konektor Microsoft SharePoint On-Prem

Penanganan pesan Microsoft Outlook

Jika konektor menemukan file .msg Microsoft Outlook saat mengindeks konten, konektor akan mengganti jenis media untuk file tersebut dan mengindeksnya sebagai application/vnd.ms-outlook.

Konfigurasi multi-tenant

Jika SharePoint Anda adalah deployment multi-tenant, tempat beberapa situs pelanggan dihosting di aplikasi Web yang sama, Anda perlu mengonfigurasi mode pengumpulan situs di file konfigurasi. Dalam deployment multi-tenant, Anda hanya mendapatkan izin untuk koleksi situs Anda dan tidak bisa mendapatkan izin Full Read, seperti yang diperlukan oleh konektor SharePoint On-Prem.

Untuk mengaktifkan mode pengumpulan situs:

• Berikan izin administrator pengumpulan situs akun pengguna konektor.
• Tetapkan sharepoint.server di file konfigurasi konektor Anda ke URL koleksi situs, seperti http://sharepoint.example.com/sites/sitecollection. URL tidak perlu menggunakan kasus yang sama persis seperti di SharePoint.
• Tetapkan sharepoint.siteCollectionOnly di file konfigurasi konektor Anda ke true.

Jika memiliki beberapa kumpulan situs untuk diindeks di lingkungan multi-tenant, Anda harus mengonfigurasi satu instance konektor untuk setiap kumpulan situs.

Batasan umum konektor

• Waktu yang dibutuhkan konektor untuk mendeteksi perubahan pada item dalam {i>database<i} akan meningkat seiring dengan bertambahnya jumlah {i>database<i} yang dimonitor konektor.
• Konsumsi memori meningkat seiring dengan jumlah pengguna unik dan grup yang Anda gunakan dalam ACL untuk setiap kumpulan situs.
• Anda dapat mengonfigurasi konektor dengan identitas hanya dari satu Domain Active Directory.
• Beberapa akun utama Active Directory dan Windows yang umum, seperti Everyone, BUILTIN\Users, dan All Authenticated Users, tidak didukung.
• Notifikasi penghapusan tidak langsung diterapkan dan mungkin perlu waktu lebih dari 4 jam agar konektor dapat mengenali bahwa pengguna telah menghapus konten dari repositori sumber.

Persyaratan sistem

Men-deploy konektor

Prasyarat

Langkah 2. Membuat file konfigurasi konektor SharePoint On-Prem

Langkah 3. Untuk HTTPS, tambahkan SharePoint sebagai host tepercaya

Jika SharePoint dikonfigurasi untuk menggunakan HTTPS, dapatkan sertifikat SharePoint untuk menambahkannya sebagai host tepercaya untuk konektor.

1. Di komputer yang akan menjalankan konektor, buka browser, lalu buka SharePoint.

2. Di halaman peringatan yang terbuka, klik Saya Memahami Risiko dan Tambahkan Pengecualian. Halaman ini akan menampilkan pesan seperti "Koneksi Ini Tidak Tepercaya" karena sertifikat ditandatangani sendiri dan tidak ditandatangani oleh {i>Certificate Authority<i} yang terpercaya.

3. Setelah tombol View tersedia, klik tombol tersebut.

4. Buka tab Details dan klik Export.

5. Simpan sertifikat di direktori konektor dengan nama sharepoint.crt.

6. Klik Tutup, lalu Batal untuk menutup jendela.

7. Buka command prompt dan masukkan perintah berikut:

   $ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint

   Saat muncul dialog "Percayai sertifikat ini?", jawab ya.

Langkah 4. Menyiapkan logging

1. Di direktori yang berisi biner konektor, buat folder bernama logs.

2. Di direktori yang sama (bukan logs), buat file berenkode Latin1 bernama logging.properties.

3. Tambahkan teks berikut ke logging.properties:

   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
   

Langkah 5. Mengonfigurasi konektor identitas SharePoint On-Prem

Langkah ini diperlukan untuk menerapkan ACL berbasis identitas SharePoint On-Prem ke hasil penelusuran. Jika Anda menyiapkan konektor dengan ACL publik, Anda dapat melewati langkah ini.

1. Di direktori yang sama dengan penginstalan konektor SharePoint Online, buat file dan beri nama sharepoint-onprem-identity-connector.config.

2. Tambahkan parameter sebagai key-value pair ke konten file, seperti pada contoh berikut:

   ### SharePoint On-prem identity connector configuration ###
   
   # Required parameters for data source access
   api.customerId=C05d3djk8
   api.serviceAccountPrivateKeyFile=service_account.json
   api.identitySourceId=08ef8becd116faa475de26d9b291fed9
   
   # Required parameters for SharePoint access
   sharepoint.server=http://sp-2016:32967/sites/doc-center-site-collection
   sharepoint.siteCollectionOnly=true
   sharepoint.username=contoso\\admin
   sharepoint.password=pa$sw0rd
   sharepoint.stripDomainInUserPrincipals=true
   
   # Required parameters for AD lookup
   adLookup.host=dc.contoso.com
   adLookup.username=contoso\\admin
   adLookup.password=pa$sw0rd
   api.referenceIdentitySources=CONTOSO,contoso
   api.referenceIdentitySource.contoso.id=08ef8becd116faa5d3783f8c5a80e5aa
   api.referenceIdentitySource.CONTOSO.id=08ef8becd116faa5d3783f8c5a80e5aa
   

   Nilainya hampir sama seperti konektor SharePoint On-Prem, hanya saja parameternya adalah api.customerId, bukan api.sourceId. Nilai api.customerId adalah ID pelanggan yang Anda dapatkan dari admin Google Workspace.

Langkah 6. Meluncurkan konektor SharePoint On-Prem

Pada langkah berikut, Anda memetakan akun utama di Active Directory lokal dan kumpulan situs SharePoint ke identitas di Cloud Identity. Sinkronisasi ini dilakukan dengan Google Cloud Directory Sync (GCDS) dan konektor identitas SharePoint On-Prem.

Setelah GCDS menyinkronkan pengguna dan grup, untuk menyinkronkan grup koleksi situs SharePoint, jalankan konektor identitas SharePoint On-Prem. Terakhir, jalankan konektor SharePoing On-Prem untuk mengindeks dan menayangkan hasil kepada pengguna Cloud Search Anda.

Akses sumber data

Akses lokal SharePoint

Pengindeksan koleksi situs

Pemetaan Identitas SharePoint

Pencarian Direktori Aktif

Pembuatan konten HTML