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 dalam 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 menginginkan kontrol yang lebih besar dari kebijakan organisasi, Anda dapat membuat kebijakan organisasi kustom.

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

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.

Peran yang telah ditetapkan ini berisi izin yang diperlukan untuk mengelola kebijakan organisasi. Untuk melihat izin yang benar-benar diperlukan, perluas 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 mung juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaanlainnya.

Batasan khusus

Batasan kustom dibuat dalam file YAML yang menentukan resource, metode, kondisi, dan tindakan yang terkena batasan tersebut. Pengecualian 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 kebijakan organisasinya ingin Anda tetapkan.

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 gunakan PII atau data sensitif dalam nama batasan, 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 termasuk awalan, misalnya, organizations/123456789/customConstraints/custom..

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.

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 khusus per jenis resource. Jika Anda mencoba membuat batasan khusus untuk jenis resource yang sudah memiliki 20 batasan khusus, operasi akan gagal.

9. Di bagian Enforcement method, pilih apakah akan menerapkan batasan pada metode REST CREATE, atau pada metode CREATE dan UPDATE. Tidak semua layanan Google Cloud mendukung kedua metode tersebut. Untuk melihat metode yang didukung untuk setiap layanan, cari 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 Save.

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

    Tindakan tolak berarti operasi untuk membuat atau mengupdate resource akan diblokir jika kondisi bernilai benar (true).

    Tindakan izinkan berarti operasi untuk membuat atau mengupdate resource hanya diizinkan jika kondisi bernilai benar (true). Setiap kasus lainnya, kecuali yang secara eksplisit tercantum 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 termasuk awalan, misalnya, organizations/123456789/customConstraints/custom..

• RESOURCE_NAME: nama yang sepenuhnya memenuhi syarat untuk 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 menerapkan batasan. Dapat berupa CREATE atau CREATE dan UPDATE. Tidak semua layanan Google Cloud mendukung kedua metode tersebut. Guna melihat metode yang didukung untuk setiap layanan, cari 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 tolak berarti jika kondisi bernilai true, operasi untuk membuat atau mengupdate resource akan diblokir.

  Tindakan izinkan berarti bahwa jika kondisi bernilai true, operasi untuk membuat atau mengupdate resource akan diizinkan. Hal ini juga berarti 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 maksimum 2.000 karakter.

Setelah membuat batasan khusus baru menggunakan Google Cloud CLI, 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. Contoh, /home/user/customconstraint.yaml. Setelah selesai, Anda akan menemukan batasan khusus sebagai kebijakan organisasi yang tersedia dalam daftar kebijakan organisasi Google Cloud. 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 informasi selengkapnya, lihat Melihat kebijakan organisasi.

Memperbarui batasan kustom

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

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 kebijakan organisasinya ingin Anda perbarui.

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

5. Klik Edit batasan.

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 kustom 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 termasuk awalan, misalnya, organizations/123456789/customConstraints/custom..

• RESOURCE_NAME: nama yang sepenuhnya memenuhi syarat untuk 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 menerapkan batasan. Dapat berupa CREATE atau CREATE dan UPDATE. Tidak semua layanan Google Cloud mendukung kedua metode tersebut. Guna melihat metode yang didukung untuk setiap layanan, cari 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 maksimum 2.000 karakter.

Setelah membuat batasan khusus baru menggunakan Google Cloud CLI, 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. Contoh, /home/user/customconstraint.yaml. Setelah selesai, Anda akan menemukan batasan khusus sebagai kebijakan organisasi yang tersedia dalam daftar kebijakan organisasi Google Cloud. 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 informasi selengkapnya, lihat Melihat kebijakan organisasi.

Menghapus batasan kustom

Anda dapat menghapus batasan kustom menggunakan Google Cloud Console 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 kebijakan organisasinya ingin Anda hapus.

4. Pilih batasan yang ingin Anda hapus dari daftar di halaman Kebijakan organisasi. Halaman Detail kebijakan untuk batasan tersebut akan muncul.

5. Klik Delete.

6. Untuk mengonfirmasi bahwa Anda ingin menghapus batasan tersebut, klik Delete.

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 khusus, kebijakan apa pun yang telah dibuat menggunakan batasan tersebut akan terus ada, tetapi akan diabaikan. Anda tidak dapat membuat batasan kustom lain dengan nama yang sama dengan batasan kustom yang dihapus.

