Menghubungkan Microsoft SharePoint Online dengan penyerapan data

Halaman ini menjelaskan cara menghubungkan SharePoint Online ke Gemini Enterprise menggunakan penyerapan data.

Bagian ini menjelaskan metode autentikasi dan prosedur untuk membuat konektor SharePoint Online di Gemini Enterprise dan menyerap data dari situs SharePoint Online Anda.

Sebelum memulai

Untuk menerapkan kontrol akses sumber data dan mengamankan data di Gemini Enterprise, pastikan Anda telah mengonfigurasi penyedia identitas Anda.

Tentang pendaftaran aplikasi Entra

Sebelum dapat membuat konektor di Gemini Enterprise, Anda harus menyiapkan pendaftaran aplikasi Entra untuk mengaktifkan akses aman ke SharePoint. Cara Anda mendaftarkan aplikasi bergantung pada metode autentikasi yang Anda pilih saat membuat konektor di Gemini Enterprise. Anda dapat memilih salah satu metode berikut:

• Kredensial gabungan:

  • Memungkinkan Google mengakses SharePoint dengan aman menggunakan token yang ditandatangani secara kriptografis, sehingga tidak memerlukan prinsipal pengguna yang sebenarnya.

  • Memerlukan ID subjek untuk mendaftarkan Gemini Enterprise di Entra. Fitur ini tersedia saat Anda membuat konektor SharePoint di Gemini Enterprise.

  • Saat mendaftarkan aplikasi di Entra, Anda harus mengumpulkan detail berikut:

    • URI Instance:
      • Untuk semua situs tingkat pertama: https://DOMAIN_OR_SERVER.sharepoint.com —misalnya, mydomain.sharepoint.com.
      • Untuk satu situs: https://DOMAIN_OR_SERVER.sharepoint.com/[sites/]WEBSITE —misalnya, mydomain.sharepoint.com/sites/sample-site.
    • ID Tenant
    • ID Klien

    Detail ini diperlukan untuk menyelesaikan autentikasi dan membuat konektor SharePoint di Gemini Enterprise.

  • Google merekomendasikan agar Anda menggunakan metode ini.

• Token refresh OAuth 2.0:

  • Memberikan kontrol terperinci atas siapa yang terhubung ke SharePoint API.

  • Saat mendaftarkan aplikasi di Entra, Anda harus mengumpulkan detail berikut:

    • URI instance: URI ini memiliki bentuk berikut:
      • Untuk semua situs tingkat pertama: https://DOMAIN_OR_SERVER.sharepoint.com —misalnya, mydomain.sharepoint.com.
      • Untuk satu situs: https://DOMAIN_OR_SERVER.sharepoint.com/[sites/]WEBSITE —misalnya, mydomain.sharepoint.com/sites/sample-site.
    • ID Tenant
    • ID Klien
    • Rahasia klien

    Detail ini diperlukan untuk menyelesaikan autentikasi dan membuat konektor SharePoint di Gemini Enterprise.

  • Proses autentikasi mencakup login ke akun SharePoint Anda.

  • Metode ini cocok jika penyiapan SharePoint Anda memerlukan autentikasi 2 langkah.

  • Memerlukan Anda untuk membuat pengguna SharePoint baru, yang dapat menambah biaya lisensi.

• Pemberian izin sandi OAuth 2.0:

  • Memberikan kontrol terperinci atas siapa yang terhubung ke SharePoint API.

  • Saat mendaftarkan aplikasi di Entra, Anda harus mengumpulkan detail berikut:

    • URI instance: URI ini memiliki bentuk berikut:
      • Untuk semua situs tingkat pertama: https://DOMAIN_OR_SERVER.sharepoint.com —misalnya, mydomain.sharepoint.com.
      • Untuk satu situs: https://DOMAIN_OR_SERVER.sharepoint.com/[sites/]WEBSITE —misalnya, mydomain.sharepoint.com/sites/sample-site.
    • ID Tenant
    • ID Klien
    • Rahasia klien

    Detail ini diperlukan untuk menyelesaikan autentikasi dan membuat konektor SharePoint di Gemini Enterprise.

  • Proses autentikasi mencakup penyediaan nama pengguna dan sandi yang diberikan admin Entra Anda.

  • Metode ini cocok jika penyiapan SharePoint Anda tidak memerlukan autentikasi 2 faktor.

  • Memerlukan Anda untuk membuat pengguna SharePoint baru, yang dapat menambah biaya lisensi.

