Tüm Ürünler
Search
Belge Merkezi

CDN:User-Agent engelleme veya izin listesi yapılandırma

Son Güncelleme:Oct 01, 2026

User-Agent, istemciyi işletim sistemi, tarayıcı türü ve sürümüne göre tanımlayan bir HTTP istek başlığıdır. CDNDCDN kaynaklarınıza erişimi kısıtlamak için bir User-Agent engelleme veya izin listesi yapılandırın.

Kullanım notları

  • Aynı anda hem User-Agent engelleme listesini hem de izin listesini yapılandıramazsınız; yalnızca birini seçebilirsiniz.

  • Bir isteğin User-Agent başlığı engelleme listesindeki bir değerle eşleşirse istek yine de CDNDCDN uç noktasına (POP) ulaşır ancak POP bu isteği 403 durum koduyla reddeder ve isteği günlüğe kaydeder.

  • Engellenen kötü niyetli istekler CDNDCDN düğümlerinde işleme kaynakları tükettiği için küçük miktarda trafik ücreti oluşturur. İstemciler HTTPS kullanıyorsa HTTPS istekleri için de ücretlendirme yapılır.

Yordam

  1. CDN konsolu üzerinde oturum açın.

  2. Sol gezinme bölmesinde Domain Names öğesine 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. User-Agent Blacklist/Whitelist sekmesine tıklayın.

  6. User-Agent Blacklist/Whitelist sekmesinde Modify seçeneğine tıklayın.

  7. Ekrandaki talimatları izleyerek User-Agent başlığı için bir Blacklist veya Whitelist yapılandırın.

    Parametre

    Açıklama

    Type

    Liste türü.

    • Blacklist

      Bir isteğin User-Agent başlığı kara listedeki bir değerle eşleşirse erişim reddedilir ve 403 durum kodu döndürülür.

    • Whitelist

      Yalnızca User-Agent başlığı beyaz listedeki bir değerle eşleşen istekler alan adı kaynaklarına erişebilir.

    Rules

    Birden fazla User-Agent değerini dikey çizgi (|) ile ayırın. Joker karakterler () desteklenir. Örnek: curl|IE|chrome|firefox*.

    Bu özellik tam eşleşme gerektirir ve alt dize eşleşmesini desteklemez. Örneğin curl/7.68.0 yalnızca User-Agent değeri tam olarak curl/7.68.0 olan isteklerle eşleşir. Belirli bir anahtar kelime içeren tüm istekleri eşleştirmek için kelimeyi joker karakterlerle () çevreleyin; örneğin 7.68.0 veya curl*.

    Not
    • User-Agent başlığı boş olan istekler için erişimi kontrol etmek üzere boş bir User-Agent değerini temsil eden this-is-empty-ua ifadesini kullanın.

      • Beyaz listede: Bir kural this-is-empty-ua içeriyorsa User-Agent başlığı boş olan isteklere izin verilir.

      • Kara listede: Bir kural this-is-empty-ua içeriyorsa User-Agent başlığı boş olan istekler reddedilir.

    • User-Agent engelleme/izin listesi User-Agent başlığı olmayan istekler için erişim kontrolünü desteklemez. Bu tür istekleri işlemek için EdgeScript kullanın. Daha fazla bilgi için bkz. EdgeScript. Alternatif olarak veya bir destek bileti oluşturun ve arka uç yapılandırması talep edin.

    Rule Condition

    Bir kural koşulu kullanıcı isteğindeki çeşitli parametre bilgilerini tanımlar. Bu durum yapılandırmanın söz konusu 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.

    • Kullanma: Kural koşulu kullanmaz.

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

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

Yapılandırma örnekleri

  • Örnek 1: Beyaz Liste

    Kural: *IE*|*firefox*

    Sonuç: Yalnızca Internet Explorer veya Firefox olarak kimlik doğrulayan istemcilerden gelen istekler kaynaklara erişebilir. Diğer tüm istekler reddedilir.

  • Örnek 2: Kara Liste

    Kural: *IE*|this-is-empty-ua

    Sonuç: Internet Explorer olarak kimlik doğrulayan istemcilerden gelen istekler veya User-Agent başlığı boş olan istekler reddedilir.

  • Örnek 3: Kara Liste (joker karakter eşleşmesi)

    Yanlış kural: curl/7.68.0

    Doğru kural: *curl/7.68.0* veya *7.68.0*

    curl/7.68.0 kuralı çalışmaz çünkü özellik alt dize eşleşmesi yerine tam eşleşme gerektirir. Bu dizeyi içeren tüm istekleri engellemek için joker karakterler (*) kullanın.