Object Storage Service:Autoriser l'accès (SDK Ruby)

require 'aliyun/sts'
require 'aliyun/oss'

sts = Aliyun::STS::Client.new(
  # Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
  access_key_id: ENV['OSS_ACCESS_KEY_ID'],
  access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
)
# Specify the ARN of the role and a custom session name.
token = sts.assume_role('role-arn', 'session-name')

client = Aliyun::OSS::Client.new(
  # The China (Hangzhou) endpoint is used as an example. Specify the endpoint based on your actual region.
  endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
  # The temporary AccessKey pair (AccessKey ID and AccessKey secret) obtained from STS.
  access_key_id: 'token.access_key_id',
  access_key_secret: 'token.access_key_secret',
  # The security token obtained from STS.
  sts_token: 'token.security_token')

# Specify the bucket name. For example, examplebucket.
bucket = client.get_bucket('examplebucket')
# Upload a file.
bucket.put_object('exampleobject.txt', :file => 'D:\\localpath\\examplefile.txt')

Notes

• Lorsqu'un SDK génère une URL pré-signée, il utilise les informations de clé stockées localement pour calculer une signature selon un algorithme spécifique. Le SDK ajoute ensuite cette signature à l'URL afin d'en garantir la validité et la sécurité. Ce processus de calcul de la signature et de construction de l'URL s'effectue côté client et n'implique aucune requête réseau. Par conséquent, l'appelant n'a pas besoin de permissions spécifiques pour générer l'URL pré-signée. Toutefois, pour garantir que les utilisateurs tiers puissent effectuer les opérations prévues sur les ressources à l'aide de l'URL pré-signée, vous devez vous assurer que l'identité utilisée pour générer l'URL dispose des permissions requises.

  Par exemple, pour télécharger ou prévisualiser un fichier à l'aide d'une URL pré-signée, l'autorisation oss:GetObject est requise.

• Vous pouvez générer une URL pré-signée et la fournir à un visiteur pour un accès temporaire. Lors de la génération d'une URL pré-signée, vous pouvez spécifier sa durée de validité afin de limiter la période pendant laquelle le visiteur peut accéder à des données spécifiques.

• Pour générer une URL pré-signée permettant d'accéder aux ressources via HTTPS, définissez le protocole dans le point de terminaison sur HTTPS.

• L'URL pré-signée générée à l'aide de l'exemple de code suivant peut contenir un signe plus (+). Dans ce cas, remplacez le signe plus (+) dans l'URL par %2B. Sinon, l'URL pré-signée risque de ne pas permettre d'accéder à l'objet comme prévu.

Générer une URL pré-signée et l'utiliser pour télécharger un fichier

1. Générez une URL pré-signée pour le téléchargement d'un fichier.

   require 'aliyun/oss'
   
   client = Aliyun::OSS::Client.new(
     # The China (Hangzhou) endpoint is used as an example. Specify the endpoint based on your actual region.
     endpoint: 'https://oss-cn-hangzhou.aliyuncs.com',
     # Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
     access_key_id: ENV['OSS_ACCESS_KEY_ID'],
     access_key_secret: ENV['OSS_ACCESS_KEY_SECRET']
   )
   # Specify the bucket name. For example, examplebucket.
   bucket = client.get_bucket('examplebucket')
   
   # Generate a presigned URL and set its validity period to 1 hour (3600 seconds).
   puts bucket.object_url('my-object', true, 3600)

2. Téléchargez un objet à l'aide d'une URL signée sur des appareils mobiles ou dans des navigateurs.

   Android-Java

   // Enter the generated signed URL. 
   String url = "";
   OkHttpClient client = new OkHttpClient();
   // Use the signed URL to download the object. 
   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;
           }
           // The object is downloaded. 
           InputStream inputStream = response.body().byteStream();
   
           byte[] buffer = new byte[2048];
           int len;
   
           while ((len = inputStream.read(buffer)) != -1) {
               // Process the downloaded data. For example, display the image or perform a write operation on the object. 
           }
       }
   });

   Object C

   // Use the signed URL to download the object. 
   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

   // You can also use the download attribute in the <a> tag of an HTML page or window.open of a web API to obtain an object URL.