Pertimbangan penting saat memberikan izin SharePoint

Google sangat merekomendasikan dan menggunakan prinsip hak istimewa terendah untuk menetapkan hanya izin yang diperlukan untuk menyelesaikan tugas tertentu. Untuk informasi selengkapnya tentang praktik terbaik yang direkomendasikan Google, lihat Menggunakan IAM dengan aman.

Namun, agar berhasil mendaftarkan aplikasi Anda di Microsoft Entra dan membuat konektor SharePoint di Gemini Enterprise, Anda harus memberikan kontrol penuh atas semua situs atau kontrol penuh atas situs yang dipilih. Hal ini mungkin tampak seperti izin yang berlebihan. Alasannya adalah izin Sites.Read.All tidak mengizinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, sedangkan Sites.FullControl.All dan Sites.Selected dengan fullcontrol mengizinkannya.

Penting: Gemini Enterprise tidak menggunakan izin kontrol penuh ini untuk menulis atau memperbarui data apa pun di instance SharePoint Anda.

Mengingat hal ini, saat mengonfigurasi konektor di Gemini Enterprise, Anda dapat melakukan hal berikut untuk membatasi apa yang dapat dan tidak dapat diakses oleh konektor:

• Berikan URI instance tertentu yang membatasi akses ke satu situs
• Pilih entitas tertentu dalam situs yang ingin Anda sinkronkan.

Jika Anda memiliki masalah lebih lanjut terkait izin yang diperlukan, Google merekomendasikan agar Anda menghubungi dukungan Microsoft.

Menyiapkan kredensial gabungan

Gunakan langkah-langkah berikut untuk mengonfigurasi pendaftaran aplikasi, memberikan izin, dan membuat autentikasi. Google merekomendasikan agar Anda menggunakan metode kredensial gabungan.

Penting: Jangan klik Lanjutkan untuk membuat penyimpanan data hingga Anda mengisi semua detail yang diperlukan. Pastikan Anda telah membaca dan melakukan semua langkah berikut sebelum mengklik Lanjutkan untuk membuat penyimpanan data.

Beberapa pesan error umum yang mungkin Anda temui selama proses ini tercantum di Pesan error.

1. Dapatkan client ID akun layanan:

   1. Di konsol Google Cloud , buka halaman Gemini Enterprise.
   2. Di menu navigasi, klik Data Stores.
   3. Klik Create Data Store.
   4. Di halaman Pilih sumber data, scroll atau telusuri SharePoint Online untuk menghubungkan sumber pihak ketiga Anda.
   5. Catat ID subjek. Jangan klik Lanjutkan terlebih dahulu. Lakukan langkah-langkah berikutnya dalam tugas ini, lalu selesaikan langkah-langkah di konsol Google Cloud dengan mengikuti petunjuk di Membuat konektor SharePoint Online.

      

      Catat ID subjek, tetapi jangan klik Lanjutkan terlebih dahulu

2. Daftarkan aplikasi di Microsoft Entra:

   1. Buka pusat admin Microsoft Entra.
   2. Di menu, luaskan bagian Aplikasi, lalu pilih Pendaftaran aplikasi.
   3. Di halaman App registrations, pilih New registration.

      

      Mendaftarkan aplikasi baru di pusat admin Microsoft Entra

   4. Buat pendaftaran aplikasi di halaman Register an application:

      • Di bagian Supported account types, pilih Accounts in the organizational directory only.
      • Di bagian URI Pengalihan, pilih Web dan masukkan URI pengalihan sebagai https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html
      • Biarkan setelan lainnya dalam mode default, lalu klik Register.

        

        Pilih jenis akun dan masukkan URI pengalihan

   5. Catat Client ID dan Tenant ID.

      

      Halaman detail aplikasi

3. Tambahkan kredensial gabungan:

   1. Buka Certificates & secrets > Federated credentials > Add credential.

      

      Menambahkan kredensial gabungan di Microsoft Entra

   2. Gunakan setelan berikut:

      • Federated credential scenario: Other issuer
      • Penerbit: https://accounts.google.com
      • Subject identifier: Gunakan nilai Subject identifier yang Anda catat di konsol Google Cloud pada Langkah 1.a.v.
      • Nama: Berikan nama unik.

   3. Klik Tambahkan untuk memberikan akses.

      

      Menghubungkan Akun Google Anda ke Microsoft Entra ID

