Membuat dan mengelola kebijakan organisasi kustom

Kebijakan Organisasi Google Cloud memberi Anda kontrol terpusat dan terprogram atas resource organisasi. Sebagai administrator kebijakan organisasi, Anda dapat menentukan kebijakan organisasi, yang merupakan serangkaian batasan yang disebut batasan yang berlaku untuk resource Google Cloud dan turunan dari resource tersebut di Hierarki resource Google Cloud. Anda dapat menerapkan kebijakan organisasi di level organisasi, folder, atau project.

Kebijakan Organisasi memberikan batasan yang telah ditetapkan untuk berbagai layanan Google Cloud. Namun, jika ingin kontrol yang lebih besar dari kebijakan organisasi, Anda dapat membuat kebijakan organisasi kustom.

Halaman ini menjelaskan cara melihat, membuat, dan mengelola kebijakan organisasi kustom. Kebijakan organisasi kustom dibuat oleh administrator untuk memberikan kontrol yang lebih terperinci dan dapat disesuaikan atas kolom tertentu yang dibatasi oleh kebijakan organisasi Anda.

Sebelum memulai

Untuk mengetahui informasi selengkapnya tentang kebijakan dan batasan organisasi serta cara kerjanya, lihat Pengantar Layanan Kebijakan Organisasi.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola kebijakan organisasi, minta administrator untuk memberi Anda peran IAM Administrator kebijakan organisasi (roles/orgpolicy.policyAdmin) di organisasi. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk mengelola kebijakan organisasi. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk mengelola kebijakan organisasi:

  • orgpolicy.constraints.list
  • orgpolicy.policies.create
  • orgpolicy.policies.delete
  • orgpolicy.policies.list
  • orgpolicy.policies.update
  • orgpolicy.policy.get
  • orgpolicy.policy.set

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

Batasan kustom

Batasan kustom dibuat dalam file YAML yang menentukan resource, metode, kondisi, dan tindakan yang tunduk pada batasan. Kebijakan ini khusus untuk layanan tempat Anda menerapkan kebijakan organisasi. Kondisi untuk batasan kustom Anda ditentukan menggunakan Common Expression Language (CEL).

Menyiapkan batasan kustom

Anda dapat membuat batasan khusus dan menyiapkannya untuk digunakan dalam kebijakan organisasi menggunakan konsol Google Cloud atau Google Cloud CLI.

