Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:referer

Son Güncelleme:Oct 01, 2026

Object Storage Service (OSS) paketinizdeki kaynaklara yetkisiz erişimi önlemek için hotlink korumasını yapılandırabilirsiniz. Bu konuda, bir paket için hotlink koruma ayarlarını yapılandırmak ve bu ayarları değiştirmek, sorgulamak veya silmek amacıyla referer komutunun nasıl çalıştırılacağı açıklanmaktadır.

Kullanım notları

  • Hotlink koruma ayarlarını oluşturmak veya değiştirmek için oss:PutBucketReferer iznine sahip olmanız gerekir. Ayarları sorgulamak için oss:GetBucketReferer iznine, ayarları silmek için ise oss:DeleteBucketReferer iznine ihtiyacınız vardır. Daha fazla bilgi için bkz. Özel bir ilke atayın.

  • ossutil 1.6.16 ve sonraki sürümlerde, komut satırında ikili dosya adı olarak doğrudan ossutil kullanabilirsiniz. İşletim sistemine göre ikili dosya adını güncellemenize gerek yoktur. 1.6.16'dan önceki ossutil sürümlerinde işletim sistemine göre ikili dosya adını güncellemeniz gerekir. Daha fazla bilgi için bkz. ossutil komut başvurusu.

  • Hotlink koruma hakkında daha fazla bilgi için bkz. Hotlink koruma.

Hotlink koruma ayarlarını oluşturun veya değiştirin

Bir paket için hotlink koruma yapılandırılmamışsa aşağıdaki referer komutu bu pakette hotlink korumayı etkinleştirir. Paket için hotlink koruma zaten yapılandırılmışsa aynı komut mevcut ayarların üzerine yazar.

