All Products
Search
Document Center

CDN:Konfigurasi daftar hitam/daftar putih Referer

Last Updated:Apr 01, 2026

Perlindungan hotlink berbasis Referer mencegah situs web tidak sah menyematkan atau menautkan ke resource CDN Anda. Permintaan dari nama domain yang tidak tercantum dalam daftar Anda akan menerima respons HTTP 403.

Secara default, fitur ini tidak diaktifkan—semua situs web dapat mengakses resource Anda. Setelah diaktifkan, Alibaba Cloud CDN memeriksa header Referer pada setiap permintaan masuk dan menolak permintaan yang tidak sesuai dengan aturan Anda.

Penting

Daftar hitam dan daftar putih Referer hanya berlaku untuk nama domain publik. Permintaan yang diblokir tetap mencapai titik keberadaan (POPs) Anda, ditolak di sana, dan dicatat dalam log Alibaba Cloud CDN. Anda dikenai biaya untuk transfer data yang dihasilkan saat POPs memblokir permintaan dari klien dalam daftar hitam, serta untuk permintaan HTTPS jika klien meminta resource melalui HTTPS.

Cara kerja

Header Referer dalam permintaan HTTP mengidentifikasi asal permintaan tersebut. Header ini berisi skema, domain, path, dan parameter kueri. Protokol dan domain wajib ada; path dan parameter kueri bersifat opsional.

image

CDN mengevaluasi setiap permintaan berdasarkan aturan Anda:

  • Jika Referer berada dalam daftar hitam—permintaan ditolak (HTTP 403).

  • Jika Referer tidak berada dalam daftar putih—permintaan ditolak (HTTP 403).

  • Jika Referer berada dalam daftar putih—permintaan diizinkan.

image

Kasus penggunaan

Kasus penggunaanDeskripsi
Perlindungan hotlinkMencegah website lain menyematkan langsung gambar, video, atau aset lain milik Anda.
Perlindungan hak ciptaHanya mengizinkan website yang sah mengakses konten berhak cipta Anda.
Manajemen sumber trafikMengontrol nama domain mana yang diizinkan menggunakan resource CDN Anda.
Penguatan keamananMemblokir hotlinking berbahaya dan mencegah resource sensitif dirujuk oleh sumber yang tidak tepercaya.

Konfigurasi daftar hitam atau daftar putih Referer

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Prosedur

  1. Masuk ke Konsol Alibaba Cloud CDN.

  2. Di panel navigasi kiri, klik Domain Names.

  3. Temukan nama domain yang ingin dikelola, lalu klik Manage pada kolom Actions.

  4. Di pohon navigasi kiri, klik Access Control.

  5. Pada tab Referer Black/Whitelist, klik Modify.

  6. Atur parameter yang dijelaskan di bagian Parameters.

  7. Klik OK.

Parameter

ParameterDeskripsi
TypePilih Blacklist atau Whitelist. Keduanya saling eksklusif—konfigurasikan hanya salah satu.- Blacklist: menolak permintaan yang Referer-nya ada dalam daftar.- Whitelist: hanya mengizinkan permintaan yang Referer-nya ada dalam daftar.
RulesMasukkan satu nama domain per baris. Konten tidak boleh melebihi 60 KB. Jangan sertakan awalan protokol—CDN secara otomatis mencocokkan http:// dan https://.- Gunakan *.example.com untuk mencocokkan semua subdomain dari example.com.- Masukkan example.com (tanpa tanda bintang) untuk mencocokkan example.com dan semua subdomain-nya. Saat Anda menambahkan aliyundoc.com, CDN secara otomatis menerapkan aturan tersebut ke semua domain yang cocok dengan *.aliyundoc.com.
Redirect URL(Opsional) Saat permintaan diblokir, CDN mengembalikan HTTP 302 dengan header Location yang diatur ke URL ini. Nilainya harus dimulai dengan http:// atau https:// (misalnya, http://www.example.com).
Allow resource URL access from browsersJika dipilih, permintaan dengan header Referer kosong diizinkan, terlepas dari konfigurasi daftar hitam atau daftar putih. Header Referer kosong terjadi ketika pengguna memasukkan URL secara langsung, menggunakan bookmark, atau mengakses resource melalui tab browser baru. Lihat Mengapa header Referer kosong pada beberapa permintaan? untuk skenario lainnya.
Exact MatchJika dipilih, pencocokan wildcard implisit dinonaktifkan. example.com hanya mencocokkan example.com, bukan subdomain-nya.
Ignore SchemeJika dipilih, header Referer tidak diwajibkan dimulai dengan http:// atau https://. Ini memungkinkan pencocokan saat browser menghilangkan protokol (misalnya, selama navigasi dari HTTPS ke HTTP atau dalam konfigurasi privasi tertentu).
Rule ConditionTerapkan kondisi aturan yang sudah ada dari Rules Engine untuk mengontrol permintaan mana yang dikenai konfigurasi ini. Lihat Rules engine untuk detail selengkapnya.