Menguji dan menganalisis perubahan kebijakan organisasi

Sebaiknya Anda menguji dan menjalankan uji coba semua perubahan pada kebijakan organisasi untuk lebih memahami kondisi lingkungan Anda dan bagaimana perubahan memengaruhinya.

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

Setelah memahami dampak 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 pelanggaran kebijakannya dicatat 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 mendapatkan petunjuk mendetail, lihat Membuat kebijakan organisasi dalam mode uji coba.

Menerapkan kebijakan organisasi kustom

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

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

Konsol

Untuk menerapkan batasan boolean:

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 project yang kebijakan organisasinya ingin Anda tetapkan.
4. Pilih batasan dari daftar di halaman Organization policies. Halaman Policy details untuk batasan tersebut akan muncul.
5. Guna mengonfigurasi kebijakan organisasi untuk resource ini, klik Kelola kebijakan.
6. Di halaman Edit policy, pilih Override parent's policy.
7. Klik Tambahkan aturan.
8. Di bagian Enforcement, pilih apakah penerapan kebijakan organisasi ini harus diaktifkan atau dinonaktifkan.
9. Secara 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 detail selengkapnya, lihat Menetapkan kebijakan organisasi dengan tag.
10. Jika ini adalah batasan kustom, Anda dapat mengklik Test changes untuk menyimulasikan efek kebijakan organisasi ini. Untuk informasi selengkapnya, lihat Menguji perubahan kebijakan organisasi dengan Policy Simulator.
11. Untuk menyelesaikan dan menerapkan kebijakan organisasi, klik Tetapkan kebijakan. Kebijakan ini akan 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 yang telah ditentukan sebelumnya dan disediakan oleh Google. File YAML batasan kustom umum terlihat mirip dengan yang berikut ini:

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 open source non-Turing yang mengimplementasikan semantik umum untuk evaluasi ekspresi.

Setiap layanan yang mendukung batasan khusus akan menyediakan kumpulan resource dan kolom tertentu dari resource tersebut. Kolom yang tersedia diketik dengan ketat, dan dapat direferensikan langsung oleh batasan khusus.

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

• Bilangan Bulat
• String
• Boolean
• Cantumkan
• Peta

Untuk 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 rujuk menggunakan batasan khusus:

{
  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 bernilai true. Anda dapat menggabungkan ekspresi dengan dan (&&) dan atau (||) untuk membuat kueri yang kompleks. Saat membuat file YAML atau JSON untuk batasan kustom, sertakan 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 pada 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 pada 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 pun 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".

Peringatan: Membuat kueri nilai daftar yang tidak ada akan menampilkan error BAD_CONDITION. Error ini memblokir semua pembuatan resource yang ditentukan tempat kebijakan organisasi khusus diterapkan. Untuk menghindari error ini, gunakan metode all(), any(), atau exists(). Jika Anda ingin membuat kueri indeks tertentu, terlebih dahulu periksa apakah indeks tersebut ada menggunakan metode size(). Misalnya, listValue.size() >= 1 && resource.listValue[0] == "bar".

Peta

Kolom peta, seperti mapValue pada 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".

Peringatan: Kueri nilai peta yang tidak ada akan menampilkan error BAD_CONDITION. Error ini memblokir semua pembuatan resource yang ditentukan tempat kebijakan organisasi khusus diterapkan. Untuk menghindari error ini, selalu pastikan nilai ada terlebih dahulu menggunakan metode has(). Contohnya, has(map.key) && map.key == "value".

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 yang 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 . Menyoroti 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 tersebut akan gagal dan menampilkan error pada saat penerapan, dan memblokir segala upaya untuk membuat resource.

Saat membuat kondisi yang bergantung pada elemen daftar atau peta, sebaiknya mulai kondisi dengan pemeriksaan yang memastikan kondisi 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 informasi selengkapnya tentang cara menyiapkan pemindai kebijakan organisasi, lihat Temuan kerentanan Kebijakan Organisasi.

Langkah selanjutnya

• Pelajari batasan secara mendalam.
• Baca opsi tambahan yang dapat Anda gunakan untuk menyesuaikan kebijakan.
• Pelajari cara menetapkan kebijakan organisasi berdasarkan Tag.
• Pelajari cara memvalidasi dan memantau kebijakan organisasi dengan Config Validator.