Konfigurasi Microsoft SharePoint

Agar berhasil menghubungkan Gemini Enterprise dengan Microsoft SharePoint, Anda harus menyelesaikan langkah-langkah konfigurasi berikut.

Menyiapkan autentikasi dan izin

Anda perlu menyiapkan autentikasi dan izin di pusat admin Microsoft Entra. Hal ini sangat penting agar konektor dapat mengakses dan menyinkronkan data.

Mendaftarkan aplikasi Microsoft Entra untuk konektor Microsoft SharePoint

Sebelum membuat konektor Microsoft SharePoint di Gemini Enterprise, daftarkan aplikasi Microsoft Entra untuk mengaktifkan akses yang aman.

Untuk mendaftarkan Gemini Enterprise sebagai aplikasi OAuth 2.0 di Entra, lakukan hal berikut:

  1. Buka Microsoft Entra admin center.
  2. Di menu navigasi, luaskan Entra ID, lalu pilih Pendaftaran aplikasi.
  3. Di halaman App registrations, klik New registration.

  4. Di halaman Register an application, lakukan hal berikut:

    1. Di kolom Name, masukkan nama untuk aplikasi Anda.
    2. Di bagian Supported account types, pilih Accounts in this organizational directory only (yang juga dapat diberi label Single tenant only atau Single tenant only - MSFT bergantung pada penyiapan tenant Anda). Tindakan ini membatasi akses ke pengguna dan tamu dalam tenant atau direktori Anda sendiri.
    3. Di bagian Redirect URI, lakukan tindakan berikut:
      1. Di daftar platform, pilih Web.
      2. Di kolom URI pengalihan, masukkan https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.
    4. Klik Daftar. Microsoft Entra akan membuat aplikasi Anda dan menampilkan halaman ringkasan aplikasi Anda.

  5. Di menu navigasi aplikasi, klik Authentication.

  6. Klik Add redirect URI.

  7. Di panel pemilihan platform, lakukan tindakan berikut:

    1. Pilih Web.
    2. Di kolom Redirect URI, masukkan https://vertexaisearch.cloud.google.com/oauth-redirect.
    3. Klik Configure.

Menambahkan kredensial gabungan untuk penyerapan data

Jika Anda menggunakan Penyerapan data sebagai mode koneksi dan Kredensial gabungan sebagai metode autentikasi, lakukan hal berikut:

  1. Di menu navigasi aplikasi, klik Certificates & secrets.
  2. Pilih tab Federated credentials.
  3. Klik Add credential.
  4. Pilih Other issuer dari daftar Federated credential scenario.
  5. Di kolom Issuer, masukkan https://accounts.google.com.
  6. Di kolom Subject identifier, masukkan nilai yang Anda dapatkan dari konsol Google Cloud . Nilai ini dibuat selama pembuatan penyimpanan data Microsoft SharePoint di bagian data.
  7. Di kolom Name, masukkan label unik untuk kredensial gabungan.
  8. Klik Add untuk memberikan akses.

Membuat konfigurasi OAuth 2.0

Untuk membuat koneksi menggunakan metode autentikasi OAuth 2.0, Anda harus mendapatkan client ID, rahasia klien, dan Tenant ID dari halaman pendaftaran aplikasi Microsoft Entra Anda.

Mendapatkan client ID dan rahasia klien

  1. Untuk mendapatkan client ID, lakukan hal berikut:

    1. Di menu navigasi aplikasi, pilih Ringkasan.
    2. Salin Application (client) ID.

  2. Untuk mendapatkan rahasia klien aplikasi, lakukan hal berikut:

    1. Di menu navigasi aplikasi, pilih Certificates & secrets.
    2. Klik rahasia klien baru.
    3. Di panel rahasia klien, lakukan hal berikut:
      1. Di kolom Deskripsi, masukkan deskripsi untuk secret.
      2. Dalam daftar Berakhir, pilih durasi masa berlaku.
      3. Klik Tambahkan.
    4. Salin rahasia klien dari kolom Nilai.

Mendapatkan URI Instance

