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

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.

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.

Menerapkan kebijakan organisasi kustom

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

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.

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.

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.

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.