Bir paket için hotlink koruma ayarlarını yapılandırmak veya mevcut ayarları değiştirmek üzere aşağıdaki komutu çalıştırın:

  • Komut sözdizimi

    ossutil referer --method put oss://bucketname refererconfig [--disable-empty-referer]

    Aşağıdaki tabloda komut sözdizimindeki parametreler ve seçenekler açıklanmıştır.

    Parametre/Seçenek

    Açıklama

    bucketname

    Hotlink koruma ayarlarını oluşturmak veya değiştirmek istediğiniz paketin adı.

    refererconfig

    Referer izin listesine eklemek istediğiniz alan adları veya IP adresleri. Joker karakter olarak yıldız (*) ve soru işareti (?) kullanabilirsiniz. Birden fazla Referer belirtiyorsanız bunları boşlukla ayırın. Örnekler:

    • Referer izin listesine http://www.aliyun.com eklerseniz http://www.aliyun.com ile başlayan URL'ler (örneğin http://www.aliyun.com/123 ve http://www.aliyun.com.cn) eşleşir.

    • Referer izin listesine *www.aliyun.com eklerseniz içinde www.aliyun.com geçen URL'ler (örneğin http://www.aliyun.com ve https://www.aliyun.com) eşleşir.

    • Sıfır veya daha fazla karakteri temsil etmek için joker karakter olarak yıldız (*) kullanabilirsiniz. Örneğin, Referer izin listesine *.aliyun.com eklerseniz https://www.alibabacloud.com/help ve https://www.aliyun.com gibi URL'ler eşleşir.

    • Tek bir karakteri temsil etmek için joker karakter olarak soru işareti (?) kullanabilirsiniz.

    • Referer izin listesine bağlantı noktası numarası içeren alan adları veya IP adresleri (örneğin https://www.example.com:8080 ve https://10.0.0.0:8080) ekleyebilirsiniz.

    --disable-empty-referer

    Boş Referer alanı içeren isteklere izin verilip verilmeyeceğini belirtir.

    • Bu parametreyi belirtmezseniz boş Referer alanı içeren isteklere izin verilir. Boş Referer alanı içeren veya Referer alanı bulunmayan HTTP ya da HTTPS isteklerine izin verilir.

    • Bu parametreyi belirtirseniz boş Referer alanı içeren isteklere izin verilmez. Yalnızca geçerli bir değer içeren Referer alanına sahip HTTP veya HTTPS istekleri pakete erişebilir.

  • Örnekler

    examplebucket paketinde hotlink korumayı yapılandırarak www.aliyun.com alan adının paketteki nesnelere başvurmasına izin verin ve tarayıcının adres çubuğuna nesne URL'lerinin girilmesi yoluyla examplebucket paketindeki nesnelere erişimi reddedin.

    ossutil referer --method put oss://examplebucket http://www.aliyun.com https://www.aliyun.com --disable-empty-referer

    examplebucket paketinde hotlink korumayı yapılandırarak www.aliyun.com alan adının paketteki nesnelere başvurmasına izin verin ve tarayıcının adres çubuğuna nesne URL'lerinin girilmesi yoluyla nesnelere erişime izin verin.

    ossutil referer --method put oss://examplebucket http://www.aliyun.com https://www.aliyun.com

    Aşağıdaki örnek çıktı, paket için hotlink koruma ayarlarının yapılandırıldığını gösterir:

    0.134839(s) elapsed

Bir paketin hotlink koruma ayarlarını sorgulayın

  • Komut sözdizimi

    ossutil referer --method get oss://bucketname [local_xml_file]

    Aşağıdaki tabloda önceki komutta yer alan parametreler açıklanmıştır.


    Parametre


    Açıklama


    bucketname


    Hotlink koruma ayarlarını sorgulamak istediğiniz paketin adı.


    local_xml_file


    Paketin hotlink koruma ayarlarını kaydetmek istediğiniz yerel dosyanın adı. Örnek: localfile.txt. Bu parametre belirtilmezse hotlink koruma ayarları ekranda görüntülenir.

  • Örnekler

    • examplebucket paketinin hotlink koruma ayarlarını sorgulayın ve ayarları localfile.txt dosyasında saklayın.

      ossutil referer --method get oss://examplebucket localfile.txt

      Aşağıdaki örnek çıktı, hotlink koruma ayarlarının alındığını gösterir.

      0.212407(s) elapsed
    • examplebucket paketinin hotlink koruma ayarlarını sorgulayın ve ayarları görüntüleyin.

      ossutil referer --method get oss://examplebucket

      Aşağıdaki örnek çıktı, yalnızca Referer üst bilgileri *www.aliyun.com ile eşleşen HTTP veya HTTPS isteklerinin examplebucket paketine erişmesine izin verildiğini ve boş Referer alanı içeren isteklerin kabul edilmediğini gösterir.

      <?xml version="1.0" encoding="UTF-8"?>
        <RefererConfiguration>
            <AllowEmptyReferer>false</AllowEmptyReferer>
            <RefererList>
                <Referer>*www.aliyun.com</Referer>
            </RefererList>
        </RefererConfiguration>
      
      
      0.080482(s) elapsed

Bir paketin hotlink koruma ayarlarını silin

  • Komut sözdizimi

    ossutil referer --method delete oss://bucketname

    Sözdiziminde bucketname parametresi, hotlink koruma ayarlarını silmek istediğiniz paketin adını belirtir.

  • Örnekler

    examplebucket paketinin hotlink koruma ayarlarını silin.

    ossutil referer --method delete oss://examplebucket

    Aşağıdaki örnek çıktı, paketin hotlink koruma ayarlarının silindiğini gösterir.

    0.212409(s) elapsed

Ortak seçenekler

Farklı bir bölgedeki bir pakete erişmek için uç noktayı belirtmek üzere -e seçeneğini kullanın. Farklı bir Alibaba Cloud hesabına ait bir pakete erişmek için AccessKey ID değeri için -i ve AccessKey secret değeri için -k seçeneğini kullanın.

Aşağıdaki komut, Çin (Hangzhou) bölgesinde bulunan ve başka bir Alibaba Cloud hesabına ait olan testbucket paketi için hotlink korumayı nasıl yapılandıracağınızı gösterir:

ossutil referer --method put oss://testbucket www.alibabacloud.com -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Ortak seçenekler.