Jika resource yang diminta tidak di-cache pada point of presence (POPs) Alibaba Cloud CDN atau cache-nya telah kedaluwarsa, POPs akan mengirim permintaan ke origin server untuk mendapatkan resource terbaru. Header dalam pesan HTTP yang dikembalikan oleh origin server disebut sebagai origin response headers. Anda dapat memodifikasi incoming response headers untuk mengonfigurasi kebijakan cache dan cross-origin resource sharing (CORS), sehingga meningkatkan performa, keamanan, serta pengalaman pengguna situs web Anda, sekaligus mengelola akses ke resource secara efektif.
Informasi latar belakang
HTTP response headers merupakan komponen bagian header dalam pesan respons yang ditransmisikan melalui HTTP dan berisi parameter spesifik yang dikirim ke klien.
Jika resource yang diminta tidak di-cache pada POPs, permintaan akan dialihkan ke origin server, yang kemudian mengembalikan resource tersebut ke POPs. Anda dapat menulis ulang incoming response headers dari origin server agar klien lebih mudah mengenali informasi respons. Sebagai contoh, Anda dapat menulis ulang nilai header Content-Type sebelum dikembalikan ke klien untuk memastikan bahwa klien dapat mengurai konten yang diambil dari origin server. Jika header Content-Type yang dikembalikan oleh origin server tidak valid, teks yang ditampilkan akan menjadi rusak (garbled). Dalam kasus ini, nilai Content-Type harus ditulis ulang pada POPs.
Setelah origin server menerima permintaan dari POP, origin server mengembalikan pesan HTTP. Aturan penulisan ulang hanya berlaku pada header HTTP dalam respons yang dikembalikan dari origin server, bukan pada header HTTP dalam respons yang langsung dikembalikan dari POPs.
Anda tidak dapat mengonfigurasi custom incoming response headers untuk wildcard domain names.
Prosedur
Masuk ke ApsaraVideo VOD console.
Pada panel navigasi kiri, pilih Configuration Management > CDN Configuration > Domain Names.
Temukan nama domain yang ingin Anda kelola, lalu klik Configure pada kolom Actions.
Pada panel navigasi kiri untuk domain tersebut, klik Back-to-Origin.
Klik tab Origin HTTP Response Headers.
Klik Add dan konfigurasikan informasi header respons HTTP back-to-origin.
PentingSaat operasi berbeda dilakukan secara bersamaan pada header respons yang sama, operasi tersebut memiliki prioritas berbeda. Urutan prioritas operasi dari yang tertinggi ke terendah adalah: Replace > Add > Change atau Delete. Misalnya, jika Anda melakukan operasi Add dan Delete secara bersamaan pada header respons yang sama, header respons tersebut akan ditambahkan lalu dihapus.
Parameter operasi Add
Parameter
Contoh
Deskripsi
Operation
Add
Operasi ini menambahkan header respons ke pesan respons dari origin server.
Response Header
Custom Response Header
Anda dapat memilih header preset atau memilih Custom Response Header dari daftar drop-down Response Header untuk menentukan header respons.
Header Name
x-code
Nama header respons kustom adalah x-code.
Header Value
key1
Anda dapat menentukan beberapa nilai untuk satu header respons. Pisahkan nilai-nilai tersebut dengan koma (,).
key1,key2
Allow Duplicates
Yes
Yes: Anda dapat menambahkan header respons duplikat. Contoh:
x-code:key1danx-code:key2.No: Nilai header terbaru akan menimpa nilai header yang sudah ada dengan nama header yang sama. Misalnya, jika Anda menambahkan
x-code:key1lalu menambahkanx-code:key2, hanyax-code:key2yang berlaku.
Rule Condition
Do not use conditions
Rule conditions mengidentifikasi berbagai parameter dalam permintaan pengguna untuk menentukan apakah suatu konfigurasi berlaku untuk permintaan tersebut.
Do not use: Tidak menggunakan rule conditions.
Untuk menambah atau mengedit rule conditions, kelola di Rules Engine.
Parameter operasi Delete
Parameter
Contoh
Deskripsi
Operation
Delete
Operasi ini menghapus semua header respons yang sesuai dengan nilai parameter Response Header dan Header Name. Header respons duplikat juga dihapus.
Response Header
Custom Response Header
Anda dapat memilih header preset atau memilih Custom Response Header dari daftar drop-down Response Header untuk menentukan header respons.
Header Name
x-code
Nama header respons kustom adalah x-code.
Rule Condition
Do not use conditions
Rule conditions mengidentifikasi berbagai parameter dalam permintaan pengguna untuk menentukan apakah suatu konfigurasi berlaku untuk permintaan tersebut.
Do not use: Tidak menggunakan rule conditions.
Untuk menambah atau mengedit rule conditions, kelola di Rules Engine.
Parameter operasi Change
Parameter
Contoh
Deskripsi
Operation
Change
Anda hanya dapat melakukan operasi Change jika tidak ada header respons duplikat.
Response Header
Custom Response Header
Anda dapat memilih header preset atau memilih Custom Response Header dari daftar drop-down Response Header untuk menentukan header respons.
Header Name
x-code
Nama header respons kustom adalah x-code.
Change Value To
key1,key3
Anda dapat menentukan beberapa nilai untuk satu header respons. Pisahkan nilai-nilai tersebut dengan koma (,).
Rule Condition
Rule conditions mengidentifikasi berbagai parameter dalam permintaan pengguna untuk menentukan apakah suatu konfigurasi berlaku untuk permintaan tersebut.
Do not use: Tidak menggunakan rule conditions.
Untuk menambah atau mengedit rule conditions, kelola di Rules Engine.
Parameter operasi Replace
Parameter
Contoh
Deskripsi
Operation
Replace
Anda hanya dapat melakukan operasi Replace jika tidak ada header respons duplikat.
Response Header
Custom Response Header
Anda dapat memilih header preset atau memilih Custom Response Header dari daftar drop-down Response Header untuk menentukan header respons.
Header Name
x-code
Nama header respons kustom adalah x-code.
Find
key
Anda dapat mencari nilai yang ingin diganti dengan menggunakan ekspresi reguler.
Replace With
abc
Anda dapat mengganti nilai yang sesuai dengan menggunakan ekspresi reguler.
Match
Match All
Match All: Semua nilai yang sesuai akan diganti. Misalnya, jika Anda menggunakan ekspresi reguler untuk mengganti semua string "key" dalam
x-code:key1,key2,key3dengan abc, pasangan kunci-nilai tersebut berubah menjadix-code:abc1,abc2,abc3.Match the First Only: Hanya nilai pertama yang sesuai yang diganti. Misalnya, jika Anda menggunakan ekspresi reguler untuk mengganti string "key" pertama dalam
x-code:key1,key2,key3dengan abc, pasangan kunci-nilai tersebut berubah menjadix-code:abc1,key2,key3.
Rule Condition
Rule conditions mengidentifikasi berbagai parameter dalam permintaan pengguna untuk menentukan apakah suatu konfigurasi berlaku untuk permintaan tersebut.
Do not use: Tidak menggunakan rule conditions.
Untuk menambah atau mengedit rule conditions, kelola di Rules Engine.
Klik OK untuk menyelesaikan konfigurasi.
Contoh
Contoh 1: Menentukan bahwa konten yang dikembalikan kepada pengguna memiliki tipe MIME tertentu
Skenario contoh
Tambahkan header respons untuk menentukan bahwa konten yang dikembalikan kepada pengguna memiliki tipe MIME tertentu.
Konten MIME mencakup jenis-jenis berikut:
Teks: termasuk file teks seperti .txt dan .csv, serta file HTML seperti .html, .htm, dan .shtml.
Gambar: termasuk file gambar umum seperti .jpg, .png, dan .gif.
Audio: termasuk file audio seperti .mp3 dan .wav.
Video: termasuk file video seperti .mp4 dan .avi.
Aplikasi: termasuk file aplikasi seperti .pdf, .doc, dan .xls.
Konfigurasi
Operation: Add
Response Header: Content-Type
Header Value: text/html
Hasil yang diharapkan: Origin server menambahkan header Content-Type dengan nilai text/html ke respons yang dikembalikan ke POPs. Jika konfigurasi diperbarui, nilainya akan ditimpa.
Contoh 2: Menghapus header respons
Skenario contoh
Hapus header respons dari respons.
Konfigurasi
Operation: Delete
Response Header: Content-Type
Hasil yang diharapkan: Header Content-Type dihapus dari respons sebelum dikembalikan ke pengguna.
Jika operasi Add pada Contoh 1 dan operasi Delete pada Contoh 2 dilakukan secara bersamaan, header Content-Type dengan nilai text/html akan ditambahkan ke respons lalu dihapus. Akibatnya, konten yang dikembalikan ke pengguna tetap menggunakan tipe aslinya, bukan tipe MIME yang ditentukan.