4. Tetapkan izin API.

   

   Pilih aplikasi untuk menyetel izin API

   1. Tambahkan dan berikan izin Microsoft Graph berikut. Anda dapat memilih antara opsi kontrol situs (Sites.FullControl.All dan Sites.Selected) dan opsi pembacaan profil (User.Read.All dan User.ReadBasic.All):

      Izin Microsoft Graph untuk kredensial gabungan

      Izin	Jenis	Deskripsi	Justifikasi
      GroupMember.Read.All	Aplikasi	Membaca semua keanggotaan grup	Izin ini memungkinkan Gemini Enterprise memahami keanggotaan grup pengguna di situs SharePoint.
      User.Read	Didelegasikan	Login dan membaca profil pengguna	Ini adalah izin default yang tidak boleh dihapus. Jika dihapus, SharePoint akan menampilkan error yang meminta Anda untuk mengaktifkan kembali izin ini.
      Opsi kontrol situs
      Opsi 1: Sites.FullControl.All	Aplikasi	Kontrol penuh atas semua situs	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Fitur ini juga memungkinkan Gemini Enterprise mengindeks dokumen, acara, komentar, lampiran, dan file di semua situs SharePoint. Jika memberikan kontrol penuh atas semua situs tampak berlebihan, gunakan Opsi 2: Sites.Selected untuk memberikan kontrol terperinci.
      Opsi 2: Sites.Selected	Aplikasi	Kontrol atas situs yang dipilih	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Gemini Enterprise juga dapat mengindeks dokumen, acara, komentar, lampiran, dan file di seluruh situs SharePoint yang dipilih. Izin ini memberikan kontrol yang lebih terperinci, bukan Sites.FullControl.All Catatan: Saat menggunakan Sites.Selected, Anda harus memberikan izin fullcontrol ke situs yang dipilih. Selain itu, agar izin ini berlaku, Anda harus melakukan setidaknya salah satu hal berikut saat membuat konektor SharePoint di Gemini Enterprise: Pada Langkah 5, gunakan URL situs tertentu sebagai URL instance konektor SharePoint Anda—misalnya, mydomain.sharepoint.com/sites/sample-site. Pada Langkah 6, berikan filter siteName yang tepat saat menyiapkan konektor Gemini Enterprise di Langkah 6.
      Opsi membaca profil
      Opsi 1: User.Read.All	Aplikasi	Membaca profil lengkap semua pengguna	Izin ini memungkinkan Gemini Enterprise memahami kontrol akses data untuk konten SharePoint Anda.
      Opsi 2: User.ReadBasic.All	Aplikasi	Membaca profil dasar semua pengguna	Izin ini memungkinkan Gemini Enterprise memahami kontrol akses data untuk konten SharePoint Anda.

   2. Tambahkan dan berikan izin SharePoint berikut. Anda dapat memilih antara Sites.FullControl.All dan Sites.Selected:

      Izin SharePoint untuk kredensial gabungan

      Izin	Jenis	Deskripsi	Justifikasi
      Opsi 1: Sites.FullControl.All	Aplikasi	Kontrol penuh atas semua situs	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Fitur ini juga memungkinkan Gemini Enterprise mengindeks dokumen, acara, komentar, lampiran, dan file di semua situs SharePoint. Jika memberikan kontrol penuh atas semua situs tampak berlebihan, gunakan Opsi 2: Sites.Selected untuk memberikan kontrol terperinci.
      Opsi 2: Sites.Selected	Aplikasi	Kontrol atas situs yang dipilih	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Gemini Enterprise juga dapat mengindeks dokumen, acara, komentar, lampiran, dan file di seluruh situs SharePoint yang dipilih. Catatan: Saat menggunakan Sites.Selected, Anda harus memberikan izin fullcontrol ke situs yang dipilih. Selain itu, agar izin ini berlaku, Anda harus melakukan setidaknya salah satu hal berikut saat membuat konektor SharePoint di Gemini Enterprise: Pada Langkah 5, gunakan URL situs tertentu sebagai URL instance konektor SharePoint Anda—misalnya, mydomain.sharepoint.com/sites/sample-site. Pada Langkah 6, berikan filter siteName yang tepat saat menyiapkan konektor Gemini Enterprise.

   3. Untuk izin yang ditambahkan, periksa apakah kolom Status mencantumkan izin sebagai Granted dan memiliki ikon centang hijau.

      

      Minta izin API (Aplikasi) untuk Microsoft Graph

   

   Verifikasi izin API

