Selain konten Google Workspace, Anda dapat menyiapkan Google Cloud Search untuk menampilkan hasil dari konten lokal SharePoint organisasi Anda. Anda menggunakan konektor Google Cloud Search SharePoint On-Prem dan mengonfigurasinya untuk mengakses sumber data SharePoint tertentu.
Pertimbangan penting
Setelan SharePoint yang dihormati
Konektor Cloud Search SharePoint On-Prem selalu mengikuti setelan Visibilitas Penelusuran di SharePoint, yang tidak dapat diganti. Untuk draf dokumen, izin pada akun pengguna (yang digunakan konektor untuk mengakses SharePoint Online) mengontrol dokumen draf yang diindeks dan ditampilkan. Jika akun hanya memiliki izin "Baca Lengkap", konektor menerapkan setelan "Visibilitas item draf" di SharePoint.
Anda juga dapat mengonfigurasi konektor untuk membatasi hasil berdasarkan akses akun pengguna. Anda dapat menggunakan akun utama Google dan akun utama eksternal untuk menentukan ACL. Untuk menerapkan pemangkasan keamanan untuk konten Share, sinkronkan identitas eksternal berikut dengan Direktori Google:
- Pengguna Direktori Aktif
- Grup Direktori Aktif
- Grup Lokal SharePoint (dengan pengguna dan grup Direktori Aktif sebagai anggota)
Untuk menyinkronkan pengguna dan grup AD, gunakan Google Cloud Directory Sync, yang mengaktifkan grup dengan pemetaan identitas. Untuk menyinkronkan grup lokal SharePoint, gunakan Konektor Identitas SharePoint.
Konektor juga perlu melakukan pencarian dengan AD untuk mengambil informasi tambahan guna menyinkronkan akun utama. Misalnya, pencarian dengan AD memungkinkan konektor melakukan hal berikut:
- Petakan SID untuk grup domain ke sAMAccountName yang sesuai.
- Petakan sAMAccountName pengguna ke alamat email untuk keanggotaan grup lokal SharePoint.
Pengoptimalan penelusuran
Anda dapat meningkatkan pengalaman pengguna dengan mengonfigurasi konektor untuk menampilkan hasil penelusuran yang lebih relevan.
Untuk menggunakan API, tetapkan nilai untuk parameter pembuatan HTML di file konfigurasi konektor SharePoint Online. Parameter ini memungkinkan Anda menetapkan kolom yang memiliki dampak lebih tinggi atau lebih rendah pada kecocokan.
Untuk menyiapkan skema, ikuti petunjuk dalam artikel Membuat dan mendaftarkan skema. Saat Anda menyiapkan skema:
Untuk memetakan nama jenis konten SharePoint ke definisi objek yang sesuai, konektor menormalisasi nama jenis konten dengan mengecualikan karakter yang tidak didukung. Untuk definisi objek, Cloud Search API hanya mendukung A-Z, a-z, dan 0-9 sebagai karakter yang valid. Misalnya, jenis konten "Pengumuman" dipetakan ke definisi objek "Pengumuman". Jenis konten "News Article" dipetakan ke "NewsArticle" (tanpa spasi).
Jika konektor tidak dapat mencocokkan definisi objek dengan definisi objek, konektor akan menggunakan jenis objek penggantian (
itemMetadata.objectType
). Pelajari parameter konfigurasi metadata lebih lanjut.Untuk memetakan nama properti SharePoint ke definisi properti, konektor menormalisasi nama properti dengan mendekode karakter yang dienkode dengan heksadesimal dan menghapus awalan "ows_", lalu mengecualikan karakter yang tidak didukung (semua karakter kecuali A-Z, a-z, dan 0-9 sebagai karakter yang valid).
Penanganan pesan Microsoft Outlook
Saat 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, dengan 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 dan tidak bisa mendapatkan izin Baca Lengkap, seperti yang diwajibkan oleh konektor SharePoint On-Prem.
Untuk mengaktifkan mode pengumpulan situs:
- Berikan izin administrator koleksi situs ke akun pengguna konektor.
- Tetapkan
sharepoint.server
di file konfigurasi konektor Anda ke URL koleksi situs, sepertihttp://sharepoint.example.com/sites/sitecollection
. URL tidak perlu menggunakan kasus yang sama persis seperti di SharePoint. - Tetapkan
sharepoint.siteCollectionOnly
di file konfigurasi konektor Anda ketrue
.
Jika Anda memiliki beberapa koleksi situs untuk diindeks di lingkungan multi-tenant, Anda perlu mengonfigurasi satu instance konektor untuk setiap koleksi situs.
Batasan umum konektor
- Waktu yang dibutuhkan konektor untuk mendeteksi perubahan pada item dalam database akan meningkat seiring dengan bertambahnya jumlah database yang dipantau konektor.
- Konsumsi memori meningkat seiring dengan bertambahnya jumlah pengguna dan grup unik yang Anda gunakan di ACL untuk setiap kumpulan situs.
- Anda dapat mengonfigurasi konektor dengan identitas hanya dari satu Domain Active Directory.
- Beberapa akun utama Active Directory dan Windows umum, seperti
Everyone
,BUILTIN\Users
, danAll Authenticated Users
, tidak didukung. - Notifikasi penghapusan tidak seketika dan perlu waktu lebih dari 4 jam bagi konektor untuk mengenali bahwa pengguna telah menghapus konten dari repositori sumber.
Persyaratan sistem
Persyaratan sistem | |
---|---|
Sistem operasi |
|
Software |
|
Autentikasi |
|
Men-deploy konektor
Prasyarat
Buat kunci pribadi Google Workspace, yang berisi ID akun layanan Anda. Untuk mempelajari cara mendapatkan kunci pribadi, buka Mengonfigurasi akses ke Google Cloud Search API.
Administrator Google Workspace Anda harus menambahkan sumber data untuk penelusuran. Catat ID sumber data.
Jika konektor menampilkan hasil berdasarkan ACL (hasil tidak bersifat publik), administrator Google Workspace Anda harus membuat dua sumber identitas dan memberikan ID-nya kepada Anda:
- Sumber identitas untuk menyinkronkan pengguna dan grup Direktori Aktif.
- Sumber identitas untuk grup Lokal SharePoint
Admin juga harus mendapatkan ID pelanggan Google Workspace organisasi dan memberikannya kepada Anda.
Pelajari cara mendapatkan nilai ini di artikel Memetakan identitas pengguna di Cloud Search.
Siapkan akun pengguna untuk konektor yang memiliki izin Baca Lengkap untuk Aplikasi Web SharePoint dalam kebijakan pengguna.
Jika Aplikasi Web SharePoint tidak memiliki kumpulan situs root, buat kumpulan situs root.
Jika ada koleksi situs yang terkunci, login ke server SharePoint dengan akun yang memiliki hak istimewa Admin, lalu jalankan skrip
PrepareWriteLockedSites.ps1
.Agar mendapatkan metrik sumber data untuk mendasari konfigurasi konektor Anda, login ke server SharePoint dengan akun yang memiliki hak istimewa administrasi pertanian, lalu jalankan
diagnose_sp.ps1
.Outputnya melaporkan jumlah aplikasi web, dokumen, dan keanggotaan grup pengguna. Gunakan informasi ini untuk memperkirakan jumlah instance konektor yang Anda perlukan, persyaratan memori, dan jumlah dokumen.
Langkah 1. Instal software konektor Google Cloud Search SharePoint On-Prem.
Clone repositori konektor dari GitHub.
$ git clone https://github.com/google-cloudsearch/sharepoint-connector.git $ cd sharepoint-connector
Lihat versi konektor yang diinginkan:
$ git checkout tags/latest_version
Dengan:
latest_version
= nilai sepertiv1-0.0.5
Buat konektor.
$ mvn package
Untuk melewati pengujian saat Anda membuat konektor, jalankan
mvn package -DskipTests
, bukanmvn package
.Salin file zip konektor ke direktori penginstalan lokal Anda:
$ cp target/google-cloudsearch-sharepoint-connector-latest_version.zip installation-dir $ cd installation-dir $ unzip google-cloudsearch-sharepoint-connector-latest_version.zip $ cd google-cloudsearch-sharepoint-connector-latest_version
Langkah 2: Membuat file konfigurasi konektor SharePoint On-Prem
Di direktori yang sama dengan penginstalan konektor, buat file. Google merekomendasikan agar Anda memberi nama file
connector-config.properties
sehingga tidak diperlukan parameter command line tambahan untuk menjalankan konektor. Jika Anda berencana menjalankan banyak instance konektor, tambahkan detail pada nama untuk membedakannya.Tambahkan parameter sebagai key-value pair ke konten file, seperti dalam contoh berikut:
### Sharepoint On-Prem Connector configuration ### # Required parameters for data source access api.sourceId=08ef8becd116faa4546b8ca2c84b2879 api.serviceAccountPrivateKeyFile=service_account.json api.identitySourceId=08ef8becd116faa475de26d9b291fed9 # Required parameters for SharePoint on-premises 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 # Optional parameters for schema mapping contentTemplate.sharepointItem.title=Title contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
Untuk deskripsi mendetail tentang setiap parameter, buka referensi parameter konfigurasi.
(Opsional) Konfigurasi parameter konektor tambahan, sesuai kebutuhan. Untuk mengetahui detailnya, buka Parameter konektor yang disediakan Google.
Langkah 3. Untuk HTTPS, tambahkan SharePoint sebagai host tepercaya
Jika SharePoint dikonfigurasi untuk menggunakan HTTPS, dapatkan sertifikat SharePoint guna menambahkannya sebagai host tepercaya untuk konektor tersebut.
Di komputer yang akan menjalankan konektor, buka browser, lalu buka SharePoint.
Pada halaman peringatan yang terbuka, klik Saya Memahami Risikonya dan Tambahkan Pengecualian. Halaman tersebut akan menampilkan pesan seperti "Koneksi Ini Tidak Tepercaya" karena sertifikat ditandatangani sendiri dan tidak ditandatangani oleh Certificate Authority tepercaya.
Setelah tombol Lihat tersedia, klik tombol tersebut.
Buka tab Details dan klik Export.
Simpan sertifikat dalam direktori konektor dengan nama
sharepoint.crt
.Klik Tutup, lalu Batalkan untuk menutup jendela.
Buka command prompt dan masukkan perintah berikut:
$ keytool -importcert -keystore cacerts.jks -storepass changeit -file sharepoint.crt -alias sharepoint
Saat ditanya "Percayai sertifikat ini?", jawab ya.
Langkah 4. Menyiapkan logging
Di direktori yang berisi biner konektor, buat folder bernama
logs
.Di direktori yang sama (bukan
logs
), buat file berenkode Latin1 dengan namalogging.properties
.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.
Di direktori yang sama dengan penginstalan konektor SharePoint Online, buat file dan beri nama
sharepoint-onprem-identity-connector.config
.Tambahkan parameter sebagai key-value pair ke konten file, seperti dalam 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 dengan konektor SharePoint On-Prem, kecuali bahwa parameternya adalah
api.customerId
, bukanapi.sourceId
. Nilaiapi.customerId
adalah ID pelanggan yang Anda dapatkan dari admin Google Workspace.
Langkah 6. Luncurkan konektor SharePoint On-Prem
Pada langkah-langkah berikut, Anda akan memetakan akun utama di Active Directory lokal dan kumpulan situs SharePoint ke identitas di layanan Cloud Identity. Sinkronisasi ini dilakukan dengan Google Cloud Directory Sync (GCDS) dan konektor identitas SharePoint On-Prem.
Setelah GCDS menyinkronkan pengguna dan grup, jalankan konektor identitas SharePoint On-Prem untuk menyinkronkan grup koleksi situs SharePoint. Terakhir, jalankan konektor SharePoing On-Prem untuk mengindeks dan menampilkan hasil kepada pengguna Cloud Search Anda.
Jika Anda belum melakukannya, konfigurasikan dan jalankan GCDS. Pastikan untuk mengaktifkan grup dengan pemetaan identitas.
Jalankan konektor identitas SharePoint On-Prem:
$ java -Djava.util.logging.config.file=logging.properties -cp "google-cloudsearch-sharepoint-connector-version.jar" com.google.enterprise.cloudsearch.sharepoint.SharePointIdentityConnector -Dconfig=sharepoint-onprem-identity-connector.config
Jalankan konektor SharePoint On-Prem. Gunakan sintaksis perintah untuk keamanan situs SharePoint Anda:
HTTP (tidak memerlukan host tepercaya):
$ java -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
HTTPS (tambahkan SharePoint sebagai host tepercaya):
$ java -Djavax.net.ssl.trustStore=cacerts.jks -Djavax.net.ssl.trustStoreType=jks -Djavax.net.ssl.trustStorePassword=changeit -Djava.util.logging.config.file=logging.properties -jar google-cloudsearch-sharepoint-connector-v1-version.jar
Referensi parameter konfigurasi
Akses sumber data
Pembahasan | Parameter |
ID sumber data | api.sourceId=1234567890abcdef
Wajib. ID sumber data Google Cloud Search disiapkan oleh administrator Google Workspace. |
Lokasi ke file kunci pribadi akun layanan | api.serviceAccountPrivateKeyFile=PrivateKey.json
Wajib. Jalur ke file kunci akun layanan Google Cloud Search. |
Akses lokal SharePoint
Pembahasan | Parameter |
URL server SharePoint | sharepoint.server=http://yoursharepoint.example.com/
Wajib. URL server SharePoint sebagai nama host yang sepenuhnya memenuhi syarat, seperti http://yoursharepoint.example.com/. Jika nama host tidak sepenuhnya memenuhi syarat, Anda harus menetapkan penggantian DNS pada host konektor. |
Nama pengguna SharePoint | sharepoint.username=YOURDOMAIN\\ConnectorUser
Wajib diisi saat Anda menjalankan konektor di Linux atau di komputer Windows yang bukan bagian dari domain AD Server SharePoint. |
Sandi SharePoint | sharepoint.password=user_password
Wajib diisi saat Anda menjalankan konektor di Linux atau di komputer Windows yang bukan bagian dari domain AD Server SharePoint. |
Gunakan Autentikasi Live untuk terhubung ke SharePoint | sharepoint.username=AdaptorUser Live Authentication Id
|
Gunakan Autentikasi ADFS untuk terhubung ke SharePoint | sharepoint.username=AdaptorUser@yourdomain.com
|
Pengindeksan koleksi situs
Pembahasan | Parameter |
Jenis indeks | sharepoint.siteCollectionOnly=boolean
Opsional, kecuali untuk deployment SharePoint multi-tenant (pelajari lebih lanjut). Tetapkan ke true agar indeks konektor |
Pemetaan Identitas SharePoint
Pembahasan | Parameter |
ID Sumber Identitas | api.identitySourceId=1234567890abcdef
Wajib. ID sumber identitas untuk menyinkronkan Grup Lokal SharePoint.ID sumber Google Cloud Search yang disiapkan oleh administrator Google Workspace, seperti yang dijelaskan dalam Menambahkan sumber data untuk penelusuran. |
Sumber Identitas Referensi | api.referenceIdentitySources=CONTOSO,contoso
Daftar sumber identitas referensi yang dipisahkan koma untuk akun utama direktori aktif. Nilainya cocok dengan nama NETBIOS Active Directory dari akun utama direktori aktif referensi. |
ID Sumber Identitas Referensi | api.referenceIdentitySource.DOMAIN.id=identity-source-id
Wajib. ID Sumber Identitas untuk menyinkronkan akun utama Active Directory. |
Pencarian Direktori Aktif
Pembahasan | Parameter |
Host Direktori Aktif | adLookup.host=host
Wajib. Nama host direktori aktif, seperti dc.contoso.com, atau alamat IP. |
Port pencarian Direktori Aktif | adLookup.port=port
Opsional. Port defaultnya adalah 389. Gunakan 686 untuk SSL. |
Metode pencarian Direktori Aktif | adLookup.method=value
Opsional. Defaultnya adalah `standar`. Untuk koneksi HTTPS, setel ke `ssl`. |
Pengguna pencarian Direktori Aktif | adLookup.username=CONTOSO\user1
Wajib. Pengguna diizinkan untuk melakukan pencarian direktori aktif. |
Sandi pencarian Direktori Aktif | adLookup.password=password123
Wajib. Sandi untuk pengguna yang ditentukan oleh |
Pembuatan konten HTML
Pembahasan | Parameter |
Kolom judul template HTML | contentTemplate.sharePointItem.title=Title
Kolom SharePoint yang akan digunakan sebagai judul template HTML untuk HTML yang dihasilkan. |
Kolom konten HTML dengan kualitas penelusuran tinggi | contentTemplate.sharePointItem.quality.high=highField1[,highField2,...]
Daftar kolom yang dipisahkan koma untuk disertakan dalam HTML yang dihasilkan sebagai kolom berkualitas tinggi. Jika istilah kueri penelusuran cocok dengan kolom ini, hasil diberi peringkat lebih tinggi. |
Kolom konten HTML dengan kualitas penelusuran sedang | contentTemplate.sharePointItem.quality.medium=mediumField1[,mediumField2,...]
Daftar kolom yang dipisahkan koma yang akan disertakan dalam HTML yang dihasilkan sebagai kolom berkualitas sedang. |
Kolom konten HTML dengan kualitas penelusuran rendah | contentTemplate.sharePointItem.quality.low=lowField1[,lowField2,...]
Daftar kolom yang dipisahkan koma untuk disertakan dalam HTML yang dihasilkan sebagai kolom berkualitas rendah. |
Kolom konten HTML yang belum dipetakan | contentTemplate.sharepointItem.unmappedColumnsMode=APPEND
Cara konektor menangani kolom yang tidak dipetakan. Nilainya adalah APPEND (default) atau IGNORE.
|