Mengonfigurasi kebijakan keamanan

Media CDN menggunakan kebijakan keamanan Google Cloud Armor untuk mencegah traffic yang tidak diinginkan mencapai layanannya. Anda dapat mengizinkan atau menolak permintaan berdasarkan hal berikut:

  • Alamat dan rentang IPv4 dan IPv6 (CIDR)
  • Kode negara (geografi)
  • Pemfilteran lapisan 7

Kemampuan ini memungkinkan Anda membatasi download konten untuk pengguna di lokasi tertentu tempat Anda memiliki batasan pemberian lisensi konten, hanya mengizinkan alamat IP perusahaan untuk mengakses endpoint pengujian atau staging, dan menolak daftar alamat IP klien buruk yang diketahui.

Anda dapat mendekorasi permintaan yang diizinkan Google Cloud Armor dengan menyisipkan header kustom dengan nama dan nilai yang dapat dikonfigurasi.

Kebijakan keamanan Google Cloud Armor berlaku untuk semua konten yang disalurkan dari Media CDN, termasuk konten yang di-cache dan cache yang tidak ditemukan.

Kebijakan keamanan Google Cloud Armor dikonfigurasi per layanan Media CDN—semua permintaan yang ditujukan untuk alamat IP (atau nama host) layanan tersebut menerapkan kebijakan keamanan secara konsisten. Kebijakan keamanan yang berbeda dapat memiliki kebijakan keamanan yang berbeda, dan Anda dapat membuat beberapa layanan untuk wilayah geografis yang berbeda sesuai kebutuhan.

Untuk perlindungan konten yang lebih mendetail di tingkat per pengguna, sebaiknya gunakan URL bertanda tangan dan cookie bertanda tangan bersama kebijakan Google Cloud Armor.

Media CDN tidak mempertimbangkan header referer selama evaluasi aturan kebijakan keamanan edge pemfilteran header Lapisan 7 saat kebijakan tersebut ditetapkan ke salah satu nilai berikut:

  • Beberapa URL
  • URL relatif
  • URL absolut yang valid yang berisi informasi pengguna atau komponen fragmen

Mengonfigurasi kebijakan keamanan

Gunakan petunjuk berikut untuk mengonfigurasi kebijakan keamanan.

Sebelum memulai

Untuk memasang kebijakan keamanan Google Cloud Armor ke layanan Media CDN, pastikan hal berikut:

Anda juga memerlukan izin Identity and Access Management berikut untuk memberi otorisasi, membuat, dan melampirkan kebijakan keamanan ke layanan Media CDN:

  • compute.securityPolicies.addAssociation
  • compute.securityPolicies.create
  • compute.securityPolicies.delete
  • compute.securityPolicies.get
  • compute.securityPolicies.list
  • compute.securityPolicies.update
  • compute.securityPolicies.use

Pengguna yang perlu melampirkan sertifikat yang sudah ada ke layanan Media CDN hanya memerlukan izin IAM berikut:

  • compute.securityPolicies.get
  • compute.securityPolicies.list
  • compute.securityPolicies.use

Peran roles/networkservices.edgeCacheUser mencakup semua izin ini.

Membuat kebijakan keamanan

Kebijakan keamanan Google Cloud Armor terdiri dari beberapa aturan, yang masing-masing menentukan kumpulan kriteria yang cocok (ekspresi) untuk permintaan, dan tindakan. Misalnya, ekspresi dapat berisi logika yang cocok untuk klien yang berada di India, dengan tindakan terkait yang adalah allow. Jika permintaan tidak cocok dengan aturan, Google Cloud Armor akan terus mengevaluasi aturan berikutnya, hingga semua aturan dicoba.

Kebijakan keamanan memiliki aturan default dengan tindakan allow. Aturan default mengizinkan permintaan yang tidak cocok dengan aturan sebelumnya. Ini dapat diubah menjadi aturan deny saat Anda ingin allow hanya meminta permintaan yang cocok dengan aturan sebelumnya dan menolak yang lainnya.

Contoh berikut menunjukkan cara membuat aturan yang memblokir semua klien yang geolokasinya ke Australia dengan HTTP 403, dan mengizinkan semua permintaan lainnya.

gcloud

Untuk membuat kebijakan baru jenis CLOUD_ARMOR_EDGE, gunakan perintah gcloud compute security-policies create:

gcloud compute security-policies create block-australia \
    --type="CLOUD_ARMOR_EDGE" --project="PROJECT_ID"

Tindakan ini akan membuat kebijakan dengan aturan izinkan default dengan prioritas terendah (priority: 2147483647):

Created [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/securityPolicies/block-australia].

Kemudian Anda dapat menambahkan aturan dengan prioritas yang lebih tinggi:

gcloud compute security-policies rules create 1000 \
    --security-policy=block-australia --description "block AU" \
    --expression="origin.region_code == 'AU'" --action="deny-403"

Output-nya adalah sebagai berikut:

Updated [https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/securityPolicies/block-australia].

Terraform 

resource "google_compute_security_policy" "default" {
  name        = "block-australia"
  type        = "CLOUD_ARMOR_EDGE"
  description = "block AU"

  rule {
    action      = "deny(403)"
    description = "block AU"
    priority    = "1000"
    match {
      expr {
        expression = "origin.region_code == 'AU'"
      }
    }
  }
  rule {
    action   = "allow"
    priority = "2147483647"
    match {
      versioned_expr = "SRC_IPS_V1"
      config {
        src_ip_ranges = ["*"]
      }
    }
    description = "default rule"
  }
}

Saat memeriksa kebijakan, Anda akan melihat dua aturan: aturan pertama memblokir permintaan yang berasal dari Australia (origin.region_code == 'AU') dan aturan prioritas kedua yang terendah, mengizinkan semua traffic yang tidak cocok dengan aturan (atau aturan) dengan prioritas yang lebih tinggi.

kind: compute#securityPolicy
name: block-australia
rules:
- action: deny(403)
  description: block AU
  kind: compute#securityPolicyRule
  match:
    expr:
      expression: origin.region_code == 'AU'
  preview: false
  priority: 1000
- action: allow
  description: default rule
  kind: compute#securityPolicyRule
  match:
    config:
      srcIpRanges:
      - '*'
    versionedExpr: SRC_IPS_V1
  preview: false
  priority: 2147483647
  ruleNumber: '1'
type: CLOUD_ARMOR_EDGE

Menambahkan aturan ke kebijakan keamanan

Kebijakan keamanan Google Cloud Armor adalah kumpulan aturan yang cocok pada atribut Lapisan 7 untuk melindungi aplikasi atau layanan yang digunakan secara eksternal. Setiap aturan dievaluasi sehubungan dengan traffic yang masuk.

Atribut-atribut ini dapat digunakan untuk permintaan HTTP dalam kebijakan keamanan: request.headers, request.method, request.path, request.scheme, dan request.query. Untuk mengetahui informasi selengkapnya tentang cara menulis ekspresi untuk aturan kebijakan keamanan, baca referensi bahasa aturan kustom Google Cloud Armor.

Aturan kebijakan keamanan Google Cloud Armor terdiri dari kondisi pencocokan dan tindakan yang akan diambil jika kondisi tersebut terpenuhi.

gcloud

Untuk membuat aturan kebijakan keamanan, gunakan perintah gcloud compute security-policies rules create PRIORITY. Ganti PRIORITY dengan prioritas aturan dalam kebijakan:

gcloud compute security-policies rules create PRIORITY \
    --security-policy POLICY_NAME \
    --description DESCRIPTION \
    --src-ip-ranges IP_RANGES | --expression EXPRESSION \
    --action=[ allow | deny-403 | deny-404 | deny-502 ] \
    --preview

Melampirkan kebijakan ke layanan

gcloud

Untuk memasang kebijakan Google Cloud Armor yang ada ke layanan Media CDN, gunakan perintah gcloud edge-cache services update:

gcloud edge-cache services update MY_SERVICE \
    --edge-security-policy=SECURITY_POLICY

Memperbarui aturan dalam kebijakan keamanan

Gunakan petunjuk ini untuk memperbarui satu aturan dalam kebijakan keamanan Google Cloud Armor. Atau, Anda dapat secara atomik memperbarui beberapa aturan dalam kebijakan keamanan.

gcloud

Gunakan gcloud compute security-policies rules updateperintah:

gcloud compute security-policies rules update PRIORITY [ \
    --security-policy POLICY_NAME  \
    --description DESCRIPTION  \
    --src-ip-ranges IP_RANGES  | --expression EXPRESSION \
    --action=[ allow | deny-403 | deny-404 | deny-502 ]  \
    --preview
  ]

