Mengonfigurasi daftar putih atau daftar hitam Referer untuk sebuah Bucket OSS. - Object Storage Service

Mengonfigurasi daftar putih atau daftar hitam Referer untuk bucket Object Storage Service (OSS). Anda dapat menentukan apakah akan mengizinkan permintaan dengan bidang Referer kosong dan apakah akan memotong string kueri dalam URL.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk mengonfigurasi daftar putih atau daftar hitam Referer untuk Bucket OSS. Untuk mengonfigurasi daftar putih atau daftar hitam Referer menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:PutBucketReferer. Untuk informasi lebih lanjut, lihat Menambahkan kebijakan kustom ke pengguna RAM.

Sintaks perintah

ossutil api put-bucket-referer --bucket value --referer-configuration value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--referer-configuration	string	Kontainer yang menyimpan konfigurasi perlindungan hotlink.

Catatan

Perintah put-bucket-referer sesuai dengan operasi PutBucketReferer. Untuk informasi lebih lanjut tentang parameter dalam operasi PutBucketReferer, lihat PutBucketReferer.

--referer-configuration

Opsi --referer-configuration mendukung format XML dan JSON. Jika nilai opsi berisi awalan file://, ossutil membaca konfigurasi dari file konfigurasi.

Format XML:

<RefererConfiguration>
  <TruncatePath>boolean</TruncatePath>
  <RefererList>
    <Referer>string</Referer>
  </RefererList>
  <RefererBlacklist>
    <Referer>string</Referer>
  </RefererBlacklist>
  <AllowEmptyReferer>boolean</AllowEmptyReferer>
  <AllowTruncateQueryString>boolean</AllowTruncateQueryString>
</RefererConfiguration>

Format JSON:

{
  "AllowEmptyReferer": boolean,
  "AllowTruncateQueryString": boolean,
  "TruncatePath": boolean,
  "RefererList": {
    "Referer": ["string", ...]
  },
  "RefererBlacklist": {
    "Referer": ["string", ...]
  }
}

Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah Global.

Contoh

Contoh berikut menunjukkan cara mengonfigurasi daftar putih atau daftar hitam Referer untuk bucket bernama examplebucket:

Buat file konfigurasi bernama referer-configuration.xml dan tambahkan kode berikut ke file konfigurasi:

<?xml version="1.0" encoding="UTF-8"?>
<RefererConfiguration>
    <AllowEmptyReferer>false</AllowEmptyReferer>
    <AllowTruncateQueryString>true</AllowTruncateQueryString>
    <TruncatePath>true</TruncatePath>
    <RefererList>
        <Referer>http://www.aliyun.com</Referer>
        <Referer>https://www.aliyun.com</Referer>
        <Referer>http://www.*.com</Referer>
        <Referer>https://www.?.aliyuncs.com</Referer>
    </RefererList>
    <RefererBlacklist>
        <Referer>http://www.refuse.com</Referer>
        <Referer>https://*.hack.com</Referer>
        <Referer>http://ban.*.com</Referer>
        <Referer>https://www.?.deny.com</Referer>
    </RefererBlacklist>
</RefererConfiguration>

Contoh perintah:

ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.xml

Buat file konfigurasi bernama referer-configuration.json dan tambahkan kode berikut ke file konfigurasi:

{
    "AllowEmptyReferer": "false",
    "AllowTruncateQueryString": "true",
    "TruncatePath": "true",
    "RefererList": {
        "Referer": [
            "http://www.aliyun.com",
            "https://www.aliyun.com",
            "http://www.*.com",
            "https://www.?.aliyuncs.com"
        ]
    },
    "RefererBlacklist": {
        "Referer": [
            "http://www.refuse.com",
            "https://*.hack.com",
            "http://ban.*.com",
            "https://www.?.deny.com"
        ]
    }
}

Contoh perintah:

ossutil api put-bucket-referer --bucket examplebucket --referer-configuration file://referer-configuration.json

Konfigurasikan parameter dalam perintah berikut dalam format JSON:

ossutil api put-bucket-referer --bucket examplebucket --referer-configuration "{\"AllowEmptyReferer\":\"false\",\"AllowTruncateQueryString\":\"true\",\"TruncatePath\":\"true\",\"RefererList\":{\"Referer\":[\"http://www.aliyun.com\",\"https://www.aliyun.com\",\"http://www.*.com\",\"https://www.?.aliyuncs.com\"]},\"RefererBlacklist\":{\"Referer\":[\"http://www.refuse.com\",\"https://*.hack.com\",\"http://ban.*.com\",\"https://www.?.deny.com\"]}}"