Object Storage Service:OSS SDK for Ruby を使用したアクセスの承認

使用上の注意

• OSS SDK を使用して署名付き URL を生成する場合、OSS SDK は特定のアルゴリズムとローカルコンピュータに保存されているキー情報を使用して署名を計算し、その署名を URL に追加して、URL の有効性とセキュリティを確保します。署名の計算と URL の構築はクライアント側で行われます。ネットワーク経由でサーバーにリクエストを送信する必要はありません。したがって、署名付き URL を生成するために特定の権限を付与される必要はありません。ただし、サードパーティユーザーが署名付き URL によって承認された操作を実行できないようにするには、対応する権限を持っている必要があります。

  たとえば、オブジェクトのダウンロードまたはプレビュー用の署名付き URL を生成するには、oss:PutObject 権限が必要です。

• 署名付き URL を生成し、一時的なアクセス用にビジターに提供できます。署名付き URL を生成するときに、URL の有効期間を指定して、ビジターが特定のデータにアクセスできる期間を制限できます。

• HTTPS 経由でリソースにアクセスするために使用される署名付き URL を生成するには、エンドポイントのプロトコルを HTTPS に設定します。

• 次のサンプルコードを使用して生成された署名付き URL には、プラス記号 (+) が含まれている場合があります。この場合、URL 内のプラス記号 (+) を %2B に置き換えます。そうしないと、署名付き URL を使用してオブジェクトにアクセスできない場合があります。

署名付き URL を生成してオブジェクトをダウンロードする

1. オブジェクトをダウンロードするための署名付き URL を生成します。

   require 'aliyun/oss'
   
   client = Aliyun::OSS::Client.new(
     # この例では、中国 (杭州) リージョンのエンドポイントが使用されています。実際のエンドポイントを指定してください。
     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']
   )
   # バケットの名前を指定します。例: examplebucket。
   bucket = client.get_bucket('examplebucket')
   
   # オブジェクトをダウンロードするために使用される署名付き URL を生成し、その有効期間を 3,600 秒に設定します。
   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 を取得することもできます。