5. Berikan izin administrator. Untuk mengetahui informasi tentang cara memberikan izin, lihat Memberikan izin administrator di seluruh tenant ke aplikasi dalam dokumentasi Microsoft Entra.

Menyiapkan OAuth 2.0 untuk pemberian token refresh dan sandi

Anda dapat menggunakan metode OAuth 2.0 untuk menyiapkan pendaftaran aplikasi Entra dan mengaktifkan akses yang aman ke SharePoint. Metode ini mencakup langkah-langkah untuk mengonfigurasi pendaftaran aplikasi, memberikan izin, dan membuat autentikasi.

Google merekomendasikan agar Anda menyiapkan kredensial gabungan daripada mengonfigurasi autentikasi OAuth 2.0.

Anda dapat menggunakan proses berikut untuk mendaftarkan aplikasi di Entra menggunakan autentikasi OAuth 2.0 untuk token refresh dan untuk pemberian sandi. Metode ini lebih disukai jika Anda memerlukan kontrol terperinci atas izin SharePoint REST API, sehingga Anda dapat membatasi akses resource di akun pengguna.

Beberapa pesan error umum yang mungkin Anda temui selama proses ini tercantum di Pesan error.

Tabel berikut menjelaskan peran SharePoint yang direkomendasikan untuk metode autentikasi OAuth 2.0:

Melihat peran

Rekomendasi peran SharePoint untuk metode autentikasi OAuth 2.0

Peran	Pendaftaran aplikasi klien	Mengambil konten semua entitas	Mengambil ACL	Mengambil identitas	Catatan
Admin Situs	Tidak	Ya	Ya	Ya
Administrator Koleksi Situs	Tidak	Ya	Ya	Ya
Administrator global	Ya	Tidak	Ya	Tidak	Batasan: Administrator global tidak dapat mengambil entitas identitas atau komentar dan lampiran.
Pemilik situs	Tidak	Ya	Ya	Tidak	Batasan: Pemilik Situs terkait dengan pusat admin Microsoft 365 / pusat admin Entra, bukan khusus untuk SharePoint.
Administrator aplikasi	Ya	T/A	T/A	T/A	Peran administrator aplikasi terkait dengan pusat administrator Microsoft 365 / pusat administrator Entra. Hal ini tidak khusus untuk SharePoint.

1. Buat pendaftaran aplikasi:

   1. Buka Pusat administrasi Entra.

   2. Buat pendaftaran aplikasi:

      • Jenis akun yang didukung: Accounts in the organizational directory only.
      • URI Pengalihan: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

   3. Catat Client ID dan Tenant ID.

2. Tambahkan rahasia klien:

   1. Buka Certificates & secrets > New client secret.
   2. Catat string rahasia.

