Tüm Ürünler
Search
Belge Merkezi

CDN:URL imzalama yapılandırma

Son Güncelleme:Oct 10, 2026

Varsayılan olarak, CDNDCDN tarafından dağıtılan içerik herkese açıktır ve URL'sine sahip olan herkes tarafından erişilebilir. Kaynak sunucularınızı yetkisiz erişimlere ve kötü amaçlı indirmelere karşı korumak için Referer hotlink koruması ve IP kara/beyaz listeleri gibi diğer erişim kontrol yöntemlerine ek olarak URL imzalama özelliğini kullanabilirsiniz. URL imzalama, imzalı bir URL içinde bulunan şifrelenmiş dizeyi ve zaman damgasını doğrulayarak içeriğinizin güvenliğini sağlar.

Çalışma mantığı

URL imzalama, Alibaba Cloud CDNDCDN POP'ları ile kaynak sunucunuz arasındaki istekleri koordine ederek kaynak sunucularınıza yetkisiz erişimi engeller. Süreç üç temel bileşeni içerir:

  • Kaynak uygulama sunucusu: Algoritma ve anahtar dahil olmak üzere tanımlanmış bir imzalama kuralına göre imzalı bir URL oluşturur ve bunu istemciye döndürür.

  • İstemci: Bir kaynağı istemek için imzalı URL'yi bir CDNDCDN POP'a gönderir.

  • CDNDCDN POP: İmza dizesi ve zaman damgası gibi imzalı URL'deki bilgileri doğrular.

