Object Storage Service：Otorisasi akses (Ruby SDK)

Catatan

• Ketika SDK menghasilkan presigned URL, SDK tersebut menggunakan informasi kunci yang disimpan secara lokal untuk menghitung signature berdasarkan algoritma tertentu. SDK kemudian menambahkan signature tersebut ke URL guna memastikan validitas dan keamanannya. Proses perhitungan signature dan penyusunan URL ini dilakukan di sisi klien dan tidak melibatkan permintaan jaringan. Oleh karena itu, pemanggil tidak memerlukan izin khusus untuk menghasilkan presigned URL. Namun, untuk memastikan bahwa pengguna pihak ketiga dapat melakukan operasi yang dimaksudkan pada sumber daya menggunakan presigned URL tersebut, Anda harus memastikan bahwa identitas yang digunakan untuk menghasilkan URL memiliki izin yang diperlukan.

  Sebagai contoh, untuk mengunduh atau melihat pratinjau file menggunakan presigned URL, diperlukan izin oss:GetObject.

• Anda dapat menghasilkan presigned URL dan memberikan URL tersebut kepada pengunjung untuk akses sementara. Saat menghasilkan presigned URL, Anda dapat menentukan periode validitas URL tersebut untuk membatasi rentang waktu pengunjung dapat mengakses data tertentu.

• Untuk menghasilkan presigned URL yang digunakan untuk mengakses sumber daya melalui HTTPS, atur protokol pada endpoint ke HTTPS.

• Presigned URL yang dihasilkan menggunakan kode contoh berikut mungkin berisi tanda plus (+). Dalam kasus ini, ganti tanda plus (+) pada URL dengan %2B. Jika tidak, presigned URL tersebut mungkin tidak dapat digunakan untuk mengakses objek seperti yang diharapkan.

Hasilkan presigned URL dan gunakan untuk mengunduh file

1. Hasilkan presigned URL untuk mengunduh file.

   require 'aliyun/oss'
   
   client = Aliyun::OSS::Client.new(
     # Titik akhir China (Hangzhou) digunakan sebagai contoh. Sesuaikan titik akhir berdasarkan wilayah Anda.
     endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
     # Dapatkan kredensial akses dari variabel lingkungan. Sebelum menjalankan kode contoh ini, pastikan variabel lingkungan OSS_ACCESS_KEY_ID dan OSS_ACCESS_KEY_SECRET telah disetel.
     access_key_id: ENV['OSS_ACCESS_KEY_ID'],
     access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
   )
   # Tentukan nama bucket. Contohnya, examplebucket.
   bucket = client.get_bucket('examplebucket')
   
   # Hasilkan presigned URL dan tetapkan periode validitasnya menjadi 1 jam (3600 detik).
   puts bucket.object_url('my-object', true, 3600)

2. Unduh objek menggunakan signed URL pada perangkat seluler atau browser.
   Android-Java

   // Masukkan signed URL yang dihasilkan. 
   String url = "";
   OkHttpClient client = new OkHttpClient();
   // Gunakan signed URL untuk mengunduh objek. 
   Request getRequest = new Request.Builder()
           .url(url)
           .get()
           .build();
   client.newCall(getRequest).enqueue(new Callback() {
       @Override
       public void onFailure(Call call, IOException e) {
           e.printStackTrace();
       }
   
       @Override
       public void onResponse(Call call, Response response) throws IOException {
           if (response.code() == 203 || response.code() >= 300) {
               Log.d("download", "fail");
               Log.d("download", response.body().string());
               return;
           }
           // Objek berhasil diunduh. 
           InputStream inputStream = response.body().byteStream();
   
           byte[] buffer = new byte[2048];
           int len;
   
           while ((len = inputStream.read(buffer)) != -1) {
               // Proses data yang diunduh. Misalnya, tampilkan citra atau lakukan operasi penulisan pada objek. 
           }
       }
   });

   Object C

   // Gunakan signed URL untuk mengunduh objek. 
   NSURL * url = [NSURL URLWithString:urlString];
   NSURLRequest * request = [NSURLRequest requestWithURL:url];
   NSURLSession * session = [NSURLSession sharedSession];
   NSURLSessionTask * sessionTask = [session dataTaskWithRequest:request
                                               completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
       if (error) {
           NSLog(@"download error: %@", error);
           return;
       } else if (((NSHTTPURLResponse*)response).statusCode == 203 ||
                  ((NSHTTPURLResponse*)response).statusCode >= 300) {
           NSString *body = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
           NSLog(@"download error: %@", body);
           return;
       }
       NSLog(@"download success");
   }];
   [sessionTask resume];

   JavaScript

   // Anda juga dapat menggunakan atribut download pada tag <a> halaman HTML atau window.open dari web API untuk mendapatkan URL objek.