Konsol

  1. Di konsol Google Cloud, buka halaman Organization policies.

    Buka Organization policies

  2. Pilih pemilih project di bagian atas halaman.

  3. Dari pemilih project, pilih resource yang ingin Anda tetapkan kebijakan organisasinya.

  4. Klik Custom constraint.

  5. Di kotak Display name, masukkan nama yang mudah dipahami manusia untuk batasan. Kolom ini memiliki panjang maksimal 200 karakter. Jangan menggunakan PII atau data sensitif dalam nama tampilan, karena dapat terekspos dalam pesan error.

  6. Di kotak Constraint ID, masukkan nama yang diinginkan untuk batasan kustom baru. Batasan kustom harus diawali dengan custom., dan hanya dapat menyertakan huruf besar, huruf kecil, atau angka, misalnya, custom.disableGkeAutoUpgrade. Panjang maksimum kolom ini adalah 70 karakter, tidak menghitung awalan, misalnya, organizations/123456789/customConstraints/custom.. Jangan sertakan PII atau data sensitif dalam ID batasan Anda, karena dapat terekspos dalam pesan error.

  7. Di kotak Description, masukkan deskripsi batasan yang mudah dipahami untuk ditampilkan sebagai pesan error saat kebijakan dilanggar. Kolom ini memiliki panjang maksimal 2000 karakter. Jangan sertakan PII atau data sensitif dalam deskripsi Anda, karena dapat terekspos dalam pesan error.

  8. Di kotak Resource type, pilih nama resource REST Google Cloud yang berisi objek dan kolom yang ingin dibatasi—misalnya, container.googleapis.com/NodePool. Ada maksimum 20 batasan kustom per jenis resource. Jika Anda mencoba membuat batasan kustom untuk jenis resource yang sudah memiliki 20 batasan kustom, operasi akan gagal.

  9. Di bagian Enforcement method, pilih apakah akan menerapkan batasan pada metode CREATE REST, atau pada metode CREATE dan UPDATE. Tidak semua layanan Google Cloud mendukung kedua metode tersebut. Untuk melihat metode yang didukung untuk setiap layanan, temukan layanan di Layanan yang didukung.

  10. Untuk menentukan kondisi, klik Edit condition.

    1. Di panel Add condition, buat kondisi CEL yang mengacu pada resource layanan yang didukung, misalnya resource.management.autoUpgrade == false. Kolom ini memiliki panjang maksimal 1000 karakter. Untuk mengetahui detail tentang penggunaan CEL, lihat Common Expression Language. Untuk mengetahui informasi selengkapnya tentang resource layanan yang dapat Anda gunakan dalam batasan kustom, lihat Layanan yang didukung batasan kustom.

    2. Klik Simpan.

  11. Di bagian Action, pilih apakah akan mengizinkan atau menolak metode yang dievaluasi jika kondisi di atas terpenuhi.

    Tindakan penolakan berarti operasi untuk membuat atau memperbarui resource diblokir jika kondisi bernilai benar.

    Tindakan izin berarti operasi untuk membuat atau memperbarui resource hanya diizinkan jika kondisi bernilai benar. Setiap kasus lain kecuali yang tercantum secara eksplisit dalam kondisi akan diblokir.

  12. Klik Create constraint.

Setelah Anda memasukkan nilai ke setiap kolom, konfigurasi YAML yang setara untuk batasan kustom ini akan muncul di sebelah kanan.

gcloud

Untuk membuat batasan khusus menggunakan Google Cloud CLI, buat file YAML untuk batasan kustom:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- METHOD1
- METHOD2
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Ganti kode berikut:

  • ORGANIZATION_ID: ID organisasi Anda, seperti 123456789.

  • CONSTRAINT_NAME: nama yang Anda inginkan untuk batasan kustom baru. Batasan kustom harus diawali dengan custom., dan hanya dapat menyertakan huruf besar, huruf kecil, atau angka, misalnya, custom.disableGkeAutoUpgrade. Panjang maksimum kolom ini adalah 70 karakter, tidak menghitung awalan, misalnya, organizations/123456789/customConstraints/custom..

  • RESOURCE_NAME: nama yang sepenuhnya memenuhi syarat dari resource REST Google Cloud yang berisi objek dan kolom yang ingin Anda batasi. Contoh, container.googleapis.com/NodePool. Ada maksimum 20 batasan kustom per jenis resource. Jika Anda mencoba membuat batasan kustom untuk jenis resource yang sudah memiliki 20 batasan kustom, operasi akan gagal. Untuk mengetahui informasi selengkapnya tentang resource layanan yang dapat Anda gunakan dalam batasan kustom, lihat Layanan yang didukung batasan kustom.

  • METHOD1,METHOD2: daftar metode RESTful yang akan menerapkan batasan. Dapat berupa CREATE atau CREATE dan UPDATE. Tidak semua layanan Google Cloud mendukung kedua metode tersebut. Untuk melihat metode yang didukung untuk setiap layanan, temukan layanan di Layanan yang didukung.

  • CONDITION: kondisi CEL yang mengacu pada resource layanan yang didukung, misalnya "resource.management.autoUpgrade == false". Kolom ini memiliki panjang maksimal 1000 karakter. Untuk mengetahui detail tentang penggunaan CEL, lihat Common Expression Language.

  • ACTION: tindakan yang akan diambil jika condition terpenuhi. Ini dapat berupa ALLOW atau DENY.

    Tindakan penolakan berarti jika kondisi dievaluasi ke benar, operasi untuk membuat atau memperbarui resource akan diblokir.

    Tindakan izin berarti jika kondisi bernilai benar, operasi untuk membuat atau memperbarui resource diizinkan. Hal ini juga berarti bahwa setiap kasus lain kecuali yang tercantum secara eksplisit dalam kondisi akan diblokir.

  • DISPLAY_NAME: nama yang mudah dibaca manusia untuk batasan. Kolom ini memiliki panjang maksimal 200 karakter.

  • DESCRIPTION: deskripsi batasan yang mudah dipahami untuk ditampilkan sebagai pesan error saat kebijakan dilanggar. Kolom ini memiliki panjang maksimal 2.000 karakter.