3. Tetapkan izin API.

   1. Tambahkan dan berikan izin Microsoft Graph berikut. Anda dapat memilih antara Sites.FullControl.All dan Sites.Selected:

      Izin Microsoft Graph untuk autentikasi OAuth 2.0

      Izin	Jenis	Deskripsi	Justifikasi
      GroupMember.Read.All	Aplikasi	Membaca semua keanggotaan grup	Izin ini memungkinkan Gemini Enterprise memahami keanggotaan grup pengguna di situs SharePoint.
      User.Read	Didelegasikan	Login dan membaca profil pengguna	Ini adalah izin default yang tidak boleh dihapus. Jika dihapus, SharePoint akan menampilkan error yang meminta Anda untuk mengaktifkan kembali izin ini.
      Opsi 1: Sites.FullControl.All	Aplikasi	Kontrol penuh atas semua situs	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Fitur ini juga memungkinkan Gemini Enterprise mengindeks dokumen, acara, komentar, lampiran, dan file di semua situs SharePoint.
      Opsi 2: Sites.Selected	Aplikasi	Kontrol atas situs yang dipilih	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Gemini Enterprise juga dapat mengindeks dokumen, acara, komentar, lampiran, dan file di seluruh situs SharePoint yang dipilih. Izin ini memberikan kontrol yang lebih terperinci, bukan Sites.FullControl.All Catatan: Saat menggunakan Sites.Selected, Anda harus memberikan izin fullcontrol ke situs yang dipilih. Selain itu, agar izin ini berlaku, Anda harus melakukan setidaknya salah satu hal berikut saat membuat konektor SharePoint di Gemini Enterprise: Pada Langkah 5, gunakan URL situs tertentu sebagai URL instance konektor SharePoint Anda—misalnya, mydomain.sharepoint.com/sites/sample-site. Pada Langkah 6, berikan filter siteName yang tepat saat menyiapkan konektor Gemini Enterprise.
      User.Read.All	Aplikasi	Membaca profil lengkap semua pengguna	Izin ini memungkinkan Gemini Enterprise memahami kontrol akses data untuk konten SharePoint Anda.

   2. Tambahkan dan berikan izin SharePoint berikut untuk autentikasi OAuth 2.0. Anda dapat memilih antara AllSites.FullControl dan Sites.Selected:

      Izin Sharepoint untuk autentikasi OAuth 2.0

      Izin	Jenis	Deskripsi	Justifikasi
      Opsi 1: AllSites.FullControl	Didelegasikan	Kontrol penuh atas semua situs	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Fitur ini juga memungkinkan Gemini Enterprise mengindeks dokumen, acara, komentar, lampiran, dan file di semua situs SharePoint.
      Opsi 2: Sites.Selected	Didelegasikan	Kontrol atas situs yang dipilih	Izin ini memungkinkan Gemini Enterprise mendapatkan grup pengguna dan penetapan peran SharePoint, yang tidak disertakan dalam izin Sites.Read.All. Gemini Enterprise juga dapat mengindeks dokumen, acara, komentar, lampiran, dan file di seluruh situs SharePoint yang dipilih. Izin ini memberikan kontrol yang lebih terperinci, bukan AllSites.FullControl Catatan: Saat menggunakan Sites.Selected, Anda harus memberikan izin fullcontrol ke situs yang dipilih. Selain itu, agar izin ini berlaku, Anda harus melakukan setidaknya salah satu hal berikut saat membuat konektor SharePoint di Gemini Enterprise: Pada Langkah 5, gunakan URL situs tertentu sebagai URL instance konektor SharePoint Anda—misalnya, mydomain.sharepoint.com/sites/sample-site. Pada Langkah 6, berikan filter siteName yang tepat saat menyiapkan konektor Gemini Enterprise.

   3. Untuk izin yang ditambahkan, periksa apakah kolom Status mencantumkan izin sebagai Granted dan memiliki ikon centang hijau.

   4. Gunakan akun pengguna khusus dengan akses terbatas ke situs tertentu. Verifikasi bahwa akun ini memiliki akses Pemilik ke situs yang dipilih.

4. Berikan izin administrator. Untuk mengetahui informasi tentang cara memberikan izin, lihat Memberikan izin administrator di seluruh tenant ke aplikasi dalam dokumentasi Microsoft Entra.

Memberi izin fullcontrol ke situs yang dipilih

Jika Anda memilih opsi Sites.Selected untuk memberikan kontrol atas situs tertentu di Microsoft Graph, Anda harus memberikan izin fullcontrol ke aplikasi Gemini Enterprise. Anda dapat melakukannya menggunakan salah satu metode berikut:

• PowerShell
• Microsoft Graph

PowerShell

Untuk sintaksis umum dalam memberikan izin menggunakan PnP PowerShell, lihat Memberikan izin melalui PnP PowerShell.

1. Jalankan perintah berikut yang memberikan izin FullControl:

   Grant-PnPAzureADAppSitePermission -AppId CLIENT_ID -DisplayName DISPLAY_NAME -Permissions FullControl -Site SITE_URL
   

   Ganti kode berikut:

   • CLIENT_ID: ID klien aplikasi Microsoft Entra.
   • SITE_URL: URL situs untuk situs SharePoint Anda, misalnya, https://example.sharepoint.com/sites/ExampleSite1.
   • DISPLAY_NAME: deskripsi untuk aplikasi Microsoft Entra.

Microsoft Graph

Untuk mengetahui keseluruhan proses pemberian izin menggunakan Microsoft Graph, lihat Memberikan izin melalui Microsoft Graph.

Gunakan Microsoft Graph Explorer untuk memanggil metode berikut. Metode ini hanya dapat dipanggil oleh pemilik situs.

