פתרון בעיות בהרשאות IAM

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

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

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

  • מפעילים את Policy Troubleshooter API, אם הוא עדיין לא מופעל.

    התפקידים שנדרשים כדי להפעיל ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים.

    להפעלת ה-API

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

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

הרשאות לפתרון בעיות בגישה של חשבונות משתמשים ספציפיים

פותר הבעיות שקשורות למדיניות מנתח את הגישה של חשבון המשתמש למשאב, על סמך כללי מדיניות ההרשאה, כללי מדיניות הדחייה, כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) והתפקידים שיש לכם הרשאה לראות. אם אין לכם הרשאה לצפות במדיניות שחלה על משאב, או אם אין לכם הרשאה לצפות בתפקיד בהתאמה אישית, יכול להיות שלא תוכלו לדעת אם לחשבון המשתמש יש גישה.

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

כדי לפתור בעיות במדיניות ההרשאות ובמדיניות הדחייה, אתם צריכים הרשאות בארגון שמכיל את המשאב שבו אתם רוצים לפתור את הבעיות. ההרשאות האלה מאפשרות לכם לראות את כללי מדיניות ההרשאות והדחייה ששולטים בגישה למשאב.

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

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

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

אם אין לכם הרשאה לצפות בכללי מדיניות ההרשאה והדחייה של משאב מסוים, תוצאות הגישה של כללי מדיניות ההרשאה והדחייה האלה הן Unknown.

הרשאות לפתרון בעיות במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)

כדי לפתור בעיות שקשורות למדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), אתם צריכים הרשאות בארגון שקבוצת חשבונות המשתמשים שלו כוללת את חשבון המשתמש. הדרך שבה מזהים את הארגון תלויה בסוג החשבון:

  • חשבונות Google וקבוצות Google: הארגון שמשויך לדומיין ב-Google Workspace שכולל את החשבון הראשי
  • זהויות מאוחדות (זהויות במאגרי זהויות של כוח עבודה או במאגרי זהויות של עומסי עבודה): הארגון שמכיל את מאגר הזהויות שכולל את החשבון הראשי
  • חשבונות שירות: הארגון שמכיל את הפרויקט שבו נוצר חשבון השירות
  • זהויות של סוכנים: הארגון שמכיל את הפרויקט שבו נוצר הסוכן

ההרשאות האלה מאפשרות לכם לראות את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שקובעים לאילו משאבים יש לחשבון המשתמש גישה.

כדי לקבל את ההרשאות שדרושות לפתרון בעיות בגישה של חשבון משתמש, צריך לבקש מהאדמין לתת לכם את התפקידים הבאים ב-IAM ברמת הארגון המתאים:

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

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

אם אין לכם הרשאה לראות את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שחלים על חשבון משתמש, תוצאות הגישה לכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) הן Unknown.

הרשאות לפתרון בעיות גישה של חברי קבוצה

אם כללי מדיניות ההרשאה והדחייה שלכם כוללים קבוצות, אתם צריכים את ההרשאה groups.read ל-Google Workspace Admin API כדי לפתור בעיות בגישה של חברי קבוצה ספציפיים. לסופר-אדמינים ולאדמינים של קבוצות יש את ההרשאה הזו באופן אוטומטי. כדי לתת את ההרשאה הזו למשתמש שהוא לא סופר-אדמין או אדמין של קבוצה, צריך ליצור תפקיד אדמין בהתאמה אישית ב-Google Workspace שכולל את ההרשאה groups.read (שנמצאת בקטע הרשאות Admin API) ולהקצות אותו למשתמש.

אם אין לכם את ההרשאות האלה, תוצאת הגישה של קישורי תפקידים וכללי דחייה שמכילים קבוצות או דומיינים תהיה Unknown, אלא אם קישור התפקיד או כלל הדחייה כוללים במפורש גם את חשבון המשתמש.

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

אם כללי המדיניות שלכם להרשאה ולדחייה כוללים חשבון Google Workspace או דומיין של Cloud Identity, אתם צריכים להיות מנהלי דומיין כדי לפתור בעיות גישה של חברי דומיין ספציפיים.

אם אין לכם את ההרשאות האלה, תוצאת הגישה של קישורי תפקידים וכללי דחייה שמכילים קבוצות או דומיינים תהיה Unknown, אלא אם קישור התפקיד או כלל הדחייה כוללים במפורש גם את חשבון המשתמש.

פתרון בעיות שקשורות לגישה

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

  • ‫Error ID: מזהה ייחודי של הודעת שגיאה בנושא הרשאות. מזהה השגיאה מספק הקשר לשגיאה, כולל חשבון המשתמש, המשאב, ההרשאה ותנאי ה-IAM הנתמכים. מזהה שגיאה שקשור ל-Agent Identity מספק הקשר ל-Agent Identity ולטענות שלו, כמו פלטפורמה ומאגר.

    תנאי ה-IAM הנתמכים כוללים את principal.type ו-principal.subject.

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

  • חשבון משתמש: הזהות שרוצים לבדוק. אפשר להזין את אחת מהאפשרויות הבאות:

    • כתובת אימייל: חייבת להתייחס למשתמש, לחשבון שירות יחיד או לקבוצת חשבונות משתמשים של חשבון שירות.

    • מזהה Agent Identity: צריך להיות בפורמט הבא: TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH.

      לדוגמה: agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent

      פותר הבעיות שקשורות למדיניות מחלץ את מאפייני הפלטפורמה ומאפייני מאגר המשאבים ממחרוזת הנושא של הנציג, באמצעות התבנית הרגילה resources/{platform}/projects/{project_number}/.... אם סוכן משתמש בפורמט נושא לא סטנדרטי, פותר הבעיות שקשורות למדיניות לא יכול להפיק את המאפיינים שלו, והקישורים של קבוצת חשבונות המשתמשים שמבוססים על מאפיינים מקבלים את הערך Unknown.

      אם לסוכן אין קישורי הרשאה שמעניקים גישה, פותר הבעיות שקשורות למדיניות מחזיר את סטטוס הגישה UNKNOWN_INFO במקום NOT_GRANTED.

      המזהים כוללים את הפרטים הבאים:

      • ‫TRUST_DOMAIN: מתחם האמון של הארגון (לדוגמה, agents.global.org-123456789012.system.id.goog)

      • ‫SERVICE: השם המקוצר של שירות Google Cloud(לדוגמה, aiplatform או discoveryengine)

      • ‫RESOURCE_PATH: הנתיב המלא למשאב שמארח את הנציג

    אין תמיכה בסוגים אחרים של ישויות מורשות, כולל קבוצות, דומיינים, זהויות של כוח עבודה ו-Workload Identity.

  • ‫Resource: השם המלא של המשאב שרוצים לפתור את בעיות הגישה אליו. לדוגמה, כדי לפתור בעיות בגישה לפרויקט my-project, מזינים //cloudresourcemanager.googleapis.com/projects/my-project. לסוגים אחרים של משאבים, אפשר לעיין בדוגמאות לשמות מלאים של משאבים.

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

    כדי לפתור בעיות בהרשאה, ההרשאה צריכה להיות רלוונטית למשאב שבבקשה. במילים אחרות, צריך להיות אפשרי להשתמש בהרשאה הזו כדי לגשת למשאב בדרך כלשהי. אם ההרשאה לא רלוונטית למשאב, הבקשה תיכשל. לדוגמה, אם תנסו לפתור בעיות בהרשאה compute.instances.get באשכול של Google Kubernetes Engine, הבקשה תיכשל כי אי אפשר להשתמש בהרשאה compute.instance.get כדי לגשת לאשכולות של Google Kubernetes Engine.

    במאמרי העזרה בנושא הרשאות מפורטת רשימה של כל ההרשאות.

