How remote authentication works, how to enable it in the console, and related API operations - ApsaraVideo VOD

Çalışma prensibi

ApsaraVideo VOD, içeriğinizin yasa dışı olarak indirilmesini veya doğrudan bağlantı yoluyla kullanılmasını önlemek için hem URL imzalama hem de uzak kimlik doğrulamayı destekler. Bu iki özellik uygulama açısından farklılık gösterir:

URL imzalama: Bir alan adı için kimlik doğrulama kuralları tanımlar ve bunları CDN uç noktalarına dağıtırsınız. CDN uç noktaları ardından tüm kimlik doğrulama sürecini yönetir. Daha fazla bilgi için bkz. URL imzalama.
Uzak kimlik doğrulama: Kendi kimlik doğrulama sunucunuzu sağlamalı ve yönetmelisiniz. Bir CDN uç noktası kimlik doğrulama gerektiren bir istek aldığında, isteği doğrulama amacıyla sunucunuza iletir.

Aşağıdaki diyagram uzak kimlik doğrulama sürecini göstermektedir: 远程鉴权原理图

Kullanıcı, bir kaynak için kimlik doğrulama parametrelerini içeren bir isteği CDN uç noktasına gönderir.
CDN uç noktası kullanıcı isteğini alır ve bunu kimlik doğrulama sunucunuza iletir.
Kimlik doğrulama sunucusu, istekteki parametreleri doğrular ve sonucu CDN uç noktasına döndürür.
CDN uç noktası, kimlik doğrulama sonucuna göre kullanıcı isteğini işler. Kimlik doğrulama başarılı olursa uç nokta isteğe izin verir. Başarısız olursa uç nokta isteği reddeder veya kısıtlar. İşte bazı örnekler:
- Örnek 1: Kimlik doğrulama başarılı olur. CDN uç noktası önbellekteki içeriği kullanıcıya sunar.
- Örnek 2: Kimlik doğrulama başarısız olur. CDN uç noktası kullanıcıya 403 durum kodu döndürür.
- Örnek 3: Kimlik doğrulama başarısız olur. CDN uç noktası kullanıcının erişimini hız sınırlamasına tabi tutar.
- Örnek 4: Kimlik doğrulama zaman aşımına uğrar. CDN uç noktası varsayılan eylem olarak kullanıcı isteğine izin verir.

Kullanım notları

Uzak kimlik doğrulamayı etkinleştirdikten sonra her kullanıcı isteği kimlik doğrulamadan geçer. Yüksek trafik hacmi bekliyorsanız, kimlik doğrulama sunucunuzun bu yükü kaldırabildiğinden emin olun.

Yordam

ApsaraVideo VOD konsolu adresinde oturum açın.
Sol gezinme bölmesinde Configuration Management seçeneğini tıklayın.
CDN Configuration > Domain Names seçeneklerini belirleyin.
Yapılandırmak istediğiniz alan adını bulun ve Actions sütunundaki Configure seçeneğini tıklayın.
Resource Access Control seçeneğini tıklayın.
Remote Authentication sekmesini seçin.

Remote Authentication anahtarını etkinleştirin ve ayarları yapılandırın.

Aşağıdaki tabloda parametreler açıklanmaktadır.

