全部产品
Search
文档中心

ApsaraVideo VOD:Konfigurasikan header respons HTTP kustom

更新时间:Jan 22, 2026

Anda dapat menambahkan header respons HTTP kustom ke pesan respons dari nama domain yang dipercepat untuk mengaktifkan Berbagi Sumber Daya Lintas Asal (CORS). Topik ini menjelaskan cara mengonfigurasi header respons HTTP kustom.

Informasi latar belakang

Berbagi Sumber Daya Lintas Asal (Cross-Origin Resource Sharing/CORS), juga dikenal sebagai akses lintas domain, merupakan mekanisme standar HTML5 yang memungkinkan server aplikasi web mengontrol akses lintas asal guna memastikan transmisi data yang aman.

Saat pengguna meminta sumber daya bisnis Anda, Anda dapat mengonfigurasi header respons dalam pesan respons untuk mengaktifkan akses lintas asal. Ketika CDN menerima permintaan lintas asal, CDN membaca aturan CORS yang sesuai dan melakukan pemeriksaan izin. CDN memeriksa setiap aturan secara berurutan dan menggunakan aturan pertama yang cocok untuk mengizinkan permintaan serta mengembalikan header yang sesuai. Jika tidak ada aturan yang cocok, header terkait CORS tidak akan ditambahkan.

Konfigurasi header respons HTTP diterapkan pada tingkat nama domain. Setelah diterapkan, konfigurasi tersebut berlaku untuk semua pesan respons atas seluruh sumber daya di bawah nama domain tersebut. Pengaturan header respons HTTP hanya memengaruhi perilaku respons klien, seperti browser, dan tidak memengaruhi perilaku cache node CDN. Nama domain wildcard tidak mendukung header respons HTTP kustom.

Prosedur

  1. Masuk ke Konsol ApsaraVideo VOD.

  2. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names.

  3. Temukan nama domain yang ingin Anda konfigurasi, lalu klik Configure.

  4. Di panel navigasi sebelah kiri untuk nama domain yang ditentukan, klik Cache.

  5. Klik tab Custom HTTP Response Headers.

  6. Klik Add untuk mengonfigurasi header respons HTTP kustom.

    Gambar berikut menunjukkan contoh penambahan header respons HTTP kustom.自定义HTTP头

    Parameter

    Deskripsi

    Operation

    Anda dapat menambahkan, menghapus, mengubah, atau mengganti header respons tertentu.

    Response Header

    Pilih Customize atau parameter header respons standar, seperti Cache-Control, dari daftar drop-down. Untuk informasi selengkapnya, lihat Parameter header respons.

    Response Header Name

    Parameter ini wajib diisi saat Anda menetapkan Parameter Header Respons Kustom ke Customize. Nama header respons kustom harus memenuhi persyaratan berikut:

    • Terdiri atas huruf, angka, dan tanda hubung (-).

    • Panjangnya antara 1 hingga 100 karakter.

    Response Header Value

    Masukkan nilai untuk header respons. Untuk informasi selengkapnya, lihat Parameter header respons.

    Allow Duplicates

    • Not Allowed: Header yang dikembalikan dari origin server dipertahankan, dan header baru dengan nama yang sama ditambahkan.

    • Allowed: Header yang dikembalikan dari origin server ditimpa oleh header baru dengan nama yang sama.

  7. Klik OK untuk menyelesaikan konfigurasi.

    Setelah mengonfigurasi header respons HTTP kustom, Anda dapat mengubahnya dengan mengklik Modify atau Delete di kolom Actions.

Parameter header respons

Catatan

Semua parameter header respons mendukung HTTP/2, kecuali parameter kustom.

Parameter header respons

Deskripsi

Contoh

Custom

Memungkinkan Anda menambahkan header respons kustom. Nama header respons kustom harus memenuhi persyaratan berikut:

  • Terdiri atas huruf, angka, dan tanda hubung (-).

  • Panjangnya antara 1 hingga 100 karakter.

Test-Header

Cache-Control

Menentukan kebijakan cache yang digunakan klien untuk permintaan dan respons.

no-cache

Content-Disposition

Menentukan nama file default saat program klien menyimpan konten yang diminta sebagai file.

examplefile.txt

Content-Type

Menentukan tipe konten objek respons untuk klien. Tipe yang didukung meliputi teks, gambar, audio, video, dan file.

image

Pragma

Header umum Pragma HTTP/1.0 adalah header spesifik implementasi yang dapat memiliki berbagai efek sepanjang rantai permintaan-respons. Pragma HTTP/1.0 kompatibel dengan HTTP/1.1.

no-cache

Access-Control-Allow-Origin

Menentukan origin yang diizinkan untuk membuat permintaan lintas asal. Anda dapat memasukkan tanda bintang (*) untuk mengizinkan semua nama domain, atau memasukkan nama domain lengkap, seperti http://example.aliyundoc.com.

Catatan
  • Nilainya dapat berupa tanda bintang (*) untuk menunjukkan origin apa pun.

  • Jika nilainya bukan tanda bintang (*), Anda dapat mengonfigurasi satu atau beberapa alamat IP, nama domain, atau kombinasi alamat IP dan nama domain. Pisahkan dengan koma (,).

  • Jika nilainya bukan tanda bintang (*), nilai tersebut harus mencakup protokol "http://" atau "https://".

  • Nilai dapat mencakup nomor port.

  • Nilai mendukung nama domain wildcard.

  • *

  • http://example.aliyundoc.com

Access-Control-Allow-Methods

Menentukan metode yang diizinkan untuk permintaan lintas asal. Anda dapat menetapkan beberapa metode, dipisahkan dengan koma (,).

POST,GET

Access-Control-Allow-Headers

Menentukan bidang header yang diizinkan untuk permintaan lintas asal.

X-Custom-Header

Access-Control-Expose-Headers

Menentukan header yang dapat diekspos sebagai bagian dari respons. Anda dapat menentukan beberapa header, dipisahkan dengan koma (,).

Content-Length

Access-Control-Allow-Credentials

Menunjukkan apakah respons terhadap permintaan dapat diekspos ke halaman.

  • Nilai true menunjukkan bahwa respons dapat diekspos.

  • Nilai lain menunjukkan bahwa respons tidak dapat diekspos.

true

Access-Control-Max-Age

Menentukan berapa lama hasil permintaan preflight dapat di-cache, dalam satuan detik.

600