Verifikasi konfigurasi

Gunakan curl untuk menguji aturan Anda. Flag -e mengatur nilai header Referer; -I hanya mengambil header respons.

Contoh berikut menggunakan daftar putih dengan aliyun.com yang telah dikonfigurasi. Parameter Redirect URL, Exact Match, Ignore Scheme, dan Rule Condition tidak dikonfigurasi.

Catatan

Dengan aliyun.com dalam daftar putih, permintaan yang Referer-nya adalah http://aliyun.com, https://aliyun.com, atau subdomain yang sesuai diizinkan. Semua nilai Referer lainnya ditolak.

Skenario 1: Hanya aturan

Uji permintaan dari domain root:

curl -e http://aliyun.com -I DomainName
image

Uji permintaan dari subdomain:

curl -e http://sub.aliyun.com -I DomainName
image

Uji permintaan dari domain yang tidak ada dalam daftar putih:

curl -e http://aIiyun.com -I DomainName
image

Uji permintaan dengan header Referer kosong:

curl -e " " -I DomainName
image

Uji permintaan di mana Referer tidak mengandung protokol:

curl -e aliyun.com -I DomainName
image

Skenario 2: Aturan + Izinkan akses URL sumber daya dari browser

Allow resource URL access from browsers juga dipilih. Dibandingkan dengan skenario 1, permintaan dengan header Referer kosong kini diizinkan.

Uji permintaan tanpa header Referer:

curl -I DomainName
image

Uji permintaan dengan nilai Referer kosong:

curl -e " " -I DomainName
image

Skenario 3: Skema Aturan + Abaikan

Ignore Scheme juga dipilih. Dibandingkan dengan skenario 1, permintaan yang Referer-nya tidak menyertakan protokol kini diizinkan.

Uji permintaan dengan Referer tanpa protokol:

curl -e aliyun.com -I DomainName
image

FAQ

Mengapa protokol tidak ada dalam header Referer?

Saat browser melakukan navigasi dari halaman HTTP ke halaman HTTPS, browser tersebut dapat menghapus protokol dari header Referer untuk mematuhi aturan keamanan Referrer-Policy. Beberapa server proxy dan mode penjelajahan pribadi juga menghapus atau mengubah header Referer. Untuk mengizinkan permintaan tersebut agar sesuai dengan aturan Anda, pilih Ignore Scheme.

Mengapa header Referer kosong pada beberapa permintaan?

Header Referer kosong—atau sama sekali tidak ada—dalam beberapa situasi umum berikut:

  • Akses langsung: pengguna mengetik URL, menggunakan bookmark, atau membuka tab baru.

  • Pengaturan privasi: mode penjelajahan pribadi atau ekstensi browser yang berfokus pada privasi menghapus Referer.

  • HTTPS ke HTTP: browser menekan Referer saat mengarahkan ulang dari HTTPS ke HTTP untuk menghindari kebocoran data.

  • Kebijakan klien: situs menetapkan Referrer-Policy melalui tag <meta> atau header HTTP untuk membatasi pengiriman Referer.

  • Batasan lintas asal: permintaan lintas asal tertentu menghilangkan Referer berdasarkan kebijakan keamanan browser.

Jika layanan Anda tidak bergantung pada header Referer—misalnya, Anda ingin mengizinkan akses langsung dari browser—pilih Allow resource URL access from browsers. Ini memungkinkan CDN melayani permintaan terlepas dari apakah Referer ada atau tidak.

Langkah selanjutnya