Halaman ini menjelaskan cara menyiapkan dan mengonfigurasi aplikasi pihak ketiga sebelum membuat penyimpanan data Microsoft 365.
Menyiapkan autentikasi dan izin
Konektor Microsoft 365 login sebagai pengguna akhir menggunakan alur kode otorisasi OAuth 2.0 terhadap platform identitas Microsoft. Semua izin Microsoft Graph didelegasikan, sehingga konektor hanya dapat menjangkau data yang sudah dapat dijangkau oleh pengguna yang login. Anda dapat mengonfigurasi autentikasi dengan salah satu dari dua cara berikut:
- OAuth yang dikelolaGoogle (OAuth 2.0 (Dikelola Google), default): Konektor menggunakan aplikasi Microsoft Entra multitenant yang Google daftarkan dan kelola. Anda tidak perlu mendaftarkan aplikasi atau memasukkan tenant ID, client ID, atau rahasia klien. Lihat OAuth yang dikelola Google.
- Bawa aplikasi Anda sendiri (OAuth 2.0 (Bawa Aplikasi Anda Sendiri)): Anda mendaftarkan aplikasi Microsoft Entra Anda sendiri, memberinya izin Microsoft Graph untuk tindakan yang ingin Anda aktifkan, dan memasukkan ID tenant, client ID, dan rahasia kliennya di Gemini Enterprise. Pilih opsi ini jika organisasi Anda perlu mengontrol aplikasi dan izinnya secara langsung, jika Anda memerlukan egress IP statis, atau jika tenant Anda berada di cloud Pemerintah AS. Lihat Mendaftarkan aplikasi Microsoft Entra.
Menggunakan OAuth yang dikelola Google
Dengan OAuth 2.0 (Google Managed), Anda tidak perlu membuat apa pun di Microsoft Entra sebelum membuat penyimpanan data. Saat pengguna mengizinkan konektor, Microsoft akan meminta mereka untuk menyetujui izin Microsoft Graph yang diperlukan oleh tindakan yang diaktifkan. Untuk mengetahui daftar lengkapnya, lihat Mengonfigurasi izin Microsoft API.
Beberapa izin ini, dan beberapa kebijakan izin tenant, memerlukan administrator Microsoft Entra untuk memberikan izin atas nama organisasi. Jika pengguna melihat pesan Need admin approval saat mengizinkan konektor, administrator harus memberikan izin di seluruh tenant ke aplikasi yang dikelola Google. Untuk mengetahui informasi selengkapnya, lihat Memberikan izin admin di seluruh tenant ke aplikasi dalam dokumentasi Microsoft.
Perhatikan hal-hal berikut saat Anda menggunakan OAuth yang dikelola Google:
- Aplikasi yang dikelola Googleterdaftar di cloud Microsoft komersial, jadi biarkan Microsoft 365 Environment Type ditetapkan ke Standard. Untuk tenant di GCC High atau DoD, gunakan OAuth 2.0 (Bring Your Own App).
- Egress IP statis tidak tersedia, karena aplikasi bersama tidak dapat membawa daftar IP yang diizinkan per pelanggan.
Bagian selanjutnya hanya berlaku untuk OAuth 2.0 (Bring Your Own App).
Mendaftarkan aplikasi Microsoft Entra untuk konektor Microsoft 365
Untuk mendaftarkan Gemini Enterprise sebagai aplikasi OAuth 2.0 di Microsoft Entra, lakukan hal berikut:
Di menu navigasi, luaskan Entra ID, lalu pilih App registrations.
Di halaman App registrations, klik New registration.
Di halaman Register an application, lakukan hal berikut:
- Di kolom Name, masukkan nama untuk aplikasi Anda.
- Di bagian Jenis akun yang didukung, pilih Akun di direktori organisasi ini saja.
- Di bagian Redirect URI, lakukan tindakan berikut:
- Dalam daftar platform, pilih Web.
- Di kolom URI pengalihan, masukkan
https://vertexaisearch.cloud.google.com/oauth-redirect.
- Klik Daftar. Microsoft Entra akan membuat aplikasi Anda dan menampilkan halaman ringkasan aplikasi Anda.
Mendapatkan client ID dan rahasia klien
Untuk mendapatkan client ID, lakukan hal berikut:
- Di menu navigasi aplikasi, pilih Ringkasan.
- Salin Application (client) ID.
Untuk mendapatkan rahasia klien aplikasi, lakukan hal berikut:
- Di menu navigasi aplikasi, pilih Certificates & secrets.
- Klik rahasia klien baru.
- Di panel rahasia klien, lakukan hal berikut:
- Di kolom Description, masukkan deskripsi untuk secret.
- Dalam daftar Expires, pilih durasi masa berlaku.
- Klik Tambahkan.
- Salin rahasia klien dari kolom Value.
Mendapatkan ID tenant
ID tenant Anda dapat ditemukan di kotak Tenant ID di halaman ringkasan di pusat admin Microsoft Entra.
Mengonfigurasi izin Microsoft API
Jika Anda menggunakan OAuth 2.0 (Bawa Aplikasi Anda Sendiri), berikan izin Microsoft Graph yang didelegasikan ke aplikasi Anda untuk tindakan yang ingin Anda aktifkan. Jika Anda menggunakan OAuth 2.0 (Dikelola Google), Anda tidak perlu menambahkan izin ini sendiri; pengguna akan diminta untuk menyetujuinya saat mereka mengizinkan konektor.
Izin yang diperlukan setiap tindakan tercantum di kolom Izin yang diperlukan pada tabel tindakan yang didukung. Setiap koneksi juga memerlukan User.Read dan offline_access.
Untuk mengonfigurasi izin API yang diperlukan di aplikasi Anda sendiri, lakukan hal berikut:
Di halaman aplikasi, pilih API permissions.
Klik Add a permission.
Di halaman Request API permissions, pilih Microsoft Graph, lalu pilih Delegated permissions.
Telusuri dan pilih
User.Read,offline_access, dan izin yang tercantum untuk setiap tindakan yang ingin Anda aktifkan.Klik Add permissions.
Cloud pemerintah dan berdaulat
Jika tenant Anda tidak berada di cloud Microsoft standar, tetapkan kedua hal berikut saat Anda membuat penyimpanan data. Login melalui Pemerintah AS memerlukan OAuth 2.0 (Bawa Aplikasi Anda Sendiri), dengan aplikasi yang terdaftar di cloud tersebut.
Microsoft 365 Environment Type, di bagian Authentication settings, memilih endpoint login: Standard menggunakan
login.microsoftonline.comdan US Government menggunakanlogin.microsoftonline.us.Microsoft 365 Cloud Environment, di bagian Advanced options, memilih endpoint Microsoft Graph: Standard / GCC menggunakan
https://graph.microsoft.com, GCC High menggunakanhttps://graph.microsoft.us, dan DoD menggunakanhttps://dod-graph.microsoft.us.
Pemecahan masalah
Bagian ini menjelaskan error yang mungkin Anda lihat setelah mengonfigurasi aplikasi Microsoft Entra, dan cara mengatasinya.
Tindakan gagal dengan HTTP 403
Tindakan yang menampilkan HTTP 403 biasanya tidak memiliki izin. Pastikan izin yang diperlukan tindakan telah disetujui, izin admin telah diberikan jika diperlukan, dan koneksi telah diotorisasi ulang setelah tindakan diaktifkan. Dengan OAuth 2.0 (Bawa Aplikasi Anda Sendiri), pastikan juga bahwa pendaftaran aplikasi Microsoft Entra Anda memberikan izin. Token refresh yang ada hanya membawa cakupan yang disetujui saat token tersebut dikeluarkan.
Penelusuran email menampilkan MailboxNotEnabledForRESTAPI
Error ini berarti kotak surat tidak dapat dijangkau melalui Microsoft Graph. Hal ini terjadi saat kotak surat dihosting secara lokal dalam deployment Exchange hybrid, saat kotak surat tidak aktif atau dihapus sementara, atau saat ada ketidakcocokan tenant atau direktori. Untuk mengatasinya, pastikan kotak surat dihosting di Exchange Online. Untuk mengetahui informasi selengkapnya, lihat Cara memperbaiki MailboxNotEnabledForRESTAPI di dokumentasi Microsoft.