Batasan kebijakan organisasi kustom

Halaman ini menunjukkan cara menggunakan batasan kustom Google Cloud Organization Policy Service untuk membatasi operasi tertentu pada resource Cloud Storage for Firebase berikut:

• firebasestorage.googleapis.com/DefaultBucket

Untuk mempelajari lebih lanjut Kebijakan Organisasi, lihat Kebijakan organisasi kustom.

Tentang batasan dan kebijakan organisasi

Organization Policy Service Google Cloud memberi Anda kontrol terpusat dan terprogram atas resource organisasi Anda. 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 menyediakan batasan terkelola bawaan untuk berbagai layanan Google Cloud. Namun, jika menginginkan kontrol yang lebih terperinci dan dapat disesuaikan atas kolom tertentu yang dibatasi dalam kebijakan organisasi, Anda juga dapat membuat batasan kustom dan menggunakan batasan kustom tersebut dalam kebijakan organisasi.

Pewarisan kebijakan

Secara default, kebijakan organisasi diwarisi oleh turunan resource tempat Anda menerapkan kebijakan tersebut. Misalnya, jika Anda menerapkan kebijakan pada folder, Google Cloud akan menerapkan kebijakan tersebut pada semua project di folder tersebut. Untuk mempelajari lebih lanjut perilaku ini dan cara mengubahnya, lihat Aturan evaluasi hierarki.

Selain itu, karena Cloud Storage for Firebase menyimpan file di bucket Cloud Storage yang mendasarinya, kebijakan organisasi atau batasan kustom apa pun yang diterapkan pada resource Cloud Storage juga berlaku untuk bucket Cloud Storage for Firebase Anda.

Manfaat

• Keamanan dan tata kelola: Terapkan kontrol organisasi terpusat atas penyediaan bucket Cloud Storage untuk memastikan kepatuhan terhadap residensi data dan batasan pengelolaan biaya.
• Kontrol atribut terperinci: Batasi pembuatan bucket default berdasarkan atribut resource tertentu seperti storageClass atau location.

Keterbatasan

Batasan berikut berlaku saat menggunakan kebijakan organisasi kustom dengan Cloud Storage for Firebase:

• Tidak ada penerapan retroaktif: Batasan kustom yang baru diterapkan tidak berlaku untuk resource yang ada. Bucket default yang ada tidak akan dievaluasi kecuali jika diupdate. Untuk mengidentifikasi resource yang ada yang mungkin melanggar batasan, Anda dapat menguji kebijakan menggunakan mode uji coba.
• Pembatasan kontrol akses: Batasan kustom tidak dapat membatasi daftar kontrol akses (ACL) atau kebijakan IAM pada bucket.

Sebelum memulai

Catatan: Untuk menggunakan kebijakan organisasi dan batasan kustom, project Firebase Anda harus menjadi bagian dari resource organisasi Google Cloud. Karena banyak project Firebase tidak terkait dengan organisasi secara default, pastikan project Anda termasuk dalam organisasi sebelum mencoba langkah-langkah di halaman ini. Untuk mempelajari lebih lanjut, lihat Membuat dan mengelola organisasi.

1. Di Firebase console, pilih atau buat project Firebase.

   Pastikan project Anda adalah bagian dari organisasi dan Anda mengetahui ID organisasi Anda.

2. Untuk menyiapkan dan menerapkan batasan kustom menggunakan command line, instal Google Cloud CLI (gcloud). Kebijakan organisasi kustom tidak dapat dikelola menggunakan Firebase CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan untuk mengelola kebijakan organisasi kustom, minta administrator untuk memberi Anda peran IAM Organization Policy Administrator (roles/orgpolicy.policyAdmin) di organisasi.

Cloud Storage for Firebase resource yang didukung

Tabel berikut mencantumkan resource Cloud Storage for Firebase yang dapat Anda referensikan dalam batasan kustom. Anda juga dapat mereferensikan resource yang didukung Cloud Storage, karena batasan kustom pada resource tersebut juga berlaku untuk bucket Cloud Storage for Firebase.

Resource	Kolom yang didukung
firebasestorage.googleapis.com/DefaultBucket	resource.location resource.storageClass

Menyiapkan batasan kustom

Batasan kustom ditentukan dalam file YAML oleh resource, metode, kondisi, dan tindakan yang didukung oleh layanan tempat Anda menerapkan kebijakan organisasi. Kondisi untuk batasan kustom Anda ditentukan menggunakan Common Expression Language (CEL). Untuk mengetahui informasi selengkapnya tentang cara membuat kondisi dalam batasan kustom menggunakan CEL, lihat bagian CEL tentang Membuat dan mengelola batasan kustom.

Konsol