1. Dapatkan ID situs:

   GET `https://graph.microsoft.com/v1.0/sites/HOSTNAME:SITE_PATH`
   

   Ganti kode berikut:

   • HOSTNAME: nama host situs Sharepoint—misalnya, example.sharepoint.com.
   • SITE_PATH: jalur situs SharePoint—misalnya, /sites/ExampleSite1 atau /teams/ExampleSite2.

2. Beri fullcontrol akses ke situs yang ID-nya Anda ambil di langkah sebelumnya.

   • Kirim permintaan POST berikut:

        POST `https://graph.microsoft.com/v1.0/sites/SITE_ID/permissions`
     

   • Gunakan isi permintaan berikut:

     {
       "roles": ["fullcontrol"],
       "grantedToIdentities": [{
         "application": {
           "id": "CLIENT_ID",
           "displayName": "DISPLAY_NAME"
         }
       }]
     }
     

     Ganti kode berikut:

     • SITE_ID: ID situs untuk situs SharePoint Anda yang Anda terima pada langkah sebelumnya. Formatnya adalah example.sharepoint.com,48332b69-85ab-0000-00o0-dbb7132863e7,2d165439-0000-0000-b0fe-030b976868a0.
     • CLIENT_ID: ID klien aplikasi Microsoft Entra.
     • DISPLAY_NAME: deskripsi untuk aplikasi Microsoft Entra.

Pesan error

Tabel berikut menjelaskan pesan error umum dan deskripsinya yang mungkin Anda temui saat menghubungkan SharePoint dengan Gemini Enterprise.

Kode error	Pesan error
SHAREPOINT_MISSING_PERMISSION_1	Peran REST API yang diperlukan tidak ada (Sites.FullControl.All atau Sites.Selected). Untuk izin yang didelegasikan, AllSites.FullControl atau Sites.Selected tidak ada.
SHAREPOINT_MISSING_PERMISSION_2	Peran Graph API yang diperlukan tidak ada (Sites.FullControl.All atau Sites.Selected).
SHAREPOINT_MISSING_PERMISSION_3	Tidak memiliki peran Graph API yang diperlukan, GroupMember.Read.All.
SHAREPOINT_MISSING_PERMISSION_4	Peran Graph API yang diperlukan tidak ada (User.Read.All atau User.ReadBasic.All).
SHAREPOINT_INVALID_SITE_URI	Gagal mengambil token akses Graph API. Kemungkinan penyebab: ID klien, nilai rahasia, atau kredensial gabungan tidak valid.
SHAREPOINT_INVALID_AUTH	Gagal mengambil token akses Graph API. Kemungkinan penyebab: ID klien, nilai rahasia, atau kredensial gabungan tidak valid.
SHAREPOINT_INVALID_JSON	Gagal mengurai konten JSON.
SHAREPOINT_TOO_MANY_REQUESTS	Terlalu banyak permintaan HTTP yang dikirim ke SharePoint; menerima respons HTTP 429.

Membuat konektor SharePoint Online

Setelah mendaftarkan aplikasi di Entra, Anda dapat membuat konektor SharePoint di konsol Google Cloud .

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari SharePoint ke Gemini Enterprise, ikuti langkah-langkah berikut. Langkah-langkah ini menunjukkan metode kredensial gabungan, yang merupakan metode yang direkomendasikan:

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Di menu navigasi, klik Data Stores.

3. Klik Create Data Store.

4. Di halaman Pilih sumber data, scroll atau telusuri SharePoint untuk menghubungkan sumber pihak ketiga Anda.

   

   Telusuri dan pilih SharePoint sebagai sumber data

5. Masukkan informasi autentikasi SharePoint Online Anda.

   

   Tambahkan informasi autentikasi

   • Masukkan URI situs SharePoint sebagai URI Instance.

     • Untuk semua situs tingkat pertama: https://DOMAIN_OR_SERVER.sharepoint.com
     • Untuk satu situs: https://DOMAIN_OR_SERVER.sharepoint.com/[sites/]WEBSITE

     Jika Anda diberi izin Sites.Selected saat menyiapkan kredensial gabungan di Entra, Anda harus menentukan situs persis yang ingin diindeks atau menentukan filter di Langkah 7 untuk menyertakan situs persis tersebut.

6. Pilih entitas yang akan disinkronkan:

   • Lampiran

   • Komentar

   • Acara

   • Halaman

   • File

   

   Pilih entitas yang akan disinkronkan dan frekuensi sinkronisasi

