Memecahkan masalah izin IAM

Pemecah Masalah Kebijakan membantu Anda memahami apakah akun utama dapat mengakses resource. Dengan mempertimbangkan akun utama, resource, dan izin, Pemecah Masalah Kebijakan memeriksa kebijakan izin, kebijakan penolakan, dan kebijakan Principal Access Boundary (PAB) yang memengaruhi akses akun utama. Kemudian, alat ini akan memberi tahu Anda apakah, berdasarkan kebijakan tersebut, akun utama dapat menggunakan izin yang ditentukan untuk mengakses resource. Bagian ini juga mencantumkan kebijakan yang relevan dan menjelaskan pengaruhnya terhadap akses akun utama.

Anda dapat mengakses Pemecah Masalah Kebijakan menggunakan konsolGoogle Cloud , Google Cloud CLI, atau REST API. Untuk kueri dasar, menggunakan konsol Google Cloud biasanya merupakan cara tercepat. Untuk skenario yang lebih kompleks, pertimbangkan gcloud CLI atau REST API.

Sebelum memulai

  • Aktifkan API Pemecah Masalah Kebijakan, jika belum diaktifkan.

    Peran yang diperlukan untuk mengaktifkan API

    Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

    Mengaktifkan API

Izin yang diperlukan

Untuk memecahkan masalah akses akun utama Anda sepenuhnya, Anda memerlukan izin berikut.

Izin untuk memecahkan masalah akses bagi setiap akun utama

Pemecah Masalah Kebijakan menganalisis akses akun utama ke resource berdasarkan kebijakan izin, kebijakan penolakan, kebijakan Principal Access Boundary, dan peran yang izinnya Anda miliki untuk melihatnya. Jika Anda tidak memiliki izin untuk melihat kebijakan yang berlaku untuk resource, atau jika Anda tidak memiliki izin untuk melihat peran khusus, Anda mungkin tidak dapat mengetahui apakah akun utama memiliki akses.

Izin untuk memecahkan masalah kebijakan izinkan dan tolak

Untuk memecahkan masalah kebijakan izinkan dan tolak, Anda memerlukan izin pada organisasi yang berisi resource yang ingin Anda pecahkan masalahnya. Izin ini memungkinkan Anda melihat kebijakan izin dan tolak yang mengontrol akses ke resource.

Untuk mendapatkan izin yang Anda perlukan untuk memecahkan masalah akses akun utama, minta administrator untuk memberi Anda peran IAM berikut pada organisasi yang berisi resource yang aksesnya ingin Anda pecahkan masalahnya:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Jika Anda tidak memiliki izin untuk melihat kebijakan izin dan tolak untuk suatu resource, hasil akses untuk kebijakan izin dan tolak tersebut adalah Unknown.

Izin untuk memecahkan masalah kebijakan Batas Akses Utama (PAB)

Untuk memecahkan masalah kebijakan Batas Akses Akun Utama, Anda memerlukan izin pada organisasi yang set akun utamanya menyertakan akun utama tersebut. Cara Anda mengidentifikasi organisasi ini bergantung pada jenis akun utama:

  • Akun Google dan grup Google: Organisasi yang terkait dengan domain Google Workspace yang menyertakan akun utama
  • Identitas gabungan (identitas dalam workforce identity pool atau workload identity pool): Organisasi yang berisi identity pool yang menyertakan akun utama
  • Akun layanan: Organisasi yang berisi project tempat akun layanan dibuat
  • Identitas agen: Organisasi yang berisi project tempat agen dibuat

Dengan izin ini, Anda dapat melihat kebijakan Batas Akses Akun Utama yang mengontrol hal yang dapat diakses oleh akun utama.

Untuk mendapatkan izin yang Anda perlukan untuk memecahkan masalah akses akun utama, minta administrator untuk memberi Anda peran IAM berikut pada organisasi yang sesuai:

  • Viewer Kebijakan Batas Akses Utama (PAB) (roles/iam.principalAccessBoundaryViewer)
  • Memecahkan masalah kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas project, folder, atau organisasi, atau terikat ke Agent Identity: Organization Administrator (roles/resourcemanager.organizationAdmin)
  • Memecahkan masalah kebijakan Batas Akses Utama (PAB) yang terikat ke domain Google Workspace: Workspace Pool IAM Admin (roles/iam.workspacePoolAdmin)
  • Memecahkan masalah kebijakan Batas Akses Utama (PAB) yang terikat ke workforce identity pool: IAM Workforce Pool Admin (roles/iam.workforcePoolAdmin)
  • Memecahkan masalah kebijakan Batas Akses Utama (PAB) yang terikat ke workload identity pool: Admin Workload Identity Pool IAM (roles/iam.workloadIdentityPoolAdmin)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Jika Anda tidak memiliki izin untuk melihat kebijakan Batas Akses Utama (PAB) yang berlaku untuk entitas, hasil akses untuk kebijakan Batas Akses Utama (PAB) adalah Unknown.

Izin untuk memecahkan masalah akses bagi anggota grup

Jika kebijakan izinkan dan tolak Anda menyertakan grup, Anda memerlukan izin Google Workspace Admin API groups.read untuk memecahkan masalah akses bagi setiap anggota grup. Admin Super dan Admin Grup otomatis memiliki izin ini. Untuk memberikan izin ini kepada pengguna yang bukan admin Super atau Grup, buat peran administrator Google Workspace khusus yang berisi hak istimewa groups.read (terletak di bagian Hak Istimewa Admin API) dan berikan kepada pengguna.

Jika Anda tidak memiliki izin ini, binding peran dan aturan penolakan yang berisi grup atau domain akan memiliki hasil akses Tidak diketahui, kecuali jika binding peran atau aturan penolakan juga secara eksplisit menyertakan akun utama.

Izin untuk memecahkan masalah akses bagi anggota domain

Jika kebijakan izinkan dan tolak Anda menyertakan akun Google Workspace atau domain Cloud Identity, Anda harus menjadi administrator domain untuk memecahkan masalah akses bagi setiap anggota domain.