Setelah membuat file YAML untuk batasan khusus baru, Anda harus menyiapkannya agar tersedia untuk kebijakan organisasi di organisasi Anda. Untuk menyiapkan batasan kustom, gunakan perintah gcloud org-policies set-custom-constraint: 

gcloud org-policies set-custom-constraint CONSTRAINT_PATH
 Ganti CONSTRAINT_PATH dengan jalur lengkap ke file batasan kustom Anda. Contohnya, /home/user/customconstraint.yaml Setelah selesai, batasan khusus Anda akan tersedia sebagai kebijakan organisasi dalam daftar kebijakan organisasi Google Cloud Anda. Untuk memverifikasi bahwa ada batasan kustom, gunakan perintah gcloud org-policies list-custom-constraints: 
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
 Ganti ORGANIZATION_ID dengan ID fasilitas organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Melihat kebijakan organisasi.

Memperbarui batasan kustom

Anda dapat memperbarui batasan kustom dengan mengedit batasan di konsol Google Cloud, atau dengan membuat file YAML baru dan menggunakan perintah gcloud CLI set-custom-constraint lagi. Tidak ada versi batasan kustom, sehingga tindakan ini akan menimpa batasan kustom yang ada. Jika batasan kustom sudah diterapkan, batasan kustom yang diperbarui akan segera berlaku.

Konsol

  1. Di konsol Google Cloud, buka halaman Organization policies.

    Buka Organization policies

  2. Pilih pemilih project di bagian atas halaman.

  3. Dari pemilih project, pilih resource yang ingin Anda perbarui kebijakan organisasinya.

  4. Pilih batasan yang ingin Anda edit dari daftar di halaman Kebijakan organisasi. Halaman Policy details untuk batasan tersebut akan muncul.

  5. Klik Edit constraint.

  6. Buat perubahan pada nama tampilan, deskripsi, metode penerapan, kondisi, dan tindakan. Anda tidak dapat mengubah ID batasan atau jenis resource setelah batasan dibuat.

  7. Klik Simpan perubahan.

gcloud

Untuk mengedit batasan khusus yang ada menggunakan Google Cloud CLI, buat file YAML baru yang berisi perubahan yang ingin Anda buat:

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- RESOURCE_NAME
methodTypes:
- METHOD1
- METHOD2
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION

Ganti kode berikut:

  • ORGANIZATION_ID: ID organisasi Anda, seperti 123456789.

  • CONSTRAINT_NAME: nama yang Anda inginkan untuk batasan kustom baru. Batasan kustom harus diawali dengan custom., dan hanya dapat menyertakan huruf besar, huruf kecil, atau angka, misalnya, custom.disableGkeAutoUpgrade. Panjang maksimum kolom ini adalah 70 karakter, tidak menghitung awalan, misalnya, organizations/123456789/customConstraints/custom..

  • RESOURCE_NAME: nama yang sepenuhnya memenuhi syarat dari resource REST Google Cloud yang berisi objek dan kolom yang ingin Anda batasi. Contoh, container.googleapis.com/NodePool. Untuk mengetahui informasi selengkapnya tentang resource layanan yang dapat Anda gunakan dalam batasan kustom, lihat Layanan yang didukung batasan kustom.

  • METHOD1,METHOD2: daftar metode RESTful yang akan menerapkan batasan. Dapat berupa CREATE atau CREATE dan UPDATE. Tidak semua layanan Google Cloud mendukung kedua metode tersebut. Untuk melihat metode yang didukung untuk setiap layanan, temukan layanan di Layanan yang didukung.

  • CONDITION: kondisi CEL yang mengacu pada resource layanan yang didukung, misalnya "resource.management.autoUpgrade == false". Kolom ini memiliki panjang maksimal 1000 karakter. Untuk mengetahui detail tentang penggunaan CEL, lihat Common Expression Language.

  • ACTION: tindakan yang akan diambil jika condition terpenuhi. Ini dapat berupa ALLOW atau DENY.

  • DISPLAY_NAME: nama yang mudah dibaca manusia untuk batasan. Kolom ini memiliki panjang maksimal 200 karakter.

  • DESCRIPTION: deskripsi batasan yang mudah dipahami untuk ditampilkan sebagai pesan error saat kebijakan dilanggar. Kolom ini memiliki panjang maksimal 2.000 karakter.

Setelah membuat file YAML untuk batasan khusus baru, Anda harus menyiapkannya agar tersedia untuk kebijakan organisasi di organisasi Anda. Untuk menyiapkan batasan kustom, gunakan perintah gcloud org-policies set-custom-constraint: 

gcloud org-policies set-custom-constraint CONSTRAINT_PATH
 Ganti CONSTRAINT_PATH dengan jalur lengkap ke file batasan kustom Anda. Contohnya, /home/user/customconstraint.yaml Setelah selesai, batasan khusus Anda akan tersedia sebagai kebijakan organisasi dalam daftar kebijakan organisasi Google Cloud Anda. Untuk memverifikasi bahwa ada batasan kustom, gunakan perintah gcloud org-policies list-custom-constraints: 
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
 Ganti ORGANIZATION_ID dengan ID fasilitas organisasi Anda. Untuk mengetahui informasi selengkapnya, lihat Melihat kebijakan organisasi.

Menghapus batasan kustom

Anda dapat menghapus batasan kustom menggunakan Konsol Google Cloud atau Google Cloud CLI.

Konsol

  1. Di konsol Google Cloud, buka halaman Organization policies.

    Buka Organization policies

  2. Pilih pemilih project di bagian atas halaman.

  3. Dari pemilih project, pilih resource yang ingin Anda hapus kebijakan organisasinya.

  4. Pilih batasan yang ingin dihapus dari daftar di halaman Kebijakan organisasi. Halaman Policy details untuk batasan tersebut akan muncul.

  5. Klik Delete.

  6. Untuk mengonfirmasi bahwa Anda ingin menghapus batasan, klik Hapus.

gcloud

Untuk menghapus batasan kustom, gunakan perintah gcloud CLI org-policies delete-custom-constraint:

gcloud org-policies delete-custom-constraint custom.CONSTRAINT_NAME \
  --organization=ORGANIZATION_ID

Ganti kode berikut:

  • ORGANIZATION_ID: ID organisasi Anda, seperti 123456789.

  • CONSTRAINT_NAME: nama batasan kustom Anda. Contoh, custom.disableGkeAutoUpgrade.

Outputnya mirip dengan hal berikut ini:

Deleted custom constraint [organizations/123456789/customConstraints/custom.disableGkeAutoUpgrade]

Jika Anda menghapus batasan kustom, kebijakan apa pun yang telah dibuat menggunakan batasan tersebut akan tetap ada, tetapi diabaikan. Anda tidak dapat membuat batasan kustom lain dengan nama yang sama seperti batasan kustom yang dihapus.

Menguji dan menganalisis perubahan kebijakan organisasi

