Object Storage Service:Cara mengonfigurasi perilaku pratinjau browser untuk objek OSS?

Skenario 1: Unduhan paksa akibat kebijakan keamanan OSS

Skenario ini terjadi ketika header respons berisi x-oss-force-download: true.

• Penyebab: OSS menambahkan header x-oss-force-download: true dan Content-Disposition: attachment untuk mencegah jenis file tertentu (seperti HTML) dieksekusi di browser. Kebijakan ini berlaku saat Anda mengakses objek melalui OSS default domain name atau acceleration endpoint pada bucket yang dibuat setelah tanggal tertentu.

  Untuk informasi lebih lanjut tentang kebijakan ini, lihat Lampiran: Referensi cepat aturan unduhan paksa OSS di akhir topik ini.

• Solusi: Gunakan nama domain kustom untuk mengakses sumber daya OSS

• Prosedur:

  1. Petakan domain kustom: Masuk ke Konsol OSS. Di halaman Domain Names bucket, petakan nama domain kustom Anda yang telah memiliki Pendaftaran ICP.

  2. Konfigurasikan rekaman CNAME: Di penyedia nama domain Anda, seperti Alibaba Cloud DNS, tambahkan Rekaman CNAME yang mengarahkan nama domain kustom Anda ke alamat CNAME yang disediakan oleh OSS.

  3. Akses objek dengan domain baru: Akses objek melalui URL domain kustom Anda. Objek kini akan dipratinjau secara inline.

Skenario 2: Unduhan paksa akibat pengaturan metadata objek

Skenario ini terjadi ketika header respons berisi Content-Disposition: attachment tetapi tidak berisi x-oss-force-download.

• Penyebab: Metadata Content-Disposition objek diatur ke attachment, yang memaksa browser mengunduh alih-alih menampilkan objek. Jika pengaturan ini tidak dihapus setelah penggunaan sementara, semua permintaan selanjutnya akan memicu pengunduhan.

• Solusi: Ubah metadata Content-Disposition objek menjadi inline

  • Ubah melalui konsol

    1. Masuk ke Konsol OSS dan buka halaman Objects di bagian Object Management bucket target.

    2. Temukan objek target. Klik ikon ┇ di kolom Actions lalu pilih Set Object Metadata.

    3. Pada kotak dialog yang muncul, temukan bidang Content-Disposition dan ubah nilainya menjadi inline.

    4. Klik OK untuk menyimpan pengaturan.

  • Ubah secara batch menggunakan ossutil

    # Atur Content-Disposition objek tertentu menjadi inline.
    ossutil set-props oss://your-bucket/your-object.pdf --content-disposition inline --metadata-directive update

Skenario 3: Browser gagal mempratinjau objek karena Content-Type salah

Skenario ini terjadi ketika header respons normal, tetapi browser tetap mengunduh objek.

• Penyebab: Content-Type objek (jenis MIME) tidak ada atau salah. Misalnya, gambar JPG dengan Content-Type diatur ke application/octet-stream akan diunduh karena browser tidak dapat mengenali jenis file tersebut.

• Solusi: Atur Content-Type yang benar untuk objek

  • Ubah melalui konsol

    1. Masuk ke Konsol OSS dan buka halaman Objects di bagian Object Management bucket target.

    2. Temukan objek target. Klik ikon ┇ di kolom Actions lalu pilih Set Object Metadata.

    3. Pada kotak dialog yang muncul, temukan bidang Content-Type dan ubah nilainya menjadi nilai yang benar.

    4. Klik OK untuk menyimpan pengaturan.

    Contoh Content-Type yang benar untuk jenis file umum:

    • Gambar: image/jpeg, image/png, image/gif, image/webp

    • Video: video/mp4

    • Dokumen PDF: application/pdf

    • File HTML: text/html

    • Teks biasa: text/plain

  • Ubah secara batch menggunakan ossutil

    # Atur Content-Type objek tertentu menjadi image/jpeg.
    ossutil set-props oss://your-bucket/your-object.jpg --content-type image/jpeg --metadata-directive update

  • Ubah dengan menggunakan SDK CopyObject

    Saat Anda menggunakan CopyObject untuk menyalin objek, direktif metadata COPY digunakan secara default. Direktif ini menyalin metadata objek sumber ke objek tujuan apa adanya dan tidak secara otomatis menginferensi atau memperbarui Content-Type berdasarkan ekstensi nama file objek tujuan. Dalam kasus ini, jika Anda hanya menentukan Content-Type dalam permintaan tanpa mengatur x-oss-metadata-directive ke REPLACE, pengaturan tersebut tidak berlaku, dan objek tujuan mempertahankan Content-Type objek sumber.

    Nilai valid untuk x-oss-metadata-directive:

    • COPY (default): menyalin metadata objek sumber dan mengabaikan metadata seperti Content-Type yang ditentukan dalam permintaan.

    • REPLACE: mengganti metadata objek sumber dengan metadata yang ditentukan dalam permintaan.

    Saat memanggil CopyObject, Anda harus menentukan Content-Type dan x-oss-metadata-directive: REPLACE untuk memperbarui Content-Type objek tujuan ke nilai yang ditentukan. Contoh kode berikut menggunakan Python SDK:

    import oss2
    
    # Inisialisasi bucket.
    auth = oss2.Auth('<your-access-key-id>', '<your-access-key-secret>')
    bucket = oss2.Bucket(auth, '<your-endpoint>', '<your-bucket-name>')
    
    # Atur Content-Type dan tetapkan direktif metadata ke REPLACE saat menyalin objek.
    headers = {
        "Content-Type": "image/jpeg",
        "x-oss-metadata-directive": "REPLACE"
    }
    bucket.copy_object('<source-bucket-name>', 'source-object.png', 'target-object.jpg', headers=headers)

    Sebagai alternatif, Anda dapat menggunakan metode update_object_meta untuk langsung memperbarui Content-Type objek yang sudah ada, atau tentukan Content-Type saat mengunggah objek menggunakan put_object.

