All Products
Search
Document Center

Edge Security Acceleration:Kunci cache kustom

Last Updated:May 21, 2026

Anda dapat membuat aturan berdasarkan bagian-bagian berbeda dari permintaan pengguna—seperti string kueri, header permintaan HTTP, atau cookie—untuk menghasilkan kunci cache kustom. Fitur ini menyatukan kunci cache untuk sekelompok permintaan yang mengakses file yang sama, sehingga mencegah file yang identik di-cache sebagai entitas terpisah akibat variasi parameter permintaan. Dengan demikian, tingkat hit cache meningkat, sedangkan waktu respons dan konsumsi bandwidth berkurang.

Informasi latar belakang

  • Fitur kunci cache kustom tidak mengubah URL asal (back-to-origin URL), melainkan hanya mengubah identitas cache dari permintaan. Hal ini memastikan bahwa permintaan ke origin tetap konsisten dengan permintaan klien.

  • Kunci cache adalah pengenal unik untuk file yang di-cache pada titik kehadiran (POP) ESA. Setiap file yang di-cache pada POP memiliki kunci cache yang unik. Secara default, kunci cache adalah URL lengkap dari permintaan klien, termasuk parameternya.

Catatan

Jika Anda mengonfigurasi CacheKey kustom dengan parameter seperti header permintaan HTTP, cookie, atau fitur pengguna, Anda tidak dapat menggunakan Purge cache by URL untuk membersihkan file cache untuk URL tertentu. Sebagai gantinya, Anda harus menggunakan Purge cache by custom key untuk membersihkan file cache untuk URL tersebut.

Kasus penggunaan

Kasus penggunaan 1: Menyatukan kunci cache

URL permintaan pelanggan berisi parameter yang kompleks. Akibatnya, meskipun beberapa permintaan mengakses file yang sama, POP ESA menganggapnya sebagai permintaan untuk file yang berbeda karena perbedaan parameter URL, sehingga menyimpannya sebagai beberapa file dan meningkatkan jumlah permintaan ke origin.

Untuk mengatasi masalah ini, Anda dapat menggunakan fitur kunci cache kustom untuk mengabaikan string kueri. Hal ini menyatukan kunci cache untuk kelompok permintaan yang sama dan mengurangi laju permintaan ke origin.

Kasus penggunaan 2: Membedakan kunci cache

Ketika URL permintaan klien identik, ESA menganggapnya sebagai permintaan untuk file yang sama. Namun, bidang client dalam header permintaan HTTP dapat membedakan antara sistem klien yang berbeda, menunjukkan bahwa file yang diminta sebenarnya berbeda.

Dalam kasus ini, Anda dapat menggunakan fitur kunci cache kustom untuk menghasilkan kunci cache yang berbeda berdasarkan tipe klien, sehingga kedua permintaan diidentifikasi oleh dua kunci cache yang berbeda.

Prosedur

Saat aturan diterapkan, permintaan dicocokkan sesuai dengan Rule Precedence.

  1. Di Konsol ESA, pilih Websites, lalu di kolom Website, klik situs target.

  2. Di panel navigasi kiri, pilih Rules > Cache Rules.

  3. Klik Create Rule dan masukkan Rule Name.

  4. Di bawah If requests match..., atur kondisi pencocokan untuk permintaan masuk. Untuk informasi lebih lanjut tentang pembuatan ekspresi aturan, lihat Composition of a rule expression.

  5. Di bagian Cache Eligibility, atur Cache Eligibility menjadi Eligible for Cache.

  6. Di bagian Custom Cache Keys, klik Configure, lalu atur parameter berikut.

    image

    Parameter

    Deskripsi

    Sort Query Strings

    Menentukan apakah akan mengaktifkan fitur Sort Query String.

    Query String

    Menentukan apakah akan menghapus karakter ? dan query string setelahnya dari URL permintaan.

    HTTP Request Header

    • Include these header names and values (enter header name; lowercase only): Menambahkan nama header permintaan HTTP yang ditentukan beserta nilainya ke Cachekey.

    • Check existence (enter header name; lowercase only): Memeriksa apakah header permintaan HTTP yang ditentukan ada. Jika ada, nama-namanya ditambahkan ke Cachekey.

    Cookie

    • Include these cookie names and values (enter cookie name; lowercase only): Menambahkan nama parameter cookie yang ditentukan beserta nilainya ke Cachekey.

    • Check existence (enter header name; lowercase only): Memeriksa apakah parameter cookie yang ditentukan ada. Jika ada, nama-namanya ditambahkan ke Cachekey.

    • Tipe karakter input yang didukung:

      • Simbol: ! # $ % & ' * + - . ^ _ ` | ~

      • Angka: 0-9

      • Huruf: a-z (huruf kecil bahasa Inggris)

    User

    • Device Type: Mengidentifikasi tipe klien berdasarkan informasi User-Agent klien, lalu menghasilkan Cachekey berdasarkan tipe klien tersebut. Nilai yang valid: desktop, tablet, mobile

    • Country/Region: Mengidentifikasi negara atau wilayah klien berdasarkan alamat IP klien, lalu menghasilkan Cachekey berdasarkan negara atau wilayah tersebut.

    • Language: Mengidentifikasi bahasa klien berdasarkan informasi Accept-Language dalam permintaan klien, lalu menghasilkan Cachekey berdasarkan jenis bahasa tersebut.

    Cache Deception Defense

    Melindungi dari serangan web cache deception sekaligus memungkinkan konten statis di-cache.

  7. Klik OK.

Contoh konfigurasi

Skenario contoh

  • URL permintaan pengguna: http://www.example.com/image.jpg?key123=321&key456=654

  • Header permintaan yang dibawa dalam permintaan pengguna:

    • name123:321

    • name456:654

    • User-Agent:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.X.X Safari/537.36

    • Accept-Language:zh-CN

  • Klien menggunakan alamat IP dari China Telecom untuk mengakses layanan.

Konfigurasi fitur

  • Query String: Delete parameter key456

  • HTTP Request Header:

    • Include these header names and values (enter header name; lowercase only): name123

    • Check existence (enter header name; lowercase only): name456

  • User: Saklar Device Type, Country/Region, dan Language semuanya diaktifkan.

image

Cachekey yang dihasilkan

Fragmen Cachekey yang dihasilkan untuk setiap parameter adalah:

  • http://www.example.com/image.jpg?key123=321

  • name123:321

  • name456

  • desktop

  • CN

  • Accept-Language:zh-CN

Oleh karena itu, Cachekey akhir merupakan gabungan dari fragmen-fragmen tersebut: http://example.com/image.jpg?key123=321name123:321name456desktopCNAccept-Language:zh-CN

Dokumentasi terkait

Fitur terkait aturan memiliki prioritas efektif, reentrancy, dan granularitas efektif yang berbeda-beda. Untuk detailnya, lihat Properties of Rule-Related Features.