Sebaiknya uji dan jalankan uji coba semua perubahan pada kebijakan organisasi Anda untuk lebih memahami status lingkungan dan pengaruh perubahan terhadapnya.

Simulator Kebijakan untuk Kebijakan Organisasi membantu Anda memahami pengaruh batasan dan kebijakan organisasi pada lingkungan Anda saat ini. Dengan alat ini, Anda dapat meninjau semua konfigurasi resource untuk melihat tempat terjadinya pelanggaran, sebelum diberlakukan di lingkungan produksi Anda. Untuk petunjuk mendetail, lihat Menguji perubahan kebijakan organisasi dengan Policy Simulator.

Setelah memahami efek saat ini, Anda dapat membuat kebijakan organisasi dalam mode uji coba untuk memahami dampak dan potensi pelanggaran kebijakan selama 30 hari ke depan. Kebijakan organisasi dalam mode uji coba adalah jenis kebijakan organisasi yang mencatat pelanggaran kebijakan ke dalam log audit, tetapi tindakan yang melanggar tidak ditolak. Anda dapat membuat kebijakan organisasi dalam mode uji coba dari batasan kustom menggunakan konsol Google Cloud atau Google Cloud CLI. Untuk mengetahui petunjuk selengkapnya, lihat Membuat kebijakan organisasi dalam mode uji coba.

Menerapkan kebijakan organisasi kustom

Setelah disiapkan, batasan kustom akan beroperasi secara identik dengan batasan boolean yang telah ditentukan sebelumnya. Google Cloud akan memeriksa batasan kustom terlebih dahulu saat mengevaluasi apakah permintaan pengguna diizinkan. Jika salah satu kebijakan organisasi kustom menolak permintaan, permintaan akan ditolak. Kemudian, Google Cloud akan memeriksa kebijakan organisasi standar yang diterapkan pada resource tersebut.

Anda dapat menerapkan batasan boolean dengan membuat kebijakan organisasi yang mereferensikannya, lalu menerapkan kebijakan organisasi tersebut ke resource Google Cloud.

Konsol

  1. Di konsol Google Cloud, buka halaman Organization policies.

    Buka Organization policies

  2. Dari pemilih project, pilih project yang ingin Anda tetapkan kebijakan organisasinya.
  3. Dari daftar di halaman Organization policies, pilih batasan untuk melihat halaman Policy details untuk batasan tersebut.
  4. Untuk mengonfigurasi kebijakan organisasi untuk resource ini, klik Manage policy.
  5. Di halaman Edit policy, pilih Override parent's policy.
  6. Klik Add a rule.
  7. Di bagian Enforcement, pilih apakah penerapan kebijakan organisasi ini diaktifkan atau dinonaktifkan.
  8. Opsional: Untuk membuat kebijakan organisasi bersyarat pada tag, klik Add condition. Perhatikan bahwa jika menambahkan aturan kondisional ke kebijakan organisasi, Anda harus menambahkan setidaknya satu aturan tanpa syarat atau kebijakan tidak dapat disimpan. Untuk mengetahui informasi selengkapnya, lihat Menetapkan kebijakan organisasi dengan tag.
  9. Jika ini adalah batasan kustom, Anda dapat mengklik Uji perubahan untuk menyimulasikan efek kebijakan organisasi ini. Untuk mengetahui informasi selengkapnya, lihat Menguji perubahan kebijakan organisasi dengan Policy Simulator.
  10. Untuk menyelesaikan dan menerapkan kebijakan organisasi, klik Set policy. Kebijakan ini memerlukan waktu hingga 15 menit untuk diterapkan.

gcloud

Untuk membuat kebijakan organisasi yang menerapkan batasan boolean, buat file YAML kebijakan yang merujuk batasan tersebut: 

      name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
      spec:
        rules:
        - enforce: true

Ganti kode berikut:

  • PROJECT_ID: project tempat Anda ingin menerapkan batasan.
  • CONSTRAINT_NAME: nama yang Anda tentukan untuk batasan kustom. Contoh, custom.disableGkeAutoUpgrade