Untuk membuat batasan kustom, lakukan hal-hal berikut:

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. Klik Custom constraint.
4. Di kotak nama tampilan, masukkan nama yang dapat dibaca manusia untuk batasan. Nama ini digunakan dalam pesan error dan dapat digunakan untuk identifikasi dan proses debug. Jangan menggunakan informasi identitas pribadi (PII) atau data sensitif dalam nama tampilan karena nama ini dapat terekspos dalam pesan error. Kolom ini dapat berisi hingga 200 karakter.
5. Di kotak Constraint ID, masukkan ID yang diinginkan untuk batasan kustom baru. Batasan kustom hanya boleh berisi huruf (termasuk huruf besar dan huruf kecil) atau angka, misalnya custom.restrictStorageClass. Kolom ini dapat berisi hingga 70 karakter, tidak termasuk imbuhan (custom.), misalnya, organizations/123456789/customConstraints/custom.restrictStorageClass. Jangan sertakan PII atau data sensitif dalam ID batasan Anda, karena dapat terekspos dalam pesan error.
6. Di kotak Description, masukkan deskripsi batasan yang dapat dibaca manusia. Deskripsi ini digunakan sebagai pesan error saat kebijakan dilanggar. Sertakan detail tentang alasan pelanggaran kebijakan dapat terjadi dan cara menyelesaikan pelanggaran kebijakan tersebut. Jangan sertakan PII atau data sensitif dalam deskripsi Anda, karena dapat terekspos dalam pesan error. Kolom ini dapat berisi hingga 2.000 karakter.
7. Di kotak Resource type, pilih nama resource REST yang berisi objek dan kolom yang ingin Anda batasi—misalnya, firebasestorage.googleapis.com/DefaultBucket. Sebagian besar jenis resource mendukung hingga 20 batasan kustom. Jika Anda mencoba membuat lebih banyak batasan kustom, operasi akan gagal.
8. Di bagian Enforcement method, pilih apakah akan menerapkan batasan pada metode CREATE REST atau pada metode CREATE dan UPDATE. (Catatan: DefaultBucket hanya mendukung CREATE).
9. Untuk menentukan kondisi, klik Edit condition.
   1. Di panel Add condition, buat kondisi CEL yang mengacu pada resource layanan yang didukung, misalnya resource.storageClass == 'STANDARD'. Kolom ini dapat berisi hingga 1.000 karakter. Untuk mengetahui detail tentang penggunaan CEL, lihat Common Expression Language.
   2. Klik Save.
10. 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 izinkan berarti operasi untuk membuat atau memperbarui resource hanya diizinkan jika kondisi bernilai benar. Setiap kasus lainnya, kecuali yang tercantum secara eksplisit dalam kondisi, akan diblokir.

11. Klik Create constraint.

gcloud

1. Untuk membuat batasan kustom, buat file YAML menggunakan format berikut:

   name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictStorageClass
   resourceTypes: firebasestorage.googleapis.com/DefaultBucket
   methodTypes:
     -   CREATE
   condition: "resource.storageClass == 'STANDARD'"
   actionType: DENY
   displayName: Restrict Standard Storage Class
   description: Deny creating buckets with STANDARD storage class.

2. Setelah membuat file YAML untuk batasan kustom 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. Contoh, /home/user/customconstraint.yaml.

3. Untuk memverifikasi ada tidaknya batasan kustom, gunakan perintah gcloud org-policies list-custom-constraints:

   gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

Menerapkan kebijakan organisasi kustom

Anda dapat menerapkan batasan 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 Anda untuk melihat halaman Policy details untuk batasan tersebut.
4. Guna 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 kebijakan organisasi ini diterapkan atau tidak.
8. Untuk menerapkan kebijakan organisasi dalam mode uji coba, klik Set dry run policy. Untuk mengetahui informasi selengkapnya, lihat Menguji kebijakan organisasi.
9. Setelah Anda memverifikasi bahwa kebijakan organisasi dalam mode uji coba berfungsi sebagaimana mestinya, tetapkan kebijakan aktif dengan mengklik Set policy.

gcloud

1. Untuk membuat kebijakan organisasi dengan aturan boolean, buat file YAML kebijakan yang mereferensikan batasan:

   name: projects/PROJECT_ID/policies/custom.restrictStorageClass
   spec:
     rules:
     -   enforce: true
   dryRunSpec:
     rules:
     -   enforce: true

2. Untuk menerapkan kebijakan organisasi dalam mode uji coba, jalankan perintah berikut dengan flag dryRunSpec:

   gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec

3. Setelah Anda memverifikasi bahwa kebijakan organisasi dalam mode uji coba berfungsi sebagaimana mestinya, tetapkan kebijakan aktif dengan perintah org-policies set-policy dan flag spec:

   gcloud org-policies set-policy POLICY_PATH --update-mask=spec

Menguji kebijakan organisasi kustom

