All Products
Search
Document Center

ApsaraVideo VOD:Signing tipe C

Last Updated:Sep 16, 2026

ApsaraVideo VOD menyediakan fitur Penandatanganan URL untuk melindungi konten origin dari unduhan dan akses yang tidak sah. Fitur ini mendukung tiga jenis penandatanganan, dan topik ini menjelaskan cara kerja signing tipe C.

Cara kerja

Cara penandatanganan URL berdasarkan tipe C

  • Format 1 

    http://DomainName/{<md5hash>/<timestamp>}/FileName
  • Format 2 

    http://DomainName/FileName?{&KEY1=<md5hash>&KEY2=<timestamp>}

Catatan 

Konten yang diapit tanda kurung kurawal ({}) menunjukkan informasi terenkripsi yang ditambahkan ke URL standar.

Bidang dalam URL yang ditandatangani

Bidang

Deskripsi

DomainName

Nama domain untuk ApsaraVideo VOD.

PrivateKey

Kunci primary atau kunci secondary yang dikonfigurasi di Konsol ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Aktifkan dan konfigurasikan Penandatanganan URL.

Filename

URL aktual yang mengarah ke resource yang diminta pada server origin. Nilai bidang Filename harus diawali dengan garis miring (/).

timestamp

Waktu saat URL yang ditandatangani dibuat. Timestamp dan periode validitas default menentukan waktu kedaluwarsa URL yang ditandatangani. Timestamp mengikuti format waktu UNIX, yaitu jumlah detik yang telah berlalu sejak pukul 00:00:00 Kamis, 1 Januari 1970. Timestamp berupa string yang terdiri dari 10 digit desimal positif dan tidak bergantung pada zona waktu. String desimal tersebut dikonversi menjadi string heksadesimal.

Catatan

Dalam kebanyakan kasus, URL yang ditandatangani kedaluwarsa setelah periode validitas default yang Anda tentukan di ApsaraVideo VOD berakhir. Jika Anda menentukan periode validitas untuk URL yang ditandatangani di server penandatanganan, timestamp dan periode validitas URL tersebut dihitung berdasarkan rumus berikut: Timestamp = Stempel waktu UNIX di server penandatanganan + Periode validitas yang dikonfigurasi di server penandatanganan. Periode validitas = Timestamp + Periode validitas default.

md5hash

String yang dihitung menggunakan algoritma MD5. String ini harus terdiri dari 32 karakter dan dapat berisi angka serta huruf kecil.

Nilai md5hash dihitung dengan metode berikut:

sstring  = Privatekey + URI + timestamp  (URI adalah path relatif objek yang diminta, tanpa parameter kueri — contohnya, /FileName)
md5hash  = md5sum(sstring)

Logika penandatanganan

Saat titik kehadiran (POP) Alibaba Cloud CDN menerima permintaan, POP memeriksa apakah waktu yang dihitung dengan menjumlahkan nilai timestamp dan periode validitas default lebih awal daripada waktu saat ini.

  • Jika waktu yang dihitung dengan menjumlahkan nilai timestamp dan periode validitas default lebih awal daripada waktu saat ini, POP menentukan bahwa URL telah kedaluwarsa dan mengembalikan kode status HTTP 403.

  • Jika waktu yang dihitung dengan menjumlahkan timestamp dan periode validitas default lebih akhir daripada waktu saat ini, POP membuat string berdasarkan sstring yang dijelaskan dalam tabel sebelumnya. Kemudian, POP menggunakan algoritma MD5 untuk menghitung nilai md5hash dan membandingkan nilai md5hash yang dihitung dengan nilai md5hash dalam permintaan.

Contoh

Contoh berikut menunjukkan cara mengimplementasikan signing tipe C. 

Kondisi contoh

  • Ambil objek dari server origin:

    http://domain.example.com/test.flv
    Catatan

    Jika URL objek yang diminta berisi karakter Tionghoa, Anda perlu melakukan encode terhadap URL sebelum menggabungkannya menjadi URL yang ditandatangani. 

    • URL asli: https://example.com/image/aliyun.jpg

    • URL yang diencode: https://example.com/image/%E9%98%BF%E9%87%8C%E4%BA%91.jpg

  • Tetapkan PrivateKey menjadi aliyuncdnexp1234. 

  • Tetapkan timestamp menjadi 55CE8100. 

Prosedur penggabungan

  1. Buat string signature yang digunakan untuk menghitung nilai md5hash.

    aliyuncdnexp1234/test.flv55CE8100
  2. Hitung nilai md5hash berdasarkan string signature.

    md5hash = md5sum(aliyuncdnexp1234/test.flv55CE8100) = a37fa50a5fb8f71214b1e7c95ec7a1bd
  3. Buat URL yang ditandatangani. 

    • Format 1: 

      http://domain.example.com/a37fa50a5fb8f71214b1e7c95ec7a1bd/55CE8100/test.flv
    • Format 2: 

      http://domain.example.com/test.flv?KEY1=a37fa50a5fb8f71214b1e7c95ec7a1bd&KEY2=55CE8100

Jika klien menggunakan URL yang ditandatangani untuk meminta resource, Alibaba Cloud CDN membandingkan nilai md5hash yang dihitung dengan nilai md5hash dalam permintaan. Jika nilainya sama, seperti a37fa50a5fb8f71214b1e7c95ec7a1bd, permintaan lolos otentikasi. Jika tidak, permintaan gagal dalam otentikasi.