Memecahkan masalah kebijakan terkait IAM

Halaman ini menjelaskan cara memecahkan masalah kebijakan izin, kebijakan penolakan, kebijakan Principal Access Boundary, dan Unified Access Policy (UAP) Identity and Access Management (IAM).

Menggunakan Pemecah Masalah Kebijakan

Jika Anda perlu memecahkan masalah akses untuk akun utama tertentu, gunakan Pemecah Masalah Kebijakan untuk 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.

Pemecah Masalah Kebijakan tidak mendukung pemecahan masalah UAP. Untuk mempelajari cara memecahkan masalah UAP, lihat Memecahkan masalah secara manual di halaman ini.

Untuk mempelajari cara menggunakan Pemecah Masalah Kebijakan guna memecahkan masalah kebijakan izin, kebijakan penolakan, dan kebijakan Principal Access Boundary, lihat Memecahkan masalah izin IAM.

Jika perlu menemukan binding peran tertentu dalam kebijakan izinkan, Anda dapat menelusuri kebijakan izinkan.

Inventaris Aset Cloud memungkinkan Anda menelusuri kebijakan izinkan untuk binding peran yang cocok dengan parameter yang ditentukan. Anda dapat menggunakan berbagai parameter penelusuran, termasuk parameter berikut:

  • Jenis aset
  • Jenis Utama:
  • Peran
  • Project
  • Folder
  • Organisasi

Untuk mengetahui informasi selengkapnya, lihat Menelusuri kebijakan izin IAM.

Memecahkan masalah secara manual

Untuk memecahkan masalah akses akun utama ke resource secara manual, tinjau semua kebijakan yang dapat memengaruhi akses akun utama.

Peran yang diperlukan

Untuk meninjau semua kebijakan yang memengaruhi akses akun utama, Anda memerlukan izin untuk melihat kebijakan izin, kebijakan penolakan, binding UAP, dan UAP.

Untuk mendapatkan izin yang diperlukan untuk melihat semua kebijakan izin dan penolakan, minta administrator untuk memberi Anda peran IAM Security Reviewer (roles/iam.securityReviewer) di organisasi yang berisi resource.

Untuk mendapatkan izin yang Anda perlukan untuk melihat semua binding UAP yang memengaruhi resource target , minta administrator untuk memberi Anda peran IAM berikut pada organisasi yang berisi resource tersebut:

  • Organization Administrator (roles/resourcemanager.organizationAdmin)
  • Mencantumkan binding untuk resource khusus layanan: Peran dengan izin SERVICE.RESOURCE.searchPolicyBindings, dengan RESOURCE adalah jenis resource dan SERVICE adalah layanan yang memiliki resource tersebut.

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

Peran bawaan ini berisi izin yang diperlukan untuk melihat semua binding UAP yang memengaruhi resource target . Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat semua binding UAP yang memengaruhi resource target:

  • Mencantumkan binding untuk organisasi: resourcemanager.organizations.searchPolicyBindings
  • Mencantumkan binding untuk folder: resourcemanager.folders.searchPolicyBindings
  • Mencantumkan binding untuk project: resourcemanager.projects.searchPolicyBindings
  • Mencantumkan binding untuk resource khusus layanan: SERVICE.RESOURCE.searchPolicyBindings

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Untuk mendapatkan izin yang diperlukan guna melihat semua binding UAP yang memengaruhi resource target, minta administrator untuk memberi Anda peran yang memungkinkan Anda mencantumkan binding untuk resource tersebut dan ancestor resource tersebut. Peran ini harus menyertakan izin SERVICE.RESOURCE.searchPolicyBindings, dengan RESOURCE adalah jenis resource target dan SERVICE adalah layanan yang memiliki resource tersebut.

Untuk mendapatkan izin yang diperlukan untuk melihat semua UAP, minta administrator untuk memberi Anda peran IAM Access Policy Viewer (roles/iam.accessPolicyViewer) di organisasi yang berisi resource. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk melihat semua UAP. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk melihat semua UAP:

  • Mencantumkan binding untuk organisasi: resourcemanager.organizations.searchPolicyBindings
  • Mencantumkan binding untuk folder: resourcemanager.folders.searchPolicyBindings
  • Mencantumkan binding untuk project: resourcemanager.projects.searchPolicyBindings
  • Mencantumkan binding untuk resource khusus layanan: SERVICE.RESOURCE.searchPolicyBindings

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Melihat semua kebijakan izin dan tolak yang berlaku untuk resource

Di Google Cloud, kebijakan izinkan dan tolak berikut memengaruhi akses ke resource:

  • 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 memengaruhi akses ke resource 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.

Gabungan dari semua kebijakan ini disebut kebijakan yang berlaku atau kebijakan efektif untuk resource.

Di Google Cloud, Anda bisa mendapatkan daftar semua kebijakan izinkan dan tolak yang memengaruhi akses ke project menggunakan perintah gcloud beta projects get-ancestors-iam-policy dengan flag --include-deny. Bersama-sama, kebijakan ini membentuk kebijakan yang berlaku untuk project. Anda dapat menyelidiki setiap kebijakan untuk melihat pengaruhnya terhadap akses akun utama.

