בדף הזה מוסבר איך אתם יכולים לשלוט בגישה ל-API ובהרשאות למשאבים של Gemini Enterprise באמצעות ניהול זהויות והרשאות גישה (IAM).
סקירה כללית
ב-Google Cloud יש ממשק לניהול זהויות והרשאות גישה (IAM), שמאפשר לתת גישה פרטנית יותר למשאבים ספציפיים ב- Google Cloud ולמנוע גישה לא רצויה למשאבים אחרים. בדף הזה מתוארים התפקידים וההרשאות של Gemini Enterprise ב-IAM. למידע מפורט עלGoogle Cloud IAM, תוכלו לעיין במסמכי העזרה של IAM.
ב-Gemini Enterprise יש קבוצה של תפקידים מוגדרים מראש שנועדו לעזור לכם לשלוט בגישה למשאבים שלכם ב-Gemini Enterprise. אם התפקידים המוגדרים מראש לא מספקים את קבוצות ההרשאות שאתם צריכים, אתם יכולים גם ליצור תפקידים בהתאמה אישית. בנוסף, התפקידים הבסיסיים הישנים (עריכה, צפייה ובעלים) עדיין זמינים, אבל הם לא מספקים את אותה רמת שליטה מפורטת כמו התפקידים ב-Gemini Enterprise. באופן ספציפי, התפקידים הבסיסיים מספקים גישה למשאבים בכל Google Cloud , ולא רק ל-Gemini Enterprise. למידע נוסף, קראו את המאמר תפקידים בסיסיים.
תפקידים מוגדרים מראש
ב-Gemini Enterprise יש כמה תפקידים מוגדרים מראש שאפשר להשתמש בהם כדי לתת הרשאות יותר מפורטות לחשבונות משתמשים. התפקיד שאתם נותנים לחשבון המשתמש קובע אילו פעולות הוא יכול לבצע. חשבונות המשתמשים יכולים להיות אנשים פרטיים, קבוצות או חשבונות שירות.
אתם יכולים להקצות לאותו חשבון משתמש כמה תפקידים, ולשנות את התפקידים שהוקצו לחשבון המשתמש בכל שלב, בתנאי שיש לכם את ההרשאות המתאימות.
התפקידים הרחבים יותר כוללים את התפקידים המוגדרים באופן צר יותר. לדוגמה, התפקיד "עריכה ב-Discovery Engine" כולל את כל ההרשאות של התפקיד "צפייה ב-Discovery Engine", וגם את ההרשאות הנוספות של התפקיד "עריכה ב-Discovery Engine". באופן דומה, התפקיד "אדמין ב-Gemini Enterprise" כולל את כל ההרשאות של התפקיד "עריכה ב-Discovery Engine", וגם את ההרשאות הנוספות שלו.
התפקידים הבסיסיים (בעלים, עריכה, צפייה) מספקים הרשאות בכל Google Cloud. התפקידים הספציפיים ל-Gemini Enterprise נותנים רק הרשאות ל-Gemini Enterprise, חוץ מההרשאות הבאות של Google Cloudשנדרשות לשימוש כללי ב- Google Cloud :
resourcemanager.projects.getresourcemanager.projects.listserviceusage.services.listserviceusage.services.get
בטבלה הבאה מפורטים תפקידי ה-IAM ב-Gemini Enterprise, עם רשימה של כל ההרשאות לכל תפקיד.
| תפקיד | הרשאות |
|---|---|
דף הניהול של Gemini Enterprise( נותן גישה ברמת אדמין למשאבי Gemini Enterprise. |
|
עריכה ב-Discovery Engine( מעניק הרשאת קריאה וכתיבה לכל המשאבים של מנוע החיפוש. |
|
משתמש ב-Gemini Enterprise( נותנת גישה ברמת המשתמש למשאבים של Gemini Enterprise. |
|
משתמש מוגבל ב-Gemini Enterprise( נותן גישה מוגבלת ברמת המשתמש למשאבי Gemini Enterprise, כדי לאפשר שליטה מדויקת בכמה מופעים של Gemini Enterprise באותו פרויקט. כדי להשתמש ב-Gemini Enterprise, חשבונות משתמש עם התפקיד הזה צריכים לקבל תפקיד ברמת המשתמש ללא הגבלה (למשל, /agentspaceUser) במדיניות של Engine. |
|
Gemini Enterprise Viewer( נותנת גישה לצפייה בפרטים של משאבי Gemini Enterprise. |
|
צפייה ב-Discovery Engine( הרשאת קריאה לכל המשאבים של מנוע החיפוש. |
|
ניהול IAM ב-Gemini Enterprise
אתם יכולים לקבל ולהגדיר מדיניות הרשאות ותפקידים ב-IAM באמצעות מסוף Google Cloud . איך מנהלים את הגישה לפרויקטים, לתיקיות ולארגונים
מתן הרשאות לאדמינים
כבעלי הפרויקט, אתם יכולים להקצות את התפקידים Gemini Enterprise Admin, Service Usage Consumer ו-Logs Viewer למשתמשים שרוצים להיות אדמינים.
כדי להוסיף את התפקידים:
-
נכנסים לדף IAM במסוף Google Cloud .
כניסה לדף IAM - בוחרים את הפרויקט.
- לוחצים על Grant access.
-
בשדה New principals, מזינים את מזהה המשתמש. בדרך כלל מזהה המשתמש הוא כתובת האימייל של חשבון Google או של קבוצת משתמשים.
- מוסיפים את התפקידים:
- לוחצים על Add another role.
- ברשימה Select a role, בוחרים באפשרות Gemini Enterprise Admin.
- חוזרים על השלבים א' ו-ב' כדי להוסיף את התפקידים Service usage consumer ו-מציג היומנים.
- לוחצים על Save.
בהתאם למשימה הניהולית, צריך גם לאמת את קישורי התפקידים הבאים:
- מחברי נתונים: הרשאה לנהל מחברי נתונים.
roles/discoveryengine.editorבפעם הראשונה שמאשרים מחבר בפרויקט, צריך גם את ההרשאותdiscoveryengine.locations.setUpDataConnectorו-discoveryengine.locations.exchangeAuthCredentials. שתי ההרשאות האלה כלולות בתפקידroles/discoveryengine.adminובתפקידroles/discoveryengine.agentspaceAdmin. - הפצת רישיונות: כדי להפיץ רישיונות, צריך להקצות את התפקיד אדמין של חשבון לחיוב (
roles/billing.admin, שכולל אתdiscoveryengine.billingAccountLicenseConfigs.distribute) בחשבון לחיוב ב-Cloud, בנוסף לתפקידroles/discoveryengine.agentspaceAdminבפרויקט. - סוכן שירות: ודאו שלסוכן השירות של Discovery Engine (
service-PROJECT_NUMBER@gcp-sa-discoveryengine.iam.gserviceaccount.com) יש את התפקידroles/discoveryengine.serviceAgentבפרויקט, אחרת יצירת האפליקציה תיכשל עם השגיאהInternal error encountered (Code 13).
הענקת הרשאות למשתמשים
בקטע הזה מוסבר איך מקצים למשתמשים את התפקידים ברמת הפרויקט שהם צריכים כדי לגשת לאפליקציות Gemini Enterprise. בהתאם למודל הגישה, בוחרים באחד מהתפקידים הבאים:
- גישה לכל האפליקציות בפרויקט: מקצים את התפקיד משתמש ב-Gemini Enterprise (
roles/discoveryengine.agentspaceUser) ברמת הפרויקט. - גישה לאפליקציות ספציפיות בלבד: מקצים את התפקיד Gemini Enterprise Restricted User (
roles/discoveryengine.agentspaceRestrictedUser) ברמת הפרויקט, ואז מקצים את התפקיד Gemini Enterprise User (roles/discoveryengine.agentspaceUser) באפליקציות הספציפיות. התפקיד "משתמש עם הרשאות מוגבלות" לא מעניק גישה לאף אפליקציה בפני עצמו, ולכן המשתמשים יכולים לפתוח רק את האפליקציות שבהן אתם מעניקים להם את התפקיד "משתמש בגרסה הארגונית של Gemini Enterprise". מידע נוסף זמין במאמר הגדרת אמצעי בקרת גישה לאפליקציות.
כדי להקצות את התפקיד ברמת הפרויקט במסוף Google Cloud :
-
נכנסים לדף IAM במסוף Google Cloud .
כניסה לדף IAM - בוחרים את הפרויקט.
- לוחצים על Grant access.
-
בשדה New principals, מזינים את מזהה המשתמש. בדרך כלל מזהה המשתמש הוא כתובת האימייל של חשבון Google, קבוצת משתמשים או המזהה של משתמש במאגר זהויות של כוח עבודה. לפרטים, ראו מזהים של חשבונות משתמשים במדיניות הרשאה.
-
מוסיפים את התפקיד ברמת הפרויקט:
- לוחצים על Add another role.
-
ברשימה Select a role, בוחרים אחד מהתפקידים הבאים:
- כדי לתת גישה לכל האפליקציות בפרויקט, בוחרים באפשרות Gemini Enterprise User.
- כדי להגביל את הגישה לאפליקציות ספציפיות, בוחרים באפשרות משתמש עם הרשאות מוגבלות ב-Gemini Enterprise.
- לוחצים על Save.
-
אם הקציתם את התפקיד Gemini Enterprise Restricted User, הקצו את התפקיד משתמש בגרסה הארגונית של Gemini Enterprise (
roles/discoveryengine.agentspaceUser) בכל אפליקציה שהמשתמש צריך לגשת אליה. להוראות מפורטות, ראו הגדרת אמצעי בקרת גישה לאפליקציות.
כדי לאפשר למשתמשים לנהל ולשתף אפליקציות, צריך להקצות להם את התפקיד צפייה ב-Discovery Engine (roles/discoveryengine.viewer).
המאמרים הבאים
- איך מנהלים את הגישה לפרויקטים, לתיקיות ולארגונים
- מידע נוסף על IAM
- מידע נוסף על תפקידים בסיסיים
- מידע נוסף על תפקידים בהתאמה אישית