עריכת מדיניות גישה מאוחדת (UAP)

מערכת גישה מאוחדת לכללי מדיניות (UAP) מאפשרת לכם לתת לחשבונות משתמשים גישה למשאבים ב-Google Cloud או לדחות את הגישה שלהם. במאמר הזה מוסבר איך לערוך כללי מדיניות UAP קיימים ולשנות את המשאבים שהם חלים עליהם.

לפני שמתחילים

  1. מגדירים אימות.

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.

    gcloud

    מפעילים את Cloud Shell במסוף Google Cloud .

    הפעלת Cloud Shell

    בחלק התחתון של מסוף Google Cloud יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

    REST

    כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

  2. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  3. זה שינוי אופציונלי. סקירה כללית על כללי מדיניות הגישה המאוחדת

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לעריכת UAP, בקשו מהאדמין לתת לכם את התפקיד אדמין של מדיניות גישה (roles/iam.accessPolicyAdmin) ב-IAM ברמת הפרויקט, התיקייה או הארגון שבבעלותם נמצא ה-UAP שאתם רוצים לערוך. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

זהו תפקיד מוגדר מראש שכולל את ההרשאות שנדרשות לעריכת כללי מדיניות הגישה המאוחדת. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:

ההרשאות הנדרשות

כדי לערוך את כללי מדיניות הגישה המאוחדת, נדרשות ההרשאות הבאות:

  • iam.accesspolicies.update
  • עורכים את כללי ה-UAP במסוף Google Cloud :
    • iam.accesspolicies.get
    • iam.accessPolicies.list

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

עריכה של מדיניות גישה מאוחדת קיימת

אתם יכולים לערוך את ה-UAP כדי לעדכן את השם המוצג או את הכללים שלה.

אפשר לערוך את ה-UAP באמצעות מסוף Google Cloud , ה-CLI של gcloud או ה-API בארכיטקטורת REST של IAM.

המסוף

  1. נכנסים לדף Unified Access Policies במסוף Google Cloud .

    כניסה לדף Unified Access Policies
  2. בוחרים את הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים לערוך.
  3. לוחצים על מזהה המדיניות של ה-UAP שרוצים לערוך.
  4. כדי להוסיף כללים, לוחצים על Add rule ומוסיפים את פרטי הכלל. כדי לשמור את הכלל, לוחצים על הוספת כלל.

    מידע נוסף על השדות של כלל מופיע במאמר יצירת UAP.

  5. כדי לערוך שדות אחרים של ה-UAP, לוחצים על Edit policy.
  6. עורכים את השדות הבאים:

    • ‫Policy name: מזינים שם חדש לתצוגה של ה-UAP.
    • כללים: עדכון, הוספה או הסרה של כללים ב-UAP.
  7. כשמסיימים לערוך את ה-UAP, לוחצים על Update policy.

gcloud