gcloud

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

  • PROJECT_ID: Project ID Google Cloud Anda. Project ID adalah string alfanumerik, seperti my-project.

Jalankan perintah gcloud beta projects get-ancestors-iam-policy :

Linux, macOS, atau Cloud Shell

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Windows (PowerShell)

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Windows (cmd.exe)

gcloud beta projects get-ancestors-iam-policy PROJECT_ID --include-deny --format=json

Respons berisi kebijakan izinkan dan tolak untuk proyek; folder apa pun yang merupakan ancestor project; dan organisasi. Contoh berikut menunjukkan kebijakan izinkan untuk organisasi 1234567890123 dan project my-project, serta kebijakan penolakan project my-project:

[
  {
    "id": "1234567890123",
    "policy": {
      "bindings": [
        {
          "members": [
            "group:cloud-admins@example.com"
          ],
          "role": "roles/iam.denyAdmin"
        },
        {
          "members": [
            "user:raha@example.com"
          ],
          "role": "roles/iam.serviceAccountAdmin"
        }
      ],
      "etag": "BwXW6Eab7TI=",
      "version": 1
    },
    "type": "organization"
  },
  {
    "id": "my-project",
    "policy": {
      "bindings": [
        {
          "members": [
            "group:cloud-admins@example.com"
          ],
          "role": "roles/owner"
        }
      ],
      "etag": "BwXXjOM7L6M=",
      "type": "project"
    }
  },
  {
    "id": "my-project",
    "policy": {
      "createTime": "2022-02-14T21:46:35.865279Z",
      "displayName": "My deny policy",
      "etag": "MTgyMzg2ODcwNTEyMjMxMTM3Mjg=",
      "kind": "DenyPolicy",
      "name": "policies/cloudresourcemanager.googleapis.com%2Fprojects%2F123456789012/denypolicies/my-deny-policy",
      "rules": [
        {
          "denyRule": {
            "deniedPermissions": [
              "iam.googleapis.com/serviceAccounts.create"
            ],
            "deniedPrincipals": [
              "user:raha@example.com"
            ]
          },
          "description": "Prevent service account creation"
        }
      ],
      "uid": "c83e3dc3-d8a6-6f51-4018-814e9f200b05",
      "updateTime": "2022-02-14T21:46:35.865279Z"
    },
    "type": "project"
  }
]

Dalam contoh ini, Raha diberi peran Service Account Admin (roles/iam.serviceAccountAdmin) di organisasi, tetapi project memiliki kebijakan penolakan yang mencegah Raha menggunakan izin iam.googleapis.com/serviceAccounts.create. Akibatnya, jika Raha mencoba membuat akun layanan di project my-project, permintaan akan ditolak.

Dalam beberapa kasus, Anda mungkin hanya perlu melihat kebijakan izinkan yang efektif untuk resource—misalnya, jika organisasi Anda tidak menggunakan kebijakan tolak. Dalam kasus ini, Anda dapat menggunakan metode berikut untuk melihat kebijakan izin yang efektif:

  • Lihat kebijakan izin IAM resource di konsolGoogle Cloud . Konsol Google Cloud otomatis menampilkan kebijakan efektif setiap resource.

    Untuk mempelajari cara melihat kebijakan izin IAM resource di konsolGoogle Cloud , lihat Melihat akses saat ini.

  • Gunakan Cloud Asset API untuk mendapatkan kebijakan izinkan resource yang efektif. Untuk mempelajari lebih lanjut, baca Melihat kebijakan IAM yang efektif.

Melihat semua Unified Access Policies yang berlaku untuk resource

Untuk melihat semua UAP yang berlaku untuk resource target, lakukan hal berikut:

Konsol

  1. Identifikasi semua resource induk dari resource target. Resource induk adalah project, folder, dan organisasi di atas resource dalam hierarki resource.
  2. Lihat UAP yang terikat ke setiap resource induk. Jika UAP menyebutkan principal, hal ini dapat memengaruhi akses principal ke resource target.

gcloud

  1. Identifikasi semua resource induk dari resource target. Resource induk adalah project, folder, dan organisasi di atas resource dalam hierarki resource.
  2. Mencantumkan binding UAP untuk resource target dan setiap ancestor resource target. Catat ID kebijakan di setiap binding.
  3. Lihat setiap UAP di setiap binding yang Anda ambil. Jika UAP menyebutkan akun utama, hal ini dapat memengaruhi akses akun utama ke resource target.

REST

  1. Identifikasi semua resource induk dari resource target. Resource induk adalah project, folder, dan organisasi di atas resource dalam hierarki resource.
  2. Mencantumkan binding UAP untuk resource target dan setiap ancestor resource target. Catat ID kebijakan di setiap binding.
  3. Lihat setiap UAP di setiap binding yang Anda ambil. Jika UAP menyebutkan akun utama, hal ini dapat memengaruhi akses akun utama ke resource target.