Jika Anda tidak memiliki izin ini, binding peran dan aturan penolakan yang berisi grup atau domain akan memiliki hasil akses Tidak diketahui, kecuali jika binding peran atau aturan penolakan juga secara eksplisit menyertakan akun utama.

Memecahkan masalah akses

Untuk memecahkan masalah akses, Anda memerlukan akun utama, resource, dan izin yang ingin diperiksa. Informasi ini dapat diberikan oleh ID error:

  • ID Error: ID unik untuk pesan error izin. ID error memberikan konteks untuk error, termasuk akun utama, resource, izin, dan kondisi IAM yang didukung. ID error yang terkait dengan Identitas Agen memberikan konteks untuk Identitas Agen dan klaimnya, seperti platform dan container.

    Kondisi IAM yang didukung mencakup principal.type dan principal.subject.

Jika tidak memiliki ID error, Anda dapat memecahkan masalah akses dengan informasi berikut:

  • Principal: Identitas yang akan diperiksa. Anda dapat memasukkan salah satu dari berikut ini:

    • Alamat email: Harus merujuk ke pengguna, satu akun layanan, atau set akun utama akun layanan.

    • ID Identitas Agen: Harus mengikuti format ini: TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH.

      Contoh: agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent

      Pemecah Masalah Kebijakan mengekstrak atribut platform dan container resource dari string subjek agen menggunakan pola standar resources/{platform}/projects/{project_number}/.... Jika agen menggunakan format subjek non-standar, Pemecah Masalah Kebijakan tidak dapat memperoleh atributnya, dan binding set akun utama berbasis atribut akan bernilai Unknown.

      Jika agen tidak memiliki binding izin yang memberikan akses, Pemecah Masalah Kebijakan akan menampilkan status akses UNKNOWN_INFO, bukan NOT_GRANTED.

      ID menggunakan hal berikut:

      • TRUST_DOMAIN: Domain trust organisasi Anda (misalnya, agents.global.org-123456789012.system.id.goog)

      • SERVICE: Nama pendek layanan Google Cloud (misalnya, aiplatform atau discoveryengine)

      • RESOURCE_PATH: Jalur lengkap ke resource yang menghosting agen

    Jenis akun utama lainnya, termasuk grup, domain, workforce identity, dan workload identity, tidak didukung.

  • Resource: Nama lengkap resource yang ingin Anda pecahkan masalah aksesnya. Misalnya, untuk memecahkan masalah akses ke project my-project, masukkan //cloudresourcemanager.googleapis.com/projects/my-project. Untuk jenis resource lainnya, lihat contoh nama resource lengkap.

  • Izin: Izin yang akan diperiksa. Jika Anda menggunakan konsolGoogle Cloud , konsol tersebut akan menampilkan daftar saran saat Anda mengetik.

    Untuk memecahkan masalah izin, izin harus berlaku untuk resource dalam permintaan. Dengan kata lain, izin tersebut harus dapat digunakan untuk mengakses resource dengan cara tertentu. Jika izin tidak berlaku untuk resource, permintaan akan gagal. Misalnya, jika Anda mencoba memecahkan masalah izin compute.instances.get untuk cluster Google Kubernetes Engine, permintaan akan gagal karena izin compute.instance.get tidak dapat digunakan untuk mengakses cluster Google Kubernetes Engine.

    Untuk mengetahui daftar lengkap izin, lihat referensi izin.

Konsol

Untuk memecahkan masalah akses, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Pemecah Masalah Kebijakan.

    Buka Pemecah Masalah Kebijakan

  2. Jika Anda memiliki ID error, pilih ID Error dan masukkan ID tersebut.

  3. Jika Anda tidak memiliki ID error, pilih Manual.

    1. Masukkan alamat email akun utama atau ID Agen yang ingin Anda periksa aksesnya.

    2. Masukkan nama resource lengkap dari resource yang akan diperiksa.

      Jika Anda tidak mengetahui nama resource lengkap, lakukan salah satu hal berikut:

      • Jika Anda memecahkan masalah akses untuk project, folder, atau organisasi, mulai ketik untuk melihat opsi pelengkapan otomatis.
      • Jika Anda memecahkan masalah akses untuk jenis resource lain, klik Browse untuk membuka dialog penelusuran resource, lalu telusuri resource:

        1. Di kotak Select scope, pilih project, folder, atau organisasi yang akan ditelusuri.
        2. Di kotak Resource type, pilih jenis resource yang ingin Anda telusuri.
        3. Di kotak Search for resources, masukkan sebagian nama resource.
        4. Di bagian hasil, pilih resource yang ingin Anda periksa.
        5. Klik Select untuk memilih resource dan menutup dialog.
    3. Masukkan izin yang akan diperiksa.

      Jika Anda tidak mengetahui nama izin lengkap, mulailah mengetik untuk melihat opsi pelengkapan otomatis.

    4. Opsional: Untuk memeriksa beberapa resource dan izin, pilih Add Another Pair dan ulangi langkah sebelumnya.

  4. Klik Periksa akses.

gcloud

Untuk mengetahui alasan akun utama memiliki, atau tidak memiliki, izin IAM, gunakan perintah gcloud beta policy-troubleshoot iam.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • VERSION: Opsional. Versi perintah yang akan digunakan. Untuk memecahkan masalah akses berdasarkan kebijakan izinkan dan tolak saja, jangan tentukan versi. Untuk memecahkan masalah akses berdasarkan kebijakan izin, penolakan, dan kebijakan Batas Akses Utama (PAB), gunakan versi beta.
  • EMAIL: Alamat email akun utama yang izinnya ingin Anda pecahkan masalahnya. Untuk Identitas Agen, Anda harus memberikan ID akun utama.
  • RESOURCE: Resource yang diberi izin.
  • PERMISSION: Izin yang ingin Anda pecahkan masalahnya.

Jalankan perintah gcloud beta policy-troubleshoot iam:

Linux, macOS, atau 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

