Halaman ini menjelaskan cara administrator Salesforce mengaktifkan server MCP yang dipanggil oleh konektor Salesforce, dan mengonfigurasi autentikasi OAuth 2.0 di Salesforce. Keduanya adalah prasyarat untuk menghubungkan Salesforce ke Gemini Enterprise.
Memilih metode autentikasi
Karena alur OAuth 2.0 berjalan terhadap endpoint My Domain organisasi Anda, bukan host login Salesforce bersama, organisasi Salesforce Anda harus memercayai aplikasi klien OAuth sebelum pengguna dapat mengizinkan konektor. Anda dapat mengonfigurasi autentikasi dengan salah satu dari dua cara berikut:
- OAuth yang dikelolaGoogle (OAuth 2.0 (Google Managed), default): Google memublikasikan paket terkelola Gemini Enterprise - Salesforce Connector di Salesforce AppExchange. Saat menginstal paket di organisasi Salesforce, Anda tidak membuat aplikasi Salesforce sendiri atau memasukkan client ID atau rahasia klien ke Gemini Enterprise. Lihat Menginstal paket terkelola Google.
- Bring your own app (OAuth 2.0 (Bring Your Own App)): Jika organisasi Anda tidak dapat menginstal paket AppExchange atau ingin mengelola aplikasi OAuth dan kebijakan keamanannya sendiri secara langsung, Anda dapat membuat aplikasi klien eksternal sendiri di Salesforce dan memasukkan client ID (kunci pengguna) dan rahasia klien (rahasia pengguna) di Gemini Enterprise. Lihat Membuat aplikasi OAuth Anda sendiri.
Sebelum memulai
Sebelum mengonfigurasi Salesforce, pastikan hal berikut:
Anda login ke Salesforce sebagai administrator:
- Untuk menginstal paket terkelola Google, profil pengguna Anda harus menyertakan izin Download AppExchange Packages (disertakan dalam profil administrator sistem).
- Untuk menggunakan aplikasi Anda sendiri, profil pengguna Anda harus memiliki izin untuk membuat dan mengelola aplikasi klien eksternal di Setup Salesforce.
Anda tahu organisasi mana yang Anda hubungkan. Selesaikan penyiapan di organisasi yang sama dengan URL Domain Saya yang ingin Anda masukkan sebagai URI Instance saat membuat penyimpanan data.
Organisasi Anda telah mengaktifkan dan men-deploy My Domain. Konektor memberikan otorisasi terhadap host Domain Saya, misalnya
https://example.my.salesforce.com.Organisasi Anda menggunakan edisi Salesforce yang didukung. Konektor ini mendukung edisi Professional, Enterprise, Unlimited, dan Developer.
Server MCP SObject All aktif di organisasi Anda. Server tidak aktif secara default. Lihat Mengaktifkan server MCP di organisasi Anda.
Setiap pengguna Salesforce yang memberikan otorisasi dan menggunakan konektor memiliki izin sistem API Enabled di profil yang ditetapkan atau set izin yang ditetapkan (di Setup, buka Users > Profiles atau Users > Permission Sets, lalu pilih System Permissions > API Enabled). Profil Administrator Sistem dan Pengguna Standar standar menyertakan izin ini secara default, tetapi profil kustom sering kali menonaktifkannya.
Mengaktifkan server MCP di organisasi Anda
Konektor memanggil server MCP SObject All yang dihosting Salesforce, yang mengekspos operasi buat, baca, update, dan hapus di balik tindakan konektor. Konektor hanya terhubung ke endpoint server MCP SObject All; server MCP terpisah per operasi tidak didukung. Mengaktifkannya diperlukan untuk OAuth 2.0 (Dikelola Google) dan OAuth 2.0 (Bawa Aplikasi Anda Sendiri).
Karena server tidak aktif secara default, administrator harus mengaktifkannya di organisasi Anda.
Untuk mengaktifkannya, ikuti langkah-langkah berikut:
Di Salesforce, buka Setup.
Buka Integrations > API Catalog > MCP Servers.
Di tab Salesforce Servers, temukan SObject All, yang dijelaskan sebagai Membuat, membaca, memperbarui, dan menghapus data Salesforce.
Tetapkan Server Status ke Active.
Mengaktifkan server MCP SObject All akan mengaktifkan server untuk organisasi Anda tanpa memerlukan izin pengguna server MCP terpisah, dan tidak memberikan izin kepada pengguna untuk membuat, memperbarui, atau menghapus data dengan sendirinya. Akses tulis dan hapus dikontrol di dua lapisan:
- Di Gemini Enterprise: Tindakan hanya baca diaktifkan secara default, dan tindakan yang membuat, memperbarui, atau menghapus data dinonaktifkan secara default. Saat menyiapkan atau mengelola penyimpanan data, administrator Google Cloud memilih tindakan buat, perbarui, atau hapus yang akan diaktifkan—atau membiarkan semuanya dinonaktifkan sehingga konektor bersifat hanya baca. Lihat Mengaktifkan tindakan.
- Di Salesforce: Setiap tindakan berjalan sebagai panggilan API di akun Salesforce milik pengguna yang memberikan otorisasi. Pengguna harus memiliki izin sistem API Enabled di profilnya atau set izin yang ditetapkan, dan konektor akan mematuhi izin tingkat objek, keamanan tingkat kolom, dan aturan berbagi pengguna tersebut.
Menginstal paket terkelola Google
Jika Anda berencana menggunakan OAuth 2.0 (Google Managed), instal paket terkelola Gemini Enterprise dari Salesforce AppExchange:
Login ke organisasi Salesforce Anda sebagai administrator.
Buka listingan Gemini Enterprise - Salesforce Connector di Salesforce AppExchange.
Klik Dapatkan Sekarang.
Pilih lingkungan yang akan diinstal:
- Install in Production untuk organisasi produksi Anda.
- Install in Sandbox untuk organisasi sandbox.
Pilih pengguna yang akan mendapatkan akses ke aplikasi:
- Install for Admins Only: hanya pengguna dengan profil System Administrator yang dapat menggunakan aplikasi.
- Install for Specific Profiles: hanya pengguna dengan profil yang Anda pilih yang dapat menggunakan aplikasi.
- Install for All Users (direkomendasikan): setiap pengguna di organisasi dapat menggunakan aplikasi tanpa konfigurasi profil tambahan.
Paket terkelola sudah menyertakan cakupan OAuth yang diperlukan (
mcp_apidanrefresh_token). Setiap pengguna yang login untuk mengizinkan konektor di Gemini Enterprise harus memiliki akses ke aplikasi berdasarkan opsi yang Anda pilih, dan juga harus memiliki izin sistem API Enabled di profil Salesforce atau set izin yang ditetapkan. Pengguna yang profilnya tidak memiliki akses ke aplikasi tidak dapat menyelesaikan langkah login, dan pengguna tanpa API Diaktifkan tidak dapat menjalankan kueri atau tindakan.Setujui akses pihak ketiga jika Salesforce meminta Anda melakukannya, lalu klik Install atau Upgrade.
Tunggu hingga penginstalan selesai. Untuk organisasi besar, Salesforce mungkin menyelesaikan penginstalan secara asinkron dan mengirim email kepada Anda setelah selesai.
Setelah penginstalan, aplikasi akan muncul di Setup Salesforce sebagai Gemini Enterprise. Selanjutnya, tetapkan kebijakan IP login untuk aplikasi.
Membuat aplikasi OAuth Anda sendiri
Jika Anda berencana menggunakan OAuth 2.0 (Bring Your Own App), buat dan konfigurasi aplikasi klien eksternal di Salesforce untuk mendapatkan kunci konsumen (Client ID) dan rahasia konsumen (Client Secret):
Login ke organisasi Salesforce Anda sebagai administrator, lalu buka Setup.
Di kolom Quick Find, masukkan
External Client App Managerdan pilih External Client App Manager.Klik New External Client App, dan di bagian Basic Information, masukkan informasi yang diperlukan (External Client App Name, API Name, dan Contact Email).
Di bagian API (Enable OAuth Settings), pilih Enable OAuth dan konfigurasi setelan berikut:
Di bagian App Settings, untuk Callback URL, masukkan:
https://vertexaisearch.cloud.google.com/oauth-redirectUntuk Cakupan OAuth, tambahkan kedua cakupan berikut:
- Mengakses server MCP Platform API Salesforce (mcp_api)
- Menjalankan permintaan kapan saja (refresh_token, offline_access)
Peran ini memberikan cakupan
mcp_apidanrefresh_tokenyang diperlukan oleh konektor.Di bagian Security, pastikan opsi berikut dipilih:
- Memerlukan ekstensi Proof Key for Code Exchange (PKCE) untuk Alur Otorisasi yang Didukung
- Mengeluarkan token akses berbasis Token Web JSON (JWT) untuk pengguna yang disebutkan namanya
Klik Create.
Konfigurasikan kebijakan OAuth aplikasi:
Di Setup, buka Apps > External Client App Manager, klik aplikasi klien eksternal Anda, pilih tab Policies, lalu klik Edit.
Untuk Permitted Users, pilih All users may self-authorize (direkomendasikan), atau pilih Admin approved users are pre-authorized dan tetapkan profil atau set izin untuk semua pengguna yang mengizinkan konektor (termasuk administrator yang memverifikasi autentikasi selama pembuatan penyimpanan data). Pastikan setiap pengguna yang memberikan otorisasi ke konektor juga memiliki izin sistem API Enabled di profil mereka atau set izin yang ditetapkan.
Untuk IP Relaxation, pilih Relax IP restrictions. Untuk mengetahui detail tentang alasan setelan ini diperlukan, lihat Menetapkan kebijakan IP login untuk aplikasi.
Klik Simpan.
Salin kredensial OAuth aplikasi:
- Pilih tab Settings, luaskan OAuth Settings, lalu klik Kunci Pengguna dan Secret.
- Salin dan simpan Consumer Key dan Consumer Secret. Anda memasukkan nilai ini sebagai Client ID dan Client Secret saat membuat penyimpanan data di Gemini Enterprise.
Menetapkan kebijakan IP login untuk aplikasi
Alamat IP statis per penyimpanan data tidak didukung untuk konektor Salesforce. Sebagai gantinya, aplikasi klien eksternal di Salesforce mengatur validasi IP login:
- Panggilan autentikasi (pertukaran dan pembaruan token OAuth): Saat pengguna mengizinkan konektor, Gemini Enterprise akan menukar dan memperbarui token Salesforce pengguna tersebut dari server Google. Permintaan tersebut tidak berasal dari alamat IP organisasi Anda. Jika aplikasi menerapkan pembatasan IP dan profil pengguna Anda memiliki rentang IP login, permintaan akan ditolak dan langkah Verifikasi Autentikasi atau Otorisasi akan gagal. Tetapkan kebijakan Pelonggaran IP aplikasi ke Longgarkan pembatasan IP. Untuk aplikasi Gemini Enterprise yang dikelolaGoogle, Google sudah membatasi permintaan token ke rentang IP egress milik Google, dan pemeriksaan tersebut berlaku terlepas dari setelan kebijakan.
- Panggilan data: Hanya permintaan login dan token yang diperiksa terhadap batasan IP. Setelah pengguna mengizinkan konektor, Salesforce akan menyajikan permintaan data konektor berdasarkan token akses pengguna yang valid.
Untuk menetapkan kebijakan bagi aplikasi yang dikelola Google(atau aplikasi klien eksternal Anda sendiri):
Di Salesforce, buka Setup.
Buka Apps > External Client App Manager, lalu klik Gemini Enterprise (atau nama aplikasi klien eksternal kustom Anda).
Pilih tab Policies, lalu klik Edit.
Di bagian OAuth Policies, tetapkan IP Relaxation ke Relax IP restrictions.
Klik Simpan.
Menghubungkan organisasi sandbox
Sandbox adalah organisasi Salesforce terpisah dengan host Domain Saya serta paket dan aplikasi terinstal miliknya sendiri. Mengonfigurasi produksi tidak akan mengonfigurasi sandbox Anda.
Untuk menghubungkan organisasi sandbox, aktifkan server MCP SObject All di sandbox, lalu instal paket AppExchange ke sandbox (pilih Install in Sandbox) atau buat aplikasi klien eksternal Anda di sandbox. Untuk setelan penyimpanan data yang diperlukan koneksi sandbox, lihat Menyiapkan penyimpanan data Salesforce.
Yang terjadi setelah Anda mengonfigurasi Salesforce
Mengonfigurasi aplikasi di Salesforce tidak akan menghubungkan apa pun dengan sendirinya. Tindakan ini akan menyediakan aplikasi OAuth untuk organisasi Anda sehingga setiap pengguna dapat mengizinkannya.
Setelah administrator Google Cloud membuat penyimpanan data Salesforce di
Gemini Enterprise dan menghubungkannya ke aplikasi (lihat
Menyiapkan penyimpanan data Salesforce),
setiap pengguna akhir (termasuk administrator yang menggunakan aplikasi web) mengizinkan
Gemini Enterprise untuk mengakses Salesforce atas nama mereka menggunakan
Autentikasi Pengguna Akhir per pengguna. Saat pengguna pertama kali mengkueri data Salesforce
di aplikasi web Gemini Enterprise, mereka akan dialihkan ke halaman login Salesforce
organisasi Anda, tempat mereka memberikan cakupan mcp_api dan refresh_token
kepada aplikasi. Untuk mengetahui informasi selengkapnya, lihat Memberikan otorisasi ke konektor.
Karena setiap pengguna memberikan otorisasi secara individual, Gemini Enterprise mengakses data Salesforce dengan izin pengguna itu sendiri. Pengguna hanya melihat dan mengubah data yang sudah dapat mereka lihat dan ubah di Salesforce.
Memecahkan masalah
| Gejala | Kemungkinan penyebab |
|---|---|
| Langkah Verify Auth atau Authorize gagal, atau halaman login Salesforce melaporkan aplikasi klien yang tidak diketahui, tidak valid, atau tidak sah. | Jika Anda menggunakan OAuth 2.0 (Google Managed), pastikan paket terkelola diinstal di organisasi yang sama persis (termasuk sandbox) yang ditunjuk oleh Instance URI. Jika Anda menggunakan OAuth 2.0 (Bring
Your Own App), pastikan Client ID dan Client
Secret cocok dengan aplikasi di organisasi tersebut, URL callback ditetapkan
ke https://vertexaisearch.cloud.google.com/oauth-redirect,
cakupan mcp_api dan refresh_token
dipilih, dan Require Proof Key for Code Exchange (PKCE) extension
for Supported Authorization Flows diaktifkan. |
| Beberapa pengguna dapat memberikan otorisasi dan pengguna lainnya tidak. | Kebijakan Pengguna yang Diizinkan aplikasi membatasi akses ke profil atau set izin tertentu yang tidak menyertakan pengguna tersebut, atau Pelonggaran IP tidak ditetapkan ke Pelonggaran pembatasan IP. Di Setup, buka tab Policies aplikasi, klik Edit, tambahkan profil atau set izin yang terpengaruh (atau tetapkan Permitted Users ke All users may self-authorize), dan pastikan IP Relaxation ditetapkan ke Relax IP restrictions. |
| Otorisasi berhasil, tetapi kueri atau tindakan gagal di aplikasi web Gemini Enterprise. | Verifikasi setelan berikut di Salesforce:
|
| Otorisasi berhasil, tetapi tidak ada data Salesforce yang ditampilkan. | Pengguna yang memberikan otorisasi mungkin tidak memiliki akses tingkat data di Salesforce. Konektor mematuhi izin Salesforce milik pengguna. |
Langkah berikutnya
- Untuk membuat penyimpanan data, lihat Menyiapkan penyimpanan data Salesforce.