Mengelola resource VPC menggunakan 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 menginginkan kontrol yang lebih terperinci dan dapat disesuaikan atas kolom tertentu yang dibatasi dalam kebijakan organisasi, Anda juga dapat membuat batasan khusus dan menggunakan batasan kustom tersebut dalam kebijakan organisasi kustom.

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.

Resource yang didukung Virtual Private Cloud

Untuk VPC, Anda dapat menetapkan batasan khusus pada resource dan kolom berikut.

  • Jaringan: compute.googleapis.com/Network
    • Nama: resource.name
    • Deskripsi: resource.description
    • Mode: resource.autoCreateSubnetworks
    • Setelan MTU: resource.mtu
    • Perintah penerapan firewall: resource.networkFirewallPolicyEnforcementOrder
    • Setelan IPv6 internal: resource.enableUlaInternalIpv6
    • Rentang IPv6 internal: resource.internalIpv6Range
    • Mode pemilihan rute: resource.routingConfig.routingMode
  • Subjaringan: compute.googleapis.com/Subnetwork
    • Nama: resource.name
    • Deskripsi: resource.description
    • Jaringan: resource.network
    • Rentang CIDR IP: resource.ipCidrRange
    • Rentang alamat IP sekunder: resource.secondaryIpRanges[]
      • Nama rentang:resource.secondaryIpRanges[].rangeName
      • Rentang CIDR IP: resource.secondaryIpRanges[].ipCidrRange
    • Jenis stack: resource.stackType
    • Jenis akses IPv6: resource.ipv6AccessType
    • Setelan Akses Google Pribadi: resource.privateIpGoogleAccess
    • Tujuan subnet: resource.purpose
    • Peran: resource.role
    • Log Aliran VPC:
      • Konfigurasi logging: resource.logConfig.enable
      • Interval agregasi: resource.logConfig.aggregationInterval
      • Frekuensi sampling: resource.logConfig.flowSampling
      • Metadata: resource.logConfig.metadata
      • Kolom metadata: resource.logConfig.metadataFields[]
      • Ekspresi filter: resource.logConfig.filterExpr
  • Rute: compute.googleapis.com/Route
    • Nama: resource.name
    • Deskripsi: resource.description
    • Jaringan: resource.network
    • Tag: resource.tags
    • Rentang tujuan: resource.destRange
    • Prioritas: resource.priority
    • Instance next hop: resource.nextHopInstance
    • Alamat IP next hop: resource.nextHopIp
    • Gateway next hop: resource.nextHopGateway
    • Load Balancer Jaringan passthrough internal next hop: resource.nextHopIlb
    • Tunnel VPN next hop: resource.nextHopVpnTunnel

Sebelum memulai

  • Siapkan autentikasi, jika Anda belum melakukannya. Autentikasi adalah proses verifikasi identitas Anda untuk akses ke layanan dan API Google Cloud. Untuk menjalankan kode atau contoh dari lingkungan pengembangan lokal, Anda dapat melakukan autentikasi ke Compute Engine sebagai berikut.

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

    Konsol

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

    gcloud

    1. Instal Google Cloud CLI, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init
    2. Menetapkan region dan zona default.

    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, lalu initialize dengan menjalankan perintah berikut: 

      gcloud init

Peran yang diperlukan

Guna mendapatkan izin yang Anda perlukan untuk mengelola kebijakan organisasi untuk resource VPC, minta administrator Anda untuk memberi Anda peran IAM berikut:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.

Peran yang telah ditetapkan ini berisi izin yang diperlukan guna mengelola kebijakan organisasi untuk resource VPC. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan guna mengelola kebijakan organisasi untuk resource VPC:

  • 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.

Menyiapkan batasan kustom

Batasan kustom ditentukan 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 membangun kondisi dalam batasan khusus menggunakan CEL, lihat bagian CEL tentang Membuat dan mengelola 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 Project picker di bagian atas halaman.

  3. Dari Project picker, 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 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.createCustomNetworks. 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 2.000 karakter.

  8. Di kotak Resource type, pilih nama resource REST Google Cloud yang berisi objek dan kolom yang ingin dibatasi. Contoh, compute.googleapis.com/Network.

  9. Di bagian Enforcement method, pilih apakah akan menerapkan batasan pada metode CREATE REST.

  10. Untuk menentukan kondisi, klik Edit condition.

    1. Di panel Add condition, buat kondisi CEL yang mengacu pada resource layanan yang didukung. Kolom ini memiliki panjang maksimal 1.000 karakter.

    2. Klik Save.

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

  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