Untuk menerapkan kebijakan organisasi yang berisi batasan, jalankan perintah berikut: 

    gcloud org-policies set-policy POLICY_PATH

Ganti POLICY_PATH dengan jalur lengkap ke file YAML kebijakan organisasi Anda. Kebijakan ini memerlukan waktu hingga 15 menit untuk diterapkan.

Contoh batasan

Anda dapat menentukan batasan kustom yang mirip dengan batasan standar yang disediakan oleh Google. File YAML batasan kustom standar terlihat seperti berikut:

name: organizations/1234567890123/customConstraints/custom.disableGkeAutoUpgrade
resourceTypes:
- container.googleapis.com/NodePool
methodTypes:
- CREATE
- UPDATE
condition: "resource.management.autoUpgrade == false"
actionType: ALLOW
displayName: Disable GKE auto upgrade
description: Only allow GKE NodePool resource to be created or updated if AutoUpgrade is not enabled where this custom constraint is enforced.

Common Expression Language

Layanan Kebijakan Organisasi menggunakan Common Expression Language (CEL) untuk mengevaluasi kondisi pada batasan kustom. CEL adalah bahasa lengkap non-Turing open source yang menerapkan semantik umum untuk evaluasi ekspresi.

Setiap layanan yang mendukung batasan kustom menyediakan kumpulan resource tertentu dan kolom resource ini. Kolom yang tersedia memiliki jenis yang kuat, dan dapat langsung dirujuk oleh batasan kustom.

Anda dapat membuat kondisi CEL yang merujuk ke kolom resource layanan berdasarkan jenis kolom. Layanan Kebijakan Organisasi mendukung sebagian jenis data, ekspresi, dan makro CEL. Bagian di bawah ini mencantumkan jenis data yang tersedia serta ekspresi dan makro umum yang berfungsi dengannya.

Untuk mengetahui detail tentang ekspresi dan makro yang tersedia untuk setiap layanan, lihat Layanan yang didukung batasan kustom.

Contoh JSON berikut menunjukkan setiap jenis kolom potensial yang dapat Anda referensikan menggunakan batasan kustom:

{
  integerValue: 1
  stringValue: "A text string"
  booleanValue: true
  nestedValue: {
    nestedStringValue: "Another text string"
  }
  listValue: [foo, bar]
  mapValue["costCenter"] == "123"
}