Misalnya, perintah berikut memperbarui aturan dengan prioritas 1111 untuk mengizinkan traffic dari rentang alamat IP 192.0.2.0/24:

gcloud compute security-policies rules update 1111 \
    --security-policy my-policy \
    --description "allow traffic from 192.0.2.0/24" \
    --src-ip-ranges "192.0.2.0/24" \
    --action "allow"

Untuk memperbarui prioritas aturan, Anda harus menggunakan REST API. Untuk mengetahui informasi selengkapnya, lihat metode securityPolicies.patchRule.

Melihat lampiran kebijakan

Untuk meninjau kebijakan yang disertakan ke layanan yang ada, periksa (jelaskan) layanan tersebut.

gcloud

Untuk melihat kebijakan Google Cloud Armor yang disertakan ke layanan Media CDN, gunakan perintah gcloud edge-cache services describe:

gcloud edge-cache services describe MY_SERVICE

Kolom edgeSecurityPolicy layanan menjelaskan kebijakan terlampir:

name: "MY_SERVICE"
edgeSecurityPolicy: "SECURITY_POLICY

Menghapus kebijakan

Untuk menghapus kebijakan yang ada, update layanan terkait dan teruskan string kosong sebagai kebijakan.

gcloud

Gunakan perintah gcloud edge-cache services update: 

gcloud edge-cache services update MY_SERVICE 

  --edge-security-policy=""

Kolom edgeSecurityPolicy sekarang dihilangkan dari output perintah gcloud edge-cache services describe MY_SERVICE.

Contoh

Pertimbangkan contoh kasus penggunaan terperinci berikut.

Contoh: Mengidentifikasi permintaan yang diblokir

Anda harus mengaktifkan logging untuk layanan Edge Cache tertentu agar permintaan yang diblokir dicatat ke dalam log.

Permintaan yang diizinkan atau ditolak oleh kebijakan pemfilteran akan dicatat ke dalam Logging. Untuk memfilter permintaan yang ditolak, Kueri logging berikut untuk konfigurasi prod-video-service akan terlihat seperti ini:

resource.type="edge_cache_service"
jsonPayload.statusDetails="denied_by_security_policy"

Contoh: Menyesuaikan kode respons

Aturan Google Cloud Armor dapat dikonfigurasi untuk menampilkan kode status tertentu sebagai tindakan yang terkait dengan aturan tertentu. Dalam sebagian besar kasus, sebaiknya tampilkan kode HTTP 403 (deny-403) untuk menunjukkan dengan jelas bahwa klien diblokir oleh aturan tersebut.

Kode status yang didukung adalah:

  • HTTP 403 (Terlarang)
  • HTTP 404 (Tidak Ditemukan)
  • HTTP 502 (Gateway Buruk)

Contoh berikut menunjukkan cara mengonfigurasi kode status yang ditampilkan:

Untuk menentukan salah satu [allow | deny-403 | deny-404 | deny-502] sebagai tindakan yang terkait dengan aturan, jalankan perintah berikut. Contoh ini mengonfigurasi aturan untuk menampilkan HTTP 502.

gcloud compute security-policies rules create 1000 \
    --security-policy=block-australia --description "block AU" \
    --expression="origin.region_code == 'AU'" --action="deny-502"

Setiap aturan dalam kebijakan keamanan dapat menentukan respons kode status yang berbeda.

Contoh: Menolak klien di luar suatu negara, kecuali untuk alamat IP yang diizinkan

Kasus yang umum dalam penayangan media adalah menolak koneksi dengan klien yang berada di luar wilayah tempat Anda memiliki lisensi konten atau mekanisme pembayaran.

Misalnya, Anda mungkin hanya ingin mengizinkan klien yang berada di India, serta alamat IP apa pun yang ada dalam daftar yang diizinkan, termasuk alamat partner konten dan karyawan Anda sendiri, dalam rentang 192.0.2.0/24, dan menolak semua alamat IP lainnya.

Dengan menggunakan bahasa aturan kustom Google Cloud Armor, ekspresi berikut mendapatkan hasil ini:

origin.region_code == "IN" || inIpRange(origin.ip, '192.0.2.0/24')

