Object Storage Service：Ruby授權訪問

注意事項

• 產生簽名URL過程中，SDK利用本機存放區的密鑰資訊，根據特定演算法計算出簽名（signature），然後將其附加到URL上，以確保URL的有效性和安全性。這一系列計算和構造URL的操作都是在用戶端完成，不涉及網路請求到服務端。因此，產生簽名URL時不需要授予調用者特定許可權。但是，為避免第三方使用者無法對簽名URL授權的資源執行相關操作，需要確保調用產生簽名URL介面的身份主體被授予對應的許可權。

  例如，通過簽名URL下載或預覽檔案時，需要授予oss:GetObject許可權。

• 您可以將產生的簽名URL提供給訪客進行臨時訪問。產生簽名URL時，您可以自訂URL的到期時間來限制訪客的訪問時間長度。

• 如果需要產生HTTPS協議的簽名URL，請將Endpoint中的通訊協定設定為HTTPS。

• 通過以下樣本產生的簽名URL中如果包含特殊符號+，可能出現無法正常訪問該簽名URL的現象。如需正常訪問該簽名URL，請將簽名URL中的+替換為%2B。

產生簽名URL並通過簽名URL下載檔案

1. 產生用於下載的簽名URL。

   require 'aliyun/oss'
   
   client = Aliyun::OSS::Client.new(
     # Endpoint以華東1（杭州）為例，其它Region請按實際情況填寫。
     endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
     # 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
     access_key_id: ENV['OSS_ACCESS_KEY_ID'],
     access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
   )
   # 填寫Bucket名稱，例如examplebucket。
   bucket = client.get_bucket('examplebucket')
   
   # 產生簽名URL，並指定URL有效時間為1小時（3600秒）。
   puts bucket.object_url('my-object', true, 3600)

2. 在移動端或者瀏覽器端通過簽名URL下載檔案。
   Android-Java

   // 填寫產生的簽名URL。
   String url = "";
   OkHttpClient client = new OkHttpClient();
   // 通過簽名URL下載檔案。
   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;
           }
           // 請求成功。
           InputStream inputStream = response.body().byteStream();
   
           byte[] buffer = new byte[2048];
           int len;
   
           while ((len = inputStream.read(buffer)) != -1) {
               // 處理下載的資料，例如圖片展示或者寫入檔案等。
           }
       }
   });

   Object C

   // 使用簽名URL下載檔案。
   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

   // 通過HTML中<a>標籤的download屬性、Web API中的window.open等方式使用擷取的檔案URL。