Kontrol akses dengan IAM
Halaman ini menjelaskan cara menggunakan Identity and Access Management (IAM) untuk mengelola akses ke resource Colab Enterprise. Untuk mengelola akses ke resource Vertex AI lainnya, lihat Kontrol akses Vertex AI dengan IAM.
Mengontrol akses ke notebook dengan IAM
Anda dapat mengelola akses ke notebook Colab Enterprise (file IPYNB) di level project atau per notebook.
- Untuk memberikan akses ke notebook di level project, tetapkan satu atau beberapa peran ke akun utama (pengguna, grup, atau akun layanan).
- Untuk memberikan akses ke notebook tertentu, tetapkan satu atau beberapa peran ke pokok pada notebook. Untuk mempelajari lebih lanjut, lihat Mengelola akses ke notebook.
Menjalankan kode yang berinteraksi dengan layanan Google Cloud lainnya
Pemberian akses ke notebook terbatas pada izin tertentu yang terkait dengan interaksi dengan notebook. Misalnya, Anda dapat memberikan kemampuan untuk membuat notebook, menulis kode di dalamnya, atau menghapus notebook.
Untuk menjalankan kode yang berinteraksi dengan layanan Google Cloud lain, Anda harus menggunakan salah satu metode berikut:
Jalankan kode di runtime dengan kredensial pengguna akhir yang diaktifkan. Artinya, notebook Anda memiliki akses yang sama ke layanan seperti pengguna notebook Anda. Google Cloud
Jalankan kode yang mengautentikasi dan memberi otorisasi pada notebook Anda untuk berinteraksi dengan layananGoogle Cloud .
Untuk mempelajari lebih lanjut, lihat Menjalankan kode yang berinteraksi dengan Google Cloud.
Jenis peran IAM
Ada berbagai jenis peran IAM yang dapat digunakan di Colab Enterprise:
Peran yang telah ditetapkan memungkinkan Anda memberikan serangkaian izin terkait ke resource Colab Enterprise di level project.
Peran dasar (Pemilik, Editor, dan Viewer) menyediakan kontrol akses ke resource Colab Enterprise Anda di level project, dan bersifat umum untuk semua layanan Google Cloud.
Peran khusus memungkinkan Anda memilih sekumpulan izin tertentu, membuat peran Anda sendiri dengan izin tersebut, dan memberikan peran tersebut kepada pengguna di organisasi Anda.
Untuk menambahkan, memperbarui, atau menghapus peran ini dalam project Colab Enterprise Anda, lihat dokumentasi tentang mengelola akses ke project, folder, dan organisasi.
Peran yang telah ditetapkan untuk Colab Enterprise
Colab Enterprise merupakan bagian dari Vertex AI, dan resource Colab Enterprise dikelola melalui Vertex AI API. Oleh karena itu, Anda dapat memberikan akses akun utama ke resource Colab Enterprise melalui peran Vertex AI.
Tabel berikut mencakup semua peran bawaan Vertex AI.
Untuk menggunakan peran yang telah ditentukan sebelumnya untuk operasi Colab Enterprise umum, lihat Admin Colab Enterprise (
roles/aiplatform.colabEnterpriseAdmin) dan Pengguna Colab Enterprise (roles/aiplatform.colabEnterpriseUser).Untuk peran yang terkait dengan pengelolaan runtime, lihat Notebook Runtime Admin (
roles/aiplatform.notebookRuntimeAdmin) dan Notebook Runtime User (roles/aiplatform.notebookRuntimeUser).Vertex AI Administrator (
roles/aiplatform.admin), Vertex AI User (roles/aiplatform.user), dan Vertex AI Viewer (roles/aiplatform.viewer) juga mencakup izin Colab Enterprise.
| Role | Permissions |
|---|---|
Agent Platform Administrator( Grants full access to all resources in Agent Platform. |
|
Aiplatform Editor( Editor role for aiplatform |
|
Agent Platform Express User Beta( Grants user access to Agent Platform Express. |
|
Agent Platform User( Grants access to use all resource in Agent Platform. |
|
Agent Platform Viewer( Grants access to view all resource in Agent Platform. |
|
Colab Enterprise Admin( Admin role of using colab enterprise. |
|
Colab Enterprise User( User role of using colab enterprise. |
|
Agent Platform Feature Store EntityType owner( Provides full access to all permissions for a particular entity type resource. Lowest-level resources where you can grant this role:
|
|
Agent Platform Express Admin Beta( Grants admin access to Agent Platform Express. |
|
Agent Platform Feature Store Admin( Grants full access to all resources in Agent Platform Feature Store. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Data Viewer( This role provides permissions to read Feature data. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Data Writer( This role provides permissions to read and write Feature data. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Instance Creator( Administrator of Featurestore resources, but not the child resources under Featurestores. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Resource Viewer( Viewer of all resources in Agent Platform Feature Store but cannot make changes. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store User Beta( Deprecated. Use featurestoreAdmin instead. |
|
Agent Platform Memory Bank Editor Role( Grants edit access to Agent Platform Memory Bank. |
|
Agent Platform Memory Bank User Role( Grants full user access to Agent Platform Memory Bank. |
|
Agent Platform Memory Bank Viewer Role( Grants viewer access to Agent Platform Memory Bank. |
|
Agent Platform Migration Service User( Grants access to use migration service in Agent Platform |
|
Notebook Executor User Beta( Grants users full access to schedules and notebook execution jobs. |
|
Notebook Runtime Admin( Grants full access to all runtime templates and runtimes in Notebook Service. |
|
Notebook Runtime User( Grants users permissions to create runtime resources using a runtime template and manage the runtime resources they created. |
|
Vertex AI Platform Provisioned Throughput Admin Beta( Grants access to use all resources related to Vertex AI Provisioned Throughput |
|
Vertex AI Platform Publisher Provisioned Throughput Admin Beta( Grants Publisher access to use all resources related to Vertex AI Provisioned Throughput Orders |
|
Vertex AI Platform Publisher Provisioned Throughput Viewer Beta( Grants Publisher access to view all resources related to Vertex AI Provisioned Throughput Orders |
|
Agent Platform Sessions Editor Role( Grants edit access to Agent Platform Sessions. |
|
Agent Platform Sessions User Role( Grants full user access to Agent Platform Sessions. |
|
Agent Platform Sessions Viewer Role( Grants viewer access to Agent Platform Sessions |
|
Agent Platform Tensorboard Web App User Beta( Grants access to the Vertex AI TensorBoard web app. |
|
Service agent roles
Service agent roles should only be granted to service agents.
| Role | Permissions |
|---|---|
Vertex AI Agent Sandbox Service Agent( Vertex AI Service Agent used to access Agent Sandbox managed resources in consumer project with restricted permissions. |
|
Vertex AI Batch Prediction Service Agent( Vertex AI Batch Prediction Service Agent for serving batch prediction requests. |
|
Vertex AI Colab Service Agent( Gives Vertex AI Colab the proper permissions to function. |
|
Vertex AI Custom Code Service Agent( Gives Vertex AI Custom Code the proper permissions. |
|
Vertex AI Extension Custom Code Service Agent( Gives Vertex AI Extension that executes custom code the permissions it needs to function. |
|
Vertex AI Extension Service Agent( Gives Vertex AI Extension the permissions it needs to function. |
|
Vertex AI Model Monitoring Service Agent( Gives Vertex AI Model Monitoring the permissions it needs to function. |
|
Vertex AI Notebook Service Agent( Vertex AI Service Agent used to run Notebook managed resources in user project with restricted permissions. |
|
Vertex AI Online Prediction Service Agent( Gives Vertex AI Online Prediction the permissions it needs to function. |
|
Vertex AI RAG Data Service Agent( Vertex AI Service Agent used by Vertex RAG to access user imported data, Vertex AI, Document AI processors, and Vector Search in the project |
|
Vertex AI Rapid Eval Service Agent( Vertex AI Service Agent used by GenAI Rapid Evaluation Service to access publisher model endpoints in the user project |
|
Vertex AI Reasoning Engine Service Agent( Gives Vertex AI Reasoning Engine the proper permissions to function. The aiplatform.reasoningEngines.create IAM permission implies read access to the GCS objects of the consumer project through this service agent. |
|
Vertex AI Service Agent( Gives Vertex AI the permissions it needs to function. |
|
Vertex AI Telemetry Service Agent( Allows Vertex AI Telemetry Service Agent to access telemetry data. |
|
Vertex AI Tuning Service Agent( Vertex AI Service Agent used for tuning in user project. |
|
Peran dasar
Peran dasar Google Cloudyang lama bersifat umum untuk semua layanan Google Cloud . Peran ini terdiri dari Pemilik, Editor, dan Viewer.
Peran dasar memberikan izin di seluruh Google Cloud, bukan hanya untuk Colab Enterprise. Karena alasan ini, Anda harus menggunakan peran Colab Enterprise jika memungkinkan.
Peran khusus
Jika peran IAM yang telah ditetapkan untuk Colab Enterprise tidak memenuhi kebutuhan Anda, Anda dapat menentukan peran khusus. Peran khusus memungkinkan Anda memilih sekumpulan izin tertentu, membuat peran Anda sendiri dengan izin tersebut, dan memberikan peran tersebut kepada pengguna di organisasi Anda. Untuk informasi selengkapnya, lihat Memahami peran khusus IAM.
Agen layanan untuk Colab Enterprise
Colab Enterprise secara otomatis membuat dan menggunakan agen layanan untuk mengakses resource atas nama Anda. Saat dibuat, agen layanan diberi peran yang telah ditetapkan untuk project Anda.
Tabel berikut mencantumkan agen layanan Colab Enterprise, alamat emailnya, dan perannya masing-masing:
| Nama | Digunakan untuk | Alamat email | Peran |
|---|---|---|---|
| Agen Layanan Vertex AI | Kemampuan Vertex AI | service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com |
roles/aiplatform.serviceAgent |
| Agen Layanan Colab Vertex AI | Memberikan izin yang tepat agar Colab Enterprise dapat berfungsi | service-PROJECT_NUMBER@gcp-sa-vertex-nb.iam.gserviceaccount.com |
roles/aiplatform.colabServiceAgent |
| Agen Layanan Notebook Vertex AI | Menjalankan resource yang dikelola notebook di project pengguna dengan izin terbatas | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com |
roles/aiplatform.notebookServiceAgent |
Jika Anda menghapus peran default agen layanan Colab Enterprise, Colab Enterprise dapat secara otomatis menetapkan ulang peran tersebut untuk memastikan fungsi layanan tidak terganggu. Untuk menonaktifkan layanan Colab Enterprise, Anda harus menonaktifkan API yang relevan, bukan menghapus peran.
Pertimbangan keamanan untuk izin Colab Enterprise
Saat pengguna membuat notebook Colab Enterprise, mereka akan otomatis diberi peran
Pemilik Kode (roles/dataform.codeOwner)
di notebook tersebut. Pemberian peran tingkat resource ini terpisah dari peran IAM tingkat project.
IAM mengatur kebijakan secara hierarkis:
- Pengguna dapat memiliki peran dalam kebijakan IAM project, yang secara otomatis diteruskan ke semua resource dalam project.
- Pengguna juga dapat memiliki peran dalam kebijakan resource tertentu, seperti notebook individual.
Pengguna memiliki akses ke resource jika mereka memiliki peran dalam kebijakan resource atau salah satu kebijakan induknya.
Untuk mencabut akses pengguna sepenuhnya, administrator dapat melakukan salah satu tindakan berikut:
- Hapus peran pengguna dari setiap notebook individual. Untuk mempelajari lebih lanjut, lihat Menghapus akses tingkat resource dari notebook.
- Buat kebijakan Penolakan IAM untuk mencabut semua izin pengguna di semua resource dalam project.
Langkah berikutnya
Pelajari cara membuat dan mengelola peran IAM kustom.
Pelajari Agen layanan lebih lanjut