7. Untuk hanya menyertakan entitas situs tertentu dalam indeks, klik Filter.

   

   Tentukan filter untuk menyertakan entitas situs

   Catatan: Opsi Kecualikan dari indeks tidak tersedia.

8. Klik Simpan.

9. Klik Lanjutkan.

10. Pilih region untuk penyimpanan data Anda.

11. Masukkan nama untuk penyimpanan data Anda.

12. Pilih frekuensi sinkronisasi untuk penyimpanan data Anda. Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

    • Frekuensi sinkronisasi data berkisar dari tiga jam hingga tujuh hari
    • Frekuensi sinkronisasi identitas berkisar dari 30 menit hingga tujuh hari

13. Klik Buat. Gemini Enterprise membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.

14. Untuk memeriksa status penyerapan, buka halaman Data Stores dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    

    Status konektor di halaman detail penyimpanan data

    Bergantung pada ukuran data Anda, penyerapan dapat memerlukan waktu beberapa menit atau jam.

Mengaktifkan sinkronisasi real-time

Pratinjau: Anda harus berada dalam daftar yang diizinkan untuk menggunakan sinkronisasi real-time.

Sinkronisasi real-time hanya menyinkronkan entitas dokumen dan tidak menyinkronkan data yang terkait dengan entitas identitas. Tabel berikut menunjukkan peristiwa dokumen yang didukung dengan sinkronisasi real-time.

Entitas SharePoint	Buat	Perbarui	Hapus	Perubahan izin
Lampiran
Komentar
Acara
File
Halaman

Untuk mengaktifkan sinkronisasi real-time untuk penyimpanan data Anda, ikuti langkah-langkah berikut.

1. Di konsol Google Cloud , buka halaman Gemini Enterprise.

   Gemini Enterprise

2. Di menu navigasi, klik Data Stores.

3. Klik nama penyimpanan data SharePoint yang ingin Anda aktifkan sinkronisasi real-time-nya.

4. Di halaman Data penyimpanan data, tunggu hingga Status konektor berubah menjadi Aktif.

5. Di kolom Sinkronisasi real-time, klik Lihat/edit.

   

   Melihat dan mengedit setelan sinkronisasi real-time.

6. Klik tombol Aktifkan sinkronisasi real-time ke posisi aktif.

7. Berikan nilai untuk Client secret. Nilai ini digunakan untuk memverifikasi peristiwa webhook SharePoint. Sebaiknya gunakan string 20 karakter.

   

   Aktifkan sinkronisasi real-time dan berikan rahasia klien.

8. Klik Simpan.

   Tunggu hingga kolom Sinkronisasi real-time berubah menjadi Berjalan.

Menguji mesin telusur

Setelah mengonfigurasi mesin telusur, uji kemampuannya. Pastikan bahwa API tersebut menampilkan hasil yang akurat berdasarkan akses pengguna.

1. Aktifkan aplikasi web:

   1. Buka konfigurasi integrasi aplikasi dan alihkan tombol ke Aktifkan aplikasi web.

2. Menguji aplikasi web:

   1. Klik Open di samping link aplikasi web dan login dengan pengguna di kumpulan tenaga kerja Anda.

   2. Pastikan hasil penelusuran dibatasi pada item yang dapat diakses oleh pengguna yang login.

Catatan: Jika Anda mengalami masalah saat login dengan ID Microsoft, pastikan pengguna ditambahkan ke pengguna aplikasi Enterprise di Microsoft Entra.

Mengonfigurasi workforce pool

Kumpulan tenaga kerja memungkinkan Anda mengelola dan mengautentikasi pengguna dari penyedia identitas eksternal, seperti Azure atau Okta, dalam Google Cloud konsol. Untuk mengonfigurasi kumpulan tenaga kerja dan mengaktifkan aplikasi web untuk akses pengguna yang lancar, lakukan hal berikut:

1. Buat workforce pool di tingkat organisasi di Google Cloud dengan mengikuti panduan penyiapan yang sesuai:

   1. Penyiapan OIDC Azure
   2. Penyiapan SAML Azure
   3. Penyiapan Okta & OIDC
   4. Penyiapan Okta & SAML

2. Konfigurasi kumpulan tenaga kerja di Gemini Enterprise > Setelan untuk region tempat Anda membuat aplikasi.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di bagian Membuat aplikasi.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan penyimpanan data Anda disiapkan, lihat Melihat pratinjau hasil penelusuran.