הפקודה gcloud iam access-policies update מעדכנת מדיניות UAP קיימת.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

  • ‫UAP_ID: המזהה של ה-UAP שרוצים לעדכן, לדוגמה example-policy.
  • ‫UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים לעדכן. אפשר להשתמש בערך project, folder או organization.
  • ‫UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים לעדכן. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫FIELD_TO_UPDATE=UPDATED_VALUE: השדות שרוצים לעדכן והערך המעודכן המתאים.

    הדוגמאות הבאות הן דגלים שאפשר להשתמש בהם כדי לעדכן את השדות במדיניות:

    • ‫--display-name=DISPLAY_NAME: מחליפים את השם המוצג של ה-UAP בשם שצוין.
    • ‫--details-rules=RULES_FILE: החלפת כללי ה-UAP בכללים שבקובץ שצוין. כל כלל בקובץ צריך להיות בפורמט הבא:

      {
        "description": "DESCRIPTION",
        "effect": "EFFECT",
        "principals": [
          INCLUDED_PRINCIPALS
        ],
        "excludedPrincipals": [
          EXCLUDED_PRINCIPALS
        ],
        "operation": {
          "permissions": [
            INCLUDED_PERMISSIONS
          ],
          "excludedPermissions": [
            EXCLUDED_PERMISSIONS
          ]
        },
        CONDITIONS
      }

      מחליפים את הערכים הבאים:

      • ‫DESCRIPTION: תיאור קריא לאנשים של הכלל.
      • ‫EFFECT: איך הכלל משפיע על הגישה. הערכים הנתמכים הם ALLOW ו-DENY:

        • ‫ALLOW: הענקת ההרשאות שצוינו לחשבונות המשתמשים שצוינו.
        • DENY: מניעה מחשבונות המשתמשים שצוינו להשתמש בהרשאות שצוינו.
      • מחליפים את הערכים הבאים כדי לציין את חשבונות המשתמשים שכלולים בכלל:

        • ‫INCLUDED_PRINCIPALS: חשבונות המשתמשים שייכללו בכלל.
        • ‫EXCLUDED_PRINCIPALS: אופציונלי. חשבונות המשתמשים שיוחרגו מהכלל, גם אם הם מופיעים ברשימת חשבונות המשתמשים שנכללים. לדוגמה, אפשר להוסיף קבוצה ב-Google לרשימת חשבונות המשתמשים שנכללים, ואז להחריג משתמשים ספציפיים ששייכים לקבוצה הזו.

        רשימת המזהים הנתמכים של חשבונות משתמשים מופיעה במאמר סוגי חשבונות משתמשים ל-UAP.

      • מחליפים את הערכים הבאים כדי לציין את ההרשאות שרוצים לכלול בכלל:

        • ‫INCLUDED_PERMISSIONS: ההרשאות שיהיו בכלל.
        • ‫EXCLUDED_PERMISSIONS: אופציונלי. ההרשאות שרוצים להחריג מהכלל, גם אם הן מופיעות ברשימת ההרשאות שנכללות. לדוגמה, אפשר להוסיף תפקיד לרשימת ההרשאות הכלולות, ואז להחריג הרשאות ספציפיות בתפקיד הזה.

        כשיוצרים את רשימות ההרשאות האלה, אפשר להפנות לשמות של הרשאות, לשמות של תפקידים ולקבוצות של הרשאות. מידע נוסף זמין במאמר תפקידים והרשאות בכללי UAP.

      • ‫CONDITIONS: אופציונלי. התנאים שבהם הכלל חל. צריך להשתמש בפורמט הבא:

        "conditions": {
          "SERVICE": {
            "title": "CONDITION_TITLE",
            "description": "CONDITION_DESCRIPTION",
            "expression": "CONDITION_EXPRESSION"
          }
        }
            

        מחליפים את הערכים הבאים:

        • ‫SERVICE: השירות שמספק את המאפיינים שבהם משתמשים בביטוי התנאי.
        • ‫CONDITION_TITLE: אופציונלי. סיכום קצר של מטרת התנאי.
        • ‫CONDITION_DESCRIPTION: אופציונלי. תיאור ארוך יותר של התנאי.
        • ‫CONDITION_EXPRESSION: ביטוי בוליאני שמפנה למאפיינים של ניסיון הגישה, כמו התגים שמצורפים למשאב בניסיון הגישה. אם הערך של הביטוי הוא true, הכלל חל על ניסיון הגישה. אם תוצאת הבדיקה של התנאי היא false, הכלל לא חל על ניסיון הגישה.

        במאמר מאפייני תנאים נתמכים תוכלו למצוא רשימה של המאפיינים הנתמכים והשירותים שלהם.

    • ‫--add-details-rules=RULES_FILE: הוספת הכללים בקובץ שצוין לכללים הקיימים ב-UAP.

    • ‫--remove-details-rules=RULES_FILE: הסרת הכללים בקובץ שצוין מהכללים הקיימים ב-UAP. רק כללים שתואמים בדיוק לאחד מהכללים בקובץ שצוין יוסרו.

    • ‫--clear-details-rules: הסרת כל הכללים מה-UAP.

    רשימה מלאה של הדגלים שאפשר להשתמש בהם כדי לעדכן UAP מופיעה בדף העזרה של הפקודה gcloud iam access-policies update. חלק מהדגלים לא יכולים להתקיים יחד.

  • ‫FORMAT: הפורמט של התשובה. אפשר להשתמש ב-json או ב-yaml.