המסוף

כדי לפתור בעיות בגישה:

  1. במסוף Google Cloud , עוברים לדף פותר הבעיות שקשורות למדיניות.

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

  2. אם יש לכם מזהה שגיאה, בוחרים באפשרות מזהה שגיאה ומזינים אותו.

  3. אם אין לכם מזהה שגיאה, בוחרים באפשרות ידני.

    1. מזינים את כתובת האימייל של חשבון המשתמש או את המזהה של Agent Identity שאת הגישה שלו רוצים לבדוק.

    2. מזינים את שם המשאב המלא של המשאב שרוצים לבדוק.

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

      • אם אתם פותרים בעיות גישה לפרויקט, לתיקייה או לארגון, התחילו להקליד כדי לראות אפשרויות להשלמה אוטומטית.
      • אם אתם פותרים בעיות גישה לסוג משאב אחר, לוחצים על Browse כדי לפתוח את תיבת הדו-שיח לחיפוש משאבים, ואז מחפשים את המשאב:

        1. בתיבה Select scope, בוחרים פרויקט, תיקייה או ארגון שבהם רוצים לחפש.
        2. בתיבה Resource type, בוחרים את סוגי המשאבים שרוצים לחפש.
        3. בתיבה Search for resources, מזינים חלק משם המשאב.
        4. בקטע התוצאות, בוחרים את המשאב שרוצים לבדוק.
        5. לוחצים על Select כדי לבחור את המשאב ולסגור את תיבת הדו-שיח.
    3. מזינים את ההרשאה שרוצים לבדוק.

      אם אתם לא יודעים את השם המלא של ההרשאה, התחילו להקליד כדי לראות אפשרויות להשלמה אוטומטית.

    4. אופציונלי: כדי לבדוק כמה משאבים והרשאות, לוחצים על Add Another Pair וחוזרים על השלב הקודם.

  4. לוחצים על בדיקת הגישה.

gcloud

כדי לברר למה לחשבון משתמש יש או אין הרשאת IAM, משתמשים בפקודה gcloud beta policy-troubleshoot iam.

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

  • ‫VERSION: אופציונלי. גרסת הפקודה שבה רוצים להשתמש. כדי לפתור בעיות גישה שמבוססות רק על כללי מדיניות ההרשאה והדחייה, אל תציינו גרסה. כדי לפתור בעיות שקשורות לגישה שמבוססת על מדיניות ההרשאות, מדיניות הדחייה והמדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), צריך להשתמש בגרסה beta.
  • ‫EMAIL: כתובת האימייל של חשבון המשתמש שאתם רוצים לפתור את הבעיות בהרשאות שלו. ב-Agent Identity, צריך לספק את המזהה של החשבון הראשי.
  • ‫RESOURCE: המשאב שבו ניתנת ההרשאה.
  • ‫PERMISSION: ההרשאה שרוצים לפתור בה בעיות.

מריצים את הפקודה gcloud beta policy-troubleshoot iam:

‫Linux,‏ macOS או Cloud Shell

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL \
    --permission=PERMISSION