resource_types: compute.googleapis.com/RESOURCE_NAME
method_types:
- CREATE
condition: "CONDITION"
action_type: ACTION
display_name: 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.createCustomNetworks. Panjang maksimum kolom ini adalah 70 karakter, tidak termasuk awalan, misalnya, organizations/123456789/customConstraints/custom..

  • RESOURCE_NAME: nama (bukan URI) resource REST Compute Engine API yang berisi objek dan kolom yang ingin Anda batasi. Contoh, Network.

  • CONDITION: kondisi CEL yang ditulis berdasarkan representasi resource layanan yang didukung. Kolom ini memiliki panjang maksimal 1000 karakter. Lihat Resource yang didukung untuk mengetahui informasi selengkapnya tentang resource yang tersedia untuk menulis kondisi.

  • 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.

Untuk mengetahui informasi selengkapnya tentang cara membuat batasan kustom, lihat Menentukan batasan kustom.

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 mengetahui informasi selengkapnya, lihat Melihat kebijakan organisasi.

Menerapkan batasan khusus

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.createCustomNetworks

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: Membuat batasan yang membatasi jaringan ke mode kustom

gcloud

  1. Buat file batasan onlyCustomNetwork.yaml dengan informasi berikut. Ganti ORGANIZATION_ID dengan ID organisasi Anda.

    name: organizations/ORGANIZATION_ID/customConstraints/custom.createOnlyCustomNetwork
resource_types: compute.googleapis.com/Network
condition: "resource.autoCreateSubnetworks == false"
action_type: ALLOW
method_types: CREATE
display_name: Restrict creation of networks to custom mode networks
description: Only custom mode networks allowed.

  2. Tetapkan batasan kustom.

    gcloud org-policies set-custom-constraint onlyCustomNetwork.yaml

  3. Buat file kebijakan onlyCustomNetwork-policy.yaml dengan informasi berikut. Dalam contoh ini, kami menerapkan batasan ini di level project, tetapi Anda juga dapat menetapkannya di level organisasi atau folder. Ganti PROJECT_ID dengan project ID Anda.

          name: projects/PROJECT_ID/policies/custom.onlyCustomNetwork
      spec:
        rules:
        – enforce: true

  4. Terapkan kebijakan.

    gcloud org-policies set-policy onlyCustomNetwork-policy.yaml

  5. Uji batasan dengan mencoba membuat jaringan VPC mode otomatis.

    gcloud compute networks create vpc1
    --project=PROJECT_ID \
    --subnet-mode=auto

    Outputnya mirip dengan hal berikut ini:

    ERROR: (gcloud.compute.networks.create) Could not fetch resource:
- Operation denied by custom org policy: [customConstraints/custom.createOnlyCustomNetwork] : Only custom mode networks allowed.

Contoh batasan kustom untuk kasus penggunaan umum

Bagian berikut memberikan sintaksis beberapa batasan khusus yang mungkin berguna bagi Anda.

Mengharuskan jaringan untuk memiliki rentang IPv6 internal

name: organizations/ORGANIZATION_ID/customConstraints/custom.networkInternalIpv6Range
resource_types: compute.googleapis.com/Network
condition: "resource.enableUlaInternalIpv6 == true"
action_type: ALLOW
method_types: CREATE
display_name: Require networks to have an internal IPv6 range
description: Networks must have a ULA internal IPv6 range configured

Mengharuskan subnet untuk menggunakan rentang di 10.0.0.0/8

name: organizations/ORGANIZATION_ID/customConstraints/custom.subnetRangeUse10Slash8
resource_types: compute.googleapis.com/Subnetwork
condition: "resource.ipCidrRange.startsWith('10.')"
action_type: ALLOW
method_types: CREATE
display_name: Require subnets to ranges in 10.0.0.0/8
description: Subnetwork's primary IPv4 range must come from 10.0.0.0/8

Mengharuskan rute next-hop-ilb ditentukan berdasarkan alamat IP

Mengharuskan rute yang menggunakan next-hop-ilb ditentukan dengan menggunakan alamat IP, bukan nama resource aturan penerusan.

name: organizations/ORGANIZATION_ID/customConstraints/custom.routeNextHopIlbByIpAddress
resource_types: compute.googleapis.com/Route
condition: "!resource.nextHopIlb.contains('forwardingRules')"
action_type: ALLOW
method_types: CREATE
display_name: Require defining next-hop-ilb by IP address
description: Next hops that are an internal load balancer must be specified by IP address instead of resource name.

Harga

Layanan Kebijakan Organisasi, termasuk kebijakan organisasi standar dan kustom, ditawarkan tanpa biaya.

Batasan

  • Batasan kustom hanya diterapkan pada metode CREATE untuk resource VPC.

Langkah selanjutnya