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。