Setelah menambahkan layanan ke Alibaba Cloud CDN, Anda dapat mengaktifkan akses lintas asal dengan mengonfigurasi header respons HTTP pada POP.
Apa itu berbagi sumber daya lintas asal?
Berbagi sumber daya lintas asal (CORS) adalah mekanisme standar yang memungkinkan halaman web mengakses resource dari origin (domain, protokol, atau port) yang berbeda. Mekanisme ini menyediakan cara aman untuk mengaktifkan transfer data lintas asal. Untuk informasi selengkapnya, lihat Cross-Origin Resource Sharing (CORS).
Secara default, CDN tidak mengaktifkan berbagi sumber daya lintas asal (CORS). Tanpa konfigurasi ini, browser memberlakukan kebijakan asal sama dan memblokir permintaan lintas asal, sehingga mencegah situs web lain memuat resource Anda.
Manfaat CORS
Karena pembatasan keamanan, browser umumnya mengikuti kebijakan asal sama yang membatasi pemuatan dan akses resource dari domain, subdomain, protokol, atau port yang berbeda. Misalnya, example.com tidak dapat mengakses resource di example.org. Dengan mengonfigurasi berbagi sumber daya lintas asal (CORS), Anda dapat mengatur header respons yang relevan pada server CDN. Jika permintaan menyertakan header yang sesuai dengan aturan yang diizinkan, server akan mengembalikan header respons HTTP yang sesuai, sehingga memungkinkan resource lintas asal untuk dimuat dan diakses.
Cara kerja
CORS dikonfigurasi pada origin server
-
Client mengirimkan permintaan ke example.com, misalnya,
https://example.com/index.html. -
example.commerespons dengan fileindex.html. Halaman tersebut berisi tautan ke resource pada origin yang berbeda:https://example.org/image_01.png. -
Client mengirimkan permintaan ke
example.org. -
Setelah menerima permintaan,
example.orgmerespons dengan header lintas asal, misalnya,Access-Control-Allow-Origin: *. -
Setelah menerima respons, browser memeriksa nilai header respons lintas asal. Karena nilainya adalah
*, yang mengizinkan akses dari origin mana pun, browser merender respons tersebut.
Dengan CORS dikonfigurasi pada CDN
-
Client mengirimkan permintaan ke CDN, misalnya,
https://example.com/index.html. -
CDN merespons dengan file index.html yang berisi resource dari origin lain:
https://example.org/image_01.png. -
Client mengirimkan permintaan ke CDN:
https://example.org/image_01.png. Permintaan tersebut menyertakan headerOrigin: http://example.com. -
Setelah menerima permintaan, CDN memeriksa apakah nilai header Origin sesuai dengan nilai Access-Control-Allow-Origin yang dikonfigurasi pada CDN. Pencocokan eksak (nilai tunggal atau multiple) dan pencocokan domain wildcard didukung. Jika nilai tidak cocok, CDN tidak mengembalikan header lintas asal; header hanya dikembalikan jika ditemukan kecocokan.
-
CDN mengembalikan header lintas asal berdasarkan hasil validasi, misalnya,
Access-Control-Allow-Origin: http://example.com. -
Setelah menerima respons, browser memeriksa nilai header respons lintas asal. Karena nilainya adalah
http://example.com, yang mengizinkan akses lintas asal, browser merender respons tersebut.
Catatan penggunaan
-
Jika Anda menggunakan bucket OSS sebagai origin server, konfigurasi CORS di konsol CDN akan menimpa konfigurasi CORS di konsol OSS. Untuk informasi selengkapnya tentang cara mengonfigurasi CORS di konsol OSS, lihat Mengatur aturan CORS.
-
Jika Anda menggunakan server on-premises atau instans ECS sebagai origin server, sebaiknya pisahkan konten statis dan dinamis, serta gunakan CDN untuk mempercepat pengiriman file statis. Fitur CORS yang dikonfigurasi di konsol CDN hanya berlaku untuk file statis.
Aktifkan berbagi sumber daya lintas asal
-
Masuk ke Konsol CDN.
-
Di panel navigasi kiri, klik Domain Names.
-
Pada halaman Domains, temukan domain yang ingin dikelola, lalu klik Actions di kolom Manage.
-
Klik Cache, pilih tab Modify Outgoing Response Header, lalu atur sumber dan metode yang diizinkan untuk permintaan lintas asal.
-
Atur origin untuk permintaan lintas asal
Klik Customize, konfigurasikan parameter seperti yang dijelaskan dalam tabel berikut, lalu klik OK.
Parameter
Deskripsi
Contoh
Operation
Atur parameter ini ke Add untuk mengaktifkan fitur validasi CORS.
Add
Response Header
Anda harus mengatur
Access-Control-Allow-Originuntuk menggunakan fitur validasi lintas asal.Access-Control-Allow-Origin
Header Value
Jika validasi CORS dinonaktifkan: Anda hanya dapat menentukan wildcard atau origin tunggal.
-
Wildcard
*: Mengizinkan origin mana pun untuk mengakses resource. -
Origin tunggal: Mengizinkan resource untuk diakses hanya dari origin tertentu (Nama domain).
Jika validasi CORS diaktifkan: Anda dapat menentukan wildcard, origin tunggal, multiple origin, atau domain wildcard.
-
Wildcard
*: Mengizinkan sumber mana pun untuk mengakses resource. -
Origin tunggal: Mengizinkan resource untuk diakses hanya dari origin tertentu (Nama domain).
-
Multiple origin yang ditentukan: Konfigurasikan multiple origin tertentu (Nama Domain), dipisahkan dengan koma
,, untuk mengizinkan origin tersebut mengakses resource.PentingSaat menentukan multiple origin, Anda harus memisahkannya dengan koma (
,). Jika Anda menggunakan titik koma (;), konfigurasi CORS tidak akan berlaku. Konsol tetap menampilkan konfigurasi berhasil, tetapi CDN menganggap seluruh string yang dipisahkan titik koma sebagai satu origin. Origin ini tidak cocok dengan domain individu mana pun dalam permintaan, sehingga CORS tidak berfungsi. -
Domain wildcard: Tentukan domain wildcard untuk mengizinkan akses dari semua origin yang sesuai dengan pola tersebut.
-
* -
http://www.aliyun.com -
https://aliyun.com,http://www.aliyun.com -
http://*.aliyun.com
Allow Duplicates
-
Yes: Header dari origin server dipertahankan, dan header baru dengan nama yang sama juga ditambahkan ke respons.
-
No: Header baru menggantikan header dengan nama yang sama dari origin server.
PentingPengaturan Allow Duplicates dan CORS Validation bersifat saling eksklusif. Jika Anda mengatur Allow Duplicates ke Yes, validasi CORS akan dinonaktifkan.
No
CORS
-
CORS hanya dapat dikonfigurasi jika Operation diatur ke Add, dan Response Header diatur ke "Access-Control-Allow-Origin".
-
CORS dapat diatur ke Disable atau Enable. Nilai defaultnya adalah Disable.
-
Disable: POP CDN tidak memvalidasi header
Origindalam permintaan masuk dan selalu mengembalikan nilaiAccess-Control-Allow-Originyang dikonfigurasi. -
Enable: POP CDN memvalidasi permintaan lintas asal berdasarkan aturan berikut dan merespons dengan nilai
Access-Control-Allow-Originyang sesuai.-
Response Header: Jika Response Header diatur ke
*, POP selalu mengembalikanAccess-Control-Allow-Origin:*, terlepas dari apakah permintaan pengguna menyertakan headerOriginatau nilainya. -
Response Header: Response Header diatur ke satu atau beberapa origin tertentu, dipisahkan dengan koma (
,).-
Jika nilai header
Origindalam permintaan pengguna cocok secara eksak dengan salah satu origin yang dikonfigurasi, POP merespons dengan origin tersebut sebagai nilai headerAccess-Control-Allow-Origin. -
Jika tidak ditemukan kecocokan, POP tidak menambahkan header CORS ke respons.
-
-
Response Header: Jika Response Header diatur ke domain wildcard, POP memeriksa apakah header
Origindalam permintaan sesuai dengan pola wildcard.
-
-
Jika Anda mengatur Enable pada Header Value dan Nama domain di bidang Header Value mengandung tanda hubung (
-), Anda harus melakukan escape dengan mengganti-menjadi%-. Contoh:-
Nilai header asli:
http://doc.aliyun-example.com. -
Nilai header setelah escape:
http://doc.aliyun%-example.com.
-
-
Enable
-
-
Atur metode untuk permintaan lintas asal
Klik Customize, konfigurasikan parameter seperti yang dijelaskan dalam tabel berikut, lalu klik OK.
Parameter
Deskripsi
Contoh
Operation
Atur parameter ini ke Add.
Add
Response Header
Harus diatur ke
Access-Control-Allow-MethodsAccess-Control-Allow-Methods
Header Value
Mendukung metode permintaan
GET, POST, dan PUT. Jika Anda perlu menambahkanGET, POST, dan PUTsecara bersamaan, pisahkan dengan koma,.GETAllow Duplicates
-
Yes: Header dari origin server dipertahankan, dan header baru dengan nama yang sama juga ditambahkan ke respons.
-
No: Header baru menggantikan header dengan nama yang sama dari origin server.
No
-
-
Contoh konfigurasi
Contoh 1
Jika nilai header respons untuk CORS diatur ke satu atau beberapa origin tertentu yang dipisahkan dengan koma (,):
-
Jika nilai header
Origindalam permintaan pengguna cocok secara eksak dengan salah satu origin yang ditentukan, POP CDN merespons dengan header CORS yang sesuai. -
Jika tidak ditemukan kecocokan eksak, header CORS tidak disertakan dalam respons.
Pada CDN/, atur: Access-Control-Allow-Origin: http://example.com,https://aliyundoc.com.
-
Header
Originpermintaan pengguna adalahhttp://example.com, dan Point of Presence (POP) CDN merespons denganAccess-Control-Allow-Origin: http://example.com. -
Header
Origindalam permintaan pengguna adalahhttps://aliyundoc.com, dan node CDN merespons denganAccess-Control-Allow-Origin: https://aliyundoc.com. -
Node CDN tidak akan merespons permintaan pengguna dengan header Origin
http://aliyundoc.com(karena ketidakcocokan protokol: permintaan pengguna menggunakan HTTP, sedangkan CDN dikonfigurasi untuk HTTPS). -
Jika header
Origindari suatu permintaan adalahhttp://aliyun.com, POP CDN tidak akan merespons (ketidakcocokan domain).
Contoh 2
Jika nilai header respons untuk CORS diatur ke domain wildcard, POP memeriksa apakah nilai Origin dalam header permintaan sesuai dengan pola wildcard.
Pada CDN/, atur: Access-Control-Allow-Origin: http://*.aliyundoc.com.
-
Permintaan pengguna berisi header Origin
http://demo.aliyundoc.com, dan POP CDN merespons denganAccess-Control-Allow-Origin: http://demo.aliyundoc.com. -
Jika header Origin dari suatu permintaan adalah
http://demo.example.com, POP CDN tidak akan merespons karena Nama domain tidak cocok. -
Node CDN tidak merespons permintaan pengguna dengan header Origin
https://demo.aliyundoc.comkarena permintaan menggunakan protokol HTTPS, tetapi CDN dikonfigurasi dengan protokol HTTP.
Verifikasi efektivitas konfigurasi lintas asal
-
Header respons lintas asal yang baru tidak otomatis berlaku untuk resource yang telah di-cache sebelumnya karena CDN menyimpan cache respons HTTP secara lengkap. Untuk menerapkan konfigurasi Access-Control-Allow-Origin yang baru, Anda harus melakukan purge pada resource terkait dari cache CDN. Jika tidak, pengguna akan terus menerima respons dari cache lama yang tidak menyertakan header tersebut.
-
Gunakan curl untuk mengirimkan permintaan GET dengan header Origin tertentu dan periksa header respons dalam output verbose:
curl -svo /dev/null https://accelerated.domain.name/resource/path -H 'origin:https://your-site.example.com' -
Periksa header
Access-Control-Allow-Origindalam respons. Jika nilai header adalah*atau sesuai dengan Origin permintaan, maka konfigurasi telah efektif.
Catatan penggunaan dan batasan
Batasan konfigurasi domain wildcard
Setelah mengaktifkan validasi CORS, Anda hanya dapat mengonfigurasi satu domain wildcard tunggal atau multiple domain eksak (non-wildcard) yang dipisahkan dengan koma. Anda tidak dapat memisahkan multiple domain wildcard secara langsung dengan koma (seperti https://*.example.com,https://*.example.org).
Perbedaan antara file font dan file video
File font (seperti .ttf dan .woff) selalu tunduk pada validasi header respons CORS wajib oleh browser, terlepas dari cara pemuatannya. File video (seperti MP4 dan WebM) yang dimuat melalui tag video tidak tunduk pada pembatasan CORS secara default, kecuali atribut crossorigin ditambahkan secara eksplisit. Oleh karena itu, meskipun video dan font di-host pada domain yang sama, mengakses video biasanya tidak memicu error CORS, tetapi mengakses file font akan memicunya. Hal ini ditentukan oleh spesifikasi browser.
Konfigurasi CORS saat CDN mengakselerasi OSS
Jika Anda ingin melakukan transmisi langsung konfigurasi CORS dari bucket OSS origin, pastikan permintaan pertama membawa header Origin. Dengan demikian, CDN dapat mengambil dari origin dan menyimpan cache header respons Access-Control-Allow-Origin yang dikembalikan oleh OSS. Namun, mekanisme caching dapat menyebabkan masalah lintas asal untuk permintaan berikutnya yang tidak membawa header Origin atau membawa Origin yang berbeda.
Praktik yang disarankan: Tambahkan header respons terkait CORS menggunakan fitur Konfigurasikan header respons keluar di Pengaturan Cache dalam konsol CDN, daripada mengandalkan transmisi langsung.
Ketika multiple domain CDN dikaitkan dengan bucket OSS yang sama, mengonfigurasi aturan CORS hanya sekali di OSS dan membiarkan CDN mewarisinya secara otomatis tidak didukung. Karena POP CDN menyimpan cache header respons dan perilaku caching dipengaruhi oleh apakah permintaan pertama membawa header Origin, Anda harus mengonfigurasi aturan CORS secara terpisah untuk setiap domain CDN di konsol CDN.
Untuk cara melakukan troubleshooting kasus di mana error CORS tetap muncul setelah Anda mengonfigurasi Access-Control-Allow-Origin, lihat Troubleshooting cache.