Parametre	Açıklama
Kimlik doğrulama sunucusu adresi	Kimlik doğrulama sunucunuzun genel olarak erişilebilir adresi. Adres aşağıdaki biçim ve değer gereksinimlerini karşılamalıdır. Biçim gereksinimleri Adres aşağıdaki biçimlerden birinde olmalıdır: http://example.com/auth https://example.com/auth http://192.0.2.1/auth https://192.0.2.1/auth Değer gereksinimleri Değer `127.0.0.1` veya `localhost` olamaz. Bu yerel adresler geçersizdir.
İstek yöntemi	Kimlik doğrulama sunucunuzun desteklediği istek yöntemi. Geçerli değerler: GET, HEAD ve POST. POST Parametreler istek gövdesinde iletilir ve adres çubuğundaki URL değişmez. İletilen veri miktarı üzerinde pratik bir sınır yoktur. İstekler önbelleğe alınmaz veya tarayıcı geçmişine kaydedilmez. Güvenlik nispeten yüksektir. GET Parametreler istek satırında iletilir ve değerleri adres çubuğunda görünür. Tarayıcı sınırlamaları nedeniyle iletilebilecek veri miktarı 1.024 bayt ile sınırlıdır. İstekler önbelleğe alınabilir ve tarayıcı geçmişine kaydedilir. Güvenlik nispeten düşüktür. HEAD HEAD yöntemi, sunucunun yanıtta bir mesaj gövdesi döndürmemesi dışında GET yöntemiyle aynıdır.
Dosya türleri	Tüm dosya türleri: Tüm dosya türlerine yönelik isteklerin kimlik doğrulamasını yapar. Belirtilen dosya türleri: Yalnızca belirtilen türlerdeki dosyalara yönelik isteklerin kimlik doğrulamasını yapar. Birden çok dosya türü belirtmek için bunları dikey çizgi (\|) ile ayırın, örneğin `mp4\|flv`. Dosya türleri büyük/küçük harfe duyarlıdır. Örneğin, `jpg` ve `JPG` farklı dosya türleri olarak kabul edilir.
Parametreleri koru	Kimlik doğrulama için kullanıcı isteği URL'sinden hangi parametrelerin kullanılacağını kontrol eder. Tüm parametreleri koru, Belirtilen parametreleri koru veya Tüm URL parametrelerini sil seçeneklerinden birini seçebilirsiniz. Belirtilen parametreleri korumayı seçerseniz, birden çok parametreyi dikey çizgi (\|) ile ayırın, örneğin `user\|token`. Parametreler büyük/küçük harfe duyarlıdır. Örneğin, `key` ve `KEY` farklı parametreler olarak kabul edilir.
Özel parametreler ekle	CDN uç noktasının kimlik doğrulama sunucusuna ilettiği istek URL'sine özel parametreler ekler. Özel parametreleri ve değerleri ayarlamak için Custom seçeneğini belirleyebilir veya konsoldaki önceden ayarlanmış değişkenleri kullanmak için Select Parameter seçeneğini belirleyebilirsiniz. Özel parametreleri ve değerleri ayarlarken: Birden çok parametreyi dikey çizgi (\|) ile ayırın, örneğin `token=$arg_token\|vendor=ali_cdn`. Parametreler büyük/küçük harfe duyarlıdır. Örneğin, `key` ve `KEY` farklı parametreler olarak kabul edilir. Önceden ayarlanmış değişkenleri kullandığınızda, bunların değerlerini çıkarabilir ve CDN uç noktası tarafından iletilen isteğe ekleyebilirsiniz. Örneğin, `$http_host` değişkenini seçerseniz, istek URL'sine `host=$http_host` eklenir; burada `$http_host`, kullanıcı isteğindeki Host üstbilgisinin değeridir. Değişkenlerin listesi ve açıklamaları için bkz. Değişken adları.
İstek üstbilgilerini koru	Kimlik doğrulama için kullanıcı isteğinden hangi üstbilgilerin kullanılacağını kontrol eder. Tüm üstbilgileri koru, Belirtilen üstbilgileri koru veya Tüm istek üstbilgilerini sil seçeneklerinden birini seçebilirsiniz. Belirtilen üstbilgileri korumayı seçerseniz, birden çok üstbilgiyi dikey çizgi (\|) ile ayırın, örneğin `user_agent\|referer\|cookies`. İstek üstbilgileri büyük/küçük harfe duyarlı değildir. Örneğin, `http_remote_addr` ve `HTTP_Remote_Addr` aynı üstbilgi olarak kabul edilir. Not Varsayılan olarak CDN uç noktası `Host` üstbilgisini siler. Bunun nedeni, iletilen isteğin `Host` üstbilgisinin hızlandırılmış alan adını içermesidir; bu durum kimlik doğrulama sunucunuz tarafından tanınmayabilir ve potansiyel olarak 404 hatalarına veya kimlik doğrulama başarısızlıklarına neden olabilir. `Host` üstbilgisini korumak için Belirtilen üstbilgileri koru veya Özel Parametreler Ekle seçeneklerini kullanın.
Özel üstbilgiler ekle	CDN uç noktasının kimlik doğrulama sunucusuna ilettiği isteğe özel üstbilgiler ekler. Özel üstbilgileri ve değerleri ayarlamak için Custom seçeneğini belirleyebilir veya konsoldaki önceden ayarlanmış değişkenleri kullanmak için Select Parameter seçeneğini belirleyebilirsiniz. Özel parametreleri ve değerleri ayarlarken: Birden çok üstbilgiyi dikey çizgi (\|) ile ayırın, örneğin `User-Agent=$http_user_agent\|vendor=ali_cdn`. İstek üstbilgileri büyük/küçük harfe duyarlı değildir. Örneğin, `http_remote_addr` ve `HTTP_Remote_Addr` aynı üstbilgi olarak kabul edilir. Önceden ayarlanmış değişkenleri kullandığınızda, bunların değerlerini çıkarabilir ve CDN uç noktası tarafından iletilen isteğe ekleyebilirsiniz. Örneğin, `$http_host` değişkenini seçerseniz, istek üstbilgisine `host=$http_host` eklenir; burada `$http_host`, kullanıcı isteğindeki Host üstbilgisinin değeridir. Değişkenlerin listesi ve açıklamaları için bkz. Değişken adları.
Başarı durum kodu	Kimlik doğrulama sunucunuzdan başarıyı gösteren HTTP durum kodu. 2xx durum kodu kullanmanızı öneririz. Örneğin, bu parametreyi 200 olarak ayarlarsanız, kimlik doğrulama sunucunuzdan gelen 200 yanıtı başarı anlamına gelir. Sunucu, ne başarı ne de başarısızlık koduyla eşleşen bir durum kodu döndürürse istek zaman aşımına uğramış olarak değerlendirilir.
Başarısızlık durum kodu	Kimlik doğrulama sunucunuzdan başarısızlığı gösteren HTTP durum kodu. 4xx durum kodu kullanmanızı öneririz. Örneğin, bu parametreyi 403 olarak ayarlarsanız, kimlik doğrulama sunucunuzdan gelen 403 yanıtı başarısızlık anlamına gelir. Sunucu, ne başarı ne de başarısızlık koduyla eşleşen bir durum kodu döndürürse istek zaman aşımına uğramış olarak değerlendirilir.
Özel yanıt durum kodu	İstek kimlik doğrulaması başarısız olursa CDN uç noktasının kullanıcıya döndürdüğü durum kodu. Örneğin, bunu 403 olarak ayarlarsanız, kullanıcının isteği kimlik doğrulamasında başarısız olduğunda CDN uç noktası kullanıcıya 403 durum kodu döndürür.
Zaman aşımı	Bir CDN uç noktasının kimlik doğrulama sunucusundan yanıt bekleyeceği maksimum süre. Birim: milisaniye. Maksimum değer 3000'dir.
Zaman aşımı durumunda eylem	Sunucunuza yapılan kimlik doğrulama isteği zaman aşımına uğrarsa CDN uç noktasının gerçekleştireceği eylem. Geçerli değerler: allow: Zaman aşımı oluşursa CDN uç noktası kullanıcı isteğine izin verir. reject: Zaman aşımı oluşursa CDN uç noktası belirtilen Configuration Management değerini kullanıcıya döndürür.