מריצים את הפקודה הבאה:

‫Linux,‏ macOS או Cloud Shell

gcloud iam access-policies update UAP_ID \
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE \
    --format=FORMAT

‏Windows (PowerShell)

gcloud iam access-policies update UAP_ID `
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID `
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE `
    --format=FORMAT

Windows‏ (cmd.exe)

gcloud iam access-policies update UAP_ID ^
    --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^
    --location=global --FIELD_TO_UPDATE=UPDATED_VALUE ^
    --format=FORMAT

התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. בסיום הפעולה, התגובה תדפיס את ה-UAP המעודכן.

Request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374208720-6181fae5e2034-2d8a712b-5c92e5b9] to complete...done.
Updated accessPolicy [example-policy].
{
  "createTime": "2026-08-31T21:43:39.822441Z",
  "details": {
    "rules": [
      {
        "conditions": {
          "iam.googleapis.com": {
            "expression": "resource.matchTag('environment', 'prod')"
          }
        },
        "description": "Grant non-delete compute permissions to compute admins in prod",
        "effect": "ALLOW",
        "excludedPrincipals": [
          "principal://goog/subject/access-restricted@example.com"
        ],
        "operation": {
          "excludedPermissions": [
            "*/*.delete"
          ],
          "permissions": [
            "role:roles/compute.admin"
          ]
        },
        "principals": [
          "principalSet://goog/group/compute-admins@example.com"
        ]
      }
    ]
  },
  "displayName": "Updated display name",
  "etag": "W/\"YZtdQgtulCVzvTwlBTFjPQ==\"",
  "name": "projects/0123456789012/locations/global/accessPolicies/example-policy",
  "uid": "puid_0123456789012345678",
  "updateTime": "2026-08-31T21:43:39.822441Z"
}

REST

ה-method‏ accessPolicies.patch מעדכנת מדיניות UAP קיימת.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • ‫UAP_PARENT_RESOURCE_TYPE: סוג המשאב של מנהל המשאבים (פרויקט, תיקייה או ארגון) שבבעלותו נמצאת מדיניות ה-UAP שרוצים לעדכן. אפשר להשתמש בערך projects, folders או organizations.
  • ‫UAP_PARENT_RESOURCE_ID: המזהה של הפרויקט, התיקייה או הארגון שבבעלותם נמצאת מדיניות ה-UAP שרוצים לעדכן. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project. מזהי תיקיות ומזהי הארגון מכילים רק ספרות, למשל 123456789012.
  • ‫UAP_ID: המזהה של ה-UAP שרוצים לעדכן, לדוגמה example-policy.
  • ‫DISPLAY_NAME: אופציונלי. תיאור קריא לאנשים של ה-UAP, לדוגמה Example policy. השם המוצג יכול להכיל עד 63 תווים.
  • UAP_RULES: רשימה של כללי UAP שמגדירים את הגישה שצריך לתת או לדחות, ואת חשבונות המשתמשים שצריך לתת להם גישה או לדחות את הגישה שלהם. בכל UAP יכולים להיות עד 100 כללים. כל כלל הוא בפורמט הבא:

    {
      "description": "DESCRIPTION",
      "effect": "EFFECT",
      "principals": [
        INCLUDED_PRINCIPALS
      ],
      "excludedPrincipals": [
        EXCLUDED_PRINCIPALS
      ],
      "operation": {
        "permissions": [
          INCLUDED_PERMISSIONS
        ],
        "excludedPermissions": [
          EXCLUDED_PERMISSIONS
        ]
      },
      CONDITIONS
    }

    מחליפים את הערכים הבאים:

    • ‫DESCRIPTION: תיאור קריא לאנשים של הכלל.
    • ‫EFFECT: איך הכלל משפיע על הגישה. הערכים הנתמכים הם ALLOW ו-DENY:

      • ‫ALLOW: הענקת ההרשאות שצוינו לחשבונות המשתמשים שצוינו.
      • DENY: מניעה מחשבונות המשתמשים שצוינו להשתמש בהרשאות שצוינו.
    • מחליפים את הערכים הבאים כדי לציין את חשבונות המשתמשים שכלולים בכלל:

      • ‫INCLUDED_PRINCIPALS: חשבונות המשתמשים שייכללו בכלל.
      • ‫EXCLUDED_PRINCIPALS: אופציונלי. חשבונות המשתמשים שיוחרגו מהכלל, גם אם הם מופיעים ברשימת חשבונות המשתמשים שנכללים. לדוגמה, אפשר להוסיף קבוצה ב-Google לרשימת חשבונות המשתמשים שנכללים, ואז להחריג משתמשים ספציפיים ששייכים לקבוצה הזו.

      רשימת המזהים הנתמכים של חשבונות משתמשים מופיעה במאמר סוגי חשבונות משתמשים ל-UAP.

    • מחליפים את הערכים הבאים כדי לציין את ההרשאות שרוצים לכלול בכלל:

      • ‫INCLUDED_PERMISSIONS: ההרשאות שיהיו בכלל.
      • ‫EXCLUDED_PERMISSIONS: אופציונלי. ההרשאות שרוצים להחריג מהכלל, גם אם הן מופיעות ברשימת ההרשאות שנכללות. לדוגמה, אפשר להוסיף תפקיד לרשימת ההרשאות הכלולות, ואז להחריג הרשאות ספציפיות בתפקיד הזה.

      כשיוצרים את רשימות ההרשאות האלה, אפשר להפנות לשמות של הרשאות, לשמות של תפקידים ולקבוצות של הרשאות. מידע נוסף זמין במאמר תפקידים והרשאות בכללי UAP.

    • ‫CONDITIONS: אופציונלי. התנאים שבהם הכלל חל. צריך להשתמש בפורמט הבא:

      "conditions": {
        "SERVICE": {
          "title": "CONDITION_TITLE",
          "description": "CONDITION_DESCRIPTION",
          "expression": "CONDITION_EXPRESSION"
        }
      }
          

      מחליפים את הערכים הבאים:

      • ‫SERVICE: השירות שמספק את המאפיינים שבהם משתמשים בביטוי התנאי.
      • ‫CONDITION_TITLE: אופציונלי. סיכום קצר של מטרת התנאי.
      • ‫CONDITION_DESCRIPTION: אופציונלי. תיאור ארוך יותר של התנאי.
      • ‫CONDITION_EXPRESSION: ביטוי בוליאני שמפנה למאפיינים של ניסיון הגישה, כמו התגים שמצורפים למשאב בניסיון הגישה. אם הערך של הביטוי הוא true, הכלל חל על ניסיון הגישה. אם תוצאת הבדיקה של התנאי היא false, הכלל לא חל על ניסיון הגישה.

      במאמר מאפייני תנאים נתמכים תוכלו למצוא רשימה של המאפיינים הנתמכים והשירותים שלהם.

ה-method של ה-HTTP וכתובת ה-URL:

PATCH https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies/UAP_ID

תוכן בקשת JSON:

{
  "displayName": "DISPLAY_NAME",
  "details": {
    "rules": [
      UAP_RULES
    ]
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

התשובה מכילה פעולה ממושכת שמייצגת את הבקשה שלכם. כדי ללמוד איך לקבל את הסטטוס של פעולה ממושכת, אפשר לעיין בקטע בדיקת הסטטוס של פעולה ממושכת שבדף הזה.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715626721931-6185a7953ef76-76f80ee4-19cd1bf7",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2026-05-13T18:58:43.721277235Z",
    "target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

שינוי המשאבים שהמדיניות חלה עליהם

אחרי שיוצרים קישור ל-UAP, אי אפשר לשנות את מזהה המדיניות או את המשאב בקישור. לכן, אם רוצים לשנות את המשאב שעליו חלה מדיניות ה-UAP, צריך לבצע אחת מהפעולות הבאות:

בדיקת הסטטוס של פעולה ממושכת

כשמשתמשים ב-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, הפעולה הושלמה ואפשר להפסיק לבצע אותה.

המאמרים הבאים