Ekspresi ini dikonfigurasi sebagai aturan allow, dengan aturan deny default yang dikonfigurasi agar cocok dengan semua klien lainnya. Kebijakan keamanan selalu memiliki aturan default. Anda biasanya mengonfigurasi setelan ini ke traffic default deny yang tidak diizinkan secara eksplisit. Dalam kasus lain, Anda dapat memilih untuk memblokir beberapa traffic dan default allow semua traffic lainnya.

Dalam output kebijakan keamanan, perhatikan hal-hal berikut:

  • Aturan prioritas tertinggi (priority: 0) mengizinkan traffic dari India OR dari daftar alamat IP yang ditentukan.
  • Aturan prioritas terendah mewakili default deny. Mesin aturan menolak semua klien yang tidak dievaluasi oleh aturan dengan prioritas yang lebih tinggi ke true.
  • Anda dapat menggabungkan beberapa aturan menggunakan boolean operators.

Kebijakan ini mengizinkan traffic dari klien di India, mengizinkan klien dari rentang IP yang ditentukan, dan menolak semua traffic lainnya.

Saat Anda melihat detail kebijakan, outputnya akan terlihat seperti berikut:

kind: compute#securityPolicy
name: allow-india-only
type: "CLOUD_ARMOR_EDGE"
rules:
- action: allow
  description: ''
  kind: compute#securityPolicyRule
  match:
    expr:
      expression: origin.region_code == "IN" || inIpRange(origin.ip, '192.0.2.0/24')
  preview: false
  priority: 0
- action: deny(403)
  description: Default rule, higher priority overrides it
  kind: compute#securityPolicyRule
  match:
    config:
      srcIpRanges:
      - '*'
    versionedExpr: SRC_IPS_V1
  preview: false
  priority: 2147483647

Anda juga dapat menetapkan header respons kustom dengan variabel header {region_code}. Header ini dapat diperiksa menggunakan JavaScript dan direfleksikan ke klien.

Contoh: Memblokir klien berbahaya berdasarkan alamat IP dan rentang IP

Dengan menggunakan bahasa aturan kustom Google Cloud Armor, ekspresi berikut mendapatkan hasil ini:

inIpRange(origin.ip, '192.0.2.2/32') || inIpRange(origin.ip, '192.0.2.170/32')

Anda dapat memblokir rentang IP hingga mask /8 di IPv4 dan /32 di IPv6. Kasus umum untuk platform streaming adalah memblokir rentang IP keluar proxy atau penyedia VPN untuk meminimalkan pengelakan pemberian lisensi konten:

inIpRange(origin.ip, '192.0.2.0/24') || inIpRange(origin.ip, '198.51.100.0/24') || inIpRange(origin.ip, '203.0.113.0/24') || inIpRange(origin.ip, '2001:DB8::B33F:2002/64')

Rentang alamat IPv4 dan IPv6 didukung.

Contoh: Hanya izinkan daftar geografi yang tetap

Jika memiliki daftar kode negara, Anda dapat menggunakan operator OR boolean || untuk menggabungkan kondisi pencocokan.

Dengan menggunakan bahasa aturan khusus Google Cloud Armor, ekspresi berikut memungkinkan pengguna yang diidentifikasi berasal dari Australia atau Selandia Baru:

origin.region_code == "AU" || origin.region_code == "NZ"

Hal ini juga dapat digabungkan dengan ekspresi origin.ip atau inIpRange(origin.ip, '...') untuk mengizinkan penguji, partner, dan rentang IP perusahaan Anda, meskipun jika mereka tidak berasal dari salah satu wilayah geografis yang ditentukan.

Ada jumlah subekspresi yang terdokumentasi untuk setiap aturan dengan ekspresi kustom. Jika perlu menggabungkan lebih banyak subekspresi, tentukan beberapa aturan dalam satu kebijakan.

Contoh: Memblokir klien dari sekumpulan negara tertentu

Contoh yang kurang umum mungkin memblokir klien dari sekumpulan negara tertentu, tetapi mengizinkan permintaan dari semua negara lain.

Untuk melakukannya, buat kebijakan yang memblokir negara dan klien yang wilayahnya tidak dapat ditentukan, lalu beralih ke aturan izinkan default untuk semua permintaan lainnya.

