מערכת גישה מאוחדת לכללי מדיניות (UAP) מאפשרת לכם לתת ולדחות גישה למשאבים ב-Google Cloud . בניגוד למדיניות הרשאות ומדיניות דחייה, ב-UAP אפשר לתת ולדחות גישה באותה מדיניות, וכך לנהל את המדיניות בצורה פשוטה יותר. אפשר גם להשתמש שוב בכללי מדיניות ה-UAP, כלומר להחיל את אותה מדיניות UAP על כמה משאבים.
איך פועלת מערכת הגישה המאוחדת לכללי מדיניות (UAP)
כדי לתת או לדחות גישה ב-IAM, צריך לציין למי מותר או אסור לבצע פעולה מסוימת במשאב מסוים.
במדיניות ה-UAP, אתם יוצרים כללי UAP כדי לציין למי מותר או אסור לבצע פעולות מסוימות. כל כלל מורכב מרשימה של חשבונות משתמשים, רשימה של תפקידים והרשאות והשפעה. ההשפעה – אישור או דחייה – מציינת אם לחשבונות המשתמשים שברשימה מוקצים התפקידים וההרשאות שבכלל, או אם נמנע מהם להשתמש בהרשאות שבכלל. בכל UAP יכולים להיות עד 100 כללים.
כדי לציין לאיזה משאב ה-UAP שולט בגישה, משתמשים בקישור של UAP כדי לקשר את ה-UAP למשאב. אפשר לקשר מדיניות UAP אחת לעד 5 משאבים. למשאב אחד יכולים להיות עד 5 כללי מדיניות שמקושרים אליו.
תרחישים לדוגמה
ב-IAM יש כמה סוגי מדיניות שמאפשרים לתת ולדחות גישה:
- כדי לאפשר גישה, אתם יכולים להשתמש בכללי מדיניות הרשאה או בכללי הרשאה של UAP.
- כדי לדחות את הגישה, אתם יכולים להשתמש בכללי מדיניות הדחייה או בכללי הדחייה של UAP.
אם אתם כבר משתמשים במדיניות הרשאה או דחייה כדי לשלוט בגישה, אנחנו ממליצים להמשיך להשתמש בהן. סוגי המדיניות האלה נתמכים גם בכלי לפתרון בעיות שקשורות למדיניות, שמאפשר להבין בקלות את שורש הבעיה של שגיאות הגישה.
כדאי להשתמש בכללי מדיניות גישה מאוחדת במקרים הבאים:
- אתם מגדירים ארגון חדש ומתכננים להשתמש ב-UAP כדי לשלוט בגישה בארגון.
- אתם רוצים להגדיר בקרת גישה מפורטת (FGAC) באמצעות תנאי UAP.
כללים של מדיניות גישה מאוחדת (UAP)
כללי מדיניות ה-UAP מורכבים מכללי הרשאה ודחייה. הכללים האלה מכילים את הרכיבים הבאים:
השפעה: אם הכלל מעניק גישה או מונע גישה. כללים שנותנים גישה נקראים כללי הרשאה. כללים שדוחים גישה נקראים כללי דחייה.
קבוצה של חשבונות משתמשים: חשבונות המשתמשים שרוצים לכלול בכלל, למשל משתמשים, קבוצות או חשבונות שירות. בכללי הרשאה, חשבונות המשתמשים האלה מקבלים גישה. בכללי דחייה, לחשבונות המשתמשים האלה אין גישה.
רשימה של תפקידים והרשאות: התפקידים וההרשאות שרוצים לכלול בכלל. בכללי הרשאה, ההרשאות האלה ניתנות. בכללי דחייה, ההרשאות האלה נדחות.
אופציונלי: ביטוי תנאי: ביטוי של תנאי IAM שמציין את התנאים שצריכים להתקיים כדי שהכלל יחול. למידע נוסף, קראו את הקטע תנאים במדיניות גישה מאוחדת שבדף הזה.
חשבונות משתמשים בכללים של מערכת גישה מאוחדת לכללי מדיניות (UAP)
כדי לציין את חשבונות המשתמשים שרוצים לכלול בכלל, מגדירים את הפרטים הבאים:
- חשבונות המשתמשים שנכללים: חשבונות המשתמשים שרוצים לכלול בכלל.
- חשבונות משתמשים מוחרגים: חשבונות המשתמשים שרוצים להחריג מהכלל, גם אם הם נמצאים בקבוצה שברשימת חשבונות המשתמשים הכלולים.
בעזרת שתי הרשימות האלה, אתם יכולים לציין בקצרה אילו חשבונות משתמשים אתם רוצים לכלול בכלל. לדוגמה, נניח שאתם יוצרים כלל הרשאה כדי לתת גישה למשתמשים ב-example.com. אם רוצים לתת גישה לכל המשתמשים בקבוצה all@example.com חוץ מהמשתמש reduced-access@example.com, צריך להוסיף את all@example.com לרשימת החשבונות הכלולים ואת reduced-access@example.com לרשימת החשבונות המוחרגים.
תפקידים והרשאות בכללים של מדיניות גישה מאוחדת (UAP)
כדי ליצור רשימה מדויקת של ההרשאות שרוצים לכלול בכלל, מגדירים את הפרטים הבאים:
- Included permissions: ההרשאות שרוצים לכלול בכלל.
- ההרשאות שלא נכללות: ההרשאות שלא רוצים לכלול בכלל, גם אם הן נמצאות בתפקיד או בקבוצת הרשאות ברשימת ההרשאות שנכללות.
כדי להוסיף הרשאות לרשימת ההרשאות הכלולות או לרשימת ההרשאות שלא נכללות, אפשר להשתמש באחת מהאפשרויות הבאות:
הרשאות: שמות של הרשאות ספציפיות בפורמט של שם דומיין שמוגדר במלואו (FQDN). לדוגמה,
cloudresourcemanager.googleapis.com/projects.get.תפקידים (כללי הרשאה בלבד): שמות של תפקידים מוגדרים מראש, כמו
roles/logging.logsViewer. אם תכללו שם של תפקיד בכלל, הכלל יכלול את כל ההרשאות שבתפקיד הזה. במאמרי העזרה בנושא תפקידים והרשאות תוכלו לראות את כל ההרשאות שכלולות בתפקיד.בקובץ ה-JSON של ה-UAP, השמות האלה תמיד מתחילים ב-
role:, לדוגמהrole:roles/logging.logsViewer.אפשר להשתמש בתפקידים רק בכללי הרשאה. אין תמיכה בתפקידים בהתאמה אישית באף כלל.
קבוצות הרשאות: קבוצות של הרשאות, כמו
aiplatform.googleapis.com/*.*. קבוצות של הרשאות הן קבוצות של הרשאות שתואמות לתבנית מסוימת. יש כמה הגבלות על קבוצות ההרשאות שאפשר להפנות אליהן ועל ההרשאות שכלולות בקבוצות האלה. למידע נוסף, אפשר לעיין בקטע קבוצות הרשאות שבדף הזה.
קבוצות הרשאות
קבוצות של הרשאות הן קבוצות של הרשאות שתואמות לתבנית מסוימת. אתם יכולים להשתמש בקבוצת הרשאות כדי לתת או לדחות קבוצות של הרשאות קשורות. לדוגמה, אתם יכולים לדחות את כל ההרשאות לשירות אחד, או לתת את כל ההרשאות שמסתיימות בפועל מסוים.
קבוצות הרשאות פועלות באופן שונה בכללי הרשאה ובכללי דחייה. בקטעים הבאים מוסבר איך להשתמש בקבוצות הרשאות בכל סוג של כלל.
קבוצות הרשאות בכללי ההרשאה
כדי לזהות קבוצת הרשאות בכלל הרשאה, מחליפים חלק אחד או יותר בשם ההרשאה בתו כללי לחיפוש (*). ההרשאות שכל קבוצה כוללת תלויות במיקום של התו הכללי לחיפוש:
-
SERVICE_FQDN/RESOURCE.*: כולל את כל ההרשאות למשאב שצוין. -
SERVICE_FQDN/*.*: כולל את כל ההרשאות לשירות שצוין. -
SERVICE_FQDN/*.VERB: כולל את כל ההרשאות לשירות שמסתיימות בפועל שצוין. -
*/*.VERB: כולל את כל ההרשאות שמסתיימות בפועל שצוין. -
*: כולל את כל ההרשאות. מותר להשתמש בערך הזה רק כשמציינים הרשאות כלולות, ולא הרשאות מוחרגות.
קבוצות ההרשאות כוללות רק את ההרשאות שאפשר לתת בתפקידים בהתאמה אישית. הרשאות אחרות לא נכללות, גם אם הן תואמות לפורמט שצוין.
במאמר רמות התמיכה להרשאות בתפקידים בהתאמה אישית מוסבר אילו הרשאות נתמכות בתפקידים בהתאמה אישית.
ההרשאות שמופיעות בדף הזה לא משתמשות באותו פורמט כמו ההרשאות ב-UAP:
- בתפקידים בהתאמה אישית, שמות ההרשאות הם בפורמט
v1, שהואSERVICE_ID.RESOURCE.VERB. - במדיניות UAP, שמות ההרשאות הם בפורמט של שם דומיין שמוגדר במלואו (FQDN):
SERVICE_FQDN/RESOURCE.VERB.
עם זאת, הערכים של SERVICE_ID ו-SERVICE_FQDN בדרך כלל דומים. ברוב המקרים, הערך של SERVICE_FQDN הוא הערך של SERVICE_ID מ-API של v1, ואחריו .googleapis.com. לדוגמה, אפשר לכתוב את ההרשאה למחיקת תפקיד בדרכים הבאות:
v1פורמט:iam.roles.delete- פורמט של שם דומיין שמוגדר במלואו:
iam.googleapis.com/roles.delete
אתם יכולים להשתמש בדמיון הזה כדי לתרגם בין שני הפורמטים כשאתם בודקים קבוצות הרשאות לכללי הרשאה.
יש כמה חריגים לכלל הזה. כדי לראות את החריגים האלה, עיינו ברשימת ההרשאות שנתמכות בכללי מדיניות הדחייה וחפשו את IAM v1 API בשדה הסינון.
קבוצות הרשאות בכללי דחייה
כללי דחייה תומכים רק בקבוצות הרשאות מסוימות. קבוצות ההרשאות הנתמכות מפורטות במאמר ההרשאות שנתמכות בכללי מדיניות הדחייה. המזהים של קבוצות ההרשאות הנתמכות מחליפים חלק אחד או יותר של שם ההרשאה בתו כללי לחיפוש (*). ההרשאות שכל קבוצה כוללת תלויות במיקום של התו הכללי לחיפוש:
-
SERVICE_FQDN/RESOURCE.*: דחייה של כל ההרשאות למשאב שצוין. -
SERVICE_FQDN/*.*: דחיית כל ההרשאות לשירות שצוין. -
SERVICE_FQDN/*.VERB: דחיית כל ההרשאות לשירות שמסתיימות בפועל שצוין.
קבוצות ההרשאות כוללות את כל ההרשאות הנוכחיות והעתידיות שתואמות לתבנית שצוינה. לדוגמה, נניח שאתם משתמשים בקבוצת ההרשאות example.googleapis.com/exampleResource.* כדי לדחות את כל ההרשאות של משתמש לסוג המשאב exampleResource. אם example.googleapis.com מוסיפה הרשאה חדשה לסוג המשאב exampleResource, כמו example.googleapis.com/exampleResource.newPermission, המשתמש יקבל באופן אוטומטי דחייה להרשאה החדשה.
אפשר להשתמש בתווים כלליים לחיפוש רק בקבוצות הרשאות נתמכות. אי אפשר להשתמש בתווים כלליים לחיפוש בשמות של הרשאות אחרות בכללי דחייה.
יצירת מערכת גישה מאוחדת לכללי מדיניות (UAP)
אפשר ליצור כללי מדיניות גישה מאוחדת בפרויקט, בתיקייה או בארגון. המשאב שבו אתם יוצרים את ה-UAP הופך להורה של ה-UAP. עם זאת, ל-UAP אין השפעה עד שמחילים אותו.
ההורה של ה-UAP מופיע בשם של ה-UAP. הפורמט של שמות כללי המדיניות הוא RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID, והפלייסהולדרים מייצגים את הפרטים הבאים:
-
RESOURCE_TYPE: סוג המשאב שבו נוצרה ה-UAP. הערך הזה הואprojects,foldersאוorganizations. -
RESOURCE_ID: מזהה המשאב שבו נוצרה ה-UAP. -
POLICY_ID: המזהה האלפאנומרי של ה-UAP.
לדוגמה, אם יוצרים מדיניות UAP בשם example-policy בפרויקט example-project, משאב ההורה של המדיניות הוא example-project ושם המדיניות הוא projects/example-project/locations/global/accessPolicies/example-policy.
איפה יוצרים מערכת גישה מאוחדת לכללי מדיניות (UAP)
ההורה של ה-UAP לא משפיע על המשאבים שאפשר להחיל עליהם את ה-UAP. עם זאת, הוא משפיע על מי שיש לו הרשאה לצפות ב-UAP ולערוך אותו. כדי לוודא שלמשתמשים המתאימים יש הרשאה לצפות ב-UAP המתאימים ולערוך אותם, מומלץ לבחור משאב הורה שמשקף בצורה הטובה ביותר את היקף ה-UAP.
לדוגמה, אם רוצים להחיל מדיניות UAP על הארגון, מומלץ ליצור את מדיניות ה-UAP בארגון.
החלת כללי מדיניות על משאבים
כדי להחיל מדיניות UAP, צריך ליצור קישור. כל קישור מציין מדיניות UAP ומשאב שאליו צריך לקשר את המדיניות. אחרי שיוצרים את הקישור, הכללים ב-UAP נכנסים לתוקף במשאב הזה ובכל הצאצאים שלו.
לדוגמה, נניח שיש לכם את ה-UAP compute-access-management. מדיניות ה-UAP הזו מקצה את התפקיד "עריכת Compute" (roles/compute.editor) לקבוצה compute-users@example.com, ודוחה את ההרשאות של compute.googleapis.com/instances.* לכל המשתמשים חוץ מ-compute-users@example.com.
בלי קישורים, למדיניות ה-UAP הזו אין השפעה.
אתם רוצים שה-UAP הזה יחול על כל המשאבים בארגון example.com, אז אתם יוצרים קישור שמחבר את ה-UAP compute-access-management אל example.com. אחרי שיוצרים את הקישור, ל-UAP יש את ההשפעות הבאות:
- חברים ב-
compute-users@example.comיכולים להשתמש בהרשאות בתפקיד Compute Editor כדי לגשת למשאבים ב-example.com. - כל המשתמשים שלא חברים ב-
compute-users@example.comלא יכולים להשתמש בהרשאות שקשורות למכונה כדי לגשת למשאבים ב-example.com.
משאבים נתמכים
בטבלה הבאה מפורטים המשאבים שאפשר לקשר אליהם כללי מדיניות גישה מאוחדת. כל שורה מכילה את הפרטים הבאים:
- סוג המשאב
- הפורמט של המזהים של אותו משאב
- המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שכולל את הקישורים לאותו סוג משאב
| משאב | מזהה המשאב | משאב ההורה של הקישורים |
|---|---|---|
| פרויקטים במנהל המשאבים | //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
הפרויקט בקישור |
| תיקיות במנהל המשאבים | //cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
התיקייה בקישור |
| ארגונים במנהל המשאבים | //cloudresourcemanager.googleapis.com/organizations/ORG_ID |
הארגון בקישור |
| אפליקציות AI ב-Agent Registry | //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID |
הפרויקט הראשי של האפליקציה |
| Agent Gateways של Network Services API | //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID |
הפרויקט הראשי של השער |
השבתת יצירת קישורים
אם אתם רוצים להשבית את היצירה של קישורים בארגון, אתם יכולים לאכוף את אילוץ מדיניות הארגון iam.managed.disableAccessPolicyBinding בארגון. האילוץ הזה מונע מחשבונות משתמשים בארגון ליצור קישורים לכללי מדיניות גישה מאוחדת.
כדי ללמוד איך להפעיל או להשבית את האילוץ הזה, ראו שימוש באילוצים מנוהלים בכלל מדיניות של הארגון.
ירושה של מדיניות
אם מקשרים מדיניות UAP לפרויקט, לתיקייה או לארגון, מדיניות ה-UAP עוברת בירושה דרך היררכיית המשאבים.
היררכיית המשאבים מורכבת מהארגון (הרמה הבסיסית) בחלק העליון, ואחריו תיקיות (אופציונלי) לקיבוץ, ואז פרויקטים שמכילים משאבים ספציפיים לשירות, כמו מכונות וירטואליות של Compute Engine וקטגוריות של Cloud Storage.
בהיררכיה הזו, פרויקטים, תיקיות וארגונים הם משאבי הורה. במילים אחרות, אלה משאבים שמכילים משאבים אחרים:
- הפרויקטים מכילים משאבים ספציפיים לשירות.
- תיקיות מכילות תיקיות אחרות, פרויקטים ואת המשאבים של הפרויקטים.
- ארגונים מכילים תיקיות, פרויקטים ואת המשאבים של הפרויקטים.
המשאבים שכלולים במשאב הורה הם הצאצאים של אותו משאב.
כשמקשרים UAP למשאב הורה, ה-UAP חלה על משאב ההורה וגם על כל הצאצאים של המשאב הזה. במילים אחרות, ה-UAP עוברת בירושה לצאצאים של המשאב.
ירושת מדיניות מאפשרת להחיל כללי מדיניות על קבוצות גדולות של משאבים באמצעות קישור יחיד. לדוגמה, נניח שאתם יוצרים מדיניות UAP שנותנת ל-taylor@example.com את התפקיד "אדמין של Compute Engine" (roles/compute.admin), ומונעת מ-noam@example.com את ההרשאה compute.googleapis.com/instances.delete.
אתם רוצים שה-UAP הזה יחול על כל המשאבים בארגון, example.com. כדי לעשות את זה, אתם צריכים לקשר את ה-UAP הזה למשאב של הארגון. אחרי שמקשרים את ה-UAP לארגון, ה-UAP עובר בירושה לכל המשאבים בארגון.
לקישור של ה-UAP לארגון יש את ההשפעות הבאות:
-
taylor@example.comיכול להשתמש בהרשאות של התפקיד "אדמין ב-Compute Engine" כדי לגשת לכל משאב ב-example.com. -
noam@example.comלא יכול להשתמש בהרשאהcompute.googleapis.com/instances.deleteבאף משאב ב-example.com, גם אם מדיניות ה-UAP במשאב צאצא נותנת לו גישה.
אם רוצים שה-UAP יחול על פחות משאבים, אפשר לקשר אותו לרמה נמוכה יותר בהיררכיית המשאבים – לדוגמה, לפרויקט או למשאב ספציפי לשירות נתמך.
קישורים בין ארגונים שונים
אי אפשר ליצור קישור בין ארגונים ל-UAP. קישור בין ארגונים הוא קישור שמחבר בין מדיניות UAP בארגון אחד למשאב בארגון אחר.
מערכת IAM מוחקת מדי פעם את הקישורים הקיימים בין הארגונים. קישורים בין ארגונים יכולים להתרחש כשמעבירים פרויקט מארגון אחד לאחר. נניח, לדוגמה, את הדברים הבאים:
- יש לכם פרויקט בשם
example-projectבארגוןexample.com. - אתם יוצרים UAP בפרויקט
example-projectומקשרים אותו ל-example-project. - העברת את
example-projectמ-example.comאלcymbalgroup.com.
במצב כזה, העברת הפרויקט יוצרת קישור בין ארגונים. הסיבה לכך היא שה-UAP ב-example.com מקושר למשאב ב-cymbalgroup.com. אם לא תמחקו את הקישור באופן ידני, בסופו של דבר IAM ימחק אותו באופן אוטומטי. מחיקת הקישור הזה עוזרת לוודא שלאדמינים ב-cymbalgroup.com יש גישה לכל כללי ה-UAP שמקושרים למשאבים בארגון שלהם.
קישורים למערכות גישה מאוחדת לכללי מדיניות (UAP) שנמחקו
בדרך כלל, צריך למחוק את הקישורים של ה-UAP לפני שמוחקים את ה-UAP. אם תנסו למחוק UAP עם קישורים קיימים, תופיע הודעת שגיאה.
עם זאת, אם רוצים למחוק UAP בלי למחוק את הקישורים הקיימים, אפשר למחוק את ה-UAP באופן ידני.
מחיקה כפויה של UAP מסירה אותו מכל המשאבים שהוא מקושר אליהם. כל הקישורים שמפנים ל-UAP יימחקו בסופו של דבר. עם זאת, עד שהם נמחקים, הקישורים עדיין נכללים במגבלה על מספר הקישורים שיכולים להתייחס למשאב יחיד.
תנאים במערכת גישה מאוחדת לכללי מדיניות (UAP)
תנאי IAM מאפשרים להגדיר ולאכוף בקרת גישה מותנית למשאבים ב- Google Cloud , על סמך מאפיינים. במדיניות UAP, אפשר להוסיף תנאים לכללים ספציפיים כדי לקבוע מתי הכלל יחול. אי אפשר להוסיף תנאים לקישורי UAP.
התנאים מורכבים משם, תיאור וביטוי בוליאני. אם הערך של הביטוי הוא true, הכלל חל על הבקשה. אם הערך הוא false, הכלל לא חל על הבקשה.
בשירותים שונים יש מאפיינים ופונקציות שונים שבהם אפשר להשתמש כדי לכתוב ביטויי תנאים. כשמוסיפים תנאים לכלל, תמיד צריך להוסיף לפני התנאי את שם השירות שאתם משתמשים במאפיינים ובפונקציות שלו. אפשר להוסיף כמה תנאים לכלל, אבל תנאי אחד לא יכול לכלול מאפיינים משירותים שונים.
לדוגמה, אם מוסיפים תנאי שמשתמש במאפיין שסופק על ידי IAM, מוסיפים את הקידומת iam.googleapis.com לתנאי:
"conditions": {
"iam.googleapis.com": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
במאמר יצירה והחלה של כללי UAP מוסבר איך יוצרים כללי UAP עם תנאים.
הרשאות רלוונטיות למאפייני תנאים
חלק מהמאפיינים הספציפיים לשירות חלים רק על בקשות שכוללות הרשאות מסוימות. לדוגמה, המאפיין eventarc.googleapis.com message.id חל רק על בקשות שדורשות את ההרשאה eventarc.googleapis.com/messageBuses.publish.
אפשר להשתמש במאפיינים האלה רק בכללים שכוללים את ההרשאה הרלוונטית. אם תנסו להשתמש במאפיין בכלל בלי ההרשאה הרלוונטית, יצירת ה-UAP תיכשל.
מאפייני תנאים נתמכים
אפשר להשתמש במאפיינים הבאים בכללי UAP:
| שירות | מאפיין | ההרשאות הרלוונטיות | מידע נוסף |
|---|---|---|---|
iam.googleapis.com (גרסת טרום-השקה (Preview)) |
תגי משאבים | הכול | מאפיין תגי המשאבים |
eventarc.googleapis.com (גרסת טרום-השקה (Preview)) |
Messages | eventarc.googleapis.com/messageBuses.publish |
מאפייני הודעות ב-Eventarc |
iap.googleapis.com (GA) |
יעדים | iap.googleapis.com/resources.egressViaIAP |
מאפייני יעדים של שרת proxy לאימות זהויות (IAP) |