URI Instance memiliki salah satu format 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.

Mendapatkan ID Tenant

ID tenant Anda dapat ditemukan di kotak Tenant ID di halaman ringkasan di pusat admin Microsoft Entra.

Mengonfigurasi izin Microsoft API

Untuk mengonfigurasi izin API yang diperlukan untuk aplikasi, lakukan hal berikut:

  1. Buka halaman aplikasi.

  2. Di menu navigasi aplikasi, pilih API permissions.

  3. Klik Add permissions.

  4. Di panel Request API permissions, pilih Microsoft Graph.

  5. Telusuri dan pilih izin berikut berdasarkan mode koneksi Anda:

    Untuk mode koneksi Federated search, izin Graph API tidak diperlukan.

    Untuk mode koneksi Penyerapan data dengan Kredensial gabungan:

    Izin Jenis Deskripsi
    GroupMember.Read.All Aplikasi Mengizinkan konektor membaca keanggotaan dan properti grup dasar untuk semua grup tanpa pengguna yang login.
    User.Read Didelegasikan Mengizinkan konektor membaca profil pengguna yang login. Konektor ini juga memungkinkan pembacaan informasi dasar perusahaan pengguna yang login.
    Opsi kontrol situs
    Opsi 1: Sites.FullControl.All Aplikasi Memungkinkan konektor memiliki kontrol penuh atas semua kumpulan situs.
    Opsi 2: Sites.Selected Aplikasi Mengizinkan konektor mengakses subset kumpulan situs. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.
    Opsi pembacaan profil
    Opsi 1: User.Read.All Aplikasi Mengizinkan konektor membaca profil pengguna.
    Opsi 2: User.ReadBasic.All Aplikasi Memungkinkan konektor membaca kumpulan properti profil dasar pengguna lain di organisasi.

    Untuk mode koneksi Penyerapan data dengan Token refresh OAuth 2.0:

    Izin Jenis Deskripsi
    GroupMember.Read.All Aplikasi Mengizinkan konektor membaca keanggotaan dan properti grup dasar untuk semua grup tanpa pengguna yang login.
    User.Read Didelegasikan Mengizinkan konektor membaca profil pengguna yang login. Konektor ini juga memungkinkan pembacaan informasi dasar perusahaan pengguna yang login.
    User.Read.All Aplikasi Mengizinkan konektor membaca profil pengguna.
    Opsi kontrol situs
    Opsi 1: Sites.FullControl.All Aplikasi Memungkinkan konektor memiliki kontrol penuh atas semua kumpulan situs.
    Opsi 2: Sites.Selected Aplikasi Mengizinkan konektor mengakses subset kumpulan situs. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.

    Jika Anda mengaktifkan Tindakan untuk mode koneksi Penelusuran gabungan atau Penyerapan data, pilih juga izin berikut:

    Izin Jenis Deskripsi
    Sites.ReadWrite.All Didelegasikan Mengizinkan konektor mengedit atau menghapus dokumen dan item daftar di semua kumpulan situs atas nama pengguna yang login.
    Files.ReadWrite Didelegasikan Mengizinkan konektor membaca (mendownload), membuat (mengupload), memperbarui, dan menghapus file pengguna yang login.
    Files.ReadWrite.All Didelegasikan Mengizinkan konektor membaca (mendownload), membuat (mengupload), memperbarui, dan menghapus semua file yang dapat diakses oleh pengguna yang login.
    Sites.Manage.All Didelegasikan Memungkinkan konektor membuat atau menghapus daftar dan koleksi dokumen di semua kumpulan situs atas nama pengguna.

  6. Klik Add Permissions.

  7. Di panel Request API permissions, pilih Microsoft SharePoint.

  8. Telusuri dan pilih izin berikut berdasarkan mode koneksi Anda:

    Untuk mode koneksi Penelusuran gabungan:

    Izin Jenis Deskripsi
    Sites.Search.All Didelegasikan Memungkinkan konektor menjalankan kueri penelusuran dan membaca info situs dasar atas nama pengguna yang saat ini login. Hasil penelusuran didasarkan pada izin pengguna, bukan izin aplikasi.
    AllSites.Read Didelegasikan Mengizinkan konektor membaca dokumen dan item daftar di semua kumpulan situs atas nama pengguna yang login.

    Untuk mode koneksi Penyerapan data dengan Kredensial gabungan:

    Izin Jenis Deskripsi
    Opsi kontrol situs
    Opsi 1: Sites.FullControl.All Aplikasi Memungkinkan konektor memiliki kontrol penuh atas semua kumpulan situs.
    Opsi 2: Sites.Selected Aplikasi Mengizinkan konektor mengakses sebagian kumpulan situs dengan pengguna yang login. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.

    Untuk mode koneksi Penyerapan data dengan Token refresh OAuth 2.0:

    Izin Jenis Deskripsi
    Opsi kontrol situs
    Opsi 1: AllSites.FullControl Didelegasikan Mengizinkan konektor memiliki kontrol penuh atas semua kumpulan situs atas nama pengguna yang login.
    Opsi 2: Sites.Selected Didelegasikan Mengizinkan konektor mengakses subset koleksi situs dengan pengguna yang login. Koleksi situs tertentu dan izin yang diberikan dapat dikonfigurasi di SharePoint Online.

    Jika Anda mengaktifkan Tindakan untuk mode koneksi Penelusuran gabungan atau Penyerapan data, pilih juga izin berikut:

    Izin Jenis Deskripsi
    AllSites.Write Didelegasikan Memungkinkan konektor membuat, membaca, memperbarui, menghapus, mengupload, dan mendownload dokumen serta item daftar di semua kumpulan situs atas nama pengguna yang login.

  9. Klik Add Permissions.

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