Skenario 4: Pratinjau gagal karena kebijakan bucket memaksakan HTTPS

Skenario ini terjadi ketika permintaan melalui HTTP mengembalikan error 403 AccessDenied dengan pesan Access denied by bucket policy. Objek tidak dipratinjau maupun diunduh, sedangkan objek yang sama dikembalikan sesuai harapan saat diminta melalui HTTPS.

• Penyebab: Kebijakan bucket berisi kondisi acs:SecureTransport, yang menolak permintaan yang tidak dikirim melalui HTTPS. Permintaan HTTP untuk URL objek ditolak oleh kebijakan bucket sebelum objek dikembalikan, sehingga browser tidak memiliki apa pun untuk dipratinjau. Permintaan yang menggunakan nama domain kustom tunduk pada kebijakan bucket yang sama seperti permintaan yang menggunakan nama domain default OSS.

• Konfirmasi penyebab:

  1. Masuk ke Konsol OSS. Klik bucket target. Di panel navigasi kiri, klik Access Control > Bucket Policy

  2. Periksa apakah daftar kebijakan berisi kebijakan yang Condition-nya membatasi metode akses ke HTTP dan Effect-nya adalah Deny.

  3. Atau, kueri kebijakan bucket dari command line:

     aliyun ossutil api get-bucket-policy --bucket <bucket-name>

• Solusi 1 (Direkomendasikan): Akses objek melalui HTTPS. Ganti http:// dengan https:// pada URL objek dan minta objek tersebut lagi. Objek kemudian akan dipratinjau di browser, dan bucket tetap menolak permintaan HTTP.

• Solusi 2: Ubah kebijakan bucket. Jika bisnis Anda memerlukan akses HTTP, di panel navigasi kiri, klik Access Control > Bucket Policy, hapus atau ubah kebijakan yang berisi kondisi acs:SecureTransport. Mengizinkan permintaan HTTP berarti data ditransmisikan dalam teks biasa, yang mengurangi keamanan transmisi. Evaluasi dampaknya sebelum mengubah kebijakan.

Perubahan metadata tidak berlaku: Periksa cache CDN

Jika Anda menggunakan CDN untuk mempercepat akses ke OSS, perubahan metadata seperti Content-Type atau Content-Disposition mungkin tidak langsung berlaku karena node CDN masih menyajikan versi yang di-cache.

Solusi: Bersihkan cache CDN untuk URL file yang dimodifikasi di Konsol CDN. Refresh dan prefetch resources.

Bagaimana cara memaksa objek diunduh alih-alih dipratinjau?

Untuk selalu memaksa pengunduhan saat pengguna mengakses file, gunakan salah satu metode berikut.

• Metode 1 (Direkomendasikan): Konfigurasi di OSS. Atur metadata Content-Disposition file ke attachment seperti yang dijelaskan di Skenario 2. Paling cocok untuk pengaturan permanen per file.

• Metode 2: Konfigurasi di CDN. Tambahkan Content-Disposition: attachment sebagai header respons outbound di bawah Cache di Konsol CDN. Ini menghindari modifikasi file sumber dan mendukung konfigurasi batch berdasarkan path atau jenis file.

Browser tidak mendukung format file untuk pratinjau

Browser tidak dapat mempratinjau format profesional tertentu seperti .psd, .ai, dan .sketch. File-file ini diunduh terlepas dari konfigurasi OSS dan CDN.

Solusi: Pasang ekstensi browser untuk format tersebut, atau gunakan layanan pratinjau dokumen seperti WebOffice Online Preview.

Nama domain default OSS

Titik akhir percepatan