Anda akan melihat respons seperti berikut:

Respons

{
  "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

Untuk mengetahui alasan akun utama memiliki, atau tidak memiliki, izin IAM, gunakan metode iam.troubleshoot Policy Troubleshooter API.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • VERSION: Versi API yang akan digunakan untuk permintaan ini. Untuk memecahkan masalah akses berdasarkan kebijakan izinkan dan tolak saja, gunakan v3. Untuk memecahkan masalah akses berdasarkan kebijakan izin, penolakan, dan kebijakan Batas Akses Utama (PAB), gunakan v3beta.
  • EMAIL: Alamat email akun utama yang izinnya ingin Anda pecahkan masalahnya. Untuk Identitas Agen, Anda harus memberikan ID akun utama.
  • RESOURCE: Resource yang diberi izin.
  • PERMISSION: Izin yang ingin Anda pecahkan masalahnya.
  • PROJECT_ID: ID project yang ingin Anda gunakan untuk membuat permintaan. Project ID adalah string alfanumerik, seperti my-project.

Metode HTTP dan URL:

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

Meminta isi JSON:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

Memahami hasil Pemecah Masalah

Konsol

Halaman hasil berisi informasi berikut:

Detail evaluasi

Bagian Detail evaluasi berisi ringkasan akses yang sedang Anda pecahkan masalahnya, termasuk akun utama, resource, dan izin yang ditentukan. Jika memecahkan masalah beberapa pasangan izin resource, Anda dapat menggunakan daftar Access Evaluation untuk beralih di antara pasangan tersebut.

Detail kebijakan

Bagian Policy details berisi detail tentang pengaruh kebijakan izinkan, tolak, dan Batas Akses Akun Utama yang relevan terhadap akses akun utama.

Kebijakan Batas Akses Utama (PAB) yang relevan mencakup semua kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas yang menyertakan entitas.

Kebijakan izin dan penolakan yang relevan mencakup hal berikut:

  • Kebijakan izinkan resource
  • Kebijakan penolakan resource, jika ada
  • Kebijakan izinkan project induk, folder, dan organisasi resource, jika ada
  • Kebijakan penolakan project, folder, dan organisasi induk resource, jika ada

Kebijakan izinkan dan tolak project induk, folder, dan organisasi relevan karena adanya pewarisan kebijakan. Jika Anda melampirkan kebijakan izinkan atau tolak ke project, folder, atau organisasi, kebijakan tersebut juga berlaku untuk semua resource di dalam project, folder, atau organisasi tersebut.

Misalnya, jika kebijakan penolakan untuk organisasi mengatakan bahwa akun utama tidak dapat menggunakan izin tertentu, akun utama tidak dapat menggunakan izin tersebut untuk resource apa pun dalam organisasi. Aturan ini berlaku meskipun folder dan project di dalam organisasi tersebut memiliki kebijakan penolakan yang lebih permisif, atau mengizinkan kebijakan yang memberikan izin kepada entity utama.

Demikian pula, jika kebijakan izinkan untuk suatu project memberikan izin khusus kepada akun utama, maka akun utama memiliki izin tersebut untuk setiap resource dalam project, asalkan tidak ditolak.

Bagian Detail kebijakan berisi bagian berikut:

Mengakses status

Bagian Access state merangkum hasil untuk setiap jenis kebijakan (kebijakan Batas Akses Utama (PAB), kebijakan penolakan, dan kebijakan izin), serta menyatakan hasil keseluruhan. Hasilnya menunjukkan apakah akun utama dapat menggunakan izin untuk mengakses resource, sesuai dengan kebijakan yang relevan.

Agar pengguna dapat menggunakan izin untuk mengakses resource, semua jenis kebijakan harus mengizinkan akses. Untuk mengetahui informasi selengkapnya, lihat Evaluasi kebijakan.

Kebijakan Principal Access Boundary

Di bagian Principal access boundary policy, Anda dapat melihat semua kebijakan Batas Akses Utama yang berlaku untuk akun utama, dan binding kebijakan yang mengikat kebijakan ini ke akun utama.

Panel Policies mencantumkan semua kebijakan yang terikat ke set akun utama yang mencakup akun utama. Di samping setiap kebijakan, terdapat ikon yang menunjukkan pengaruh kebijakan tersebut terhadap akses akun utama.

Kebijakan Principal Access Boundary dapat memengaruhi akses akun utama dengan cara berikut:

  • Akun utama memenuhi syarat untuk mengakses resource: Kebijakan Batas Akses Akun Utama berlaku untuk akun utama, dan salah satu aturannya berisi resource yang dikueri.
  • Principal is ineligible to access the resource: Kebijakan Batas Akses Akun Utama berlaku untuk akun utama, tetapi resource yang dikueri tidak ada dalam aturan kebijakan tersebut.
  • Tidak diterapkan: Kebijakan Batas Akses Utama (PAB) tidak diterapkan dalam situasi berikut:

    • IAM tidak menerapkan izin yang ditentukan pada versi penegakan kebijakan Batas Akses Akun Utama. Akibatnya, kebijakan Batas Akses Akun Utama tidak dapat memblokir akses.
    • Karena kondisi dalam binding kebijakan, kebijakan atau binding Principal Access Boundary tidak berlaku untuk principal.
    • Kebijakan Principal Access Boundary tidak memiliki aturan.

    Jika kebijakan Batas Akses Akun Utama tidak diterapkan, kebijakan tersebut tidak dapat memengaruhi apakah akun utama dapat mengakses resource.

Untuk melihat aturan dan binding yang terkait dengan kebijakan Batas Akses Akun Utama, klik nama kebijakan. Panel di samping panel Policies menampilkan detail kebijakan.

Untuk melihat aturan dalam kebijakan, klik tab Boundary rules. Tab ini menampilkan tabel aturan kebijakan Principal Access Boundary yang relevan.

Aturan Principal Access Boundary relevan jika aturan tersebut memengaruhi hasil keseluruhan kueri Pemecah Masalah Kebijakan. Oleh karena itu, aturan yang relevan bervariasi bergantung pada hasil Pemecah Masalah Kebijakan. Misalnya, pertimbangkan situasi berikut:

  • Pemecah Masalah Kebijakan menunjukkan bahwa akun utama dapat mengakses resource. Oleh karena itu, aturan yang relevan adalah aturan yang membuat akun utama memenuhi syarat untuk mengakses resource.
  • Pemecah Masalah Kebijakan menunjukkan bahwa akun utama tidak dapat mengakses resource. Namun, menurut kebijakan Batas Akses Utama (PAB) yang relevan, entitas memenuhi syarat untuk mengakses resource. Akibatnya, tidak ada aturan yang relevan, karena kebijakan Principal Access Boundary bukanlah alasan akun utama tidak dapat mengakses resource.
  • Pemecah Masalah Kebijakan menunjukkan bahwa akun utama tidak dapat mengakses resource. Selain itu, menurut kebijakan Batas Akses Akun Utama yang relevan, akun utama tidak memenuhi syarat untuk mengakses resource. Akibatnya, aturan yang relevan adalah aturan yang tidak membuat akun utama memenuhi syarat untuk mengakses resource.

Untuk melihat semua aturan Principal Access Boundary dalam kebijakan, hapus centang pada kotak Show only relevant rules and bindings.

Kolom Findings dalam tabel aturan batas menunjukkan apakah aturan Principal Access Boundary berisi resource yang dikueri. Untuk melihat detail selengkapnya tentang aturan, klik Lihat detail aturan.

Untuk melihat binding kebijakan untuk kebijakan tersebut, klik tab Bindings. Tab ini menampilkan tabel binding kebijakan yang relevan untuk kebijakan Batas Akses Utama yang dipilih.

Binding kebijakan relevan jika secara efektif menerapkan kebijakan Batas Akses Akun Utama ke akun utama yang dikueri. Agar binding kebijakan dapat menerapkan kebijakan Principal Access Boundary ke akun utama, hal berikut harus terpenuhi:

  • Akun utama yang ditetapkan dalam binding kebijakan harus menyertakan akun utama yang dikueri
  • Setiap kondisi dalam binding kebijakan harus dievaluasi ke true untuk akun utama yang dikueri.

Untuk melihat semua binding kebijakan dengan set akun utama yang menyertakan akun utama yang dikueri, terlepas dari apakah akun utama yang dikueri memenuhi kondisi dalam binding, hapus centang pada kotak Show only relevant rules and bindings.

Untuk Identitas Agen, Pemecah Masalah Kebijakan mengevaluasi kebijakan Batas Akses Akun Utama yang terkait dengan hierarki resource project atau container hosting agen, dan mengevaluasi kondisi yang cocok dengan jenis identitas agen (principal.type == 'iam.googleapis.com/AgentPoolIdentity') dan pola subjek (principal.subject.startsWith(...)).

Kolom Temuan dalam tabel binding menunjukkan apakah binding diterapkan untuk akun utama yang dikueri. Untuk melihat detail selengkapnya tentang binding kebijakan, klik See binding details.

Kebijakan penolakan

Di bagian Deny policy, Anda dapat melihat semua kebijakan penolakan yang relevan, mengidentifikasi aturan penolakan yang menolak akses ke akun utama, dan memahami alasan aturan penolakan menolak atau tidak menolak izin akun utama.

Panel Resources with deny policies mencantumkan semua kebijakan penolakan yang relevan, yang diatur berdasarkan resource tempat kebijakan tersebut dilampirkan. Di samping setiap kebijakan penolakan, terdapat evaluasi akses. Evaluasi ini hanya berlaku untuk kebijakan penolakan tersebut—tidak mencerminkan akses apa pun dari kebijakan yang diwariskan. Jika Anda tidak memiliki izin untuk melihat kebijakan penolakan resource, daftar resource tidak akan menyertakan resource tersebut atau kebijakan penolakannya.

Untuk melihat aturan penolakan yang relevan dalam kebijakan penolakan ini, klik kebijakan penolakan. Untuk melihat semua aturan penolakan dalam kebijakan penolakan resource, klik resource. Aturan penolakan akan muncul di panel Deny rules. Panel ini berisi tabel semua aturan penolakan dengan akun utama atau izin yang dikueri untuk resource atau kebijakan penolakan yang telah Anda pilih.

Kolom Access menunjukkan apakah aturan penolakan menolak izin akun utama. Untuk melihat detail selengkapnya tentang aturan penolakan, klik See deny rule di baris aturan tersebut.

Kebijakan izin

Di bagian Allow policy, Anda dapat melihat semua kebijakan izin yang relevan, mengidentifikasi binding peran yang memberikan akses ke akun utama, dan memahami alasan binding peran memberikan atau tidak memberikan izin kepada akun utama.

Panel Resources mencantumkan resource yang ditentukan dan ancestor-nya. Di samping setiap resource, terdapat evaluasi akses. Evaluasi ini hanya berlaku untuk kebijakan izin resource tersebut—evaluasi ini tidak mencerminkan akses apa pun dari kebijakan yang diwariskan. Jika Anda tidak memiliki izin untuk melihat kebijakan izin resource, daftar resource tidak akan menyertakan resource tersebut.

Untuk melihat binding peran yang relevan dalam kebijakan izin resource dan melihat bagaimana binding tersebut memberikan atau tidak memberikan izin kepada akun utama, klik resource. Binding peran kebijakan izin akan muncul di panel Role bindings.

Panel Role bindings berisi tabel binding peran dalam kebijakan izin resource yang dipilih. Secara default, tabel hanya berisi binding peran yang menyertakan peran dengan izin yang ditentukan. Jika principal tidak memiliki akses, tabel juga akan menampilkan binding peran dengan peran khusus yang dapat diedit. Untuk melihat semua binding peran, hapus centang pada kotak Show only relevant bindings.

Kolom Access menunjukkan apakah binding peran memberikan izin kepada akun utama. Untuk melihat detail selengkapnya tentang binding peran, klik See binding details di baris binding peran tersebut.

Saat mengevaluasi kebijakan izin untuk identitas agen, Pemecah Masalah Kebijakan akan memeriksa apakah agen cocok dengan salah satu ID akun utama berikut:

ID utama Contoh
Identitas agen langsung principal://TRUST_DOMAIN/resources/SERVICE/RESOURCE_PATH
Set entitas domain trust principalSet://TRUST_DOMAIN/*
Set akun utama platform principalSet://TRUST_DOMAIN/attribute.platform/SERVICE
Set akun utama container resource principalSet://TRUST_DOMAIN/attribute.container/projects/PROJECT_NUMBER
Set akun utama container platform principalSet://TRUST_DOMAIN/attribute.platformContainer/SERVICE/projects/PROJECT_NUMBER

Saat Anda memecahkan masalah akses untuk akun utama non-agen, seperti pengguna atau akun layanan, setiap binding peran untuk Identitas Agen akan dievaluasi menjadi Not matched.

gcloud

Respons berisi empat bagian utama: deskripsi tuple akses dalam permintaan, hasil evaluasi kebijakan izin, hasil evaluasi kebijakan penolakan, dan status akses keseluruhan.

  • accessTuple: Deskripsi tuple akses dalam permintaan, termasuk konteks kondisi apa pun yang Anda berikan. Bagian ini juga berisi ringkasan tag yang berlaku untuk resource.
  • allowPolicyExplanation: Ringkasan apakah kebijakan izin yang relevan memberikan izin kepada akun utama, diikuti dengan daftar kebijakan izin dan binding perannya.

    Untuk setiap kebijakan izin, respons mencantumkan semua binding peran dalam kebijakan dan mengevaluasinya berdasarkan kriteria berikut:

    • Apakah binding peran menyertakan izin.
    • Apakah binding peran menyertakan akun utama.
    • Apakah kondisi dalam binding peran, jika ada, terpenuhi.

    Kemudian, respons akan mencetak teks JSON lengkap dari kebijakan izin.

  • denyPolicyExplanation: Ringkasan apakah kebijakan penolakan yang relevan menolak izin akun utama, diikuti dengan daftar resource yang memiliki kebijakan penolakan. Untuk setiap resource, respons mencantumkan semua kebijakan penolakan yang dilampirkan ke resource.

    Untuk setiap kebijakan penolakan, respons akan mencetak metadata kebijakan, mencantumkan aturan penolakan dalam kebijakan, lalu mengevaluasi setiap aturan berdasarkan kriteria berikut:

    • Apakah aturan penolakan menyertakan izin.
    • Apakah izin tercantum sebagai pengecualian dalam aturan penolakan.
    • Apakah aturan penolakan menyertakan akun utama.
    • Apakah akun utama tercantum sebagai pengecualian dalam aturan penolakan.
    • Apakah kondisi dalam aturan penolakan, jika ada, terpenuhi.
  • overallAccessState: Apakah akun utama dapat menggunakan izin yang ditentukan untuk mengakses resource yang ditentukan berdasarkan kebijakan izin, kebijakan penolakan, dan kebijakan Principal Access Boundary yang relevan.

    Kebijakan Batas Akses Utama (PAB) yang relevan mencakup semua kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas yang menyertakan entitas.

    Kebijakan izin dan penolakan yang relevan mencakup hal berikut:

    • Kebijakan izinkan resource
    • Kebijakan penolakan resource, jika ada
    • Kebijakan izinkan project induk, folder, dan organisasi resource, jika ada
    • Kebijakan penolakan project, folder, dan organisasi induk resource, jika ada

    Kebijakan izinkan dan tolak project induk, folder, dan organisasi relevan karena adanya pewarisan kebijakan. Jika Anda melampirkan kebijakan izinkan atau tolak ke project, folder, atau organisasi, kebijakan tersebut juga berlaku untuk semua resource di dalam project, folder, atau organisasi tersebut.

    Misalnya, jika kebijakan penolakan untuk organisasi mengatakan bahwa akun utama tidak dapat menggunakan izin tertentu, akun utama tidak dapat menggunakan izin tersebut untuk resource apa pun dalam organisasi. Aturan ini berlaku meskipun folder dan project di dalam organisasi tersebut memiliki kebijakan penolakan yang lebih permisif, atau mengizinkan kebijakan yang memberikan izin kepada entity utama.

    Demikian pula, jika kebijakan izinkan untuk suatu project memberikan izin khusus kepada akun utama, maka akun utama memiliki izin tersebut untuk setiap resource dalam project, asalkan tidak ditolak.

    Agar pengguna dapat menggunakan izin untuk mengakses resource, semua jenis kebijakan harus mengizinkan akses. Untuk mengetahui informasi selengkapnya, lihat Evaluasi kebijakan.

  • pabPolicyExplanation: Ringkasan apakah kebijakan Batas Akses Akun Utama yang relevan mengizinkan akun utama mengakses resource, diikuti dengan binding kebijakan Batas Akses Akun Utama dan kebijakan Batas Akses Akun Utama yang relevan.

    Kebijakan Batas Akses Utama (PAB) dapat mengizinkan akses, tidak mengizinkan akses, atau tidak diterapkan. kebijakan Batas Akses Utama (PAB) tidak diterapkan dalam situasi berikut:

    • IAM tidak menerapkan izin yang ditentukan pada versi penegakan kebijakan Batas Akses Akun Utama. Akibatnya, kebijakan Batas Akses Akun Utama tidak dapat memblokir akses.
    • Karena kondisi dalam binding kebijakan, kebijakan atau binding Principal Access Boundary tidak berlaku untuk principal.
    • Kebijakan Principal Access Boundary tidak memiliki aturan.

    Jika kebijakan Batas Akses Akun Utama tidak diterapkan, kebijakan tersebut tidak dapat memengaruhi apakah akun utama dapat mengakses resource.

    Respons juga mencantumkan semua binding kebijakan yang menyertakan akun utama, dan detail kebijakan Batas Akses Akun Utama di setiap binding kebijakan tersebut:

    • Untuk setiap binding kebijakan Batas Akses Akun Utama, respons akan mencetak apakah binding kebijakan diterapkan untuk akun utama, lalu mencetak teks binding kebijakan. Binding kebijakan diterapkan jika akun utama yang ditetapkan dalam binding menyertakan akun utama yang dikueri, dan jika kondisi dalam binding kebijakan bernilai true untuk akun utama yang dikueri. Jika binding kebijakan tidak diterapkan, kebijakan tidak dapat memengaruhi apakah akun utama dapat mengakses resource.
    • Untuk setiap kebijakan Batas Akses Akun Utama, respons akan mencetak hal berikut:

      • Apakah kebijakan mengizinkan akses, tidak mengizinkan akses, atau tidak diterapkan.
      • Versi penerapan kebijakan. Nomor versi ini menentukan apakah IAM menerapkan kebijakan Batas Akses Akun Utama ini untuk izin yang dikueri. Jika izin tidak diterapkan, kebijakan tidak dapat memengaruhi apakah akun utama dapat mengakses resource.
      • Aturan dalam kebijakan Batas Akses Akun Utama dan apakah setiap aturan mengizinkan akses. Untuk setiap aturan, respons menunjukkan apakah resource yang dikueri disertakan dalam aturan.

        Resource disertakan dalam aturan jika salah satu kondisi berikut terpenuhi:

        • Resource tercantum dalam aturan. Hanya resource Resource Manager (project, folder, dan organisasi) yang dapat dicantumkan langsung dalam aturan Principal Access Boundary.
        • Salah satu ancestor resource (yaitu, project, folder, atau organisasi di atas resource dalam hierarki resource) tercantum dalam aturan.

Banyak objek dalam respons juga memiliki kolom relevance. Nilai dalam kolom ini menunjukkan seberapa besar kontribusi objek tersebut terhadap status akses keseluruhan. Kolom relevance dapat memiliki nilai berikut:

  • HEURISTIC_RELEVANCE_HIGH: Menunjukkan bahwa objek memiliki dampak yang kuat pada hasil. Dengan kata lain, menghapus objek kemungkinan akan mengubah status akses secara keseluruhan. Misalnya, binding peran yang memberikan izin yang ditentukan kepada akun utama akan memiliki nilai relevansi ini.

  • HEURISTIC_RELEVANCE_NORMAL: Menunjukkan bahwa objek memiliki dampak terbatas pada hasil. Dengan kata lain, menghapus objek tidak akan mengubah status akses secara keseluruhan. Misalnya, aturan penolakan yang tidak berisi izin atau akun utama akan memiliki nilai relevansi ini.

REST

Respons berisi empat bagian utama: status akses keseluruhan, deskripsi tuple akses dalam permintaan, hasil evaluasi kebijakan izin, dan hasil evaluasi kebijakan penolakan.

  • overallAccessState: Apakah akun utama dapat menggunakan izin yang ditentukan untuk mengakses resource yang ditentukan berdasarkan kebijakan izin, kebijakan penolakan, dan kebijakan Principal Access Boundary yang relevan.

    Kebijakan Batas Akses Utama (PAB) yang relevan mencakup semua kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas yang menyertakan entitas.

    Kebijakan izin dan penolakan yang relevan mencakup hal berikut:

    • Kebijakan izinkan resource
    • Kebijakan penolakan resource, jika ada
    • Kebijakan izinkan project induk, folder, dan organisasi resource, jika ada
    • Kebijakan penolakan project, folder, dan organisasi induk resource, jika ada

    Kebijakan izinkan dan tolak project induk, folder, dan organisasi relevan karena adanya pewarisan kebijakan. Jika Anda melampirkan kebijakan izinkan atau tolak ke project, folder, atau organisasi, kebijakan tersebut juga berlaku untuk semua resource di dalam project, folder, atau organisasi tersebut.

    Misalnya, jika kebijakan penolakan untuk organisasi mengatakan bahwa akun utama tidak dapat menggunakan izin tertentu, akun utama tidak dapat menggunakan izin tersebut untuk resource apa pun dalam organisasi. Aturan ini berlaku meskipun folder dan project di dalam organisasi tersebut memiliki kebijakan penolakan yang lebih permisif, atau mengizinkan kebijakan yang memberikan izin kepada entity utama.

    Demikian pula, jika kebijakan izinkan untuk suatu project memberikan izin khusus kepada akun utama, maka akun utama memiliki izin tersebut untuk setiap resource dalam project, asalkan tidak ditolak.

    Agar pengguna dapat menggunakan izin untuk mengakses resource, semua jenis kebijakan harus mengizinkan akses. Untuk mengetahui informasi selengkapnya, lihat Evaluasi kebijakan.

  • accessTuple: Deskripsi tuple akses dalam permintaan, termasuk konteks kondisi apa pun yang Anda berikan. Bagian ini juga berisi ringkasan tag yang berlaku untuk resource.
  • allowPolicyExplanation: Ringkasan apakah kebijakan izin yang relevan memberikan izin kepada akun utama, diikuti dengan daftar kebijakan izin dan binding perannya.

    Untuk setiap kebijakan izin, respons mencantumkan semua binding peran dalam kebijakan dan mengevaluasinya berdasarkan kriteria berikut:

    • Apakah binding peran menyertakan izin.
    • Apakah binding peran menyertakan akun utama.
    • Apakah kondisi dalam binding peran, jika ada, terpenuhi.

    Kemudian, respons akan mencetak teks JSON lengkap dari kebijakan izin.

  • denyPolicyExplanation: Ringkasan apakah kebijakan penolakan yang relevan menolak izin akun utama, diikuti dengan daftar resource yang memiliki kebijakan penolakan. Untuk setiap resource, respons mencantumkan semua kebijakan penolakan yang dilampirkan ke resource.

    Untuk setiap kebijakan penolakan, respons akan mencetak metadata kebijakan, mencantumkan aturan penolakan dalam kebijakan, lalu mengevaluasi setiap aturan berdasarkan kriteria berikut:

    • Apakah aturan penolakan menyertakan izin.
    • Apakah izin tercantum sebagai pengecualian dalam aturan penolakan.
    • Apakah aturan penolakan menyertakan akun utama.
    • Apakah akun utama tercantum sebagai pengecualian dalam aturan penolakan.
    • Apakah kondisi dalam aturan penolakan, jika ada, terpenuhi.
  • pabPolicyExplanation: Ringkasan apakah kebijakan Batas Akses Akun Utama yang relevan mengizinkan akun utama mengakses resource, diikuti dengan binding kebijakan Batas Akses Akun Utama dan kebijakan Batas Akses Akun Utama yang relevan.

    Kebijakan Batas Akses Utama (PAB) dapat mengizinkan akses, tidak mengizinkan akses, atau tidak diterapkan. kebijakan Batas Akses Utama (PAB) tidak diterapkan dalam situasi berikut:

    • IAM tidak menerapkan izin yang ditentukan pada versi penegakan kebijakan Batas Akses Akun Utama. Akibatnya, kebijakan Batas Akses Akun Utama tidak dapat memblokir akses.
    • Karena kondisi dalam binding kebijakan, kebijakan atau binding Principal Access Boundary tidak berlaku untuk principal.
    • Kebijakan Principal Access Boundary tidak memiliki aturan.

    Jika kebijakan Batas Akses Akun Utama tidak diterapkan, kebijakan tersebut tidak dapat memengaruhi apakah akun utama dapat mengakses resource.

    Respons juga mencantumkan semua binding kebijakan yang menyertakan akun utama, dan detail kebijakan Batas Akses Akun Utama di setiap binding kebijakan tersebut:

    • Untuk setiap binding kebijakan Batas Akses Akun Utama, respons akan mencetak apakah binding kebijakan diterapkan untuk akun utama, lalu mencetak teks binding kebijakan. Binding kebijakan diterapkan jika akun utama yang ditetapkan dalam binding menyertakan akun utama yang dikueri, dan jika kondisi dalam binding kebijakan bernilai true untuk akun utama yang dikueri. Jika binding kebijakan tidak diterapkan, kebijakan tidak dapat memengaruhi apakah akun utama dapat mengakses resource.
    • Untuk setiap kebijakan Batas Akses Akun Utama, respons akan mencetak hal berikut:

      • Apakah kebijakan mengizinkan akses, tidak mengizinkan akses, atau tidak diterapkan.
      • Versi penerapan kebijakan. Nomor versi ini menentukan apakah IAM menerapkan kebijakan Batas Akses Akun Utama ini untuk izin yang dikueri. Jika izin tidak diterapkan, kebijakan tidak dapat memengaruhi apakah akun utama dapat mengakses resource.
      • Aturan dalam kebijakan Batas Akses Akun Utama dan apakah setiap aturan mengizinkan akses. Untuk setiap aturan, respons menunjukkan apakah resource yang dikueri disertakan dalam aturan.

        Resource disertakan dalam aturan jika salah satu kondisi berikut terpenuhi:

        • Resource tercantum dalam aturan. Hanya resource Resource Manager (project, folder, dan organisasi) yang dapat dicantumkan langsung dalam aturan Principal Access Boundary.
        • Salah satu ancestor resource (yaitu, project, folder, atau organisasi di atas resource dalam hierarki resource) tercantum dalam aturan.

Banyak objek dalam respons juga memiliki kolom relevance. Nilai dalam kolom ini menunjukkan seberapa besar kontribusi objek tersebut terhadap status akses keseluruhan. Kolom relevance dapat memiliki nilai berikut:

  • HEURISTIC_RELEVANCE_HIGH: Menunjukkan bahwa objek memiliki dampak yang kuat pada hasil. Dengan kata lain, menghapus objek kemungkinan akan mengubah status akses secara keseluruhan. Misalnya, binding peran yang memberikan izin yang ditentukan kepada akun utama akan memiliki nilai relevansi ini.

  • HEURISTIC_RELEVANCE_NORMAL: Menunjukkan bahwa objek memiliki dampak terbatas pada hasil. Dengan kata lain, menghapus objek tidak akan mengubah status akses secara keseluruhan. Misalnya, aturan penolakan yang tidak berisi izin atau akun utama akan memiliki nilai relevansi ini.

Memecahkan masalah binding peran bersyarat

Pemecah Masalah Kebijakan otomatis memecahkan masalah binding peran bersyarat dan aturan penolakan berdasarkan tag. Alat ini juga secara otomatis memecahkan masalah binding kebijakan Principal Access Boundary dengan kondisi berdasarkan akun utama.

Untuk memecahkan masalah jenis binding peran bersyarat atau aturan penolakan bersyarat lainnya, Pemecah Masalah Kebijakan memerlukan konteks tambahan tentang permintaan tersebut. Misalnya, untuk memecahkan masalah kondisi berdasarkan atribut tanggal/waktu, Pemecah Masalah Kebijakan memerlukan waktu permintaan.

Di gcloud CLI dan REST API, Anda memberikan konteks tambahan ini secara manual.

Di konsol Google Cloud , Anda dapat memberikan konteks tambahan ini dengan memecahkan masalah langsung dari log audit Aktivitas Admin atau log audit Akses Data. Setiap entri log audit sesuai dengan permintaan keGoogle Cloud API, atau tindakan yang dilakukan Google Cloud atas nama Anda. Saat Anda memecahkan masalah dari log audit, Pemecah Masalah Kebijakan akan otomatis mendapatkan informasi tambahan tentang permintaan, seperti tanggal dan waktunya, yang memungkinkan Pemecah Masalah Kebijakan menganalisis binding peran bersyarat dan aturan penolakan.

Konsol

Untuk memecahkan masalah binding peran bersyarat dan aturan penolakan, lakukan hal berikut:

  1. Di konsol Google Cloud , buka halaman Logs Explorer.

    Buka Logs Explorer

  2. Jika judul halaman adalah Legacy Logs Viewer, klik menu drop-down Upgrade, lalu pilih Upgrade to the new Logs Explorer.

  3. Untuk melihat log audit Aktivitas Admin dan audit akses data saja, masukkan kueri berikut di Pembuat Kueri, lalu klik Run query:

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

    Ganti nilai berikut:

    • RESOURCE_TYPE: Jenis resource yang log auditnya Anda cantumkan. Gunakan projects, folders, atau organizations.
    • RESOURCE_ID: ID resource Anda.
  4. Temukan entri log audit yang sesuai dengan permintaan yang ingin Anda pecahkan masalahnya. Untuk mempelajari cara menggunakan Logs Explorer untuk menemukan entri log tertentu, lihat Menggunakan Logs Explorer.

  5. Di kolom Summary pada entri log, klik IAM, lalu klik Troubleshoot access issue.

    Pemecah Masalah Kebijakan menggunakan informasi dalam entri log untuk memecahkan masalah akses, lalu menampilkan hasilnya kepada Anda. Konteks tambahan dicantumkan dalam detail evaluasi di bagian Condition context. Untuk melihat detail konteks, klik View condition context. Untuk mempelajari lebih lanjut halaman hasil Pemecah Masalah Kebijakan, lihat Memahami hasil Pemecah Masalah di halaman ini.

  6. Opsional: Untuk memecahkan masalah permintaan lain yang melibatkan binding peran bersyarat dan aturan penolakan, kembali ke halaman Logs Explorer dan ulangi langkah-langkah sebelumnya.

gcloud

Untuk memecahkan masalah binding peran bersyarat dan aturan penolakan, gunakan perintah gcloud policy-troubleshoot iam.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • EMAIL: Alamat email akun utama yang izinnya ingin Anda pecahkan masalahnya. Untuk Identitas Agen, Anda harus memberikan ID akun utama.
  • RESOURCE: Resource yang diberi izin.
  • PERMISSION: Izin yang ingin Anda pecahkan masalahnya.
  • DESTINATION_IP: Opsional. Alamat IP tujuan permintaan yang akan digunakan saat memeriksa binding peran bersyarat. Misalnya, 198.1.1.1.
  • DESTINATION_PORT: Opsional. Port tujuan permintaan yang akan digunakan saat memeriksa binding peran bersyarat. Misalnya, `8080`.
  • REQUEST_TIME: Opsional. Stempel waktu permintaan yang akan digunakan saat memeriksa binding peran bersyarat. Gunakan stempel waktu dalam format RFC 3339—misalnya, 2099-02-01T00:00:00Z.
  • RESOURCE_NAME: Opsional. Nilai nama resource yang akan digunakan saat memeriksa binding peran bersyarat. Untuk daftar format nama resource yang diterima, lihat Format nama resource.
  • RESOURCE_SERVICE: Opsional. Nilai layanan resource yang akan digunakan saat memeriksa binding peran bersyarat. Untuk daftar nama layanan yang diterima, lihat Nilai layanan resource.
  • RESOURCE_TYPE: Opsional. Untuk mengetahui daftar jenis resource yang diterima, lihat Nilai jenis resource.

Jalankan perintah gcloud policy-troubleshoot iam:

Linux, macOS, atau 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

Respons berisi penjelasan tentang akses akun utama. Untuk setiap binding peran dan aturan penolakan dengan kondisi, responsnya mencakup kolom conditionExplanation yang menjelaskan apakah kondisi dievaluasi ke true atau false berdasarkan konteks kondisi yang Anda berikan.

Misalnya, berikut adalah evaluasi binding peran dengan kondisi yang menentukan jenis resource dan layanan resource:

Respons

...
{
  "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

Untuk memecahkan masalah binding peran bersyarat dan aturan penolakan, gunakan metode iam.troubleshoot Policy Troubleshooter API.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • EMAIL: Alamat email akun utama yang izinnya ingin Anda pecahkan masalahnya. Untuk Identitas Agen, Anda harus memberikan ID akun utama.
  • RESOURCE: Resource yang diberi izin.
  • PERMISSION: Izin yang ingin Anda pecahkan masalahnya.
  • DESTINATION_IP: Opsional. Alamat IP tujuan permintaan yang akan digunakan saat memeriksa binding peran bersyarat. Misalnya, 198.1.1.1.
  • DESTINATION_PORT: Opsional. Port tujuan permintaan yang akan digunakan saat memeriksa binding peran bersyarat. Misalnya, `8080`.
  • REQUEST_TIME: Opsional. Stempel waktu permintaan yang akan digunakan saat memeriksa binding peran bersyarat. Gunakan stempel waktu dalam format RFC 3339—misalnya, 2099-02-01T00:00:00Z.
  • RESOURCE_NAME: Opsional. Nilai nama resource yang akan digunakan saat memeriksa binding peran bersyarat. Untuk daftar format nama resource yang diterima, lihat Format nama resource.
  • RESOURCE_SERVICE: Opsional. Nilai layanan resource yang akan digunakan saat memeriksa binding peran bersyarat. Untuk daftar nama layanan yang diterima, lihat Nilai layanan resource.
  • RESOURCE_TYPE: Opsional. Untuk mengetahui daftar jenis resource yang diterima, lihat Nilai jenis resource.

Metode HTTP dan URL:

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

Meminta isi 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
      }
    }
  }
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi penjelasan tentang akses akun utama. Untuk setiap binding peran dan aturan penolakan dengan kondisi, responsnya mencakup kolom conditionExplanation yang menjelaskan apakah kondisi dievaluasi ke true atau false berdasarkan konteks kondisi yang Anda berikan.

Misalnya, berikut adalah evaluasi binding peran dengan kondisi yang menentukan jenis resource dan layanan resource:

...
{
  "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
    }]
  }
}
...

Langkah berikutnya