Halaman ini menjelaskan cara mengontrol akses dan izin API untuk resource Gemini Enterprise menggunakan Identity and Access Management (IAM).
Ringkasan
Google Cloud menawarkan IAM, yang memungkinkan Anda memberikan akses secara lebih terperinci ke resource Google Cloud tertentu dan mencegah akses yang tidak diinginkan ke resource lain. Halaman ini menjelaskan peran dan izin IAM Gemini Enterprise. Untuk mengetahui deskripsi mendetail tentang Google Cloud IAM, lihat dokumentasi IAM.
Gemini Enterprise menyediakan sekumpulan peran yang telah ditetapkan yang dirancang untuk membantu Anda mengontrol akses ke resource Gemini Enterprise. Anda juga dapat membuat peran khusus sendiri, jika peran yang telah ditetapkan tidak memberikan sekumpulan izin yang Anda perlukan. Selain itu, peran dasar lama (Editor, Viewer, dan Owner) juga tetap tersedia untuk Anda, meskipun tidak memberikan kontrol terperinci yang sama dengan peran Gemini Enterprise. Secara khusus, peran dasar memberikan akses ke resource di seluruh Google Cloud , bukan hanya untuk Gemini Enterprise. Lihat dokumentasi peran dasar untuk mengetahui informasi selengkapnya.
Peran yang telah ditetapkan
Gemini Enterprise menyediakan beberapa peran bawaan yang dapat Anda gunakan untuk memberikan izin yang lebih terperinci kepada akun utama. Peran yang Anda berikan kepada akun utama mengontrol tindakan yang dapat dilakukan akun utama. Akun utama dapat berupa individu, grup, atau akun layanan.
Anda dapat memberikan beberapa peran ke akun utama yang sama, dan dapat mengubah peran yang diberikan ke akun utama kapan saja, asalkan Anda memiliki izin untuk melakukannya.
Peran yang lebih luas mencakup peran yang lebih spesifik. Misalnya, peran Discovery Engine Editor mencakup semua izin peran Discovery Engine Viewer, beserta izin tambahan peran Discovery Engine Editor. Demikian juga, peran Admin Gemini Enterprise mencakup semua izin peran Discovery Engine Editor, beserta izin tambahannya.
Peran dasar (Pemilik, Editor, Viewer) memberikan izin di seluruh Google Cloud. Peran khusus Gemini Enterprise hanya memberikan izin Gemini Enterprise, kecuali untuk izin Google Cloudberikut, yang diperlukan untuk penggunaan Google Cloud umum:
resourcemanager.projects.getresourcemanager.projects.listserviceusage.services.listserviceusage.services.get
Tabel berikut mencantumkan peran IAM Gemini Enterprise beserta daftar terkait semua izin untuk setiap peran.
| Peran | Izin |
|---|---|
Admin Gemini Enterprise( Memberikan akses tingkat admin ke resource Gemini Enterprise. |
|
Discovery Engine Editor( Memberikan akses baca dan tulis ke semua resource discovery engine. |
|
Pengguna Gemini Enterprise( Memberikan akses tingkat pengguna ke resource Gemini Enterprise. |
|
Pengguna Terbatas Gemini Enterprise( Memberikan akses tingkat pengguna yang dibatasi ke resource Gemini Enterprise, untuk kontrol terperinci atas beberapa instance Gemini Enterprise dalam project yang sama. Akun utama dengan peran ini harus diberi peran tingkat pengguna tanpa batasan (misalnya, /agentspaceUser) pada kebijakan Engine untuk menggunakan Gemini Enterprise. |
|
Gemini Enterprise Viewer( Memberikan akses untuk melihat detail resource Gemini Enterprise. |
|
Discovery Engine Viewer( Memberikan akses baca ke semua resource discovery engine. |
|
Mengelola IAM Gemini Enterprise
Anda dapat memperoleh dan menetapkan kebijakan izin IAM serta peran IAM menggunakan Konsol Google Cloud . Untuk mengetahui informasi selengkapnya, lihat Mengelola akses ke project, folder, dan organisasi.
Memberikan izin kepada admin
Sebagai Project Owner, Anda dapat memberikan peran Gemini Enterprise Admin,
Service Usage Consumer, dan Logs Viewer kepada pengguna yang ingin menjadi
administrator.
Ikuti langkah-langkah berikut untuk menambahkan peran:
-
Di konsol Google Cloud , buka halaman IAM.
Buka IAM - Pilih project.
- Klik Grant access.
-
Di kolom New principals, masukkan ID pengguna. Biasanya, ini adalah alamat email untuk Akun Google atau grup pengguna.
- Tambahkan peran:
- Klik Add another role.
- Di daftar Select a role, pilih Gemini Enterprise Admin.
- Ulangi langkah a dan b untuk menambahkan peran Service usage consumer dan Logs viewer.
- Klik Simpan.
Bergantung pada tugas administratif, verifikasi juga binding peran berikut:
- Konektor data: Berikan
roles/discoveryengine.editoruntuk mengelola konektor data. Saat Anda mengizinkan konektor untuk pertama kalinya dalam sebuah project, Anda juga memerlukan izindiscoveryengine.locations.setUpDataConnectordandiscoveryengine.locations.exchangeAuthCredentials. Kedua izin ini disertakan dalam peranroles/discoveryengine.admindan peranroles/discoveryengine.agentspaceAdmin. - Distribusi lisensi: Berikan Billing Account Administrator
(
roles/billing.admin, yang mencakupdiscoveryengine.billingAccountLicenseConfigs.distribute) di akun Penagihan Cloud selainroles/discoveryengine.agentspaceAdmindi project untuk mendistribusikan lisensi. - Agen layanan: Pastikan agen layanan Discovery Engine
(
service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com) memilikiroles/discoveryengine.serviceAgentdi project, atau pembuatan aplikasi akan gagal denganInternal error encountered (Code 13).
Memberikan izin kepada pengguna Anda
Bagian ini menjelaskan cara memberikan peran level project kepada pengguna yang mereka perlukan untuk mengakses aplikasi Gemini Enterprise. Bergantung pada model akses Anda, pilih salah satu peran berikut:
- Mengakses semua aplikasi dalam project: Berikan peran Gemini Enterprise
User
(
roles/discoveryengine.agentspaceUser) di level project. - Hanya mengakses aplikasi tertentu: Berikan peran Gemini Enterprise Restricted
User
(
roles/discoveryengine.agentspaceRestrictedUser) di level project, lalu berikan peran Gemini Enterprise User (roles/discoveryengine.agentspaceUser) di setiap aplikasi. Peran Pengguna yang Dibatasi tidak memberikan akses ke aplikasi apa pun, sehingga pengguna hanya dapat membuka aplikasi tempat Anda memberi mereka peran Pengguna Gemini Enterprise. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi kontrol akses untuk aplikasi.
Untuk memberikan peran level project di konsol Google Cloud , ikuti langkah-langkah berikut:
-
Di konsol Google Cloud , buka halaman IAM.
Buka IAM - Pilih project.
- Klik Grant access.
-
Di kolom New principals, masukkan ID pengguna. Biasanya, ini adalah alamat email untuk Akun Google, grup pengguna, atau ID untuk pengguna dalam workforce identity pool. Untuk mengetahui detailnya, lihat ID utama untuk kebijakan izin.
-
Tambahkan peran level project:
- Klik Add another role.
-
Di daftar Select a role, pilih salah satu peran berikut:
- Untuk memberikan akses di semua aplikasi dalam project, pilih Gemini Enterprise User.
- Untuk membatasi akses ke aplikasi tertentu, pilih Pengguna Terbatas Gemini Enterprise.
- Klik Simpan.
-
Jika Anda memberikan peran Gemini Enterprise Restricted User, berikan peran Gemini Enterprise User (
roles/discoveryengine.agentspaceUser) pada setiap aplikasi yang perlu diakses pengguna. Untuk mengetahui petunjuk langkah demi langkah, lihat Mengonfigurasi kontrol akses untuk aplikasi.
Untuk mengizinkan pengguna mengelola dan membagikan aplikasi, beri mereka peran Discovery Engine Viewer (roles/discoveryengine.viewer).
Langkah berikutnya
- Pelajari cara mengelola akses ke project, folder, dan organisasi.
- Pelajari IAM lebih lanjut.
- Pelajari peran dasar lebih lanjut.
- Pelajari peran khusus lebih lanjut.