בקרת גישה באמצעות IAM
בדף הזה מוסבר איך משתמשים בניהול הזהויות והרשאות הגישה (IAM) כדי לנהל את הגישה למשאבים ב-Colab Enterprise. כדי לנהל את הגישה למשאבים אחרים של Gemini Enterprise Agent Platform, אפשר לעיין במאמר בנושא בקרת גישה ל-Agent Platform באמצעות IAM.
שליטה בגישה למחברות באמצעות IAM
אפשר לנהל את הגישה לקובצי notebook של Colab Enterprise (קובצי IPYNB) ברמת הפרויקט או לכל notebook בנפרד.
- כדי להעניק גישה למחברות ברמת הפרויקט, מקצים תפקיד אחד או יותר לחשבון ראשי (משתמש, קבוצה או חשבון שירות).
- כדי להעניק גישה למחברת ספציפית, מקצים תפקיד אחד או יותר לישות (principal) במחברת. מידע נוסף על ניהול הגישה לנוטבוק
הפעלת קוד שיוצר אינטראקציה עם שירותים אחרים של Google Cloud
הגישה לנוטבוק מוגבלת להרשאות הספציפיות שקשורות לאינטראקציה עם הנוטבוק. לדוגמה, אתם יכולים להעניק את היכולת ליצור מחברת, לכתוב בה קוד או למחוק אותה.
כדי להריץ קוד שיוצר אינטראקציה עם שירותים אחרים של Google Cloud Google, צריך להשתמש באחת מהשיטות הבאות:
הפעלת קוד בסביבת זמן ריצה עם פרטי כניסה של משתמשי קצה. המשמעות היא של-Notebook יש גישה לאותם Google Cloud שירותים שיש למשתמש ב-Notebook.
להריץ קוד שמאמת ומאשר את המחברת כדי ליצור אינטראקציה עם שירותיGoogle Cloud .
מידע נוסף זמין במאמר הפעלת קוד שמתקשר עםGoogle Cloud.
סוגים של תפקידי IAM
יש סוגים שונים של תפקידי IAM שאפשר להשתמש בהם ב-Colab Enterprise:
תפקידים מוגדרים מראש מאפשרים להעניק קבוצה של הרשאות קשורות למשאבים של Colab Enterprise ברמת הפרויקט.
תפקידים בסיסיים (בעלים, עריכה וצפייה) מספקים בקרת גישה למשאבי Colab Enterprise ברמת הפרויקט, והם משותפים לכל השירותים. Google Cloud
תפקידים בהתאמה אישית מאפשרים לכם לבחור קבוצה ספציפית של הרשאות, ליצור תפקיד משלכם עם ההרשאות האלה ולהקצות את התפקיד למשתמשים בארגון.
כדי להוסיף, לעדכן או להסיר את התפקידים האלה בפרויקט Colab Enterprise, אפשר לעיין במסמכי העזרה בנושא ניהול הגישה לפרויקטים, לתיקיות ולארגונים.
תפקידים מוגדרים מראש ב-Colab Enterprise
Colab Enterprise הוא חלק מ-Agent Platform, והמשאבים של Colab Enterprise מנוהלים דרך Agent Platform API. לכן, אתם יכולים להעניק לישויות מורשות גישה למשאבים של Colab Enterprise באמצעות תפקידים ב-Agent Platform.
בטבלה הבאה מפורטים כל התפקידים המוגדרים מראש ב-Agent Platform.
כדי להשתמש בתפקידים מוגדרים מראש לפעולות נפוצות ב-Colab Enterprise, אפשר לעיין במאמרים Colab Enterprise Admin (
roles/aiplatform.colabEnterpriseAdmin) ו-Colab Enterprise User (roles/aiplatform.colabEnterpriseUser).לגבי תפקידים שקשורים לניהול זמן ריצה, אפשר לעיין באדמין של זמן ריצה של מחברת (
roles/aiplatform.notebookRuntimeAdmin) ובמשתמש של זמן ריצה של מחברת (roles/aiplatform.notebookRuntimeUser).ההרשאות של Agent Platform Administrator (
roles/aiplatform.admin), Agent Platform User (roles/aiplatform.user) ו-Agent Platform Viewer (roles/aiplatform.viewer) כוללות גם הרשאות ל-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. The aiplatform.customJobs.create IAM permission is highly privileged. Through Vertex AI Custom Training jobs, it effectively grants editor-level access to other services activated for the consumer project, such as GCS and BigQuery. |
|
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. |
|
תפקידים בסיסיים
התפקידים הבסיסיים הישנים יותר Google Cloudמשותפים לכל השירותים של Google Cloud . התפקידים האלה הם 'בעלים', 'עריכה' ו'צפייה'.
התפקידים הבסיסיים מספקים הרשאות ב- Google Cloud, ולא רק ב-Colab Enterprise. לכן, מומלץ להשתמש בתפקידים ב-Colab Enterprise בכל הזדמנות.
תפקידים בהתאמה אישית
אם תפקידי ה-IAM המוגדרים מראש ל-Colab Enterprise לא מתאימים לצרכים שלכם, אתם יכולים להגדיר תפקידים בהתאמה אישית. תפקידים בהתאמה אישית מאפשרים לכם לבחור קבוצה ספציפית של הרשאות, ליצור תפקיד משלכם עם ההרשאות האלה ולהקצות את התפקיד למשתמשים בארגון. מידע נוסף מופיע במאמר הסבר על תפקידים בהתאמה אישית ב-IAM.
סוכני שירות ל-Colab Enterprise
Colab Enterprise יוצר באופן אוטומטי סוכני שירות ומשתמש בהם כדי לגשת למשאבים בשמכם. כשסוכן שירות נוצר, הוא מקבל תפקיד מוגדר מראש בפרויקט שלכם.
בטבלה הבאה מפורטים סוכני השירות של Colab Enterprise, כתובות האימייל שלהם והתפקידים שלהם:
| שם | משמש ל: | כתובת האימייל | תפקיד |
|---|---|---|---|
| סוכן שירות Vertex AI | היכולות של Agent Platform | service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com |
roles/aiplatform.serviceAgent |
| סוכן שירות Vertex AI Colab | נותן ל-Colab Enterprise את ההרשאות המתאימות כדי לפעול | service-PROJECT_NUMBER@gcp-sa-vertex-nb.iam.gserviceaccount.com |
roles/aiplatform.colabServiceAgent |
| סוכן שירות Vertex AI Notebook | הפעלת משאבים שמנוהלים על ידי מחברת בפרויקט המשתמש עם הרשאות מוגבלות | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com |
roles/aiplatform.notebookServiceAgent |
אם מסירים את תפקידי ברירת המחדל של סוכני השירות של Colab Enterprise, Colab Enterprise יכול להקצות מחדש את התפקידים האלה באופן אוטומטי כדי להבטיח שהפונקציונליות של השירות לא תיפגע. כדי להשבית את השירות Colab Enterprise, צריך להשבית את ממשקי ה-API הרלוונטיים במקום להסיר תפקידים.
שיקולי אבטחה לגבי הרשאות ב-Colab Enterprise
כשמשתמש יוצר מחברת Colab Enterprise, הוא מקבל באופן אוטומטי את התפקיד בעלים של קוד (roles/dataform.codeOwner) במחברת הזו. הענקת התפקיד ברמת המשאב נפרדת מכל תפקידי ה-IAM ברמת הפרויקט.
מדיניות IAM מאורגנת באופן היררכי:
- למשתמש יכול להיות תפקיד במדיניות IAM של הפרויקט, שמועבר אוטומטית לכל המשאבים בפרויקט.
- למשתמש יכול להיות גם תפקיד במדיניות משאבים ספציפית, כמו מחברת מסוימת.
למשתמש יש גישה למשאב אם יש לו תפקיד במדיניות המשאב או בכל אחת ממדיניות ההורה שלו.
כדי לבטל באופן מלא את הגישה של משתמש, אדמינים יכולים לבצע אחת מהפעולות הבאות:
- מסירים את התפקידים של המשתמש מכל מחברת בנפרד. מידע נוסף זמין במאמר הסרת גישה ברמת המשאב מנוטבוק.
- יוצרים מדיניות IAM לביטול הרשאות כדי לבטל את כל ההרשאות של המשתמש בכל המשאבים בפרויקט.