Contoh berikut membuat batasan dan kebijakan kustom yang mengharuskan semua bucket default yang baru dibuat untuk menghindari penggunaan kelas penyimpanan STANDARD. Anda dapat menguji kebijakan dengan mencoba melakukan tindakan yang seharusnya dicegah oleh kebijakan.

Catatan: Nilai Default: Saat membuat bucket default di Cloud Storage for Firebase, jika atribut storage_class dihilangkan dalam permintaan Anda, bucket fisik akan ditetapkan secara default ke STANDARD. firebasestorage API secara otomatis mengisi storage_class: "STANDARD" selama kontrol penerimaan. Oleh karena itu, permintaan storage_class yang kosong akan dievaluasi dan berhasil diblokir oleh batasan kustom ini.

Membuat batasan

1. Simpan file berikut sebagai constraint-restrict-storage-class.yaml:

   name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictStorageClass
   resourceTypes:
   -   firebasestorage.googleapis.com/DefaultBucket
   methodTypes:
   -   CREATE
   condition: "resource.storageClass == 'STANDARD'"
   actionType: DENY
   displayName: Restrict Standard Storage Class
   description: Deny creating buckets with STANDARD storage class.
   

   Ganti ORGANIZATION_ID dengan ID organisasi Anda.

2. Terapkan batasan:

   gcloud org-policies set-custom-constraint ~/constraint-restrict-storage-class.yaml
   

3. Pastikan batasan ada:

   gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
   

   Outputnya mirip dengan yang berikut ini:

   CUSTOM_CONSTRAINT            ACTION_TYPE   METHOD_TYPES   RESOURCE_TYPES                                 DISPLAY_NAME
   custom.restrictStorageClass  DENY          CREATE         firebasestorage.googleapis.com/DefaultBucket   Restrict Standard Storage Class
   ...
   

Membuat kebijakan

1. Simpan file berikut sebagai policy-restrict-storage-class.yaml:

   name: projects/PROJECT_ID/policies/custom.restrictStorageClass
   spec:
     rules:
     -   enforce: true
   

   Ganti PROJECT_ID dengan project ID Anda.

2. Terapkan kebijakan:

   gcloud org-policies set-policy ~/policy-restrict-storage-class.yaml
   

3. Pastikan kebijakan ada:

   gcloud org-policies list --project=PROJECT_ID
   

   Outputnya mirip dengan hal berikut ini:

   CONSTRAINT                   LIST_POLICY    BOOLEAN_POLICY    ETAG
   custom.restrictStorageClass  -              SET               CIqktscGELiZn6cC-
   

Setelah Anda menerapkan kebijakan, tunggu sekitar dua menit hingga Google Cloud mulai menerapkan kebijakan tersebut.

Menguji kebijakan

Coba buat bucket default menggunakan Cloud Storage for Firebase REST API tanpa menentukan kelas penyimpanan (yang ditetapkan secara default ke STANDARD):

PROJECT_ID="PROJECT_ID"
TOKEN=$(gcloud auth print-access-token)

curl -X POST "https://firebasestorage.googleapis.com/v1beta/projects/${PROJECT_ID}/defaultBucket" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"location": "US-EAST1"}'

Permintaan gagal dengan error yang mirip dengan berikut ini:

FAILED_PRECONDITION: Operation denied by org policy: ["customConstraints/custom.restrictStorageClass": "Deny creating buckets with STANDARD storage class."].
-   '@type': type.googleapis.com/google.rpc.ErrorInfo
  domain: iam.googleapis.com
  metadata:
    customConstraints: customConstraints/custom.restrictStorageClass
  reason: CUSTOM_ORG_POLICY_VIOLATION

Contoh kebijakan organisasi kustom untuk kasus penggunaan umum

Tabel ini memberikan contoh sintaksis untuk beberapa batasan kustom umum.

Deskripsi	Sintaksis batasan
Membatasi pembuatan bucket default dengan kelas penyimpanan STANDARD	name: organizations/ORGANIZATION_ID/customConstraints/custom.restrictStorageClass resourceTypes: - firebasestorage.googleapis.com/DefaultBucket methodTypes: - CREATE condition: "resource.storageClass == 'STANDARD'" actionType: DENY displayName: Restrict Standard Storage Class description: Deny creating buckets with STANDARD storage class.
Mewajibkan bucket default dibuat di lokasi tertentu	name: organizations/ORGANIZATION_ID/customConstraints/custom.requireDefaultBucketLocation resourceTypes: - firebasestorage.googleapis.com/DefaultBucket methodTypes: - CREATE condition: "resource.location != 'US-EAST1'" actionType: DENY displayName: Require US-EAST1 Location description: Deny creating default buckets outside the US-EAST1 location.

Langkah berikutnya

• Pelajari lebih lanjut Layanan Kebijakan Organisasi.
• Pelajari lebih lanjut cara membuat dan mengelola kebijakan organisasi.
• Lihat daftar lengkap batasan kebijakan organisasi terkelola.