Memberi fullcontrol izin ke situs yang dipilih

Jika Anda memilih opsi Sites.Selected untuk memberikan kontrol atas situs yang dipilih 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 guna memberikan izin menggunakan PnP PowerShell, lihat Memberikan izin menggunakan PnP PowerShell.

  1. Untuk memberikan izin FullControl, jalankan perintah berikut di PowerShell :

    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: nama tampilan untuk aplikasi Microsoft Entra.

Microsoft Graph

Untuk mengetahui proses keseluruhan dalam memberikan izin menggunakan Microsoft Graph, lihat Memberikan izin menggunakan 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 di langkah sebelumnya. Formatnya adalah example.sharepoint.com,48332b69-85ab-0000-0000-dbb7132863e7,2d165439-0000-0000-b0fe-030b976868a0.
      • CLIENT_ID: client ID aplikasi Microsoft Entra.
      • DISPLAY_NAME: nama tampilan untuk aplikasi Microsoft Entra.

Pemecahan masalah

Bagian ini menjelaskan cara menyelesaikan masalah umum terkait konektor Microsoft SharePoint.

Pengguna melihat "Perlu persetujuan admin" saat mereka terhubung

Saat pengguna terhubung ke Microsoft SharePoint dari aplikasi web Gemini Enterprise untuk pertama kalinya, Microsoft mungkin menampilkan layar Need admin approval. Hal ini terjadi jika Gemini Enterprise meminta izin tingkat administrator, atau jika tenant Microsoft Entra Anda melarang pengguna mengizinkan aplikasi pihak ketiga tanpa izin administrator di seluruh tenant sebelumnya.

Untuk mengatasi masalah ini, administrator harus menyelesaikan otorisasi pertama. Setelah itu, pengguna lain di tenant Anda dapat terhubung tanpa layar persetujuan.

  1. Minta administrator Microsoft Entra ID yang dapat memberikan izin di seluruh tenant untuk login ke aplikasi web Gemini Enterprise dan terhubung ke Microsoft SharePoint.

  2. Di layar izin, minta administrator memilih Consent on behalf of your organization, lalu klik Accept.

  3. Minta pengguna untuk menghubungkan kembali.

Untuk mengetahui informasi selengkapnya, lihat bagian Memberikan persetujuan admin di seluruh tenant dalam dokumentasi Microsoft Entra.