‏Windows (PowerShell)

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL `
    --permission=PERMISSION

Windows‏ (cmd.exe)

gcloud VERSION policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL ^
    --permission=PERMISSION

אמורים לקבל תגובה שדומה לזו:

תשובה

{
  "accessTuple": {
    "conditionContext": {
      "destination": {},
      "effectiveTags": [
        {
          "namespacedTagKey": "project-1/tag-key-1",
          "namespacedTagValue": "project-1/tag-key-1/tag-value-1",
          "tagKey": "tagKeys/123456789012",
          "tagKeyParentName": "projects/123456789012",
          "tagValue": "tagValues/123456789012"
        },
      ],
      "request": {},
      "resource": {}
    },
    "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/project-1",
    "permission": "bigtable.instances.create",
    "permissionFqdn": "bigtable.googleapis.com/instances.create",
    "principal": "service-account-3@project-1."
  },
  "allowPolicyExplanation": {
    "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
    "explainedPolicies": [
      {
        "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
        "bindingExplanations": [
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "condition": {
              "expression": "resource.type == \"cloudresourcemanager.googleapis.com/Project\"",
              "title": "Resource-based condition"
            },
            "conditionExplanation": {
              "evaluationStates": [
                {
                  "end": 62,
                  "value": false
                }
              ],
              "value": false
            },
            "memberships": {
              "serviceAccount:service-account-1@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/bigquery.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "condition": {
              "expression": "resource.matchTag(\"project-1/tag-key-1\", \"tag-value-1\")",
              "title": "Tag-based condition"
            },
            "conditionExplanation": {
              "evaluationStates": [
                {
                  "end": 73,
                  "value": true
                }
              ],
              "value": true
            },
            "memberships": {
              "serviceAccount:service-account-2@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/bigquery.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-2@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/compute.admin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-1@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "user:user-3@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/iam.serviceAccountTokenCreator",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "user:user-2@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "user:user-1@example.com": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_HIGH",
            "role": "roles/owner",
            "rolePermission": "ROLE_PERMISSION_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "serviceAccount:service-account-3@project-1.": {
                "membership": "MEMBERSHIP_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              },
              "serviceAccount:service-account-4@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/resourcemanager.projectIamAdmin",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          },
          {
            "allowAccessState": "ALLOW_ACCESS_STATE_NOT_GRANTED",
            "combinedMembership": {
              "membership": "MEMBERSHIP_NOT_MATCHED",
              "relevance": "HEURISTIC_RELEVANCE_NORMAL"
            },
            "memberships": {
              "serviceAccount:service-account-4@project-1.": {
                "membership": "MEMBERSHIP_NOT_MATCHED",
                "relevance": "HEURISTIC_RELEVANCE_NORMAL"
              }
            },
            "relevance": "HEURISTIC_RELEVANCE_NORMAL",
            "role": "roles/resourcemanager.tagViewer",
            "rolePermission": "ROLE_PERMISSION_NOT_INCLUDED",
            "rolePermissionRelevance": "HEURISTIC_RELEVANCE_NORMAL"
          }
        ],
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/project-1",
        "policy": {
          "bindings": [
            {
              "condition": {
                "expression": "resource.type == \"cloudresourcemanager.googleapis.com/Project\"",
                "title": "Resource-based condition"
              },
              "members": [
                "serviceAccount:service-account-1@project-1."
              ],
              "role": "roles/bigquery.admin"
            },
            {
              "condition": {
                "expression": "resource.matchTag(\"project-1/tag-key-1\", \"tag-value-1\")",
                "title": "Tag-based condition"
              },
              "members": [
                "serviceAccount:service-account-2@project-1."
              ],
              "role": "roles/bigquery.admin"
            },
            {
              "members": [
                "user:user-2@example.com"
              ],
              "role": "roles/compute.admin"
            },
            {
              "members": [
                "user:user-1@example.com",
                "user:user-3@example.com"
              ],
              "role": "roles/iam.serviceAccountTokenCreator"
            },
            {
              "members": [
                "user:user-2@example.com",
                "user:user-1@example.com"
              ],
              "role": "roles/owner"
            },
            {
              "members": [
                "serviceAccount:service-account-3@project-1.",
                "serviceAccount:service-account-4@project-1."
              ],
              "role": "roles/resourcemanager.projectIamAdmin"
            },
            {
              "members": [
                "serviceAccount:service-account-4@project-1."
              ],
              "role": "roles/resourcemanager.tagViewer"
            }
          ],
          "etag": "BwYY6ttEMEY=",
          "version": 3
        },
        "relevance": "HEURISTIC_RELEVANCE_HIGH"
      },
    ],
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "denyPolicyExplanation": {
    "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
    "explainedResources": [
      {
        "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
        "explainedPolicies": [
          {
            "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
            "policy": {
              "createTime": "2024-04-09T23:28:24.103203Z",
              "displayName": "Troubleshooter v3 prober non-tag deny policy",
              "etag": "MTgyMzk3MDY4OTY4MDE0ODg4OTY=",
              "kind": "DenyPolicy",
              "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F546942305807/denypolicies/deny-policy-1",
              "rules": [
                {
                  "denyRule": {
                    "deniedPermissions": [
                      "bigquery.googleapis.com/datasets.create"
                    ],
                    "deniedPrincipals": [
                      "principal://iam.googleapis.com/projects/-/serviceAccounts/service-account-1@project-1."
                    ]
                  }
                }
              ],
              "uid": "fab63b4d-ecfb-5f06-8a6d-602bf1be5062",
              "updateTime": "2024-05-20T23:29:38.428095Z"
            },
            "relevance": "HEURISTIC_RELEVANCE_HIGH",
            "ruleExplanations": [
              {
                "combinedDeniedPermission": {
                  "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_HIGH"
                },
                "combinedDeniedPrincipal": {
                  "membership": "MEMBERSHIP_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_HIGH"
                },
                "combinedExceptionPermission": {
                  "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL"
                },
                "combinedExceptionPrincipal": {
                  "membership": "MEMBERSHIP_NOT_MATCHED",
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL"
                },
                "deniedPermissions": {
                  "bigquery.googleapis.com/datasets.create": {
                    "permissionMatchingState": "PERMISSION_PATTERN_NOT_MATCHED",
                    "relevance": "HEURISTIC_RELEVANCE_HIGH"
                  }
                },
                "deniedPrincipals": {
                  "principal://iam.googleapis.com/projects/-/serviceAccounts/service-account-1@project-1.": {
                    "membership": "MEMBERSHIP_NOT_MATCHED",
                    "relevance": "HEURISTIC_RELEVANCE_HIGH"
                  }
                },
                "denyAccessState": "DENY_ACCESS_STATE_NOT_DENIED",
                "relevance": "HEURISTIC_RELEVANCE_HIGH"
              }
            ]
          },
        ],
        "fullResourceName": "//cloudresourcemanager.googleapis.com/projects/123456789012",
        "relevance": "HEURISTIC_RELEVANCE_HIGH"
      }
    ],
    "permissionDeniable": true,
    "relevance": "HEURISTIC_RELEVANCE_NORMAL"
  },
  "overallAccessState": "CANNOT_ACCESS",
  "pabPolicyExplanation": {
    "explainedBindingsAndPolicies": [
      {
        "bindingAndPolicyAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
        "explainedPolicy": {
          "explainedRules": [
            {
              "combinedResourceInclusionState": "RESOURCE_INCLUSION_STATE_NOT_INCLUDED",
              "effect": "ALLOW",
              "explainedResources": [
                {
                  "relevance": "HEURISTIC_RELEVANCE_NORMAL",
                  "resource": "//cloudresourcemanager.googleapis.com/projects/project-2",
                  "resourceInclusionState": "RESOURCE_INCLUSION_STATE_NOT_INCLUDED"
                }
              ],
              "relevance": "HEURISTIC_RELEVANCE_NORMAL",
              "ruleAccessState": "PAB_ACCESS_STATE_NOT_ALLOWED"
            }
          ],
          "policy": {
            "createTime": "2024-04-09T17:40:51.627668Z",
            "details": {
              "enforcementVersion": "1",
              "rules": [
                {
                  "effect": "ALLOW",
                  "resources": [
                    "//cloudresourcemanager.googleapis.com/projects/project-2"
                  ]
                }
              ]
            },
            "displayName": "Troubleshooter v3 PAB Policy",
            "etag": "m64s4IgR80eDJDywuVA2DA==",
            "name": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
            "uid": "puid_11875429267422576641",
            "updateTime": "2024-04-09T17:40:51.627668Z"
          },
          "policyAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
          "policyVersion": {
            "enforcementState": "PAB_POLICY_ENFORCEMENT_STATE_NOT_ENFORCED",
            "version": 1
          },
          "relevance": "HEURISTIC_RELEVANCE_NORMAL"
        },
        "explainedPolicyBinding": {
          "conditionExplanation": {
            "evaluationStates": [
              {
                "end": 53,
                "value": true
              },
              {
                "end": 153,
                "start": 58,
                "value": false
              },
              {
                "end": 248,
                "start": 157,
                "value": false
              }
            ],
            "value": false
          },
          "policyBinding": {
            "condition": {
              "expression": "principal.type == 'iam.googleapis.com/ServiceAccount' && (principal.subject=='service-account-1@project-1.' || principal.subject=='service-account-2@project-1.')"
            },
            "createTime": "2024-04-09T17:51:13.504418Z",
            "displayName": "PAB Policy Binding on project-1 project",
            "etag": "W/\"hz9IKzHsIqvopqDRcVYDxQ==\"",
            "name": "projects/123456789012/locations/global/policyBindings/example-policy-binding",
            "policy": "organizations/123456789012/locations/global/principalAccessBoundaryPolicies/example-pab-policy",
            "policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
            "policyUid": "puid_11875429267422576641",
            "target": {
              "principalSet": "//cloudresourcemanager.googleapis.com/projects/project-1"
            },
            "uid": "buid_1012746966204940289", 
            "updateTime": "2024-05-09T23:08:56.846355Z"
          },
          "policyBindingState": "POLICY_BINDING_STATE_NOT_ENFORCED",
          "relevance": "HEURISTIC_RELEVANCE_NORMAL"
        },
        "relevance": "HEURISTIC_RELEVANCE_NORMAL"
      }
    ],
    "principalAccessBoundaryAccessState": "PAB_ACCESS_STATE_NOT_ENFORCED",
    "relevance": "HEURISTIC_RELEVANCE_NORMAL"
  }
}

REST

כדי לברר למה לחשבון משתמש יש או אין הרשאת IAM, משתמשים ב-method‏ iam.troubleshoot של Policy Troubleshooter API.

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

  • ‫VERSION: גרסת ה-API שבה ייעשה שימוש בבקשה הזו. כדי לפתור בעיות בגישה שמבוססת רק על כללי מדיניות ההרשאות והדחייה, משתמשים ב-v3. כדי לפתור בעיות שקשורות לגישה על סמך מדיניות ההרשאות, מדיניות הדחייה והמדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), אתם יכולים להשתמש ב-v3beta.
  • ‫EMAIL: כתובת האימייל של חשבון המשתמש שאתם רוצים לפתור את הבעיות בהרשאות שלו. ב-Agent Identity, צריך לספק את המזהה של החשבון הראשי.
  • ‫RESOURCE: המשאב שבו ניתנת ההרשאה.
  • ‫PERMISSION: ההרשאה שרוצים לפתור בה בעיות.
  • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים להשתמש כדי לשלוח את הבקשה. מזהי פרויקטים הם מחרוזות אלפאנומריות, כמו my-project.

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

POST https://policytroubleshooter.googleapis.com/VERSION/iam:troubleshoot

תוכן בקשת JSON:

{
  "accessTuple": {
    "principal": "EMAIL",
    "fullResourceName": "RESOURCE",
    "permission": "PERMISSION"
  }
}

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

אתם אמורים לקבל תגובת JSON שדומה לזו:

הסבר על התוצאות של פותר הבעיות

המסוף

דף התוצאות מכיל את המידע הבא:

פרטי ההערכה

בקטע Evaluation details מופיע סיכום של הגישה שאתם בודקים, כולל החשבון, המשאב וההרשאה שציינתם. אם אתם פותרים בעיות בכמה צמדים של משאבים והרשאות, אתם יכולים להשתמש ברשימה Access Evaluation כדי לעבור ביניהם.

פרטי המדיניות

בקטע Policy details מפורט איך מדיניות ההרשאה, מדיניות הדחייה והמדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) משפיעות על הגישה של חשבון המשתמש.

מדיניות רלוונטית לקביעת גבול הגישה לחשבונות משתמשים (PAB) כוללת את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות משתמשים שכוללת את חשבון המשתמש.

כללי מדיניות הרלוונטיים של הרשאה ודחייה כוללים את הדברים הבאים:

  • מדיניות ההרשאות של המשאב
  • מדיניות הדחייה של המשאב (אם יש)
  • מדיניות ההרשאות של הפרויקט, התיקייה והארגון שנמצאים מעל למשאב בהיררכיית המשאבים (אם יש)
  • מדיניות הדחייה של הפרויקט, התיקייה והארגון שנמצאים מעל למשאב בהיררכיית המשאבים (אם יש)

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

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

באותו האופן, אם מדיניות ההרשאות של הפרויקט נותנת לחשבון המשתמש הרשאה מסוימת, תהיה לו את ההרשאה בכל משאב בפרויקט (אלא אם ההרשאה תילקח באמצעות מדיניות הדחייה).

הקטע פרטי המדיניות כולל את החלקים הבאים:

מצב הגישה

בקטע Access state מופיע סיכום של התוצאות לכל סוג מדיניות (מדיניות לקביעת גבול הגישה לחשבונות משתמשים, מדיניות דחייה ומדיניות הרשאה), וגם התוצאה הכוללת. התוצאה מציינת אם חשבון המשתמש יכול להשתמש בהרשאה כדי לגשת למשאב, בהתאם לכללי המדיניות הרלוונטיים.

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

מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB)

בקטע Principal access boundary policy אפשר לראות את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שחלים על חשבון המשתמש, ואת הקישורים שמקשרים את כללי המדיניות האלה לחשבון המשתמש.

בחלונית Policies מופיעה רשימה של כל כללי המדיניות שמקושרים לקבוצת חשבונות משתמשים שכוללת את החשבון. לצד כל מדיניות מופיע סמל שמציין איך המדיניות הזו משפיעה על הגישה של חשבון המשתמש.

כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) יכולים להשפיע על הגישה של חשבון המשתמש בדרכים הבאות:

  • לחשבון המשתמש יש גישה למשאב: המדיניות לקביעת גבול הגישה לחשבונות משתמשים חלה על חשבון המשתמש, ואחד מהכללים שלה מכיל את המשאב שנשלחה לגביו שאילתה.
  • ‫ לחשבון המשתמש אין גישה למשאב: המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) חלה על חשבון המשתמש, אבל המשאב שנשלחה לגביו שאילתה לא נמצא בכללים של המדיניות הזו.
  • לא נאכפת: מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לא נאכפת במצבים הבאים:

    • ‫IAM לא אוכף את ההרשאה שצוינה בגרסת האכיפה של מדיניות ה-PAB. כתוצאה מכך, המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לא יכולה לחסום את הגישה.
    • בגלל תנאי בקישור המדיניות, המדיניות או הקישור של גבול הגישה לחשבונות משתמשים לא חלים על חשבון המשתמש.
    • במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) אין כללים.

    אם מדיניות PAB לא נאכפת, היא לא יכולה להשפיע על הגישה של חשבון המשתמש למשאב.

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

כדי לראות את הכללים במדיניות, לוחצים על הכרטיסייה כללי גבולות. בכרטיסייה הזו מוצגת טבלה של כללי המדיניות הרלוונטיים לקביעת גבול הגישה לחשבונות משתמשים (PAB).

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

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

כדי לראות את כל כללי ה-PAB במדיניות, מבטלים את הסימון של התיבה Show only relevant rules and bindings.

בעמודה Findings בטבלת כללי הגבולות מצוין אם כלל ה-PAB מכיל את המשאב שנשלחה לגביו שאילתה. כדי לראות פרטים נוספים על הכלל, לוחצים על הצגת פרטי הכלל.

כדי לראות את קישורי המדיניות, לוחצים על הכרטיסייה Bindings. בכרטיסייה הזו מוצגת טבלה של קישורי המדיניות הרלוונטיים למדיניות שנבחרה לקביעת גבול הגישה לחשבונות משתמשים.

קישור מדיניות רלוונטי אם הוא מחיל בפועל את המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) על חשבון המשתמש שנשלחה לגביו שאילתה. כדי שקישור מדיניות יחיל מדיניות PAB על חשבון משתמש, התנאים הבאים צריכים להתקיים:

  • החשבון הראשי שמוגדר בקישור המדיניות חייב לכלול את החשבון הראשי שנשלחה לגביו שאילתה
  • כל התנאים בקישור המדיניות חייבים להחזיר את הערך true לחשבון המשתמש ששלח את השאילתה.

כדי לראות את כל קישורי המדיניות עם קבוצות של חשבונות משתמשים שכוללות את חשבון המשתמש שנשלחה לגביו שאילתה, בלי קשר לשאלה אם חשבון המשתמש שנשלחה לגביו שאילתה עומד בתנאי שבקישור, מבטלים את הסימון בתיבה Show only relevant rules and bindings.

בזהויות של נציגים, פותר הבעיות שקשורות למדיניות בודק את כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמשויכים להיררכיית המשאבים של הפרויקט או הקונטיינר המארח של הנציג, ובודק את התנאים שתואמים לסוג הזהות של הנציג (principal.type == 'iam.googleapis.com/AgentPoolIdentity') ולתבנית הנושא (principal.subject.startsWith(...)).

בעמודה Findings בטבלת הקישורים מצוין אם הקישור נאכף על חשבון המשתמש ששלח את השאילתה. כדי לראות פרטים נוספים על הקישור למדיניות, לוחצים על See binding details.

מדיניות הדחייה

בקטע Deny policy אפשר לראות את כל כללי מדיניות הדחייה הרלוונטיים, לזהות את כללי הדחייה שמונעים את הגישה של חשבון המשתמש ולהבין למה כלל דחייה מסוים מונע או לא מונע את ההרשאה מחשבון המשתמש.

בחלונית Resources with deny policies מופיעה רשימה של כל כללי מדיניות הדחייה הרלוונטיים, לפי המשאבים שאליהם הם מצורפים. לצד כל מדיניות דחייה מופיעה הערכת גישה. הבדיקה הזו חלה רק על מדיניות הדחייה הזו, והיא לא משקפת גישה מכללי מדיניות שעברו בירושה. אם אין לכם הרשאה לצפות במדיניות הדחייה של משאב מסוים, רשימת המשאבים לא תכלול את המשאב הזה או את מדיניות הדחייה שלו.

כדי לראות את כללי הדחייה הרלוונטיים בכללי מדיניות הדחייה האלה, לוחצים על מדיניות דחייה. כדי לראות את כל כללי הדחייה במדיניות הדחייה של המשאב, לוחצים על המשאב. כללי הדחייה מופיעים בחלונית Deny rules. החלונית הזו מכילה טבלה של כל כללי הדחייה עם חשבון המשתמש או ההרשאה ששלחתם לגביהם שאילתה, למשאב או למדיניות הדחייה שבחרתם.

בעמודה Access מצוין אם כלל הדחייה מונע מחשבון המשתמש את ההרשאה. כדי לראות פרטים נוספים על כלל הדחייה, לוחצים על See deny rule בשורה של הכלל.

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

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

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

כדי לראות את קישורי התפקידים הרלוונטיים במדיניות ההרשאות של המשאב, ולבדוק אם הם נותנים לחשבון המשתמש את ההרשאה, לוחצים על המשאב. קישורי התפקידים של מדיניות ההרשאות מופיעים בחלונית Role bindings.

בחלונית Role bindings מופיעה טבלה של קישורי תפקידים במדיניות ההרשאות של המשאב שנבחר. כברירת מחדל, הטבלה מכילה רק קישורי תפקידים שכוללים תפקיד עם ההרשאה שצוינה. אם לחשבון המשתמש אין גישה, בטבלה יוצגו גם קישורי תפקידים עם תפקידים בהתאמה אישית שניתנים לעריכה. כדי לראות את כל קישורי התפקידים, מבטלים את הסימון של התיבה Show only relevant bindings.

בעמודה Access מצוין אם קישור התפקידים נותן לחשבון המשתמש את ההרשאה. כדי לראות פרטים נוספים על קישור התפקיד, לוחצים על See binding details בשורה של קישור התפקיד.

כשבודקים את מדיניות ההרשאות של זהויות הסוכנים, פותר הבעיות שקשורות למדיניות בודק אם הסוכן תואם לאחד ממזהי חשבונות המשתמשים הבאים:

מזהה של חשבון משתמש דוגמה
זהויות של סוכנים ישירים principal://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH
קבוצות של חשבונות משתמשים במתחם אמון (trust domain) principalSet://TRUST_DOMAIN/*
קבוצות של חשבונות משתמשים בפלטפורמה principalSet://TRUST_DOMAIN/attribute.platform/SERVICE
קבוצות של חשבונות משתמשים במאגר משאבים principalSet://TRUST_DOMAIN/attribute.container/projects/PROJECT_NUMBER
קבוצות של חשבונות משתמשים בקונטיינר של הפלטפורמה principalSet://TRUST_DOMAIN/attribute.platformContainer/SERVICE/projects/PROJECT_NUMBER

כשפותרים בעיות גישה של חשבון משתמש שהוא לא סוכן, כמו משתמש או חשבון שירות, כל קישורי התפקידים של זהויות הסוכנים מקבלים את הערך Not matched.

gcloud

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

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

    לכל מדיניות הרשאות, התשובה מפרטת את כל קישורי התפקידים במדיניות ומעריכה אותם על סמך הקריטריונים הבאים:

    • אם קישור התפקיד כולל את ההרשאה.
    • אם קישור התפקיד כולל את החשבון הראשי.
    • אם התנאים בקישור התפקיד מתקיימים, אם יש כאלה.

    לאחר מכן, התגובה מדפיסה את טקסט ה-JSON המלא של מדיניות ההרשאה.

  • ‫denyPolicyExplanation: סיכום שבו מצוין אם כללי מדיניות הדחייה הרלוונטיים דוחים את ההרשאה של חשבון המשתמש, ואחריו רשימה של משאבים עם כללי מדיניות דחייה. לכל משאב, התשובה מציגה את כל כללי מדיניות הדחייה שמצורפים למשאב.

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

    • אם כלל הדחייה כולל את ההרשאה.
    • אם ההרשאה מופיעה כחריגה בכלל הדחייה.
    • אם כלל הדחייה כולל את חשבון המשתמש.
    • אם חשבון המשתמש מופיע כחריג בכלל הדחייה.
    • אם התנאים בכלל הדחייה (אם יש כזה) מתקיימים.
  • ‫overallAccessState: אם חשבון המשתמש יכול להשתמש בהרשאה שצוינה כדי לגשת למשאב שצוין, על סמך כללי מדיניות ההרשאה, כללי מדיניות הדחייה וכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) הרלוונטיים.

    מדיניות רלוונטית לקביעת גבול הגישה לחשבונות משתמשים (PAB) כוללת את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות משתמשים שכוללת את חשבון המשתמש.

    כללי מדיניות הרלוונטיים של הרשאה ודחייה כוללים את הדברים הבאים:

    • מדיניות ההרשאות של המשאב
    • מדיניות הדחייה של המשאב (אם יש)
    • מדיניות ההרשאות של הפרויקט, התיקייה והארגון שנמצאים מעל למשאב בהיררכיית המשאבים (אם יש)
    • מדיניות הדחייה של הפרויקט, התיקייה והארגון שנמצאים מעל למשאב בהיררכיית המשאבים (אם יש)

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

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

    באותו האופן, אם מדיניות ההרשאות של הפרויקט נותנת לחשבון המשתמש הרשאה מסוימת, תהיה לו את ההרשאה בכל משאב בפרויקט (אלא אם ההרשאה תילקח באמצעות מדיניות הדחייה).

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

  • ‫pabPolicyExplanation: סיכום שבו מצוין אם כללי המדיניות הרלוונטיים לקביעת גבול הגישה לחשבונות משתמשים (PAB) מאפשרים לחשבון המשתמש לגשת למשאב, ואחריו הקישורים הרלוונטיים של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) וכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).

    מדיניות PAB יכולה לאפשר גישה, לא לאפשר גישה או לא להיאכף. כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לא נאכפים במצבים הבאים:

    • ‫IAM לא אוכף את ההרשאה שצוינה בגרסת האכיפה של מדיניות ה-PAB. כתוצאה מכך, המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לא יכולה לחסום את הגישה.
    • בגלל תנאי בקישור המדיניות, המדיניות או הקישור של גבול הגישה לחשבונות משתמשים לא חלים על חשבון המשתמש.
    • במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) אין כללים.

    אם מדיניות PAB לא נאכפת, היא לא יכולה להשפיע על הגישה של חשבון המשתמש למשאב.

    התשובה גם מפרטת את כל קישורי המדיניות שכוללים את חשבון המשתמש, ואת הפרטים של מדיניות ה-PAB בכל אחד מקישורי המדיניות האלה:

    • לכל קישור מדיניות של גבול גישה לחשבונות משתמשים, בתגובה מודפס אם קישור המדיניות נאכף על חשבון המשתמש, ואז מודפס הטקסט של קישור המדיניות. קישור מדיניות נאכף אם קבוצת החשבונות הראשיים שמוגדרת בקישור כוללת את החשבון הראשי שנשלחה לגביו שאילתה, ואם התנאי בקישור המדיניות מקבל את הערך true לגבי החשבון הראשי שנשלחה לגביו שאילתה. אם קישור המדיניות לא נאכף, המדיניות לא יכולה להשפיע על היכולת של חשבון המשתמש לגשת למשאב.
    • לכל מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), התגובה מדפיסה את הפרטים הבאים:

      • אם המדיניות מאפשרת גישה, לא מאפשרת גישה או לא נאכפת.
      • גרסת האכיפה של המדיניות. מספר הגרסה הזה קובע אם IAM אוכף את מדיניות ה-PAB הזו להרשאה שנשלחה לגביה שאילתה. אם ההרשאה לא נאכפת, המדיניות לא יכולה להשפיע על היכולת של חשבון המשתמש לגשת למשאב.
      • הכללים במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), והאם כל כלל מאפשר גישה. לכל כלל, התשובה מציינת אם המשאב שנשלחה לגביו שאילתה נכלל בכלל.

        משאב נכלל בכלל אם מתקיים אחד מהתנאים הבאים:

        • המשאב מופיע בכלל. אפשר להוסיף ישירות לכללי בקרת הגישה לישויות מורשות רק משאבים של מנהל המשאבים (פרויקטים, תיקיות וארגונים).
        • אחת מישויות האב של המשאב (כלומר פרויקט, תיקייה או ארגון שנמצאים מעל למשאב בהיררכיית המשאבים) מופיעה בכלל.

להרבה אובייקטים בתגובה יש גם שדה relevance. הערך בשדה הזה מציין את מידת התרומה של האובייקט למצב הגישה הכולל. השדה relevance יכול להכיל את הערכים הבאים:

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

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

REST

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

  • ‫overallAccessState: אם חשבון המשתמש יכול להשתמש בהרשאה שצוינה כדי לגשת למשאב שצוין, על סמך כללי מדיניות ההרשאה, כללי מדיניות הדחייה וכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) הרלוונטיים.

    מדיניות רלוונטית לקביעת גבול הגישה לחשבונות משתמשים (PAB) כוללת את כל כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) שמקושרים לקבוצת חשבונות משתמשים שכוללת את חשבון המשתמש.

    כללי מדיניות הרלוונטיים של הרשאה ודחייה כוללים את הדברים הבאים:

    • מדיניות ההרשאות של המשאב
    • מדיניות הדחייה של המשאב (אם יש)
    • מדיניות ההרשאות של הפרויקט, התיקייה והארגון שנמצאים מעל למשאב בהיררכיית המשאבים (אם יש)
    • מדיניות הדחייה של הפרויקט, התיקייה והארגון שנמצאים מעל למשאב בהיררכיית המשאבים (אם יש)

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

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

    באותו האופן, אם מדיניות ההרשאות של הפרויקט נותנת לחשבון המשתמש הרשאה מסוימת, תהיה לו את ההרשאה בכל משאב בפרויקט (אלא אם ההרשאה תילקח באמצעות מדיניות הדחייה).

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

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

    לכל מדיניות הרשאות, התשובה מפרטת את כל קישורי התפקידים במדיניות ומעריכה אותם על סמך הקריטריונים הבאים:

    • אם קישור התפקיד כולל את ההרשאה.
    • אם קישור התפקיד כולל את החשבון הראשי.
    • אם התנאים בקישור התפקיד מתקיימים, אם יש כאלה.

    לאחר מכן, התגובה מדפיסה את טקסט ה-JSON המלא של מדיניות ההרשאה.

  • ‫denyPolicyExplanation: סיכום שבו מצוין אם כללי מדיניות הדחייה הרלוונטיים דוחים את ההרשאה של חשבון המשתמש, ואחריו רשימה של משאבים עם כללי מדיניות דחייה. לכל משאב, התשובה מציגה את כל כללי מדיניות הדחייה שמצורפים למשאב.

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

    • אם כלל הדחייה כולל את ההרשאה.
    • אם ההרשאה מופיעה כחריגה בכלל הדחייה.
    • אם כלל הדחייה כולל את חשבון המשתמש.
    • אם חשבון המשתמש מופיע כחריג בכלל הדחייה.
    • אם התנאים בכלל הדחייה (אם יש כזה) מתקיימים.
  • ‫pabPolicyExplanation: סיכום שבו מצוין אם כללי המדיניות הרלוונטיים לקביעת גבול הגישה לחשבונות משתמשים (PAB) מאפשרים לחשבון המשתמש לגשת למשאב, ואחריו הקישורים הרלוונטיים של כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) וכללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB).

    מדיניות PAB יכולה לאפשר גישה, לא לאפשר גישה או לא להיאכף. כללי המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לא נאכפים במצבים הבאים:

    • ‫IAM לא אוכף את ההרשאה שצוינה בגרסת האכיפה של מדיניות ה-PAB. כתוצאה מכך, המדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) לא יכולה לחסום את הגישה.
    • בגלל תנאי בקישור המדיניות, המדיניות או הקישור של גבול הגישה לחשבונות משתמשים לא חלים על חשבון המשתמש.
    • במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) אין כללים.

    אם מדיניות PAB לא נאכפת, היא לא יכולה להשפיע על הגישה של חשבון המשתמש למשאב.

    התשובה גם מפרטת את כל קישורי המדיניות שכוללים את חשבון המשתמש, ואת הפרטים של מדיניות ה-PAB בכל אחד מקישורי המדיניות האלה:

    • לכל קישור מדיניות של גבול גישה לחשבונות משתמשים, בתגובה מודפס אם קישור המדיניות נאכף על חשבון המשתמש, ואז מודפס הטקסט של קישור המדיניות. קישור מדיניות נאכף אם קבוצת החשבונות הראשיים שמוגדרת בקישור כוללת את החשבון הראשי שנשלחה לגביו שאילתה, ואם התנאי בקישור המדיניות מקבל את הערך true לגבי החשבון הראשי שנשלחה לגביו שאילתה. אם קישור המדיניות לא נאכף, המדיניות לא יכולה להשפיע על היכולת של חשבון המשתמש לגשת למשאב.
    • לכל מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), התגובה מדפיסה את הפרטים הבאים:

      • אם המדיניות מאפשרת גישה, לא מאפשרת גישה או לא נאכפת.
      • גרסת האכיפה של המדיניות. מספר הגרסה הזה קובע אם IAM אוכף את מדיניות ה-PAB הזו להרשאה שנשלחה לגביה שאילתה. אם ההרשאה לא נאכפת, המדיניות לא יכולה להשפיע על היכולת של חשבון המשתמש לגשת למשאב.
      • הכללים במדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB), והאם כל כלל מאפשר גישה. לכל כלל, התשובה מציינת אם המשאב שנשלחה לגביו שאילתה נכלל בכלל.

        משאב נכלל בכלל אם מתקיים אחד מהתנאים הבאים:

        • המשאב מופיע בכלל. אפשר להוסיף ישירות לכללי בקרת הגישה לישויות מורשות רק משאבים של מנהל המשאבים (פרויקטים, תיקיות וארגונים).
        • אחת מישויות האב של המשאב (כלומר פרויקט, תיקייה או ארגון שנמצאים מעל למשאב בהיררכיית המשאבים) מופיעה בכלל.

להרבה אובייקטים בתגובה יש גם שדה relevance. הערך בשדה הזה מציין את מידת התרומה של האובייקט למצב הגישה הכולל. השדה relevance יכול להכיל את הערכים הבאים:

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

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

פתרון בעיות בקישורי תפקידים מותנים

פותר הבעיות שקשורות למדיניות פותר באופן אוטומטי בעיות בקישורי תפקידים מותנים ובכללי דחייה שמבוססים על תגים. הוא גם פותר באופן אוטומטי בעיות בקישורי מדיניות לקביעת גבול הגישה לחשבונות משתמשים (PAB) עם תנאים שמבוססים על חשבונות משתמשים.

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

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

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

המסוף

כדי לפתור בעיות שקשורות לקישורי תפקידים מותנים ולכללי דחייה:

  1. נכנסים לדף Logs Explorer במסוף Google Cloud .

    כניסה לדף Logs Explorer

  2. אם כותרת הדף היא מציג היומנים מדור קודם, לוחצים על הרשימה הנפתחת שדרוג ובוחרים באפשרות שדרוג ל-Logs Explorer החדש.

  3. כדי להציג רק את יומני הביקורת של פעילות אדמין ושל גישה לנתונים, מזינים את השאילתה הבאה בכלי ליצירת שאילתות ולוחצים על Run query:

    logName=("RESOURCE_TYPE/RESOURCE_ID/logs/cloudaudit.googleapis.com%2Factivity" OR "RESOURCE_TYPE/RESOURCE_ID/logs/cloudaudit.googleapis.com%2Fdata_access")
    

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

    • ‫RESOURCE_TYPE: סוג המשאב שאתם רוצים להציג את יומני הביקורת שלו. אפשר להשתמש ב-projects, ב-folders או ב-organizations.
    • ‫RESOURCE_ID: מזהה המשאב.
  4. מאתרים את הרשומה ביומן הביקורת שמתאימה לבקשה שרוצים לפתור בה את הבעיה. במאמר שימוש ב-Logs Explorer מוסבר איך משתמשים ב-Logs Explorer כדי למצוא רשומות ספציפיות ביומן.

  5. בעמודה Summary של רשומת היומן, לוחצים על IAM ואז על Troubleshoot access issue.

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

  6. אופציונלי: כדי לפתור בעיות בבקשה אחרת שכוללת קישורי תפקידים מותנים וכללי דחייה, חוזרים לדף Logs Explorer וחוזרים על השלבים הקודמים.

gcloud

כדי לפתור בעיות בקישורי תפקידים מותנים ובכללי דחייה, משתמשים בפקודה gcloud policy-troubleshoot iam.

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

  • ‫EMAIL: כתובת האימייל של חשבון המשתמש שאתם רוצים לפתור את הבעיות בהרשאות שלו. ב-Agent Identity, צריך לציין את מזהה החשבון הראשי.
  • ‫RESOURCE: המשאב שבו ניתנת ההרשאה.
  • ‫PERMISSION: ההרשאה שרוצים לפתור את הבעיות שקשורות אליה.
  • ‫DESTINATION_IP: אופציונלי. כתובת ה-IP של יעד הבקשה שבה צריך להשתמש כשבודקים קישורי תפקידים מותנים. לדוגמה: 198.1.1.1.
  • ‫DESTINATION_PORT: אופציונלי. יציאת היעד של הבקשה שבה צריך להשתמש כשבודקים קישורי תפקידים מותנים. לדוגמה, `8080`.
  • ‫REQUEST_TIME: אופציונלי. חותמת הזמן של הבקשה שבה צריך להשתמש כשבודקים קישורי תפקידים מותנים. צריך להשתמש בחותמת זמן בפורמט RFC 3339, לדוגמה 2099-02-01T00:00:00Z.
  • ‫RESOURCE_NAME: אופציונלי. ערך שם המשאב שבו צריך להשתמש כשבודקים קישורי תפקידים מותנים. אפשר למצוא רשימה של הפורמטים המקובלים של שמות המשאבים במאמר פורמט השמות של המשאבים.
  • ‫RESOURCE_SERVICE: אופציונלי. ערך שירות המשאב שבו צריך להשתמש כשבודקים קישורי תפקידים מותנים. במאמר ערכי שירות של משאבים תוכלו למצוא רשימה של שמות השירותים שאפשר להשתמש בהם.
  • ‫RESOURCE_TYPE: אופציונלי. במאמר ערכים של סוגי משאבים תוכלו למצוא רשימה של סוגי המשאבים שאפשר להשתמש בהם.

מריצים את הפקודה gcloud policy-troubleshoot iam:

‫Linux,‏ macOS או Cloud Shell

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL \
    --permission=PERMISSION --destination-ip=DESTINATION_IP \
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME \
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE \
    --resource-type=RESOURCE_TYPE

‏Windows (PowerShell)

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL `
    --permission=PERMISSION --destination-ip=DESTINATION_IP `
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME `
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE `
    --resource-type=RESOURCE_TYPE

Windows‏ (cmd.exe)

gcloud policy-intelligence troubleshoot-policy iam RESOURCE --principal-email=EMAIL ^
    --permission=PERMISSION --destination-ip=DESTINATION_IP ^
    --destination-port=DESTINATION_PORT --request-time=REQUEST_TIME ^
    --resource-name=RESOURCE_NAME --resource-service=RESOURCE_SERVICE ^
    --resource-type=RESOURCE_TYPE

התשובה תכיל הסבר על הגישה של חשבון המשתמש. לכל קישור תפקיד וכלל דחייה עם תנאי, התשובה כוללת שדה conditionExplanation שמתאר אם התנאי מקבל את הערך True או False על סמך הקשר התנאי שסיפקתם.

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

תשובה

...
{
  "allowAccessState": "ALLOW_ACCESS_STATE_GRANTED",
  "combinedMembership": {
    "membership": "MEMBERSHIP_MATCHED",
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "condition": {
    "expression": " resource.type \u003d\u003d \"compute.googleapis.com/Instance\" \u0026\u0026 resource.service \u003d\u003d \"compute.googleapis.com\"",
    "title": "Compute instances only",
    "description": "Condition that limits permissions to only Compute instances"
  },
  "conditionExplanation": {
    "evaluationStates": [{
      "end": 51,
      "start": 1,
      "value": true
    }, {
      "end": 99,
      "start": 55,
      "value": true
    }],
    "value": true,
  },
  "memberships": {
    "user:my-user@example.com": {
      "membership": "MEMBERSHIP_MATCHED",
      "relevance": "HEURISTIC_RELEVANCE_HIGH"
    }
  },
  "relevance": "HEURISTIC_RELEVANCE_HIGH",
  "role": "roles/compute.viewer",
  "rolePermission": "ROLE_PERMISSION_INCLUDED",
  "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH"
}
...

REST

כדי לפתור בעיות שקשורות לקישורי תפקידים מותנים ולכללי דחייה, משתמשים ב-method‏ iam.troubleshoot של Policy Troubleshooter API.

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

  • ‫EMAIL: כתובת האימייל של חשבון המשתמש שאתם רוצים לפתור את הבעיות בהרשאות שלו. ב-Agent Identity, צריך לציין את מזהה החשבון הראשי.
  • ‫RESOURCE: המשאב שבו ניתנת ההרשאה.
  • ‫PERMISSION: ההרשאה שרוצים לפתור את הבעיות שקשורות אליה.
  • ‫DESTINATION_IP: אופציונלי. כתובת ה-IP של יעד הבקשה שבה צריך להשתמש כשבודקים קישורי תפקידים מותנים. לדוגמה: 198.1.1.1.
  • ‫DESTINATION_PORT: אופציונלי. יציאת היעד של הבקשה שבה צריך להשתמש כשבודקים קישורי תפקידים מותנים. לדוגמה, `8080`.
  • ‫REQUEST_TIME: אופציונלי. חותמת הזמן של הבקשה שבה צריך להשתמש כשבודקים קישורי תפקידים מותנים. צריך להשתמש בחותמת זמן בפורמט RFC 3339, לדוגמה 2099-02-01T00:00:00Z.
  • ‫RESOURCE_NAME: אופציונלי. ערך שם המשאב שבו צריך להשתמש כשבודקים קישורי תפקידים מותנים. אפשר למצוא רשימה של הפורמטים המקובלים של שמות המשאבים במאמר פורמט השמות של המשאבים.
  • ‫RESOURCE_SERVICE: אופציונלי. ערך שירות המשאב שבו צריך להשתמש כשבודקים קישורי תפקידים מותנים. במאמר ערכי שירות של משאבים תוכלו למצוא רשימה של שמות השירותים שאפשר להשתמש בהם.
  • ‫RESOURCE_TYPE: אופציונלי. במאמר ערכים של סוגי משאבים תוכלו למצוא רשימה של סוגי המשאבים שאפשר להשתמש בהם.

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

POST https://policytroubleshooter.googleapis.com/v3/iam:troubleshoot

תוכן בקשת JSON:

{
  "accessTuple": {
    "principal": "EMAIL",
    "fullResourceName": "RESOURCE",
    "permission": "PERMISSION",
    "conditionContext": {
      "destination": {
        "ip": DESTINATION_IP,
        "port": DESTINATION_PORT
      },
      "request": {
        "receiveTime": REQUEST_TIME
      },
      "resource": {
        "name": RESOURCE_NAME,
        "service": RESOURCE_SERVICE,
        "type": RESOURCE_TYPE
      }
    }
  }
}

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

התשובה תכיל הסבר על הגישה של חשבון המשתמש. לכל קישור תפקיד וכלל דחייה עם תנאי, התשובה כוללת שדה conditionExplanation שמתאר אם התנאי מקבל את הערך True או False על סמך הקשר התנאי שסיפקתם.

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

...
{
  "allowAccessState": "ALLOW_ACCESS_STATE_GRANTED",
  "role": "roles/compute.viewer",
  "rolePermission": "ROLE_PERMISSION_INCLUDED",
  "rolePermissionRelevance": "HEURISTIC_RELEVANCE_HIGH",
  "combinedMembership": {
    "membership": "MEMBERSHIP_MATCHED",
    "relevance": "HEURISTIC_RELEVANCE_HIGH"
  },
  "memberships": {
    "user:my-user@example.com": {
      "membership": "MEMBERSHIP_MATCHED",
      "relevance": "HEURISTIC_RELEVANCE_HIGH"
    }
  },
  "relevance": "HEURISTIC_RELEVANCE_HIGH",
  "condition": {
    "expression": " resource.type \u003d\u003d \"compute.googleapis.com/Instance\" \u0026\u0026 resource.service \u003d\u003d \"compute.googleapis.com\"",
    "title": "Compute instances only",
    "description": "Condition that limits permissions to only Compute instances"
  },
  "conditionExplanation": {
    "value": true,
    "evaluationStates": [{
      "start": 1,
      "end": 51,
      "value": true
    }, {
      "start": 55,
      "end": 99,
      "value": true
    }]
  }
}
...

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