Untuk setiap ekspresi CEL, batasan kustom diterapkan saat kondisi dievaluasi menjadi true. Anda dapat menggabungkan ekspresi dengan and (&&) dan or (||) untuk membuat kueri yang kompleks. Saat membuat file YAML atau JSON untuk batasan kustom, masukkan kueri lengkap dalam tanda kutip ganda (").

Bilangan bulat

Kolom bilangan bulat, seperti integerValue dalam contoh di atas, memungkinkan operator perbandingan digunakan dalam kondisi. Contoh:

resource.integerValue == 1
resource.integerValue > 5
resource.integerValue < 10

String

Kolom string, seperti stringValue dalam contoh di atas, dapat dievaluasi menggunakan literal string, ekspresi reguler, atau ekspresi CEL. Contoh:

resource.stringValue == "abc"
// stringValue is exactly "abc".

resource.stringValue.matches("dev$")
// stringValue matches a regular expression, which specifies the string ends
// with the word "dev".

resource.stringValue.startsWith("startValue")
// stringValue starts with "startValue".

resource.stringValue.endsWith("endValue")
// stringValue ends with "endValue".

resource.stringValue.contains("fooBar")
// stringValue contains "fooBar".

Kolom bertingkat, seperti nestedStringValue dalam contoh di atas, harus direferensikan dengan jalur lengkap. Contoh:

resource.nestedValue.nestedStringValue == "foo"
// nestedValue contains the object nestedStringValue, which has a value of "foo".

Boolean

Kolom boolean, seperti booleanValue dalam contoh di atas, berisi nilai boolean, baik true maupun false.

Daftar

Kolom daftar, seperti listValue dalam contoh di atas, dapat dievaluasi berdasarkan ukuran daftar, konten daftar, dan apakah elemen tertentu ada di mana saja dalam daftar.

Contoh:

resource.listValue.size() >= 1 && resource.listValue[0] == "bar"
// listValue has size greater than or equal to one, and the first element is "bar".

resource.listValue.exists(value, value == "foo")
// listValue has at least one element that is exactly "foo".

resource.listValue.all(value, value.contains("foo"))
// listValue is a list of values that are all exactly "foo".

Peta

Kolom peta, seperti mapValue dalam contoh di atas, adalah key-value pair yang dapat dievaluasi berdasarkan keberadaan dan nilai elemen tertentu.

Contoh:

has(resource.mapValue.foo) && resource.mapValue.foo == "bar"
// mapValue contains the key "foo", and that key has the value "bar".

Memecahkan masalah error CEL

Kondisi yang dibuat dengan ekspresi yang tidak valid atau ketidakcocokan jenis akan menampilkan error saat Anda mencoba menyiapkan batasan kustom. Misalnya, dengan batasan kustom tidak valid berikut, yang membandingkan string dengan bilangan bulat:

name: organizations/1234567890123/customConstraints/custom.badConfig
resourceTypes:
- dataproc.googleapis.com/Cluster
methodTypes:
- CREATE
- UPDATE
condition: "resource.config.masterConfig.numInstances == 'mismatch'"
actionType: ALLOW
displayName: Number of instances is a string
description: Demonstrate that type mismatches cause an error.

Error akan muncul jika Anda mencoba menyiapkan batasan tersebut menggunakan Google Cloud CLI:

ERROR: (gcloud.org-policies.set-custom-constraint) INVALID_ARGUMENT: Custom constraint condition [resource.config.masterConfig.numInstances == "mismatch"] is invalid. Error: ERROR: <input>:1:15: found no matching overload for '_==_' applied to '(int, string)' (candidates: (%A0, %A0))
 | resource.config.masterConfig.numInstances == "mismatch"
 | ..........................................^.

Di konsol Google Cloud, error sintaksis CEL yang tidak valid akan ditandai dengan ikon Error . Menandai ikon ini akan menampilkan tooltip yang berisi informasi selengkapnya tentang error sintaksis.

Layanan Kebijakan Organisasi mengompilasi dan memvalidasi kondisi yang Anda buat, yang menampilkan error jika kondisi tidak benar secara sintaksis. Namun, ada kondisi tertentu yang dikompilasi, tetapi menghasilkan error saat Google Cloud mencoba menerapkan batasan. Misalnya, jika Anda menyiapkan batasan dengan kondisi yang mencoba mengakses indeks daftar atau kunci peta yang tidak ada, batasan akan gagal dan menampilkan error pada saat penerapan, dan memblokir upaya apa pun untuk membuat resource.

Saat membuat kondisi yang bergantung pada elemen daftar atau peta, sebaiknya mulai kondisi dengan pemeriksaan yang memastikan kondisi tersebut valid dalam semua kasus. Misalnya, periksa list.size() sebelum mereferensikan elemen daftar tertentu atau gunakan has() sebelum mereferensikan elemen peta.

Layanan yang didukung

Setiap layanan menentukan kumpulan kolom batasan kustom yang dapat digunakan untuk menerapkan kebijakan organisasi pada resource layanannya. Untuk daftar layanan yang mendukung batasan kustom, lihat Layanan yang didukung batasan kustom.

Untuk mengetahui informasi selengkapnya tentang cara menyiapkan pemindai kebijakan organisasi, lihat Temuan kerentanan Kebijakan Organisasi.

Langkah selanjutnya