image
  1. CDNDCDN müşterileri, kaynak uygulama sunucusunda imzalı URL'ler için oluşturma kurallarını (imzalama algoritması ve anahtar dahil) yapılandırır.

    Örneğin, imzalı bir URL şu biçimde olabilir: http://DomainName/timestamp/md5hash/FileName.

  2. Bir istemci uygulamanızdaki bir sayfayı ziyaret ettiğinde, kaynak uygulama sunucusu yapılandırılmış kurallara göre imzalı bir URL oluşturur ve bunu istemciye döndürülen sayfaya yerleştirir.

  3. İstemci, kaynağı bir CDNDCDN POP'tan istemek için imzalı URL'yi kullanır.

  4. CDNDCDN POP, isteğin meşru olup olmadığını belirlemek için imza dizesi ve zaman damgası gibi imzalı URL'deki bilgileri doğrular.

    • Kimlik doğrulama başarısız olursa, POP isteği reddeder.

    • Kimlik doğrulama başarılı olursa, POP içeriği sunar.

      Not
      • Bir CDNDCDN düğümünde önbelleğe alınmış bir kaynak yoksa, CDNDCDN düğümü imzalı URL'den kimlik doğrulama parametrelerini kaldırır ve onu orijinal URL'ye geri yükler (örneğin, http://DomainName/FileName), ardından orijinal URL'yi kullanarak bir önbellek anahtarı oluşturur veya kaynak getirme isteği başlatır.

      • CDNDCDN istek URL'sini doğruladıktan sonra, Çince veya diğer ASCII olmayan karakterler gibi URL'deki özel karakterleri kodlar.

Kullanım notları

  • URL imzalamayı yapılandırdıktan sonra, kimlik doğrulaması başarısız olan istekler yine de CDNDCDN düğümlerine ulaşabilir ancak CDNDCDN düğümleri tarafından reddedilir ve 403 durum kodu döndürülür. CDNDCDN günlükleri bu başarısız kimlik doğrulama isteklerini kaydetmeye devam eder.

  • URL imzalama, istekleri CDNDCDN POP'larında doğrular. Bu nedenle, kötü niyetli isteklerin engellenmesi hala küçük miktarda faturalandırılabilir trafik tüketir. HTTPS istekleri için, CDNDCDN POP'ları engellemeyi gerçekleştirmek için işleme kaynaklarını tükettiğinden ek ücretler uygulanır.

  • URL imzalama ayrı olarak faturalandırılmaz. Referer hotlink koruması, uzak kimlik doğrulama ve IP/UA kara/beyaz listeleriyle birlikte temel bir CDN güvenlik özelliğidir.

  • URL imzalamayı etkinleştirdikten sonra, her istek URL'si kimlik doğrulama parametrelerini taşımak zorundadır. Bu özellik portal web siteleri için uygun değildir. Büyük hacimli görüntü veya video sunan siteler gibi kaynak barındırma siteleri için en uygun seçenektir.

  • URL imzalama kullanan Alibaba Cloud CDN üzerinde hızlandırılmış bir alan adı için kaynakları temizlerken veya ön belleğe alırken, kaynağın önbellek anahtarıyla eşleşen bir URL gönderin. Konsol, gönderdiğiniz URL'den kimlik doğrulama parametrelerini kaldırmaz, sorgu parametresi değerlerini yüzde kodlamasına tabi tutmaz veya URL'yi başka şekilde normalize etmez.

    URL imzalama işlemi sırasında kimlik doğrulama parametrelerinin kaldırıldığı ve kalan iş sorgusu parametresi değerlerindeki eğik çizgilerin yüzde kodlamasına tabi tutulduğu onaylanmış bir hızlandırılmış alan adı için son temizleme veya ön belleğe alma URL'sini aşağıdaki gibi türetin:

    1. İstemci erişim URL'si. Bu URL, iş sorgusu parametrelerini ve kimlik doğrulama parametrelerini içerir.

      https://image.example.com/cat.jpg?x-oss-process=image/resize,m_fill,w_390,h_520,limit_1/auto-orient,1/sharpen,100/quality,q_80&k=123456789abcdefg&t=123abc
    2. Kimlik doğrulama parametreleri kaldırıldıktan sonraki URL. Yapılandırılmış imza ve zaman damgası parametrelerini kaldırın, ancak iş sorgusu parametrelerini koruyun.

      https://image.example.com/cat.jpg?x-oss-process=image/resize,m_fill,w_390,h_520,limit_1/auto-orient,1/sharpen,100/quality,q_80
    3. Son temizleme veya ön belleğe alma URL'si. URL'nin onaylanan önbellek anahtarıyla eşleşmesi için kalan sorgu parametresi değerindeki eğik çizgileri yüzde kodlamasına tabi tutun. cat.jpg öncesindeki eğik çizgi gibi yol ayırıcıları değişmeden kalır.

      https://image.example.com/cat.jpg?x-oss-process=image%2Fresize,m_fill,w_390,h_520,limit_1%2Fauto-orient,1%2Fsharpen,100%2Fquality,q_80

    Yöntem F'de, Signature Parameter ve Timestamp Parameter adları hızlandırılmış alan adı başına yapılandırılır. Bu örnekteki k ve t parametreleri sabit parametre adları değildir.

    Temizleme ve ön belleğe alma URL'lerini gönderme talimatları için bkz. Kaynakları temizleme ve ön belleğe alma.

URL imzalamayı yapılandırma ve etkinleştirme

Önemli
  • Kaynak uygulama sunucunuzda imzalama algoritması ve anahtar dahil olmak üzere imzalı URL'ler için oluşturma kurallarını yapılandırdığınızdan emin olun.

  • CDNDCDN konsolunda yapılandırılan URL imzalama mantığı, kaynak uygulama sunucunuzdaki mantıkla eşleşmelidir.

  1. CDN konsolu oturumunu açın.

  2. Sol gezinme bölmesinde, Domain Names seçeneğine tıklayın.

  3. Domain Names sayfasında, hedef alan adını bulun ve Actions sütunundaki Manage seçeneğine tıklayın.

  4. Alan adının gezinme bölmesinde, Access Control seçeneğine tıklayın.

  5. URL Signing sekmesine tıklayın.

  6. URL Signing bölümünde, Modify seçeneğine tıklayın.

  7. URL Signing anahtarını açın ve parametreleri yapılandırın.

    Parametre

    Açıklama

    Type

    Alibaba Cloud CDN dört imzalama yöntemi sunar. Kaynak kaynaklarınızı etkili bir şekilde korumak için imzalı URL'lerinizin biçimine göre bir imzalama türü seçebilirsiniz. Aşağıdaki URL imzalama türleri mevcuttur:

    Not

    URL imzalama başarısız olursa, 403 hatası döndürülür:

    • MD5 hesaplama hatası

      Örnek: X-Tengine-Error:denied by req auth: invalid md5hash=de7bfdc915ced05e17380a149bd760be

    • Zamanla ilgili hata

      Örnek: X-Tengine-Error:denied by req auth: expired timestamp=1439469547

    Primary Key

    İmzalama yöntemi için birincil anahtarı girin. Anahtar 6 ila 128 karakter uzunluğunda olmalı ve büyük harfler, küçük harfler ve rakamlar içerebilir.

    Secondary Key

    İmzalama yöntemi için ikincil anahtarı girin. Anahtar 6 ila 128 karakter uzunluğunda olmalı ve büyük harfler, küçük harfler ve rakamlar içerebilir. En az bir birincil veya ikincil anahtar belirtmeniz gerekir.

    TTL

    İmzalı URL'nin geçerlilik süresini belirtir. İstemci, kaynağa zaman damgası + TTL süresi içinde erişmelidir. Bu süreden sonra gönderilen isteklerin kimlik doğrulaması başarısız olur.

    • Birim: saniye

    • Geçerli değerler: 1 ila 31536000

    • Varsayılan değer: 1800 (30 dakika)

    • Örnek: İmzalama sunucunuz 15 Ağustos 2020 tarihinde saat 15:00:00'da (UTC+8) imzalı bir URL oluşturursa ve TTL 1.800 saniye ise, imzalı URL 15 Ağustos 2020 tarihinde saat 15:30:00'da (UTC+8) sona erer.

    Signature Parameter

    İmza parametrelerinin adlarını özelleştirebilirsiniz. Bu yalnızca kimlik doğrulama türü Yöntem F olarak ayarlandığında geçerlidir.

    Timestamp Parameter

    Zaman damgası parametresinin adını özelleştirebilirsiniz. Bu yalnızca kimlik doğrulama türü Tür F olarak ayarlandığında etkilidir.

    Timestamp Format

    Ondalık (Unix zaman damgası) veya onaltılık (Unix zaman damgası) olabilen zaman damgası biçimini ayarlar. Bu ayar yalnızca kimlik doğrulama türü Tür F olarak ayarlandığında geçerli olur.

    URL Encoding

    URL kodlama anahtarı varsayılan olarak devre dışıdır. Bu anahtarı etkinleştirirseniz, kullanıcı istek URL'lerini URL kodlamasına tabi tutar. Bu özellik yalnızca kimlik doğrulama türü Yöntem F olarak ayarlandığında etkilidir.

    Rule Condition

    Bir kural koşulu, bir kullanıcı isteğindeki çeşitli parametre bilgilerini tanımlar. Bu, bir yapılandırmanın o istek için etkili olup olmadığını belirler.

    Önemli

    Kural koşullarına başvurduğunuzda, bunlar özelliğin yapılandırma sırasına göre değil, ilişkili kural koşullarının önceliğine göre eşleştirilir.

    • Kullanmayın: Kural koşulu kullanmaz.

    • Kural koşullarını eklemek veya düzenlemek için, bunları Rules Engine içinde yönetin.

  8. OK seçeneğine tıklayın.

İmzalı URL'yi doğrulama

URL imzalamayı yapılandırdıktan sonra, uygulamayı doğrulamak için CDN konsolundaki Signed URL Generator'ı kullanarak imzalı bir URL oluşturun. Bu süreç, sunucunuzun imzalama mantığının doğru olduğunu teyit eder.

  1. Signed URL Generator bölümünde, Original URL (Unencoded) ve diğer imzalama bilgilerini belirtin.


    Parametre


    Açıklama


    Original URL (Unencoded)


    Tam orijinal URL'yi girin, örneğin https://www.aliyun.com. Araç, imzalı URL'yi oluştururken orijinal URL'yi otomatik olarak kodlar.


    Type


    URL imzalamayı yapılandırma ve etkinleştirme bölümünde yapılandırdığınız ayarlara göre URL imzalama türünü seçin.


    Cryptographic Key

    URL imzalamayı yapılandırma ve etkinleştirme bölümünde yapılandırdığınız Primary Key veya Secondary Key değerini girin.


    TTL

    URL imzalamayı yapılandırma ve etkinleştirme bölümünde yapılandırdığınız ayarlara göre URL imzalama için TTL değerini saniye cinsinden girin.

  2. Generate seçeneğine tıklayarak Signed URL ve Timestamp değerlerini elde edin.

URL imzalamayı devre dışı bırakma

Önemli

CDNDCDN konsolunda URL imzalamayı devre dışı bırakırsanız ancak istemci istekleri imzalama parametreleri içermeye devam ederse, CDNDCDN istek URL'lerini orijinal biçimlerine geri yükleyemez. Bu durum önbellek isabetlerinin oluşmamasına ve bu tür tüm isteklerin kaynak sunucunuza yönlendirilmesine neden olur. Sonuç olarak, kaynak sunucu trafiğiniz ve maliyetleriniz önemli ölçüde artar. Bu nedenle, URL imzalamayı tamamen devre dışı bırakmak için yapılandırmayı hem uygulama sunucunuzdan hem de CDNDCDN konsolundan kaldırmalısınız.

image
  1. CDN konsolu üzerindeki URL Signing bölümünde, Modify seçeneğine tıklayın ve URL imzalama anahtarını kapatın.

  2. Uygulama sunucunuzda, istek URL'lerine imzalama parametreleri ekleyen mantığı kaldırın.

API referansı