CDN:Konfigurasikan Penandatanganan URL

Cara kerja

1. Pelanggan CDN atau mengonfigurasi aturan pembuatan URL yang ditandatangani (termasuk algoritma penandatanganan dan kunci) pada origin application server.

   Sebagai contoh, URL yang ditandatangani dapat memiliki format http://DomainName/timestamp/md5hash/FileName.

2. Saat client mengunjungi halaman pada aplikasi Anda, origin application server menghasilkan URL yang ditandatangani berdasarkan aturan yang telah dikonfigurasi dan menyematkannya dalam halaman yang dikembalikan ke client.

3. Client menggunakan URL yang ditandatangani tersebut untuk meminta resource dari POP CDN.

4. POP CDN memvalidasi informasi dalam URL yang ditandatangani, seperti string signature dan timestamp, untuk menentukan apakah permintaan tersebut sah.

   • Jika autentikasi gagal, POP menolak permintaan tersebut.

   • Jika autentikasi berhasil, POP menyajikan kontennya.

     Catatan

     • Jika node CDN tidak memiliki sumber daya dalam cache, node CDN menghapus parameter otentikasi dari URL yang ditandatangani dan memulihkannya ke URL asli (misalnya, http://DomainName/FileName), lalu menggunakan URL asli tersebut untuk menghasilkan kunci cache atau memulai permintaan origin-fetch.

     • Setelah CDN mengautentikasi URL permintaan, sistem akan meng-encode karakter khusus dalam URL tersebut, seperti karakter Tionghoa atau karakter non-ASCII lainnya.

Catatan penggunaan

• Setelah Anda mengonfigurasi Penandatanganan URL, permintaan yang gagal otentikasi masih dapat mencapai node CDN, tetapi ditolak oleh node CDN dan kode status 403 dikembalikan. Log CDN tetap mencatat permintaan otentikasi yang gagal ini.

• URL signing memvalidasi permintaan di POP CDN. Oleh karena itu, mencegat permintaan berbahaya tetap mengonsumsi sejumlah kecil traffic yang dikenai biaya. Untuk Permintaan HTTPS, biaya tambahan berlaku karena POP CDN mengonsumsi sumber daya pemrosesan untuk melakukan pencegatan tersebut.

Konfigurasikan dan aktifkan URL signing

1. Masuk ke CDN console.

2. Di panel navigasi kiri, klik Domain Names.

3. Pada halaman Domain Names, temukan nama domain target dan klik Manage di kolom Actions.

4. Di panel navigasi domain, klik Access Control.

5. Klik tab URL Signing.

6. Di bagian URL Signing, klik Modify.

7. Aktifkan sakelar Set URL Signing dan konfigurasikan parameter-parameter berikut.

   Parameter	Deskripsi
   Type	Alibaba Cloud CDN menyediakan empat metode penandatanganan. Anda dapat memilih tipe penandatanganan berdasarkan format URL yang ditandatangani untuk melindungi resource origin secara efektif. Tipe URL signing berikut tersedia: Signing type A Signing type B Signing type C Signing type F Catatan Jika URL signing gagal, error 403 dikembalikan: Error perhitungan MD5 Contoh: X-Tengine-Error:denied by req auth: invalid md5hash=de7bfdc915ced05e17380a149bd760be Error terkait waktu Contoh: X-Tengine-Error:denied by req auth: expired timestamp=1439469547
   Primary Key	Masukkan primary key untuk metode penandatanganan. Kunci harus terdiri dari 6 hingga 128 karakter dan dapat berisi huruf kapital, huruf kecil, dan angka.
   Secondary Key	Masukkan secondary key untuk metode penandatanganan. Kunci harus terdiri dari 6 hingga 128 karakter dan dapat berisi huruf kapital, huruf kecil, dan angka. Anda harus menentukan setidaknya primary key atau secondary key.
   TTL	Menentukan periode validitas URL yang ditandatangani. Client harus mengakses resource dalam periode timestamp + TTL. Permintaan yang dikirim setelah periode ini akan gagal dalam autentikasi. Unit: detik Nilai valid: 1 hingga 31536000 Nilai default: 1800 (30 menit) Contoh: Jika server penandatanganan Anda menghasilkan URL yang ditandatangani pada pukul 15:00:00 (UTC+8) tanggal 15 Agustus 2020 dan TTL-nya adalah 1.800 detik, maka URL tersebut kedaluwarsa pada pukul 15:30:00 (UTC+8) tanggal 15 Agustus 2020.
   Signature Parameter	Anda dapat menyesuaikan nama parameter signature. Ini hanya berlaku ketika tipe autentikasi diatur ke Method F.
   Timestamp Parameter	Anda dapat menyesuaikan nama parameter timestamp. Ini hanya berlaku ketika tipe autentikasi diatur ke Type F.
   Timestamp Format	Menetapkan format timestamp, yang dapat berupa desimal (Unix timestamp) atau heksadesimal (Unix timestamp). Pengaturan ini hanya berlaku ketika tipe autentikasi diatur ke Type F.
   URL Encoding	Sakelar URL encoding dinonaktifkan secara default. Jika Anda mengaktifkan sakelar ini, sistem akan melakukan URL-encoding terhadap URL permintaan pengguna. Fitur ini hanya berlaku ketika tipe autentikasi diatur ke Method F.
   Rule Condition	Rule condition memungkinkan suatu aturan diterapkan hanya jika permintaan memenuhi kriteria tertentu. Penting Ketika suatu fitur mereferensikan rule condition, urutan eksekusi mengikuti prioritas rule condition terkait, bukan urutan konfigurasi fitur tersebut. Do not use: Menonaktifkan aturan kondisional. Anda dapat menambah atau mengedit aturan kondisional di Rules engine.

8. Klik OK.

Verifikasi URL yang ditandatangani

Setelah Anda mengonfigurasi URL signing, gunakan Signed URL Generator di Konsol CDN untuk menghasilkan URL yang ditandatangani dan memverifikasi implementasinya. Proses ini memastikan bahwa logika penandatanganan server Anda benar.

1. Di bagian Signed URL Generator, tentukan Original URL (Unencoded) dan informasi penandatanganan lainnya.

   Parameter	Deskripsi
   Original URL (Unencoded)	Masukkan URL asli lengkap, misalnya, https://www.aliyun.com. Tool ini secara otomatis melakukan encoding terhadap URL asli saat menghasilkan URL yang ditandatangani.
   Type	Pilih tipe URL signing berdasarkan pengaturan yang telah Anda konfigurasi di bagian Konfigurasikan dan aktifkan URL signing.
   Cryptographic Key	Masukkan Primary Key atau Secondary Key yang telah Anda konfigurasi di bagian Konfigurasikan dan aktifkan URL signing.
   TTL	Masukkan TTL untuk URL signing dalam satuan detik, berdasarkan pengaturan yang telah Anda konfigurasi di bagian Konfigurasikan dan aktifkan URL signing.

2. Klik Generate untuk mendapatkan Signed URL dan Timestamp.

Nonaktifkan URL signing

1. Di bagian URL Signing pada CDN console, klik Modify dan nonaktifkan sakelar URL signing.

2. Di server aplikasi Anda, hapus logika yang menambahkan parameter penandatanganan ke URL permintaan.

Referensi API

• DescribeCdnDomainConfigs

• SetCdnDomainConfig