כללי מדיניות של בקרת גישה לישויות מורשות (PAB) מאפשרים להגביל את המשאבים שקבוצה של חשבונות משתמשים יכולה לגשת אליהם. בדף הזה מוסבר איך לערוך כללי מדיניות קיימים לקביעת גבול הגישה לחשבונות משתמשים (PAB), ואיך לערוך את קישורי המדיניות של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) כדי לשנות את המשתמשים שהמדיניות חלה עליהם.
לפני שמתחילים
מגדירים אימות.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
gcloud
מפעילים את Cloud Shell במסוף Google Cloud .
בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.
REST
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .
סקירה כללית של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
התפקידים שנדרשים כדי לערוך את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי לקבל את ההרשאה שנדרשת לעריכת מדיניות PAB, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (roles/iam.principalAccessBoundaryAdmin) ב-IAM בארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד המוגדר מראש הזה כולל את ההרשאה iam.principalaccessboundarypolicies.update, שנדרשת כדי לערוך את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).
יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.
התפקידים שנדרשים כדי לערוך את הקישורים של מדיניות PAB
ההרשאות שנדרשות כדי לערוך את קישורי המדיניות של כללי מדיניות PAB תלויות בקבוצת החשבונות שמשויכת למדיניות.
כדי לקבל את ההרשאות שדרושות לעריכת קישורי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך לבקש מהאדמין את התפקידים הבאים ב-IAM:
- משתמש בבקרת גישה לישויות מורשות (PAB) (
roles/iam.principalAccessBoundaryUser) בארגון -
עריכת קישורי מדיניות של מדיניות PAB שמקושרת למאגרי זהויות של כוח עבודה:
אדמין של מאגר כוח עבודה ב-IAM (
roles/iam.workforcePoolAdmin) במאגר הזהויות של כוח העבודה הרלוונטי -
עריכת קישורי מדיניות של מדיניות PAB שמקושרת למאגרי זהויות של עומסי עבודה: אדמין של מאגר זהויות של עומסי עבודה ב-IAM (
roles/iam.workloadIdentityPoolAdmin) בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה. -
כדי לקבל את הסטטוס של פעולה ארוכת-טווח לעריכת קישור שמפנה למאגר זהויות של עומסי עבודה:
צפייה בפעולות IAM (
roles/iam.operationViewer) בפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה המטורגט -
עריכת קישורי מדיניות של מדיניות PAB שמקושרת לדומיין ב-Google Workspace:
אדמין IAM של מאגר Workspace (
roles/iam.workspacePoolAdmin) בארגון -
עריכת קישורי המדיניות של מדיניות PAB שמקושרת לקבוצת חשבונות המשתמשים של הפרויקט: אדמין IAM של פרויקט (
roles/resourcemanager.projectIamAdmin) בפרויקט -
כדי לקבל את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה לקבוצת חשבונות המשתמשים של הפרויקט: צפייה בפעולות IAM (
roles/iam.operationViewer) בפרויקט -
עריכת קישורי מדיניות של מדיניות PAB שמקושרת לקבוצת חשבונות המשתמשים של התיקייה: אדמין IAM של תיקיות (
roles/resourcemanager.folderIamAdmin) בתיקייה -
כדי לערוך את קישורי המדיניות של מדיניות PAB שמקושרת לקבוצת חשבונות המשתמשים של הארגון: אדמין ארגוני (
roles/resourcemanager.organizationAdmin) בארגון
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לערוך את קישורי המדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לערוך את קישורי המדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), נדרשות ההרשאות הבאות:
-
iam.principalaccessboundarypolicies.bindבארגון -
עריכת קישורי המדיניות של מדיניות PAB שמקושרת למאגרי זהויות של כוח עבודה:
iam.workforcePools.updatePolicyBindingבמאגר הזהויות של כוח העבודה הרלוונטי -
עריכת קישורי המדיניות של כללי מדיניות PAB שמקושרים למאגרי זהויות של עומסי עבודה:
iam.workloadIdentityPools.updatePolicyBindingבפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה הרלוונטי -
קבלת הסטטוס של פעולה ממושכת לעריכת קישור שמפנה למאגר זהויות של עומסי עבודה:
iam.operations.getבפרויקט שבבעלותו מאגר הזהויות של עומסי העבודה המטורגט -
עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרת לדומיין ב-Google Workspace:
iam.workspacePools.updatePolicyBindingבארגון -
עריכת קישורי המדיניות של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות המשתמשים של הפרויקט:
resourcemanager.projects.updatePolicyBindingבפרויקט -
איך מקבלים את הסטטוס של פעולה ממושכת לעריכת קישור שמפנה לקבוצת חשבונות המשתמשים של הפרויקט:
iam.operations.getבפרויקט -
עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרת לקבוצת חשבונות המשתמשים של התיקייה:
resourcemanager.folders.updatePolicyBindingבתיקייה -
עריכת קישורי מדיניות של מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקשורה לקבוצת חשבונות המשתמשים של הארגון:
resourcemanager.organizations.updatePolicyBindingבארגון
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
עריכת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB)
כדי להוסיף כללים למדיניות PAB, להסיר כללים ממדיניות PAB או לשנות את המטא-נתונים של מדיניות PAB, צריך לערוך את מדיניות ה-PAB.
אפשר לערוך מדיניות PAB באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים לערוך.
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים לערוך.
לוחצים על עריכת המדיניות.
כדי לערוך את הכללים של המדיניות, מבצעים את הפעולות הבאות:
- לוחצים על הכלל שרוצים לערוך.
- עורכים את התיאור של הכלל או את המשאבים שכלולים בו.
- לוחצים על סיום.
כדי למחוק כלל מהמדיניות, לוחצים על Delete בשורה של הכלל.
כדי לערוך את השם המוצג של המדיניות, עורכים את השדה Display name.
כדי לערוך את גרסת האכיפה של המדיניות, לוחצים על הרשימה Enforcement version ובוחרים ערך חדש.
אופציונלי: כדי לבדוק את השינויים במדיניות לקביעת גבול הגישה לחשבונות משתמשים באמצעות סימולטור המדיניות, לוחצים על Test changes. בודקים את תוצאות הסימולציה ומעדכנים את המדיניות לפי הצורך.
למידע נוסף על בדיקת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים באמצעות סימולטור המדיניות, קראו את המאמר סימולטור המדיניות לכללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים.
לוחצים על Save.
gcloud
הפקודה
gcloud iam principal-access-boundary-policies update
מעדכנת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB).
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
PAB_POLICY_ID: המזהה של מדיניות גבול הגישה לחשבונות משתמשים שרוצים לעדכן, לדוגמהexample-policy. -
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
FIELD_TO_UPDATE=UPDATED_VALUE: השדות שרוצים לעדכן והערך המעודכן המתאים.הנה כמה דוגמאות לדגלים שאפשר להשתמש בהם כדי לעדכן את השדות במדיניות:
-
--display-name=DISPLAY_NAME: מחליפים את השם המוצג של המדיניות ב-DISPLAY_NAME. -
--details-enforcement-version=ENFORCEMENT_VERSION: מעדכנים את גרסת האכיפה של המדיניות ל-ENFORCEMENT_VERSION. -
--details-rules=RULES_FILE.json: החלפת הכללים של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) בכללים שבקובץRULES_FILE.json. במאמר יצירת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך ליצור את קובץ הכללים בפורמט הנכון.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--add-details-rules. -
--add-details-rules=RULES_FILE: הוספת הכללים ב-RULES_FILE.jsonלכללים הקיימים של המדיניות. במאמר יצירת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך ליצור את קובץ הכללים בפורמט הנכון.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--details-rules. -
--remove-details-rules=RULES_FILE: הסרת הכללים ב-RULES_FILE.jsonמהכללים הקיימים של המדיניות. במאמר יצירת מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) מוסבר איך ליצור את קובץ הכללים בפורמט הנכון. יוסרו רק כללים שתואמים בדיוק לאחד מהכללים ב-RULES_FILE.json.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--clear-rule-details. -
--clear-details-rules: מחיקת כל הכללים ממדיניות ה-PAB.אם משתמשים בדגל הזה, אי אפשר להשתמש בדגל
--remove-rule-details.
רשימה מלאה של הדגלים שבהם אפשר להשתמש כדי לעדכן מדיניות PAB מופיעה בדף העזרה של הפקודה
gcloud iam principal-access-boundary-policies update. -
-
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam principal-access-boundary-policies update PAB_POLICY_ID \ --organization=ORG_ID --location=global \ --FIELD_TO_UPDATE=UPDATED_VALUE \ --format=FORMAT
Windows (PowerShell)
gcloud iam principal-access-boundary-policies update PAB_POLICY_ID ` --organization=ORG_ID --location=global ` --FIELD_TO_UPDATE=UPDATED_VALUE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam principal-access-boundary-policies update PAB_POLICY_ID ^ --organization=ORG_ID --location=global ^ --FIELD_TO_UPDATE=UPDATED_VALUE ^ --format=FORMAT
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. בסיום הפעולה, התשובה תדפיס את המדיניות המעודכנת לקביעת גבול הגישה לחשבונות משתמשים (PAB).
Request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done.
Updated principalAccessBoundaryPolicy [example-policy].
{
"name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_13364150419245236225",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Updated display name",
"createTime": "2024-05-07T00:05:48.295209Z",
"updateTime": "2024-05-10T20:50:09.200421Z",
"details": [
"rules": {
[
"description": "Make principals eligible to access example.com"
"resources": {
"//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"effect": ALLOW
]
},
"enforcementVersion": "1"
]
}
REST
השיטה principalAccessBoundaryPolicies.patch מעדכנת מדיניות קיימת לקביעת גבול הגישה לחשבונות משתמשים (PAB).
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
ORG_ID: המזהה של הארגון שבבעלותו המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מזהי ארגונים הם מספרים, למשל123456789012. -
PAB_POLICY_ID: המזהה של מדיניות גבול הגישה לחשבונות משתמשים שרוצים לעדכן, לדוגמהexample-policy. -
FIELDS_TO_UPDATE: רשימה מופרדת בפסיקים של השדות שרוצים לעדכן. אם לא תציינו את השדות שצריך לעדכן, IAM יחליף את המדיניות הקיימת בתוכן של גוף הבקשה.הערכים הקבילים הם
displayName,details,details.rules,details.rules.description,details.rules.resources,details.rules.effectו-details.enforcementVersion. -
DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), לדוגמהExample policy. השם המוצג יכול להכיל עד 63 תווים. -
PAB_RULES: רשימה של כללי בקרת גישה לישויות מורשות, שמגדירים את המשאבים שהישויות המושפעות יכולות לגשת אליהם. מדיניות PAB יכולה לכלול עד 500 כללים. כל כלל הוא בפורמט הבא:{ "description": "DESCRIPTION", "resources": [ RESOURCES ], "effect": "ALLOW" }
מחליפים את הערכים הבאים:
-
DESCRIPTION: אופציונלי. תיאור כלל המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). התיאור יכול להכיל עד 256 תווים. -
RESOURCES: רשימה של משאבים ב-Resource Manager (פרויקטים, תיקיות וארגונים) שאתם רוצים שלחשבונות המשתמשים תהיה גישה אליהם. כל חשבון משתמש שכפוף למדיניות הזו יכול לגשת למשאבים האלה.כל מדיניות PAB יכולה להפנות ל-500 משאבים לכל היותר בכל הכללים שבמדיניות.
-
-
ENFORCEMENT_VERSION: גרסת המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שבה IAM משתמש כשהוא אוכף את המדיניות. גרסת האכיפה קובעת על אילו הרשאות IAM אוכף את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).הערכים הקבילים הם
1,2,3,4ו-latest.למידע נוסף על הגדרה וניהול של גרסאות אכיפה, ראו ניהול גרסאות אכיפה.
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?updateMask=FIELDS_TO_UPDATE
תוכן בקשת JSON:
{
"displayName": DISPLAY_NAME,
"details": {
"rules": [
PAB_RULES
],
"enforcementVersion": "ENFORCEMENT_VERSION",
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-13T18:58:43.721277235Z",
"target": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
שינוי המשתמשים שעליהם חלה מדיניות PAB
אחרי שיוצרים קישור מדיניות למדיניות PAB, אי אפשר לשנות את מזהה המדיניות או את קבוצת חשבונות המשתמשים בקישור. לכן, אם רוצים לשנות את חשבונות המשתמשים שעליהם חלה מדיניות PAB, צריך לבצע אחת מהפעולות הבאות:
- כדי לצמצם את קבוצת חשבונות המשתמשים שעליהם חלה מדיניות PAB, אתם יכולים לשנות את התנאים בקישור המדיניות. כדי לשנות את התנאים בקישור, עורכים את קישור המדיניות.
- כדי לאכוף את מדיניות ה-PAB על קבוצת חשבונות משתמשים נוספת, יוצרים קישור מדיניות חדש שמקשר את המדיניות לקבוצת חשבונות המשתמשים הזו.
- כדי להסיר מדיניות PAB מקבוצת חשבונות משתמשים, מוחקים את קישור המדיניות שמקשר את המדיניות לקבוצת חשבונות המשתמשים.
עריכת קישורי מדיניות קיימים למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
אחרי שיוצרים קישור מדיניות, אפשר לערוך את הקישור כדי לשנות את התנאים או את השם המוצג שלו.
אפשר לערוך קישור מדיניות באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.
המסוף
נכנסים לדף Principal Access Boundary policies במסוף Google Cloud .
בוחרים את הארגון שבבעלותו נמצאת מדיניות ה-PAB שרוצים לערוך.
לוחצים על מזהה המדיניות של המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שרוצים לערוך את הקישורים שלה.
לוחצים על הכרטיסייה Bindings.
מוצאים את המזהה של הקישור שרוצים לערוך. בשורה של הקישור, לוחצים על Actions ואז על Edit binding.
כדי לעדכן את השם המוצג של הקישור, עורכים את השדה Display name.
כדי להוסיף תנאי לקישור:
- לוחצים על הוספת תנאי.
- בשדה Title, מזינים סיכום קצר של מטרת התנאי.
- אופציונלי: בשדה Description, מזינים תיאור ארוך יותר של התנאי.
- בשדה Expression, מזינים ביטוי תנאי שמשתמש בתחביר של Common Expression Language (CEL). הביטוי חייב להפנות למאפיינים
principal.typeאוprincipal.subject. אין תמיכה במאפיינים אחרים. - לוחצים על Save.
כדי לעדכן תנאי קיים:
- לוחצים על Edit condition ליד שם התנאי.
- מעדכנים את הכותרת, התיאור או הביטוי של התנאי.
- לוחצים על Save.
אופציונלי: כדי לבדוק את השינויים בקישור של מדיניות PAB באמצעות סימולטור המדיניות, לוחצים על Test changes. בודקים את תוצאות הסימולציה ומעדכנים את קישור המדיניות לפי הצורך.
למידע נוסף על בדיקת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים באמצעות סימולטור המדיניות, קראו את המאמר סימולטור המדיניות לכללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים.
כדי לשמור את השינויים לוחצים על שמירה.
gcloud
הפקודה
gcloud iam policy-bindings update
מעדכנת קישור מדיניות קיים.
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
-
BINDING_ID: המזהה של קישור המדיניות שרוצים לעדכן, לדוגמהexample-binding. -
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךproject,folderאוorganization.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
FIELD_TO_UPDATE=UPDATED_VALUE: השדות שרוצים לעדכן והערך המעודכן המתאים.הדוגמאות הבאות הן דגלים שאפשר להשתמש בהם כדי לעדכן את השדות בקישור מדיניות:
-
--display-name=DISPLAY_NAME: החלפת השם המוצג של הקישור ב-DISPLAY_NAME. -
--condition-description=CONDITION_DESCRIPTION: אם לקישור יש תנאי, מחליפים את תיאור התנאי ב-CONDITION_DESCRIPTION. אחרת, מוסיפים תנאי חדש לקישור עם התיאור שצוין. אם משתמשים בדגל הזה כדי לעדכן קישור שאין לו תנאי, צריך להגדיר גם את הדגל--condition-expression. -
--condition-expression=CONDITION_EXPRESSION: אם לקישור יש תנאי, מחליפים את הביטוי של התנאי ב-CONDITION_EXPRESSION. אחרת, מוסיפים תנאי חדש לקישור עם הביטוי שצוין. -
--condition-title=CONDITION_TITLE: אם לקישור יש תנאי, מחליפים את שם התנאי ב-CONDITION_TITLE. אחרת, מוסיפים תנאי חדש לקישור עם השם שצוין. אם משתמשים בדגל הזה כדי לעדכן קישור שאין לו תנאי, צריך להגדיר גם את הדגל--condition-expression.
רשימה מלאה של השדות שאפשר לעדכן מופיעה בחומרי העזר של הפקודה
gcloud iam policy-bindings update. -
-
FORMAT: הפורמט של התשובה. אפשר להשתמש ב-jsonאו ב-yaml.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud iam policy-bindings update BINDING_ID \ --RESOURCE_TYPE=RESOURCE_ID --location=global \ --FIELD_TO_UPDATE=UPDATED_VALUE \ --format=FORMAT
Windows (PowerShell)
gcloud iam policy-bindings update BINDING_ID ` --RESOURCE_TYPE=RESOURCE_ID --location=global ` --FIELD_TO_UPDATE=UPDATED_VALUE ` --format=FORMAT
Windows (cmd.exe)
gcloud iam policy-bindings update BINDING_ID ^ --RESOURCE_TYPE=RESOURCE_ID --location=global ^ --FIELD_TO_UPDATE=UPDATED_VALUE ^ --format=FORMAT
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
Update request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done.
Updated policyBinding [example-binding].
{
"createTime": "2024-05-06T18:08:24.729843Z",
"displayName": "Updated display name",
"etag": "W/\"xkdnPfTxoxyVqOwhQSJbMg==\"",
"name": "organizations/123456789012/locations/global/policyBindings/example-binding",
"policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policyUid": "puid_9519202237377675265",
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/123456789012"
},
"uid": "buid_9904260005517852673",
"updateTime": "2024-05-06T18:11:16.798841Z"
}
REST
ה-method policyBindings.patch מעדכנת קישור מדיניות קיים.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שקישור המדיניות הוא צאצא שלו. אפשר להשתמש בערךprojects,foldersאוorganizations.סוג המשאב תלוי בחשבון המשתמש שמוגדר בקישור המדיניות. כדי לראות באיזה סוג משאב להשתמש, עיינו במאמר סוגי חשבונות משתמשים נתמכים.
-
RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שקישור המדיניות הוא צאצא שלו. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמוmy-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל123456789012. -
BINDING_ID: המזהה של קישור המדיניות שרוצים לעדכן, לדוגמהexample-binding. -
FIELDS_TO_UPDATE: רשימה מופרדת בפסיקים של השדות שרוצים לעדכן. אם לא מציינים את השדות שרוצים לעדכן, IAM מחליף את הקישור הקיים בתוכן של גוף הבקשה.הערכים הקבילים הם
displayName,condition,condition.expression,condition.titleו-condition.description. -
DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של הקישור, למשלExample binding. השם המוצג יכול להכיל עד 63 תווים. -
CONDITION_DETAILS: אופציונלי. ביטוי תנאי שמציין על אילו חשבונות משתמשים בקבוצת החשבונות נאכפת המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB). מכיל את השדות הבאים:-
expression: ביטוי תנאי שמשתמש בתחביר של Common Expression Language (CEL). הביטוי חייב להתייחס למאפייניםprincipal.typeאוprincipal.subject. אין תמיכה במאפיינים אחרים.הביטוי יכול להכיל עד 10 אופרטורים לוגיים (
&&,||,!), והאורך שלו יכול להיות עד 250 תווים. -
title: אופציונלי. סיכום קצר של מטרת התנאי. -
description: אופציונלי. תיאור ארוך יותר של התנאי.
-
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID?updateMask=FIELDS_TO_UPDATE
תוכן בקשת JSON:
{
"displayName": "DISPLAY_NAME",
"condition": {
CONDITION_DETAILS
}
}
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373159010-6181f6fcccfa7-dcd0055c-00c22cad",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-05-10T20:32:39.254910121Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "update",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
בדיקת הסטטוס של פעולה ממושכת
כשמשתמשים ב-API בארכיטקטורת REST או בספריות הלקוח, כל שיטה שמשנה מדיניות או קישור מחזירה פעולה ממושכת (LRO). הפעולה הממושכת עוקבת אחרי הסטטוס של הבקשה ומציינת אם השינוי במדיניות או בקישור הושלם.
REST
השיטה
operations.get
מחזירה את הסטטוס של פעולה ממושכת.
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
-
OPERATION_NAME: השם המלא של הפעולה. השם הזה מופיע בתגובה לבקשה המקורית.הפורמט של שם הפעולה הוא:
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
ה-method של ה-HTTP וכתובת ה-URL:
GET https://iam.googleapis.com/v3/OPERATION_NAME
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
אם השדה done של הפעולה לא מופיע, אפשר לבצע את הפעולה שוב ושוב כדי להמשיך לעקוב אחר הסטטוס שלה. צריך להשתמש בהשהיה מעריכית (exponential backoff) קטועה לפני ניסיון חוזר כדי ליצור עיכוב בין כל בקשה. כשהערך של השדה done מוגדר בתור true, הפעולה הושלמה ואפשר להפסיק לבצע אותה.
המאמרים הבאים
- יצירה והחלה של כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- הצגת כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)
- הסרת כללי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)