Selain konten Google Workspace, Anda dapat menyiapkan Google Cloud Search untuk menampilkan hasil dari konten SharePoint Online organisasi Anda. Anda menggunakan konektor Google Cloud Search SharePoint Online dan mengonfigurasinya untuk mengakses sumber data SharePoint Online tertentu.
Pertimbangan penting
Setelan SharePoint yang dihormati
Konektor Cloud Search SharePoint Online selalu menerapkan setelan Visibilitas Penelusuran di SharePoint, yang tidak dapat diganti. Untuk draf dokumen, izin di akun pengguna (yang digunakan konektor untuk mengakses SharePoint Online) mengontrol dokumen draf apa yang diindeks dan ditampilkan. Jika akun hanya memiliki izin "Baca Penuh", konektor mengikuti setelan "Visibilitas item draf" di SharePoint.
Anda juga mengonfigurasi konektor untuk membatasi hasil berdasarkan akses akun pengguna. Untuk menerapkan pemangkasan keamanan untuk konten SharePoint, Anda harus menyinkronkan identitas eksternal berikut dengan Direktori Google:
- Pengguna Office 365/Azure AD
- Grup keamanan Office 365/Azure AD
- Grup SharePoint (dengan pengguna dan grup Office 365 sebagai anggota)
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.Konektor memetakan nama properti SharePoint ke definisi properti.
Saat konektor menemukan file .msg Microsoft Outlook saat mengindeks konten, konektor akan mengganti jenis konten untuk file tersebut dan mengindeksnya sebagai
application/vnd.ms-outlook.
Batasan umum konektor
- Setiap instance konektor dapat mengindeks konten hanya dari satu koleksi situs. Untuk mengindeks beberapa koleksi situs, siapkan instance konektor tambahan.
- Konsumsi memori meningkat seiring dengan bertambahnya jumlah pengguna dan grup unik yang Anda gunakan di ACL untuk setiap kumpulan situs.
- 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 |
|
Autentikasi |
|
Software |
|
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:
- satu untuk pengguna dan grup Office 365
- satu untuk grup 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 hak istimewa Administrator Pengumpulan Situs SharePoint Online.
Jika konektor menampilkan hasil berdasarkan ACL (hasil tidak bersifat publik), buat kredensial untuk membaca pengguna dan grup dari akun Office 365 Anda. Ikuti petunjuk Microsoft untuk membuat aplikasi Azure Active Directory. Saat Anda menyiapkan aplikasi:
- Beri nama aplikasi dengan nama deskriptif, seperti "gcs-o365-identity-connector".
- Tambahkan izin. Aplikasi memerlukan "Group.Read.All" dan "User.Read.All".
- Catat informasi berikut untuk digunakan dalam konfigurasi konektor:
- ID Aplikasi
- Tenant
- Rahasia Klien
Langkah 1. Instal software konektor SharePoint Online
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/v1-0.0.3
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-v1-0.0.3.zip installation-dir $ cd installation-dir $ unzip google-cloudsearch-sharepoint-connector-v1-0.0.3.zip $ cd google-cloudsearch-sharepoint-connector-v1-0.0.3
Langkah 2: Membuat file konfigurasi konektor SharePoint Online
Di direktori yang sama dengan penginstalan konektor, buat file baru dan beri nama
sharepoint-online-connector.config
. Jika Anda berencana menjalankan banyak instance konektor, tambahkan detail lainnya pada nama untuk membedakannya.Tambahkan parameter sebagai key-value pair ke konten file, seperti dalam contoh berikut:
### SharePoint Online connector configuration ### # Required parameters for data source access api.sourceId=08ef8becd116faa4546b8ca2c84b2879 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 # Optional SharePoint List Item metadata parameters 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. Menyiapkan logging untuk konektor SharePoint Online
Buat folder bernama logs di direktori yang sama yang berisi biner konektor.
Buat file berenkode Latin-1 bernama logging.properties di direktori yang sama dan tambahkan konten berikut:
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 4. Mengonfigurasi konektor identitas SharePoint Online
Langkah ini diperlukan untuk menerapkan ACL berbasis identitas SharePoint Online 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 baru dan beri nama
sharepoint-online-identity-connector.config
.Tambahkan parameter sebagai key-value pair ke konten file, seperti dalam contoh berikut:
### 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
Nilainya hampir sama seperti konektor SharePoint Online, kecuali bahwa parameternya adalah
api.customerId
, bukanapi.sourceId
. Nilaiapi.customerId
adalah ID pelanggan yang Anda dapatkan dari admin Google Workspace.
Langkah 5. Menginstal Konektor identitas Office 365
Langkah ini diperlukan untuk menerapkan ACL berbasis identitas SharePoint Online ke hasil penelusuran. Jika Anda menyiapkan konektor dengan ACL publik, Anda dapat melewati langkah ini.
Clone repositori konektor dari GitHub.
$ git clone https://github.com/google-cloudsearch/office-365-connector.git $ cd office-365-connector
Lihat versi konektor yang diinginkan:
$ git checkout tags/v1-0.0.3
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-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
Langkah 6. Mengonfigurasi Konektor Identitas Office 365 dan menyiapkan logging
Di direktori yang sama dengan penginstalan konektor identitas, buat file baru dan beri nama
o365-identity-connector.config
.Tambahkan parameter sebagai key-value pair ke konten file, seperti dalam contoh berikut. Catatan: Semua parameter diperlukan.
### Office 365 Identity connector configuration ###
api.identitySourceId=12345abcde api.customerId=abcde12345 o365.clientId=a63c6eb3-29e7-486 o365.tenant=185ef9ed-29e7-486 o365.clientSecret=raHJN15vRLBKsUntuk deskripsi mendetail tentang setiap parameter, buka Referensi konfigurasi konektor identitas Office 365.
Buat folder bernama logs di direktori yang sama yang berisi biner konektor.
Buat file ASCII atau UTF-8 bernama logging.properties di direktori yang sama dan tambahkan konten berikut:
handlers = java.util.logging.ConsoleHandler,java.util.logging.FileHandler # Default log level .level = INFO # uncomment line below to increase logging level for Office 365 APIs #com.google.enterprise.cloudsearch.o365.level=FINE # uncomment line below to increase logging level to enable Google API traces #com.google.api.client.http.level = FINE java.util.logging.ConsoleHandler.level = INFO java.util.logging.FileHandler.pattern=logs/connector-o365.%g.log java.util.logging.FileHandler.limit=10485760 java.util.logging.FileHandler.count=10 java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
Langkah 7. Luncurkan konektor SharePoint Online
Pada langkah-langkah berikut, Anda akan memetakan akun utama di Office 365 dan kumpulan situs SharePoint ke identitas di layanan Cloud Identity. Sinkronisasi ini dilakukan dengan Konektor identitas Office 365 dan konektor identitas SharePoint Online.
Setelah konektor Office 365 menyinkronkan pengguna dan grup, jalankan konektor identitas SharePoint Online, untuk menyinkronkan grup kumpulan situs SharePoint. Kemudian, jalankan konektor SharePoint Online untuk mengindeks dan menampilkan hasilnya kepada pengguna Cloud Search Anda.
Jalankan konektor identitas 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
Jalankan konektor identitas 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
Jalankan konektor 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
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 SharePoint Online
Pembahasan | Parameter |
Nama domain yang memenuhi syarat sepenuhnya untuk Kumpulan Situs SharePoint | sharepoint.server= http://yoursharepoint.example.com/
Wajib. Jika nama domain tidak sepenuhnya memenuhi syarat, tetapkan penggantian DNS pada host konektor. |
Mode Khusus Kumpulan Situs | sharepoint.siteCollectionOnly=true
Wajib. Untuk SharePoint Online, tetapkan nilai |
Nama pengguna SharePoint | sharepoint.username=username
Wajib. Nama pengguna akun yang digunakan untuk mengakses SharePoint Online. |
Sandi SharePoint | sharepoint.password=user_password
Wajib. Kata sandi untuk akun yang digunakan untuk mengakses SharePoint Online. |
Mode Autentikasi | sharepoint.formsAuthenticationMode=LIVE
Wajib. Untuk SharePoint Online, nilainya selalu `LIVE`. |
Jenis Penerapan | sharepoint.deploymentType=ONLINE
Wajib. Untuk SharePoint Online, nilainya selalu `ONLINE`. |
Pemetaan Identitas SharePoint
Pembahasan | Parameter |
ID Sumber Identitas | api.identitySourceId=1234567890abcdef
Wajib. ID sumber identitas Cloud Search untuk sumber identitas grup SharePoint. |
Sumber Identitas Referensi | api.referenceIdentitySources=defaultIdentitySource
Wajib. Untuk sharePoint Online, nilainya selalu `defaultIdentitySource`. |
ID Sumber Identitas Referensi | api.referenceIdentitySource.defaultIdentitySource.id=112233abcd
Wajib. ID sumber identitas Cloud Search untuk sumber identitas Pengguna dan Grup Office 365. |
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.
|
Konfigurasi Konektor identitas Office 365
Pembahasan | Parameter |
ID Sumber Identitas | api.identitySourceId=1234567890abcdef
Wajib. ID sumber identitas Office 365. Nilai ini harus cocok dengan nilai `api.referenceIdentitySource.defaultIdentitySource.id` dalam konfigurasi konektor SharePoint Online. |
ID Pelanggan Google | api.customerId=c1b1d1e1
Wajib. ID pelanggan Google Workspace organisasi Anda. |
ID Aplikasi Office 365 | o365.clientId=a63c6eb3-29e7-486
Wajib. ID aplikasi dari penyiapan aplikasi Office 365. |
Tenant Office 365 | o365.tenant=185ef9ed-29e7-486
Wajib. Penyewa untuk akun Office 365 Anda (aplikasi Azure Activity Directory) |
Rahasia klien Office 365 | o365.clientSecret=raHJN15vRLBKs
Wajib. Rahasia kredensial dari penyiapan Aplikasi Office 365 |