Mencegah pengguna memberikan akses

Menolak izin yang memungkinkan pengguna memberikan akses akan membantu Anda mencegah eskalasi hak istimewa yang tidak sah dan memperketat kontrol keamanan. Dokumen ini menjelaskan cara mengidentifikasi izin ini dan membuat kebijakan penolakan yang memblokirnya untuk sebagian besar pengguna sekaligus mengizinkan pengecualian untuk akun utama tepercaya.

Sebelum memulai

  • Aktifkan IAM API, 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

  • Menyiapkan autentikasi.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    Konsol

    Saat menggunakan konsol Google Cloud untuk mengakses layanan dan API Google Cloud , Anda tidak perlu menyiapkan autentikasi.

    gcloud

    Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

  • Opsional: Baca ringkasan kebijakan penolakan.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk membuat kebijakan penolakan, minta administrator untuk memberi Anda peran IAM Deny Admin (roles/iam.denyAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran yang telah ditetapkan ini berisi izin iam.denypolicies.create, yang diperlukan untuk membuat kebijakan penolakan.

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

Mengidentifikasi izin yang memungkinkan pengguna memberikan akses

Sebelum membuat kebijakan penolakan untuk mencegah pengguna memberikan akses, tentukan izin yang ingin Anda tolak.

Izin berikut memungkinkan pengguna memberikan akses:

  • Izin yang diakhiri dengan setIamPolicy. Izin yang paling permisif secara luas di antara izin-izin ini adalah izin untuk resource Resource Manager, karena kebijakan izin untuk resource tersebut diwarisi oleh semua resource turunan. Izin ini adalah sebagai berikut:

    • cloudresourcemanager.googleapis.com/projects.setIamPolicy
    • cloudresourcemanager.googleapis.com/folders.setIamPolicy
    • cloudresourcemanager.googleapis.com/organizations.setIamPolicy

    Resource lain juga memiliki izin setIamPolicy—misalnya, instance Compute Engine memiliki izin compute.googleapis.com/instances.setIamPolicy. Agar pengguna tidak dapat mengubah kebijakan izin untuk resource ini, tambahkan izin ini ke kebijakan penolakan Anda.

    Untuk mengetahui daftar lengkap izin yang dapat ditolak dan diakhiri dengan setIamPolicy, buka Izin yang didukung dalam kebijakan penolakan dan telusuri setIamPolicy.

  • Izin iam.googleapis.com/roles.update, yang memungkinkan pengguna mengubah peran khusus. Pengguna dengan izin ini dapat menambahkan izin ke peran khusus, sehingga secara efektif memberikan izin tersebut kepada diri mereka sendiri atau orang lain.

  • Izin untuk mengubah Unified Access Policies (UAP) dan mengikatnya ke resource. Izin ini adalah sebagai berikut:

    • Izin iam.googleapis.com/accesspolicies.update, yang memungkinkan pengguna memperbarui UAP yang ada.
    • Izin yang diakhiri dengan createPolicyBinding. Izin ini ada untuk setiap resource yang dapat Anda ikat dengan UAP. Untuk project, folder, dan organisasi, izin ini adalah sebagai berikut:
      • cloudresourcemanager.googleapis.com/projects.createPolicyBinding
      • cloudresourcemanager.googleapis.com/folders.createPolicyBinding
      • cloudresourcemanager.googleapis.com/organizations.createPolicyBinding

    Atau, Anda dapat mencegah semua pengguna mengikat UAP ke resource dengan menerapkan batasan kebijakan organisasi iam.managed.disableAccessPolicyBinding di organisasi Anda. Namun, kebijakan organisasi ini tidak mencegah pengguna mengubah UAP yang sudah ada dan terikat ke resource.

Menolak izin perubahan akses

Setelah menentukan izin yang ingin ditolak, buat kebijakan penolakan untuk organisasi Anda yang menolak izin ini.

Konsol

  1. Di konsol Google Cloud , buka tab Deny di halaman IAM.

    Buka IAM

  2. Pilih organisasi Anda.

  3. Klik Create deny policy.

  4. Di bagian Policy name, tentukan ID kebijakan dengan melakukan salah satu hal berikut:

    • Di kolom Display name, masukkan nama tampilan untuk kebijakan. Mengisi kolom ini akan otomatis mengisi kolom ID. Jika Anda ingin mengubah ID kebijakan, perbarui teks di kolom ID.
    • Di kolom ID, masukkan ID untuk kebijakan.
  5. Di bagian Deny rules, tambahkan aturan penolakan yang memblokir izin perubahan akses:

    1. Di kolom Denied principals, tambahkan akun utama yang akan ditolak aksesnya. Untuk menolak izin perubahan akses bagi semua pengguna, gunakan nilai principalSet://goog/public:all. Untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan, lihat ID utama untuk kebijakan penolakan.

    2. Di kolom Exception principals, tambahkan akun utama tepercaya yang ingin Anda izinkan untuk memberikan akses. Untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan, lihat ID utama untuk kebijakan penolakan.

    3. Di bagian Denied permissions, tambahkan izin yang Anda identifikasi di Mengidentifikasi izin yang memungkinkan pengguna memberikan akses.

    4. Opsional: Tambahkan kondisi penolakan yang menentukan resource mana yang terpengaruh oleh aturan ini. Misalnya, Anda dapat menambahkan kondisi untuk memastikan bahwa kebijakan hanya berlaku untuk resource dengan nilai tag prod. Untuk mengetahui informasi selengkapnya tentang kondisi penolakan, lihat Kondisi dalam kebijakan penolakan.

  6. Klik Create.

gcloud

Perintah gcloud iam policies create membuat kebijakan penolakan untuk resource.

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

  • POLICY_ID: ID untuk kebijakan penolakan.
  • ORG_ID: ID numerik organisasi tempat Anda ingin membuat kebijakan penolakan.
  • POLICY_FILE: File yang berisi kebijakan penolakan yang ingin Anda tetapkan. Gunakan format berikut untuk kebijakan penolakan:

    {
      "displayName": "POLICY_NAME",
      "rules": [
        {
          "denyRule": {
            "deniedPrincipals": [
              DENIED_PRINCIPALS
            ],
            "exceptionPrincipals": [
              EXCEPTION_PRINCIPALS
            ],
            "deniedPermissions": [
              ACCESS_CHANGE_PERMISSIONS
            ],
            DENIAL_CONDITION
          }
        }
      ]
    }
        

    Ganti nilai berikut:

    • POLICY_NAME: Nama tampilan untuk kebijakan tolak.
    • DENIED_PRINCIPALS: Akun utama yang akan ditolak aksesnya. Untuk menolak izin perubahan akses bagi semua pengguna, gunakan nilai "principalSet://goog/public:all". Untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan, lihat ID utama untuk kebijakan penolakan.
    • EXCEPTION_PRINCIPALS: Akun utama tepercaya yang ingin Anda izinkan untuk memberikan akses. Untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan, lihat ID principal untuk kebijakan penolakan.

    • ACCESS_CHANGE_PERMISSIONS: Izin yang Anda identifikasi di Mengidentifikasi izin yang memungkinkan pengguna memberikan akses.
    • DENIAL_CONDITION: Opsional. Kondisi penolakan yang menentukan resource mana yang terpengaruh oleh aturan ini. Misalnya, Anda dapat menambahkan kondisi untuk memastikan bahwa aturan hanya berlaku untuk resource dengan nilai tag prod. Untuk mengetahui informasi selengkapnya tentang kondisi penolakan, lihat Kondisi dalam kebijakan penolakan.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam policies create POLICY_ID \
    --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \
    --kind=denypolicies \
    --policy-file=POLICY_FILE

Windows (PowerShell)

gcloud iam policies create POLICY_ID `
    --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID `
    --kind=denypolicies `
    --policy-file=POLICY_FILE

Windows (cmd.exe)

gcloud iam policies create POLICY_ID ^
    --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^
    --kind=denypolicies ^
    --policy-file=POLICY_FILE

Jika berhasil, perintah ini tidak akan menampilkan output. Untuk mencetak respons mendetail, gunakan flag --format=json.

REST

Metode policies.createPolicy membuat kebijakan penolakan untuk resource.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • ORG_ID: ID numerik organisasi tempat Anda ingin membuat kebijakan penolakan.
  • POLICY_ID: ID untuk kebijakan penolakan.
  • POLICY_NAME: Nama tampilan untuk kebijakan tolak.
  • DENIED_PRINCIPALS: Akun utama yang aksesnya ditolak. Untuk menolak izin perubahan akses bagi semua pengguna, gunakan nilai "principalSet://goog/public:all". Untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan, lihat ID principal untuk kebijakan penolakan.
  • EXCEPTION_PRINCIPALS: Akun utama tepercaya yang ingin Anda izinkan untuk memberikan akses. Untuk mengetahui daftar lengkap nilai yang dapat Anda gunakan, lihat ID utama untuk kebijakan penolakan.

  • ACCESS_CHANGE_PERMISSIONS: Izin yang Anda identifikasi di Mengidentifikasi izin yang memungkinkan pengguna memberikan akses.
  • DENIAL_CONDITION: Opsional. Kondisi penolakan yang menentukan resource mana yang terpengaruh oleh aturan ini. Misalnya, Anda dapat menambahkan kondisi untuk memastikan bahwa aturan hanya berlaku untuk resource dengan nilai tag prod. Untuk mengetahui informasi selengkapnya tentang kondisi penolakan, lihat Kondisi dalam kebijakan penolakan.

Metode HTTP dan URL:

POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID

Meminta isi JSON:

{
  "displayName": "POLICY_NAME",
  "rules": [
    {
      "denyRule": {
        "deniedPrincipals": [
          DENIED_PRINCIPALS
        ],
        "exceptionPrincipals": [
          EXCEPTION_PRINCIPALS
        ],
        "deniedPermissions": [
          ACCESS_CHANGE_PERMISSIONS
        ],
        DENIAL_CONDITION
      }
    }
  ]
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON seperti berikut:

{
  "name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
    "createTime": "2026-10-31T19:06:12.455151Z"
  },
  "response": {
    "@type": "type.googleapis.com/google.iam.v2.Policy",
    "name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
    "uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
    "kind": "DenyPolicy",
    "displayName": "Deny access change permissions.",
    "etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
    "createTime": "2026-10-31T19:06:12.455151Z",
    "updateTime": "2026-10-31T22:26:21.968687Z",
    "rules": [
      {
        "denyRule": {
          "deniedPrincipals": [
            "principalSet://goog/public:all"
          ],
          "exceptionPrincipals": [
            "principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
            "principalSet://goog/group/iam-admins@example.com"
          ],
          "deniedPermissions": [
            
            "cloudresourcemanager.googleapis.com/projects.setIamPolicy",
            "cloudresourcemanager.googleapis.com/folders.setIamPolicy",
            "cloudresourcemanager.googleapis.com/organizations.setIamPolicy",
            "iam.googleapis.com/accesspolicies.update",
            "cloudresourcemanager.googleapis.com/projects.createPolicyBinding",
            "cloudresourcemanager.googleapis.com/folders.createPolicyBinding",
            "cloudresourcemanager.googleapis.com/organizations.createPolicyBinding"
            
          ],
          "denialCondition": {
            "title": "Only for prod resources",
            "expression": "resource.matchTag('12345678/env', 'prod')"
          }
        }
      }
    ]
  }
}

Respons mengidentifikasi operasi yang berjalan lama. Anda dapat memantau status operasi yang berjalan lama untuk mengetahui kapan operasi tersebut selesai. Untuk detailnya, lihat Periksa status operasi yang berjalan lama.

Langkah berikutnya