בדף הזה מוסבר איך להשתמש באילוצים בהתאמה אישית של שירות מדיניות הארגון כדי להגביל פעולות ספציפיות במשאבי Cloud de Confiance by S3NS הבאים:
iam.googleapis.com/AllowPolicy
מידע נוסף על מדיניות הארגון בהתאמה אישית
מידע על כללי מדיניות ואילוצים של הארגון
Cloud de Confiance שירות מדיניות הארגון נותן לכם שליטה מרוכזת ופרוגרמטית על המשאבים של הארגון. אדמינים של מדיניות הארגון יכולים להגדיר את מדיניות הארגון, שהיא קבוצה של הגבלות שנקראות אילוצים. האילוצים חלים על משאביCloud de Confiance ועל הצאצאים של המשאבים האלה בCloud de Confiance by S3NS היררכיית המשאבים. אפשר לאכוף את מדיניות הארגון ברמת הארגון, התיקייה או הפרויקט.
מדיניות הארגון מספקת אילוצים מנוהלים מובְנים לשירותים שונים של Cloud de Confiance . עם זאת, אם אתם רוצים שליטה מפורטת יותר וניתנת להתאמה אישית על השדות הספציפיים שמוגבלים במדיניות הארגון, אתם יכולים גם ליצור אילוצים בהתאמה אישית ולהשתמש בהם במדיניות הארגון.
ירושה של מדיניות
כברירת מחדל, מדיניות הארגון עוברת בירושה לצאצאים של המשאבים שעליהם אתם אוכפים את המדיניות. לדוגמה, אם אוכפים מדיניות בתיקייה, Cloud de Confiance אוכף את המדיניות בכל הפרויקטים שבתיקייה. למידע נוסף על ההתנהגות הזו ואיך לשנות אותה, קראו את המאמר כללי הערכה של היררכיה.
יתרונות
אתם יכולים להשתמש במדיניות ארגונית מותאמת אישית שמפנה למאפייני IAM, כדי לקבוע איך אפשר לשנות את מדיניות ההרשאות. באופן ספציפי, אתם יכולים לשלוט באפשרויות הבאות:
- למי אפשר להקצות תפקידים
- למי אפשר לבטל את התפקיד
- אילו תפקידים אפשר להקצות
- אילו תפקידים אפשר לבטל
לדוגמה, אתם יכולים למנוע הקצאה של תפקידים שמכילים את המילה admin לחשבונות משתמשים שכתובות האימייל שלהם מסתיימות ב-@gmail.com.
מגבלות
יש כמה מגבלות על כללי מדיניות בהתאמה אישית של הארגון במצב פרימטר לבדיקות, שמפנים למאפייני IAM. כלומר, יכול להיות שביומני הביקורת של הפרות שקשורות ל-method
setIamPolicyלא יופיעו השדות הבאים:resourceNameserviceNamemethodName
לא נוצרים יומני ביקורת לכל הפרות המדיניות של הארגון בהתאמה אישית שקשורות ל-IAM. כלומר, אם מדיניות ארגונית מותאמת אישית גורמת לפעולת
setIamPolicyבמשאב הארגון להיכשל, לא נוצר ב-Cloud de Confiance יומן ביקורת לאירוע הזה.מדיניות ארגונית בהתאמה אישית שמפנה למאפייני IAM לא משפיעה על:
- הרשאות שמוגדרות כברירת מחדל על ידי רשימות ACL של Cloud Storage.
- הקצאת תפקידים אוטומטית לערכי הנוחות של Cloud Storage ולגישה למערך הנתונים שמוגדר כברירת מחדל ב-BigQuery.
- תפקידים שניתנו על ידי מדיניות הרשאות שמוגדרת כברירת מחדל – לדוגמה, יוצר הפרויקט מקבל באופן אוטומטי את התפקיד "בעלים" (
roles/owner) בפרויקט.
אפשר לשלוח למשתמשים הזמנות להפוך לבעלים, גם אם יש לכם מדיניות ארגונית בהתאמה אישית שמונעת את הקצאת התפקיד "בעלים" (
roles/owner). עם זאת, מדיניות הארגון בהתאמה אישית לא מונעת שליחת הזמנה, אבל היא מונעת ממשתמשים שהוזמנו לקבל את התפקיד "בעלים". אם משתמשים שהוזמנו ינסו לאשר את ההזמנה, תוצג להם הודעת שגיאה והם לא יקבלו את תפקיד הבעלים.פעולות מסוימות ב- Cloud de Confiance, כמו יצירת משאבים או הפעלת ממשקי API, כוללות הקצאה אוטומטית של תפקיד לסוכן שירות או לחשבון שירות שמוגדר כברירת מחדל. אם פעולה כוללת הקצאה אוטומטית של תפקיד, ומדיניות הארגון מונעת את הקצאת התפקיד, יכול להיות שכל הפעולה תיכשל.
אם נתקלתם בבעיה הזו, אתם יכולים להשתמש בתגים כדי להשבית באופן זמני את המגבלה שמונעת את הקצאת התפקיד. לאחר מכן, מבצעים את הפעולה. אחרי שהפעולה מסתיימת, מפעילים מחדש את האילוץ.
לפני שמתחילים
-
אם אתם רוצים לבדוק כללי מדיניות מותאמים אישית של הארגון שמפנים למשאבי IAM, צרו פרויקט חדש. בדיקה של כללי מדיניות הארגון האלה בפרויקט קיים עלולה לשבש את תהליכי העבודה של האבטחה.
-
נכנסים לדף לבחירת הפרויקט במסוף Cloud de Confiance .
-
בוחרים או יוצרים פרויקט ב- Cloud de Confiance .
התפקידים שנדרשים כדי לבחור או ליצור פרויקט
- בחירת פרויקט: כדי לבחור פרויקט לא נדרש תפקיד IAM ספציפי – אתם יכולים לבחור כל פרויקט שקיבלתם בו תפקיד.
-
יצירת פרויקט: כדי ליצור פרויקט, צריך את התפקיד "יצירת פרויקטים" (
roles/resourcemanager.projectCreator), שכולל את ההרשאהresourcemanager.projects.create. איך מקצים תפקידים?
-
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול מדיניות הארגון, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM:
- Organization Policy Administrator (
roles/orgpolicy.policyAdmin) בארגון -
כדי לבדוק את כללי מדיניות הארגון שמתוארים בדף הזה: אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) בפרויקט
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות לניהול מדיניות הארגון. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לנהל את מדיניות הארגון, נדרשות ההרשאות הבאות:
-
orgpolicy.*בארגון -
בודקים את כללי מדיניות הארגון שמתוארים בדף הזה:
resourcemanager.projects.setIamPolicyבפרויקט
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
משאבים שנתמכים בניהול זהויות והרשאות גישה (IAM)
IAM תומך במשאב AllowPolicy. למשאב הזה יש את המאפיין resources.bindings, שמוחזר לכל השיטות שמשנות את מדיניות ההרשאות של המשאב. כל ה-methods שמשנות את מדיניות ההרשאות של המשאב מסתיימות ב-setIamPolicy.
למאפיין resource.bindings יש את המבנה הבא, כאשר BINDINGS הוא מערך של קישורי תפקידים ששונו במהלך שינוי של מדיניות הרשאה:
{
"bindings": {
BINDINGS
}
}
לכל קישור ב-resource.bindings יש את המבנה הבא, שבו ROLE הוא שם התפקיד בקישור התפקידים ו-MEMBERS הוא רשימה של מזהים לכל חשבונות המשתמשים שנוספו לקישור התפקידים או הוסרו ממנו:
{
"role": "ROLE"
"members": {
MEMBERS
}
}
כדי לראות את הפורמטים של מזהי חשבונות המשתמשים, קראו את המאמר מזהים של חשבונות משתמשים.
אפשר להעריך את המאפיין resource.bindings והשדות שלו רק באמצעות הפונקציות הנתמכות. אין תמיכה באופרטורים ובפונקציות אחרים, כמו ==, !=, in, contains, startsWith ו-endsWith.
פונקציות נתמכות
אתם יכולים להשתמש בפונקציות הבאות של CEL כדי להעריך תפקידים וחברים ספציפיים בקישור.
כדי להעריך את כל הקישורים במערך bindings או את כל החברים במערך members, משתמשים בפקודות המאקרו all ו-exists. למידע נוסף, אפשר לעיין בקטע פקודות מאקרו להערכת רשימות שבדף הזה.
אפשר גם להשתמש באופרטורים הלוגיים && (and) ו-|| (or) כדי לכתוב תנאים עם כמה חלקים.
| תפקיד | תיאור |
|---|---|
RoleNameMatches(
bool
|
הפונקציה מחזירה
|
RoleNameStartsWith(
bool
|
הפונקציה מחזירה את הערך
|
RoleNameEndsWith(
bool
|
הפונקציה מחזירה את הערך
|
RoleNameContains(
bool
|
הפונקציה מחזירה
|
MemberSubjectMatches(
bool
|
הפונקציה מחזירה את הערך
אם המזהה של
|
MemberSubjectStartsWith(
bool
|
הפונקציה מחזירה את הערך
אם המזהה של
|
MemberSubjectEndsWith(
bool
|
הפונקציה מחזירה את הערך
אם המזהה של
|
MemberInPrincipalSet(
bool
|
הפונקציה מחזירה
|
MemberTypeMatches(
bool
|
הפונקציה מחזירה את הערך
|
פקודות מאקרו להערכת רשימות
משתמשים בפקודות המאקרו all ו-exists כדי להעריך ביטוי תנאי לרשימת פריטים.
| מאקרו | תיאור |
|---|---|
list.all(
bool
|
הפונקציה מחזירה
בדרך כלל משתמשים בפקודת המאקרו הזו למדיניות ארגונית בהתאמה אישית עם
|
list.exists(
bool
|
הפונקציה מחזירה
בדרך כלל משתמשים בפקודת המאקרו הזו למדיניות ארגונית בהתאמה אישית עם
|
תנאים עם רשימות בתצוגת עץ
באופן כללי, אם התנאי כולל רשימות בתצוגת עץ, צריך להשתמש באותו מאקרו לכל הרשימות בתנאי.
מומלץ להביא בחשבון את הדוגמאות הבאות:
- אם המדיניות כוללת את
actionTypeALLOW, צריך להשתמש בפקודת המאקרוallגם ברשימהmembersוגם ברשימהbindingsכדי לוודא שהשינויים במדיניות מותרים רק אם כל החברים בכל הקישורים ששונו עומדים בתנאי. - אם המדיניות כוללת את
actionTypeDENY, צריך להשתמש בפקודת המאקרוexistsגם ברשימהmembersוגם ברשימהbindingsכדי לוודא שלא ניתן לשנות את המדיניות אם כל חבר בכל קישור ששונה עומד בתנאי.
אם תשלבו פקודות מאקרו בתנאי אחד, יכול להיות שהתנאי לא יפעל כמו שאתם רוצים.
לדוגמה, נניח שאתם רוצים למנוע הקצאת תפקידים לחברים מחוץ לארגון example.com. מזהה הארגון example.com הוא 123456789012.
כדי להשיג את המטרה הזו, אתם כותבים את התנאי הבא:
לא מומלץ – תנאי שהוגדר באופן שגוי
"resource.bindings.all(
binding,
binding.members.exists(member,
MemberInPrincipalSet(member, ['//cloudresourcemanager.googleapis.com/organizations/123456789012'])
)
)"
נראה שהתנאי הזה מונע הקצאת תפקידים לחברים מחוץ לארגון example.com. עם זאת, התנאי מקבל את הערך true אם כל חבר בכל אחד מקישורי התפקידים ששונו נמצא בארגון example.com. כתוצאה מכך, עדיין תוכלו להקצות תפקידים לחברים מחוץ לארגון example.com אם תקצו את אותו תפקיד גם לחבר בארגון example.com.
לדוגמה, התנאי מקבל את הערך true עבור קבוצת הקישורים הבאה, למרות שאחד מהחברים לא נמצא בארגון example.com:
"bindings": [ { "members": [ "principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/raha@altostrat.com", "principal://iam.googleapis.com/locations/global/workforcePools/example-pool/subject/jie@example.com" ], "role": "roles/resourcemanager.projectCreator" } ],
במקום זאת, צריך לכתוב תנאי כמו זה:
מומלץ – תנאי שהוגדר בצורה נכונה
"resource.bindings.all(
binding,
binding.members.all(member,
MemberInPrincipalSet(member, ['//cloudresourcemanager.googleapis.com/organizations/123456789012'])
)
)"
שימוש בפקודת המאקרו all גם במערך members.bindings וגם במערך resource.bindings מבטיח שהתנאי יקבל את הערך true רק אם כל החברים בכל הקישורים נמצאים בקבוצת החשבונות הראשיים example.com.
סוגי חשבונות המשתמשים שנתמכים ב-MemberTypeMatches
בפונקציה MemberTypeMatches צריך לציין לאיזה סוג של חשבון משתמש החבר שצוין חייב להתאים.
בטבלה הבאה מפורטים סוגי חשבונות המשתמשים שאפשר להזין, ותיאור של מה שסוג חשבון המשתמש מייצג. בנוסף, מפורטים בה המזהים שתואמים לכל סוג חשבון משתמש. המזהים האלה הם הערכים שבהם משתמשים בכללי מדיניות IAM.
| סוג חשבון המשתמש | תיאור | מזהים של חשבונות משתמשים |
|---|---|---|
iam.googleapis.com/ |
חשבון Google פרטי. כתובות האימייל של החשבונות האלה בדרך כלל מסתיימות ב-gmail.com.
|
user:USER_EMAIL_ADDRESS |
iam.googleapis.com/ |
חשבון Google שהוא חלק מחשבון Cloud Identity או Google Workspace. החשבונות האלה נקראים גם חשבונות משתמשים מנוהלים. | user:USER_EMAIL_ADDRESS |
iam.googleapis.com/ |
קבוצה ב-Google שנוצרה על ידי חשבון Google פרטי. הקבוצות האלה לא בבעלות של חשבון Cloud Identity או Google Workspace. כתובות האימייל של הקבוצות האלה בדרך כלל מסתיימות ב-googlegroups.com.
|
group:GROUP_EMAIL_ADDRESS |
iam.googleapis.com/ |
קבוצה ב-Google שבבעלות חשבון Cloud Identity או Google Workspace. | group:GROUP_EMAIL_ADDRESS |
iam.googleapis.com/ |
חשבון Cloud Identity או Google Workspace. | domain:DOMAIN |
iam.googleapis.com/ |
חשבון משתמש יחיד במאגר זהויות של כוח עבודה. | principal://iam.googleapis.com/ |
iam.googleapis.com/ |
קבוצת חשבונות משתמשים שמכילה קבוצה של זהויות במאגר זהויות של כוח עבודה. לדוגמה, קבוצת חשבונות משתמשים שכוללת את כל החשבונות במאגר זהויות של כוח עבודה. |
|
iam.googleapis.com/ |
זהות יחידה במאגר זהויות של עומסי עבודה | principal://iam.googleapis.com/projects/ |
iam.googleapis.com/ |
קבוצת חשבונות משתמשים שמכילה קבוצה של זהויות במאגר זהויות של עומסי עבודה. לדוגמה, קבוצת חשבונות משתמשים שכוללת את כל החשבונות במאגר זהויות של עומסי עבודה. |
|
iam.googleapis.com/ |
כל חשבון שירות. חשבון שירות הוא סוג מיוחד של חשבון שמייצג עומס עבודה ולא משתמש אנושי.
בהקשר של הפונקציה |
serviceAccount:SERVICE_ACCOUNT_EMAIL_ADDRESS |
iam.googleapis.com/ |
כל סוכן שירות. סוכן שירות הוא סוג מיוחד של חשבון שירות שנוצר ומנוהל על ידי Cloud de Confiance . כשמקצים תפקידים לסוכני שירות בפרויקטים, הם מאפשרים לשירותי Cloud de Confiance לבצע פעולות בשמכם. | serviceAccount:SERVICE_AGENT_EMAIL_ADDRESS |
iam.googleapis.com/ |
חשבונות המשתמשים allUsers ו-allAuthenticatedUsers.
|
|
iam.googleapis.com/ |
חשבונות משתמשים שמוגדרים על סמך התפקיד שניתן להם. חשבונות המשתמשים האלה נקראים גם ערכי נוחות. |
|
iam.googleapis.com/ |
משאב עם זהות מובנית. | כל אחד ממזהי חשבונות המשתמשים שמפורטים בקטע מזהים של חשבונות משתמשים למשאבים בודדים. |
iam.googleapis.com/ |
משאבים עם זהויות מובנות שחולקים מאפיינים מסוימים, כמו סוג או ישות אב. | כל אחד מהמזהים שמפורטים בקטע מזהים של חשבונות משתמשים לקבוצות של משאבים. |
iam.googleapis.com/AgenticIdentityPoolPrincipal |
זהות סוכן אחת. |
|
iam.googleapis.com/AgenticIdentityPoolPrincipalSet |
קבוצת חשבונות שכוללת קבוצה של זהויות של סוכנים. |
לדוגמה: |
הגדרת אילוץ בהתאמה אישית
אילוץ בהתאמה אישית מוגדר בקובץ YAML לפי המשאבים, השיטות, התנאים והפעולות שנתמכים בשירות שבו אתם אוכפים את מדיניות הארגון. התנאים של האילוצים המותאמים אישית מוגדרים באמצעות Common Expression Language (CEL). בקטע CEL במאמר יצירה וניהול של אילוצים בהתאמה אישית מוסבר איך ליצור תנאים באילוצים בהתאמה אישית באמצעות CEL.
המסוף
כדי ליצור אילוץ בהתאמה אישית:
- במסוף Cloud de Confiance , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- לוחצים על Custom constraint.
- בתיבה Display name, מזינים שם לאילוץ שיהיה קריא לאנשים. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע רגיש בשמות לתצוגה, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
-
בתיבה Constraint ID, מזינים את המזהה שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה
custom.denyProjectIAMAdmin. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. - בתיבה Description, מזינים תיאור קריא לאנשים של האילוץ. התיאור הזה משמש כהודעת שגיאה כשיש הפרה של המדיניות. ציינו פרטים על הסיבה להפרת המדיניות ואיך לפתור את הבעיה. אל תכללו פרטים אישיים מזהים או מידע רגיש בתיאור, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
-
בתיבה Resource type, בוחרים את השם של משאב ה- Cloud de Confiance REST שמכיל את האובייקט והשדה שרוצים להגביל, לדוגמה
container.googleapis.com/Cluster. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
בקטע Enforcement method, בוחרים אם לאכוף את האילוץ על שיטת REST
CREATEאו על השיטותCREATEו-UPDATE. אם אוכפים את האילוץ באמצעות השיטהUPDATEבמשאב שמפר את האילוץ, מדיניות הארגון חוסמת את השינויים במשאב הזה, אלא אם השינוי פותר את ההפרה. - כדי להגדיר תנאי, לוחצים על עריכת התנאי.
-
בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, לדוגמה
resource.management.autoUpgrade == false. השדה הזה יכול להכיל עד 1,000 תווים. לפרטים על השימוש ב-CEL, קראו את המאמר Common Expression Language. מידע נוסף על משאבי השירות שבהם אפשר להשתמש באילוצים המותאמים אישית מופיע במאמר שירותים שנתמכים באילוצים מותאמים אישית. - לוחצים על Save.
- בקטע Action, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.
- לוחצים על Create constraint.
כדי לראות את השיטות הנתמכות לכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
פעולת הדחייה פירושה שהפעולה ליצירה או לעדכון של המשאב נחסמת אם התנאי מקבל את הערך true.
פעולת ההרשאה מאפשרת ליצור או לעדכן את המשאב רק אם התנאי מתקיים. כל מקרה אחר, מלבד אלה שרשומים במפורש בתנאי, נחסם.
אחרי שמזינים ערך בכל שדה, הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה מופיעה בצד שמאל.
gcloud
- כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא:
-
ORGANIZATION_ID: מזהה הארגון, למשל123456789. -
CONSTRAINT_NAME: השם שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה,custom.denyProjectIAMAdmin. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים (PII) או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. -
RESOURCE_NAME: השם המלא של המשאב ב- Cloud de Confianceשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה,iam.googleapis.com/AllowPolicy. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
methodTypes: שיטות ה-REST שעליהן נאכף האילוץ. יכול להיותCREATEאו גםCREATEוגםUPDATE. אם אוכפים את האילוץ באמצעות השיטהUPDATEבמשאב שמפר את האילוץ, מדיניות הארגון חוסמת את השינויים במשאב הזה, אלא אם השינוי פותר את ההפרה. -
CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,000 תווים. לדוגמה,.resource.bindings.exists(binding, RoleNameMatches(binding.role, ['roles/resourcemanager.projectIamAdmin'])) -
ACTION: הפעולה שצריך לבצע אם התנאיconditionמתקיים. הערכים האפשריים הםALLOWו-DENY. -
DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים. -
DESCRIPTION: תיאור ידידותי למשתמש של האילוץ, שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. השדה הזה יכול להכיל עד 2,000 תווים. -
אחרי שיוצרים את קובץ ה-YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה
gcloud org-policies set-custom-constraint: -
כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה
gcloud org-policies list-custom-constraints:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE
- UPDATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
מחליפים את מה שכתוב בשדות הבאים:
כדי לראות את השיטות הנתמכות בכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
למידע נוסף על המשאבים הזמינים לכתיבת תנאים, ראו משאבים נתמכים.
הפעולה allow פירושה שאם התנאי מקבל את הערך true, מותר ליצור או לעדכן את המשאב. זה גם אומר שכל מקרה אחר, מלבד המקרה שמופיע במפורש בתנאי, חסום.
פעולת הדחייה פירושה שאם התנאי מקבל את הערך True, הפעולה ליצירה או לעדכון של המשאב נחסמת.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוץ בהתאמה אישית. לדוגמה, /home/user/customconstraint.yaml.
בסיום הפעולה, האילוצים המותאמים אישית יהיו זמינים כמדיניות של הארגון ברשימת Cloud de Confiance by S3NS כללי המדיניות של הארגון.
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
מחליפים את ORGANIZATION_ID במזהה של משאב הארגון.
למידע נוסף, קראו את המאמר הצגת מדיניות הארגון.
אכיפה של מדיניות ארגונית בהתאמה אישית
כדי לאכוף אילוץ, אתם יכולים ליצור מדיניות ארגון שמפנה אליו, ואז להחיל את מדיניות הארגון על משאב ב- Cloud de Confiance by S3NS .המסוף
- במסוף Cloud de Confiance , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- ברשימה שבדף מדיניות הארגון, בוחרים את האילוץ כדי להציג את הדף Policy details של אותו אילוץ.
- כדי להגדיר את מדיניות הארגון למשאב הזה, לוחצים על ניהול המדיניות.
- בדף עריכת המדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
- לוחצים על Add a rule.
- בקטע Enforcement, בוחרים אם לאכוף את מדיניות הארגון הזו או לא.
- אופציונלי: כדי להוסיף תנאי למדיניות הארגון על סמך תג, לוחצים על Add condition. שימו לב: אם מוסיפים כלל מותנה למדיניות הארגון, צריך להוסיף לפחות כלל אחד לא מותנה, אחרת אי אפשר לשמור את המדיניות. מידע נוסף מופיע במאמר הגדרת ההיקף של מדיניות הארגון באמצעות תגים.
- כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, לוחצים על הגדרת המדיניות להרצת בדיקה. למידע נוסף, קראו את המאמר בדיקת כללי מדיניות של הארגון.
- אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמו שצריך, לוחצים על Set policy כדי להגדיר את המדיניות הפעילה.
gcloud
- כדי ליצור מדיניות ארגונית עם כללים בוליאניים, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ:
-
PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ. -
CONSTRAINT_NAME: השם שהגדרתם לאילוץ המותאם אישית. לדוגמה,custom.denyProjectIAMAdmin. -
כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, מריצים את הפקודה הבאה עם הדגל
dryRunSpec: -
אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמצופה, מגדירים את המדיניות הפעילה באמצעות הפקודה
org-policies set-policyוהדגלspec:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true dryRunSpec: rules: - enforce: true
מחליפים את מה שכתוב בשדות הבאים:
gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
gcloud org-policies set-policy POLICY_PATH --update-mask=spec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
בדיקת מדיניות הארגון בהתאמה אישית
אפשר גם לבדוק את מדיניות הארגון: מגדירים את המדיניות ואז מנסים לבצע פעולה שהמדיניות אמורה למנוע.
יצירת האילוץ
שומרים את הקובץ הבא בשם
constraint-deny-project-iam-admin.name: organizations/ORG_ID/customConstraints/custom.denyProjectIAMAdmin resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.exists( binding, RoleNameMatches(binding.role, ['roles/resourcemanager.projectIamAdmin']) && binding.members.exists(member, MemberSubjectMatches(member, ['user:EMAIL_ADDRESS']) ) )" actionType: DENY displayName: Do not allow EMAIL_ADDRESS to be granted the Project IAM Admin role.מחליפים את הערכים הבאים:
-
ORG_ID: המזהה המספרי של הארגון ב-Cloud de Confiance . -
MEMBER_EMAIL_ADDRESS: כתובת האימייל של חשבון המשתמש שבו רוצים להשתמש כדי לבדוק את האילוץ המותאם אישית. כל עוד האילוץ פעיל, אי אפשר להקצות לחשבון המשתמש הזה את התפקיד "אדמין IAM בפרויקט" (roles/resourcemanager.projectIamAdmin) בפרויקט שבו אוכפים את האילוץ.
-
מחילים את האילוץ:
gcloud org-policies set-custom-constraint ~/constraint-deny-project-iam-admin.yamlמוודאים שהאילוץ קיים:
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
יצירת המדיניות
שומרים את הקובץ הבא בשם
policy-deny-project-iam-admin.yaml:name: projects/PROJECT_ID/policies/custom.denyProjectIamAdmin spec: rules: - enforce: trueמחליפים את
PROJECT_IDבמזהה הפרויקט.מחילים את המדיניות:
gcloud org-policies set-policy ~/policy-deny-project-iam-admin.yamlמוודאים שהמדיניות קיימת:
gcloud org-policies list --project=PROJECT_ID
אחרי שמחילים את המדיניות, מחכים כשתי דקות עד ש- Cloud de Confiance יתחיל לאכוף אותה.
בדיקת המדיניות
נסו להקצות את התפקיד "אדמין IAM בפרויקט" (roles/resourcemanager.projectIamAdmin) לחשבון המשתמש שכתובת האימייל שלו נכללה באילוץ המותאם אישית. לפני שמריצים את הפקודה, מחליפים את הערכים הבאים:
-
PROJECT_ID: המזהה של הפרויקט ב- Cloud de Confianceשבו אכפתם את האילוץ -
EMAIL_ADDRESS: כתובת האימייל של חשבון המשתמש שציינתם כשיצרתם את האילוץ של מדיניות הארגון.
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=user:EMAIL_ADDRESS --role=roles/resourcemanager.projectIamAdmin
הפלט שיתקבל:
Operation denied by custom org policies: ["customConstraints/custom.denyProjectIAMAdmin": "EMAIL_ADDRESS can't be granted the Project IAM Admin role."]
דוגמאות למדיניות ארגונית בהתאמה אישית לתרחישים נפוצים
בטבלה הבאה מופיע התחביר של כמה אילוצים בהתאמה אישית לתרחישים נפוצים.
בדוגמאות הבאות נעשה שימוש בפקודות המאקרו all ו-exists של CEL. מידע נוסף על פקודות המאקרו האלה זמין במאמר פקודות מאקרו להערכת רשימות.
| תיאור | תחביר של אילוצים |
|---|---|
| לחסום את האפשרות להקצות תפקיד ספציפי. |
name: organizations/ORG_ID/customConstraints/custom.denyRole resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.exists( binding, RoleNameMatches(binding.role, ['ROLE']) )" actionType: DENY displayName: Do not allow the ROLE role to be granted |
| לאפשר הקצאה של תפקידים ספציפיים בלבד. |
name: organizations/ORG_ID/customConstraints/custom.specificRolesOnly resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.all( binding, RoleNameMatches(binding.role, ['ROLE_1', 'ROLE_2']) )" actionType: ALLOW displayName: Only allow the ROLE_1 role and ROLE_2 role to be granted |
מניעת הקצאה של תפקידים שמתחילים ב-roles/storage..
|
name: organizations/ORG_ID/customConstraints/custom.dontgrantStorageRoles resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.exists( binding, RoleNameStartsWith(binding.role, ['roles/storage.']) )" actionType: DENY displayName: Prevent roles that start with "roles/storage." from being granted |
למנוע ביטול של תפקידים עם admin בשם.
|
name: organizations/ORG_ID/customConstraints/custom.dontRevokeAdminRoles resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - REMOVE_GRANT condition: "resource.bindings.exists( binding, RoleNameContains(binding.role, ['admin']) )" actionType: DENY displayName: Prevent roles with "admin" in their names from being revoked |
| לאפשר רק לחשבונות משתמשים ספציפיים לקבל תפקידים. |
name: organizations/ORG_ID/customConstraints/custom.allowSpecificPrincipals resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.all( binding, binding.members.all(member, MemberSubjectMatches(member, ['user:USER','serviceAccount:SERVICE_ACCOUNT']) ) )" actionType: ALLOW displayName: Only allow roles to be granted to USER and SERVICE_ACCOUNT |
| למנוע ביטול של תפקידים בחשבונות ראשיים ספציפיים. |
name: organizations/ORG_ID/customConstraints/custom.denyRemovalOfSpecificPrincipals resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - REMOVE_GRANT condition: "resource.bindings.exists( binding, binding.members.exists(member, MemberSubjectMatches(member, ['user:USER_1','user:USER_2']) ) )" actionType: DENY displayName: Do not allow roles to be revoked from USER_1 or USER_2 |
למנוע הקצאת תפקידים לחשבונות משתמשים עם כתובות אימייל שמסתיימות ב-@gmail.com.
|
name: organizations/ORG_ID/customConstraints/custom.dontGrantToGmail resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.exists( binding, binding.members.exists(member, MemberSubjectEndsWith(member, ['@gmail.com']) ) )" actionType: DENY displayName: Do not allow members whose email addresses end with "@gmail.com" to be granted roles |
| לאפשר הקצאה של תפקידים ספציפיים בלבד, ורק לחשבונות משתמשים ספציפיים. |
name: organizations/ORG_ID/customConstraints/custom.allowSpecificRolesAndPrincipals resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.all( binding, RoleNameMatches(binding.role, ['ROLE_1', 'ROLE_2']) && binding.members.all(member, MemberSubjectMatches(member, ['serviceAccount:SERVICE_ACCOUNT', 'group:GROUP']) ) )" actionType: ALLOW displayName: Only allow ROLE_1 and ROLE_2 to be granted to SERVICE_ACCOUNT and GROUP |
מונעים את האפשרות להקצות תפקידים ב-Cloud Storage ל-allUsers ול-allAuthenticatedUsers.
|
name: organizations/ORG_ID/customConstraints/custom.denyStorageRolesForPrincipalAllUsers resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.exists( binding, RoleNameStartsWith(binding.role, ['roles/storage.']) && binding.members.exists(member, MemberSubjectMatches(member, ['allUsers', 'allAuthenticatedUsers']) ) )" actionType: DENY displayName: Do not allow storage roles to be granted to allUsers or allAuthenticatedUsers |
| למנוע הקצאת תפקידים לזהויות מחוץ לארגון. |
name: organizations/ORG_ID/customConstraints/custom.allowInternaldentitiesOnly resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.all( binding, binding.members.all(member, MemberInPrincipalSet(member, ['//cloudresourcemanager.googleapis.com/organizations/ORG_ID']) ) )" actionType: ALLOW displayName: Only allow organization members to be granted roles |
| רק חשבונות שירות יכולים לקבל תפקידים. |
name: organizations/ORG_ID/customConstraints/custom.allowServiceAccountsOnly resourceTypes: iam.googleapis.com/AllowPolicy methodTypes: - CREATE - UPDATE condition: "resource.bindings.all( binding, binding.members.all(member, MemberTypeMatches(member, ['iam.googleapis.com/ServiceAccount']) ) )" actionType: ALLOW displayName: Only allow service accounts to be granted roles |
| מניעת הסרה של סוכני שירות בניהול Google מקישורי תפקידים. |
name: organizations/ORG_ID/customConstraints/custom.denyRemovalOfGoogleManagedServiceAgents resource_types: iam.googleapis.com/AllowPolicy method_types: - REMOVE_GRANT condition: |- resource.bindings.all( binding, binding.members.all(member, MemberTypeMatches(member, ['iam.googleapis.com/ServiceAgent']) ) ) action_type: DENY display_name: Deny Removal Of Google-Managed Service Agents description: Restricts the removal of Google-managed service agents from role bindings. Please reach out to your organization admins for if you have any questions. |
כללי מדיניות מותנים של הארגון
אפשר להגדיר מדיניות ארגונית מותנית בהתאמה אישית באמצעות תגים.
לדוגמה, נניח שכתבתם את האילוץ הבא בהתאמה אישית כדי למנוע הקצאה של תפקידים שמתחילים ב-roles/storage.:
name: organizations/ORG_ID/customConstraints/custom.dontgrantStorageRoles
resourceTypes: iam.googleapis.com/AllowPolicy
methodTypes:
- CREATE
- UPDATE
condition:
"resource.bindings.exists(
binding,
RoleNameStartsWith(binding.role, ['roles/storage.'])
)"
actionType: DENY
displayName: Prevent roles that start with "roles/storage." from being granted
כדי לאכוף את האילוץ באופן מותנה, אפשר ליצור מדיניות ארגון כמו זו:
name: organizations/ORG_ID/policies/custom.dontgrantStorageRoles
spec:
rules:
- condition:
expression: "resource.matchTag('ORG_ID/environment', 'dev')"
enforce: true
- enforce: false
מדיניות הארגון הזו מונעת הקצאה של תפקידים שמתחילים ב-roles/storage. לכל משאב שיש לו גם את התג environment=dev.