Yapılandırmayı kaydetmek için OK seçeneğini tıklayın.

Uzak kimlik doğrulamayı yapılandırdıktan sonra ayarları değiştirmek veya özelliği devre dışı bırakmak için Remote Authentication sekmesine dönebilirsiniz.

Değişken adları

Özel parametreler eklerken aşağıdaki önceden ayarlanmış değişkenleri kullanabilirsiniz.

Parametre	Açıklama
$http_host	İstekteki Host üstbilgisinin değeri.
$http_user_agent	İstekteki User-Agent üstbilgisinin değeri.
$http_referer	İstekteki Referer üstbilgisinin değeri.
$http_content_type	İstekteki Content-Type üstbilgisinin değeri.
$http_x_forward_for	İstekteki X-Forwarded-For üstbilgisinin değeri.
$remote_addr	İsteğin istemci IP adresi.
$scheme	İsteğin protokolü, örneğin `http` veya `https`.
$server_protocol	İsteğin protokol sürümü, örneğin `HTTP/1.1`.
$uri	İsteğin orijinal URI'si.
$args	İsteğin sorgu dizesi. Bu, soru işaretini (`?`) içermez.
$request_method	İstek yöntemi.
$request_uri	Sorgu dizesi dahil tam istek URI'si (`uri` + `?` + `args`).

İlgili API'ler

BatchSetVodDomainConfigs