Contoh berikut menjelaskan kebijakan yang memblokir klien dari Kanada, serta klien yang lokasinya tidak diketahui, tetapi mengizinkan semua traffic lainnya:

  kind: compute#securityPolicy
  name: block-canada
  type: "CLOUD_ARMOR_EDGE"
  rules:
  - action: deny(403)
    description: ''
    kind: compute#securityPolicyRule
    match:
      expr:
        expression: origin.region_code == "CA" || origin.region_code == "ZZ"
    preview: false
    priority: 0
  - action: allow
    description: Default rule, higher priority overrides it
    kind: compute#securityPolicyRule
    match:
      config:
        srcIpRanges:
        - '*'
      versionedExpr: SRC_IPS_V1
    preview: false
    priority: 2147483647

Contoh: Menolak permintaan untuk konten yang di-cache dengan header tertentu

Kebijakan keamanan edge berlaku untuk semua permintaan yang menargetkan layanan Media CDN apa pun tempat kebijakan disertakan. Penegakan kebijakan ini dilakukan sebelum pencarian cache apa pun. Permintaan yang tidak diizinkan oleh kebijakan keamanan edge akan ditolak dengan kode status yang dikonfigurasi.

Ekspresi berikut cocok dengan permintaan dari alamat IP 1.2.3.4 yang berisi string user1 di header user-agent:

inIpRange(origin.ip, '1.2.3.4/32') && request.headers['user-agent'].contains('user1')

Perintah berikut menambahkan aturan pemfilteran 105 ke kebijakan keamanan edge my-edge-policy, yang dilampirkan ke layanan Media CDN:

gcloud compute security-policies rules create 105 \
    --security-policy my-edge-policy \
    --expression = "inIpRange(origin.ip, '1.2.3.4/32') && request.headers['user-agent'].contains('charlie')" \
    --action= deny-403 \
    --description="block requests from IP addresses in which the user-agent header contains the string charlie"

Mencatat tindakan penegakan kebijakan ke dalam log

Setiap log permintaan memberikan detail tentang kebijakan keamanan mana yang diterapkan dan apakah permintaan diizinkan (ALLOW) atau ditolak (DENY).

Untuk mengaktifkan logging, pastikan logConfig.enable ditetapkan ke true pada layanan Anda. Layanan yang tidak mengaktifkan log tidak akan mencatat peristiwa kebijakan keamanan ke dalam log.

Jika klien berada di luar Amerika Serikat dan kebijakan keamanan bernama deny-non-us-clients diberlakukan untuk menolak permintaan yang berasal dari luar AS, ini adalah entri log untuk permintaan yang ditolak:

enforcedSecurityPolicy:
  name: deny-non-us-clients
  outcome: DENY

Layanan tanpa kebijakan Google Cloud Armor yang terlampir berisi no_policy sebagai nilai enforcedSecurityPolicy.name dan outcome sebesar ALLOW. Misalnya, entri log permintaan untuk layanan tanpa kebijakan yang dilampirkan memiliki nilai berikut:

enforcedSecurityPolicy:
  name: no_policy
  outcome: ALLOW

Memahami klasifikasi GeoIP

Media CDN mengandalkan sumber data klasifikasi IP internal Google untuk mendapatkan lokasi (wilayah, negara bagian, provinsi, atau kota) dari alamat IP. Jika Anda bermigrasi dari, atau membagi traffic antara, beberapa penyedia, sejumlah kecil alamat IP terkadang dapat dikaitkan dengan lokasi yang berbeda.

  • Google Cloud Armor menggunakan kode wilayah ISO 3166-1 alpha 2 untuk mengaitkan klien ke lokasi geografis.
  • Misalnya, US untuk Amerika Serikat, atau AU untuk Australia.
  • Dalam beberapa kasus, wilayah sesuai dengan negara, tetapi tidak selalu seperti ini. Misalnya, kode US mencakup semua negara bagian Amerika Serikat, satu distrik, dan enam area terpencil.
  • Untuk informasi selengkapnya, lihat unicode_region_subtag di Unicode Technical Standard.
  • Untuk klien yang tidak dapat memperoleh lokasi, origin.region_code disetel ke ZZ.

Anda dapat menambahkan data geografis ke header respons ke endpoint Media CDN (dengan routing.routeRules[].headerActions[].responseHeadersToAdd[]) atau mencerminkan data geografis yang diberikan ke Cloud Function untuk memvalidasi setiap perbedaan antara sumber data geoIP selama integrasi dan pengujian awal.

Selain itu, log permintaan Media CDN menyertakan clientRegion dan data khusus klien lainnya yang dapat Anda validasi terhadap sumber data yang ada.

Langkah selanjutnya